PolyDoc (nezávislá Publisher) (Preview)

Převeďte HTML nebo adresu URL na soubory PDF a snímky obrazovek a vygenerujte hybridní elektronické faktury kompatibilní s EU (ZUGFeRD / Factur-X). PolyDoc se vykreslí pomocí skutečného prohlížeče, takže to, co vidíte na stránce, je to, co v dokumentu získáte.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Oblasti
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logické aplikace Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Azure Government oblastí
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Automatizace napájení Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Jméno PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
Metadata konektoru
Vydavatel blue-d3v
Internetová stránka https://polydoc.tech
Zásady ochrany osobních údajů https://polydoc.tech/legal/privacy-policy/
Kategorie Obsah a soubory

PolyDoc

PolyDoc změní kód HTML nebo adresu URL na pixelově dokonalé soubory PDF a snímky obrazovky a vygeneruje hybridní elektronické faktury kompatibilní s EU (ZUGFeRD / Factur-X). Převody se vykreslují v reálném prohlížeči, takže to, co vidíte na stránce, je to, co získáte v dokumentu.

Vydavatel

PolyDoc

Předpoklady

Potřebujete účet PolyDoc a klíč rozhraní API. Úroveň Free stačí k vyhodnocení konektoru. Vlastní konektory jsou funkce premium Power Automate, takže toky, které tento konektor používají, potřebují plán Power Automate Premium (podle uživatele nebo toku), který je stejný jako integrovaná akce HTTP.

Získání přihlašovacích údajů

  1. Přihlaste se na dashboard.polydoc.tech.
  2. Otevřete klíče rozhraní API a vytvořte klíč.
  3. Při vytváření připojení vložte klíč do klíče rozhraní PolyDoc API. Vložit pouze klíč; konektor za vás přidá předponu Bearer .

Podporované operace

Operace Jak funguje
Převést na PDF Vykreslujte HTML, adresu URL nebo uloženou šablonu do PDF. Ovládací prvky pro formát stránky, okraje, měřítko, záhlaví/zápatí, záložky, přístupné (označené) soubory PDF, metadata, šifrování, vodoznaky a PDF/A.
Snímek obrazovky zachycení Zachyťte formát PNG, JPEG nebo WebP html, adresu URL nebo šablonu. Full-page nebo clipped, with viewport and device-pixel-ratio control.

E-faktury se vytvářejí pomocí příkazu Convert to PDF: vyplňte pole elektronické faktury (standardní, profil a strukturovaný invoice objekt) a PolyDoc vloží do vrácené pdf faktury ZUGFeRD / Factur-X fakturu. Podívejte se do example-flows/ složky v úložišti konektoru pro tělo připravené k použití.

Zdroj

Každá operace přebírá jeden zdroj , který je jedním z těchto zdrojů:

  • adresa URL, např. https://example.com
  • vložený řetězec HTML
  • a saved template reference, [template:TEMPLATE_ID], optionally with Template data for the Liquid renderer

Doručení

Ve výchozím nastavení se soubor vrátí jako binární obsah připravený k vložení do souboru Create (OneDrive, SharePoint, blob) nebo přílohy e-mailu. V rozšířených možnostech jsou k dispozici dva alternativní režimy doručení:

  • Cloudové úložiště: zadejte předem podepsanou adresu URL PUT; PolyDoc nahraje soubor a akce vrátí JSON obsahující uloženou adresu URL.
  • Webhook: PolyDoc doručí soubor do webhooku a akce vrátí potvrzení JSON (HTTP 202 při asynchronním přístupu).

Pokud se použije některý z režimů doručení, odpověď je JSON místo binárního souboru.

Režim sandboxu

Každá operace má pokročilý vstup v režimu sandboxu . Nastavte ho tak, aby true se vygeneroval výstup s vodoznakem z samostatné kvóty s nižším limitem rychlosti, což je užitečné při sestavování a testování toku. Nechte ho false pro produkční dokumenty.

Známé problémy a omezení

  • Odpověď každé akce je deklarována jako binární soubor. Pokud je nakonfigurované cloudové úložiště nebo doručování Webhooku , vrátí akce místo souboru JSON.
  • Stránky, které načítají JavaScript z externího CDN, mohou převaděč výrazně zpomalit. U vloženého KÓDU HTML preferujete samostatné značky (vložené šablony stylů CSS, obrázky data-URI).
  • Elektronické faktury se řídí EN 16931. Minimálně zadejte termín splatnosti nebo platební podmínky (pravidlo BR-CO-25), DIČ prodejce, pokud řádek používá kategorii SDPH a konzistentní součty (čisté + daň = hrubá částka). Pokud je povolené ověření faktury, která selže, vrátí chybu.

Pokyny k nasazení

Tento konektor je definovaný jako standardní vlastní konektor Power Platform (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Nasaďte ho pomocí rozhraní příkazového řádku konektorů Power Platform:

# one-time login
paconn login

# validate the definition
paconn validate --api-def apiDefinition.swagger.json

# create the connector in the selected environment
paconn create --api-def apiDefinition.swagger.json \
  --api-prop apiProperties.json --icon icon.png --secret <none>

Můžete také importovat apiDefinition.swagger.json přímo z portálu pro tvůrce Power Automate (vlastní datové > konektory > – Nový vlastní konektor > importuje soubor OpenAPI).

Vytvoření připojení

Konektor podporuje následující typy ověřování:
Default Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Jméno Typ Popis Povinné
Klíč rozhraní PolyDoc API securestring Klíč rozhraní PolyDoc API. Vytvořte ho na dashboard.polydoc.tech v části Klíče rozhraní API. Vložit pouze klíč; spojnice za vás přidá předponu Bearer. Pravdivé

Akce

Převést na PDF

Vykreslujte HTML, adresu URL nebo uloženou šablonu do PDF. Vyplňte pole elektronické faktury pro vložení hybridní faktury ZUGFeRD / Factur-X místo prostého PDF. Vrátí soubor jako binární obsah.
Snímek obrazovky zachycení

Vykreslujte HTML, adresu URL nebo uloženou šablonu a zachyťte snímek obrazovky PNG, JPEG nebo WebP. Vrátí obrázek jako binární obsah.

Převést na PDF

ID operace:
ConvertToPdf

Vykreslujte HTML, adresu URL nebo uloženou šablonu do PDF. Vyplňte pole elektronické faktury pro vložení hybridní faktury ZUGFeRD / Factur-X místo prostého PDF. Vrátí soubor jako binární obsah.

Parametry

Name Klíč Vyžadováno Typ Description
Režim sandboxu
 X-Sandbox string

Spusťte převod v režimu sandboxu. Výstup sandboxu je vodoznak a nakreslí se z samostatné kvóty s nižším limitem rychlosti. Pro produkční dokumenty použijte false.
Zdroj
 source True string

Adresa URL (https://...), vložený řetězec HTML nebo uložený odkaz na šablonu ve formuláři [template:TEMPLATE_ID].
Jméno souboru
 filename string

Výstupní název souboru, např. invoice.pdf.
Data šablony
 templateData object

Data klíč/hodnota předaná do rendereru šablony Liquid, když zdroj je odkaz [template:ID].
Štítek
 tag string

Popisek pro protokolování a analýzu (maximálně 30 znaků)
Časový limit (ms)
 timeout integer

Časový limit převodu v milisekundách (max. 600000).
Formát papíru
 format string

Formát papíru. Výchozí hodnota je A4.
Krajina
 landscape boolean

Použijte orientaci na šířku.
Tisk pozadí
 printBackground boolean

Tisk grafiky a barev pozadí
Scale
 scale number

Měřítko vykreslení v rozsahu od 0,1 do 2
Rozsahy stránek
 pageRanges string

Stránky, které mají být zahrnuty, například "1-5, 8". Prázdné znamená všechny stránky.
Osnova (záložky)
 outline boolean

Vygenerujte záložky PDF z nadpisů HTML.
Tagged (přístupné)
 tagged boolean

Vytvoří označený (přístupný) PDF.
Preferovat velikost stránky CSS
 preferCSSPageSize boolean

@page Respektujte velikost deklarovanou v ŠABLONĚ stylů CSS ve formátu Papíru.
Vynechání pozadí
 omitBackground boolean

Vykreslení s průhledným pozadím
Zobrazení záhlaví nebo zápatí
 displayHeaderFooter boolean

Vykreslí šablony záhlaví a zápatí.
Šablona záhlaví
 headerTemplate string

HTML pro záhlaví stránky. Vyžaduje záhlaví nebo zápatí zobrazení.
Šablona zápatí
 footerTemplate string

HTML pro zápatí stránky. Vyžaduje záhlaví nebo zápatí zobrazení.
Vrchol
 top string
Správně
 right string
Dolní
 bottom string
Vlevo
 left string
Title
 title string
Autor
 author string
Předmět
 subject string
Klíčová slova
 keywords array of string
Producer
 producer string
Tvůrce
 creator string
Uživatelské heslo
 userPassword string
Heslo vlastníka
 ownerPassword string
Zdroj
 source True string

Text vodoznaku nebo adresa URL obrázku / identifikátor URI dat
Typ
 type True string
Možnosti
 options object

Možnosti písma, neprůhlednosti, otočení, měřítka, opakování a posunu
Úroveň
 level True string
Ověření dodržování předpisů
 verify boolean
Ověření dodržování předpisů
 verify boolean

Ověření proti veraPDF PDF/UA-1; vrátí chybu, pokud se ověření nezdaří.
Standard
 standard True string

Standard hybridní faktury.
Profile
 profile True string

Profil členitosti dat, který se má ověřit.
Ověření dodržování předpisů
 verify boolean

Ověření dodržování předpisů pdf/A a a e-invoice; vrátí chybu, pokud se ověření nezdaří.
Číslo faktury
 number True string
Datum emise
 issueDate True string

Datum vydání, YYYY-MM-DD.
Datum splatnosti
 dueDate string

Termín splnění, YYYY-MM-DD. Zadejte tyto nebo platební podmínky (PRAVIDLO BR-CO-25 PRAVIDLA EN 16931).
Měna
 currencyCode True string

Kód měny ISO 4217, např. EUR.
Jméno
 name True string
Řádek adresy 1
 line1 True string
Řádek adresy 2
 line2 string
Město
 city True string
PSČ
 postalCode True string
Kód země
 countryCode True string

KÓD ZEMĚ ISO 3166-1 alfa-2, např.
DIČ
 taxId string

IDENTIFIKÁTOR DPH. Vyžaduje se pro prodejce, pokud řádek používá kategorii DPH S.
Email
 email string
telefon
 phone string
Popis
 description True string
Množství
 quantity True number
Kód jednotky
 unitCode string

Kód jednotky UN/ECE, např. C62 (kus).
Jedn. cena
 unitPrice True number
Součet řádku
 lineTotal True number
SAZBA DPH (%)
 vatRate number
Kategorie DPH
 vatCategoryCode string

Kód kategorie DPH, např. S (standard), Z (nula), E (osvobození).
Kód kategorie
 categoryCode True string
Rate (%)
 rate True number
Daňovatelná částka
 taxableAmount True number
Částka daně
 taxAmount True number
Platební podmínky
 paymentTerms string

Podmínky platby zdarma Zadejte toto datum nebo termín splnění.
Typ kódu
 typeCode True string

UN/ECE 4461 platba znamená kód, např. 30 (kreditní převod).
IBAN
 iban string
BIC
 bic string
Název účtu
 accountName string
Platební reference
 paymentReference string
Celkem net
 totalNetAmount True number
Daň celkem
 totalTaxAmount True number
Celkový hrubý součet
 totalGrossAmount True number

Musí se rovnat čisté + daň.
Note
 note string
Referenční dokumentace kupujícího
 buyerReference string

Referenční informace kupujícího / Leitweg-ID pro faktury ve veřejném sektoru.
Zakázání JavaScriptu
 disableJavascript boolean
Vložení šablon stylů CSS
 css string

Další šablony stylů CSS vložené na stránku.
Vložení JavaScriptu
 javascript string

JavaScript se na stránce spustil před zachycením.
Čekání na selektor
 waitForSelector string

Počkejte, až se zobrazí tento selektor šablon stylů CSS.
Wait for function
 waitForFunction string

Počkejte, až tento výraz JS vrátí hodnotu true.
Typ média
 mediaType string
Blokování reklam
 blockAds boolean
Klientský software
 userAgent string
Hlavičky HTTP
 httpHeaders object

Extra hlavičky HTTP jako páry klíč/hodnota.
Jméno
 name True string
Hodnota
 value True string
URL
 url string
Doména
 domain string
Cesta
 path string
Platnost vyprší (epocha)
 expires number
Pouze HTTP
 httpOnly boolean
Secure
 secure boolean
Stejný web
 sameSite string
Typ
 type string
Uživatelské jméno
 username True string
Heslo
 password True string
Adresa URL webhooku
 url True string
Async
 async boolean

Doručte na pozadí a okamžitě vraťte verzi 202.
Metoda
 method string
Headers
 headers object

Extra hlavičky pro požadavek webhooku
Časový limit (ms)
 timeout number
Znovupokusy
 retries integer
Zpoždění opakování (ms)
 retryDelay number
Předsignovaná adresa URL
 presignedUrl True string

Předsignovaná adresa URL HTTP PUT od poskytovatele úložiště.

Návraty

response
binary

Snímek obrazovky zachycení

ID operace:
CaptureScreenshot

Vykreslujte HTML, adresu URL nebo uloženou šablonu a zachyťte snímek obrazovky PNG, JPEG nebo WebP. Vrátí obrázek jako binární obsah.

Parametry

Name Klíč Vyžadováno Typ Description
Režim sandboxu
 X-Sandbox string

Spusťte převod v režimu sandboxu. Výstup sandboxu je vodoznak a nakreslí se z samostatné kvóty s nižším limitem rychlosti. Pro produkční dokumenty použijte false.
Zdroj
 source True string

Adresa URL (https://...), vložený řetězec HTML nebo uložený odkaz na šablonu ve formuláři [template:TEMPLATE_ID].
Jméno souboru
 filename string

Výstupní název souboru, např. screenshot.png.
Data šablony
 templateData object

Data klíč/hodnota předaná do rendereru šablony Liquid, když zdroj je odkaz [template:ID].
Typ obrázku
 type string

Formát obrázku Výchozí hodnota je png.
Celostránkový
 fullPage boolean

Zachyťte celou stránku, která se dá posunout.
Quality
 quality integer

Kvalita komprese 0-100 pro JPEG/WebP.
Vynechání pozadí
 omitBackground boolean

Zachytávání s průhledným pozadím (PNG/WebP)
Šířka (px)
 width integer
Výška (px)
 height integer
Poměr pixelů zařízení
 devicePixelRatio number
X
 x number
Й
 y number
Šířka
 width number
Výška
 height number
Scale
 scale number
Štítek
 tag string

Popisek pro protokolování a analýzu (maximálně 30 znaků)
Časový limit (ms)
 timeout integer

Časový limit převodu v milisekundách (max. 600000).
Zakázání JavaScriptu
 disableJavascript boolean
Vložení šablon stylů CSS
 css string

Další šablony stylů CSS vložené na stránku.
Vložení JavaScriptu
 javascript string

JavaScript se na stránce spustil před zachycením.
Čekání na selektor
 waitForSelector string

Počkejte, až se zobrazí tento selektor šablon stylů CSS.
Wait for function
 waitForFunction string

Počkejte, až tento výraz JS vrátí hodnotu true.
Typ média
 mediaType string
Blokování reklam
 blockAds boolean
Klientský software
 userAgent string
Hlavičky HTTP
 httpHeaders object

Extra hlavičky HTTP jako páry klíč/hodnota.
Jméno
 name True string
Hodnota
 value True string
URL
 url string
Doména
 domain string
Cesta
 path string
Platnost vyprší (epocha)
 expires number
Pouze HTTP
 httpOnly boolean
Secure
 secure boolean
Stejný web
 sameSite string
Typ
 type string
Uživatelské jméno
 username True string
Heslo
 password True string
Adresa URL webhooku
 url True string
Async
 async boolean

Doručte na pozadí a okamžitě vraťte verzi 202.
Metoda
 method string
Headers
 headers object

Extra hlavičky pro požadavek webhooku
Časový limit (ms)
 timeout number
Znovupokusy
 retries integer
Zpoždění opakování (ms)
 retryDelay number
Předsignovaná adresa URL
 presignedUrl True string

Předsignovaná adresa URL HTTP PUT od poskytovatele úložiště.

Návraty

response
binary

Definice

binární

Toto je základní datový typ Binary.