PolyDoc (független Publisher) (előzetes verzió)

HTML- vagy URL-cím konvertálása képpont-tökéletes PDF-fájlokká és képernyőképekké, és eu-kompatibilis hibrid e-számlák létrehozása (ZUGFeRD/ Factur-X). A PolyDoc egy valódi böngészőmotorral jeleníti meg a renderelést, így a lapon az látható, amit a dokumentumban talál.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Regions
Copilot Studio prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Az összes Logic Apps-régió , kivéve a következőket:
     - Azure Government-régiók
     - Azure China-régiók
     - Amerikai Védelmi Minisztérium (DoD)
Power Apps prémium Az összes Power Apps-régió , kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate prémium Az összes Power Automate-régió, kivéve a következőket:
     - USA kormánya (GCC)
     - Amerikai kormány (GCC High)
     - A 21Vianet által üzemeltetett China Cloud
     - Amerikai Védelmi Minisztérium (DoD)
Kapcsolat
Név PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
Összekötő metaadatai
Kiadó kék-d3v
Webhely https://polydoc.tech
Adatvédelmi irányelvek https://polydoc.tech/legal/privacy-policy/
Categories Tartalom és fájlok

PolyDoc

A PolyDoc a HTML-t vagy az URL-címet pixel-tökéletes PDF-ekké és képernyőképekké alakítja, és eu-kompatibilis hibrid e-számlákat hoz létre (ZUGFeRD/ Factur-X). A konverziók egy valódi böngészőmotorban jelennek meg, így a lapon az látható, amit a dokumentumban talál.

Kiadó

PolyDoc

Prerequisites

PolyDoc-fiókra és API-kulcsra van szüksége. Az ingyenes szint elegendő az összekötő kiértékeléséhez. Az egyéni összekötők egy prémium szintű Power Automate szolgáltatás, ezért az összekötőt használó folyamatoknak Power Automate Prémium csomagra (felhasználónként vagy folyamatonként) van szükségük, ugyanazzal, mint a beépített HTTP-művelettel.

Hitelesítő adatok beszerzése

  1. Jelentkezzen be a dashboard.polydoc.tech.
  2. Nyissa meg az API-kulcsokat , és hozzon létre egy kulcsot.
  3. A kapcsolat létrehozásakor illessze be a kulcsot a PolyDoc API-kulcsba. Csak a kulcsot illessze be; az összekötő hozzáadja önnek az Bearer előtagot.

Támogatott műveletek

Operation Mire szolgál?
Konvertálás PDF-fájllá HTML- vagy URL-cím vagy mentett sablon megjelenítése PDF-fájlba. Az oldalformátum, margók, méretezés, élőfejek/élőlábak, könyvjelzők, akadálymentes (címkézett) PDF-fájlok, metaadatok, titkosítás, vízjelek és PDF/A vezérlők.
Képernyőkép rögzítése PNG-, JPEG- vagy webp-fájl rögzítése HTML-ből, URL-címből vagy sablonból. Teljes vagy kivágott, nézetport és eszköz-képpont arány vezérlővel.

Az e-számlák pdf formátumba konvertálással készülnek: töltse ki az E-számla mezőket (standard, profil és strukturált invoice objektum), a PolyDoc pedig beágyazza a ZUGFeRD/Factur-X számlát a visszaadott PDF-fájlba. example-flows/ A használatra kész törzset az összekötő-adattár mappájában tekintheti meg.

Source

Minden művelet egyetlen forrást vesz igénybe, amely az alábbiak egyike:

  • URL-cím, pl. https://example.com
  • beágyazott HTML-sztring
  • egy mentett sablonhivatkozás, [template:TEMPLATE_ID]opcionálisan a Liquid renderer sablonadataival

Kézbesítés

Alapértelmezés szerint a fájl bináris tartalomként lesz visszaadva, készen áll a Fájl létrehozása (OneDrive, SharePoint, Blob) vagy egy e-mail-mellékletre. A speciális lehetőségek között két alternatív kézbesítési mód érhető el:

  • Felhőalapú tárolás: előre hozzárendelt PUT URL-cím megadása; A PolyDoc feltölti a fájlt, és a művelet visszaadja a tárolt URL-címet tartalmazó JSON-t.
  • Webhook: A PolyDoc kézbesíti a fájlt a webhooknak, és a művelet JSON-nyugtát ad vissza (HTTP 202 aszinkron állapotban).

Ha bármelyik kézbesítési módot használja, a válasz nem bináris fájl, hanem JSON.

Tesztkörnyezet mód

Minden művelet speciális Tesztkörnyezet módú bemenettel rendelkezik . Állítsa be úgy, hogy true vízjeles kimenetet hozzon létre egy alacsonyabb sebességkorláttal rendelkező külön kvótából, ami a folyamat létrehozása és tesztelése során hasznos. Hagyja meg false az éles dokumentumokban.

Ismert problémák és korlátozások

  • Az egyes műveletek válasza bináris fájlként van deklarálva. Ha a cloud storage vagy a Webhook kézbesítése konfigurálva van, a művelet a JSON-t adja vissza fájl helyett.
  • A Külső CDN-ről JavaScriptet betöltő lapok jelentősen lelassíthatják a konvertert. Beágyazott HTML esetén előnyben részesítse az önálló korrektúrát (beágyazott CSS, adat-URI-képek).
  • Az e-számlák az EN 16931-et követik. Legalább adja meg a határidőt vagy a fizetési feltételeket (BR-CO-25 szabály), az eladó adóazonosítóját, amikor egy sor áfakategóriát Shasznál, és konzisztens összegeket (nettó + adó = bruttó). Ha az Ellenőrzés engedélyezve van, egy sikertelen érvényesítést eredményező számla hibát ad vissza.

Üzembe helyezési utasítások

Ez az összekötő szabványos egyéni Power Platform-összekötőként (apiDefinition.swagger.json + + apiProperties.jsonicon.png) van definiálva. Üzembe helyezése a Power Platform-összekötők parancssori felületével:

# 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>

Közvetlenül a Power Automate készítői portálról is importálhat apiDefinition.swagger.json (Egyéni adatösszekötők >> Új egyéni összekötő > OpenAPI-fájl importálása).

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:
Default A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Leírás Szükséges
PolyDoc API-kulcs securestring A PolyDoc API-kulcs. Hozzon létre egyet dashboard.polydoc.tech API-kulcsok alatt. Csak a kulcsot illessze be; az összekötő hozzáadja Önnek a "Bearer" előtagot. True

Műveletek

Konvertálás PDF-fájllá

HTML- vagy URL-cím vagy mentett sablon megjelenítése PDF-fájlba. Töltse ki az E-számla mezőket a ZUGFeRD/Factur-X hibrid számla egyszerű PDF helyett való beágyazásához. Bináris tartalomként adja vissza a fájlt.
Képernyőkép rögzítése

HTML- vagy URL-címeket vagy mentett sablonokat jeleníthet meg, és PNG-, JPEG- vagy WebP-képernyőképeket rögzíthet. Bináris tartalomként adja vissza a képet.

Konvertálás PDF-fájllá

Műveletazonosító:
ConvertToPdf

HTML- vagy URL-cím vagy mentett sablon megjelenítése PDF-fájlba. Töltse ki az E-számla mezőket a ZUGFeRD/Factur-X hibrid számla egyszerű PDF helyett való beágyazásához. Bináris tartalomként adja vissza a fájlt.

Paraméterek

Név Kulcs Kötelező Típus Description
Tesztkörnyezet mód
 X-Sandbox string

Futtassa a konvertálást tesztkörnyezet módban. A tesztkörnyezet kimenete vízjellel van jelölve, és egy alacsonyabb sebességkorláttal rendelkező külön kvótából származik. Használjon hamis értéket az éles dokumentumokhoz.
Source
 source True string

URL-cím (https://...), beágyazott HTML-sztring vagy mentett sablonhivatkozás [template:TEMPLATE_ID].
Fájlnév
 filename string

Kimeneti fájlnév, például invoice.pdf.
Sablonadatok
 templateData object

A Liquid-sablon renderelőjének átadott kulcs-/értékadatok, ha a forrás egy [template:ID] hivatkozás.
Címke
 tag string

Címke naplózáshoz és elemzéshez (max. 30 karakter).
Időtúllépés (ms)
 timeout integer

Konvertálási időtúllépés ezredmásodpercben (max. 600000).
Papírformátum
 format string

Papírformátum. Alapértelmezés szerint A4.
Táj
 landscape boolean

Fekvő tájolás használata.
Nyomtatási háttér
 printBackground boolean

Háttérképek és színek nyomtatása.
Scale
 scale number

Renderelési skálázás 0,1 és 2 között.
Oldaltartományok
 pageRanges string

A belefoglalandó oldalak, pl. "1-5, 8". Az üres érték az összes oldalt jelenti.
Vázlat (könyvjelzők)
 outline boolean

PDF-könyvjelzők létrehozása HTML-címsorokból.
Címkézett (akadálymentes)
 tagged boolean

Címkézett (akadálymentes) PDF létrehozása.
A CSS-oldalméret előnyben részesítve
 preferCSSPageSize boolean

@page A CSS-ben papírformátumban deklarált méret tiszteletben tartható.
Háttér kihagyás
 omitBackground boolean

Renderelés áttetsző háttérrel.
Élőfej/élőláb megjelenítése
 displayHeaderFooter boolean

Az élőfej- és élőlábsablonok megjelenítése.
Fejlécsablon
 headerTemplate string

HTML az oldalfejléchez. Megjelenítési élőfejet/élőlábat igényel.
Élőlábsablon
 footerTemplate string

HTML az oldallábhoz. Megjelenítési élőfejet/élőlábat igényel.
Legfelső
 top string
Jobbra
 right string
Alsó
 bottom string
Balra
 left string
Title
 title string
Author
 author string
Tárgy
 subject string
Kulcsszavak
 keywords array of string
Producer
 producer string
Creator
 creator string
Felhasználói jelszó
 userPassword string
Tulajdonos jelszava
 ownerPassword string
Source
 source True string

Vízjel szövege vagy kép URL-címe/ adat URI-ja.
Típus
 type True string
Beállítások
 options object

Betűtípus, átlátszatlanság, forgatás, skálázás, ismétlés és eltolás beállításai.
Level
 level True string
Megfelelőség ellenőrzése
 verify boolean
Megfelelőség ellenőrzése
 verify boolean

Ellenőrzés a veraPDF PDF/UA-1 fájlon; hibaüzenetet ad vissza, ha az ellenőrzés sikertelen.
Standard
 standard True string

Hibrid számlaszabvány.
Profile
 profile True string

Adatrészletességi profil, amely alapján érvényesíthető.
Megfelelőség ellenőrzése
 verify boolean

A PDF/A és az e-számla megfelelőségének ellenőrzése; hibaüzenetet ad vissza, ha az ellenőrzés sikertelen.
Számla száma
 number True string
Kibocsátás dátuma
 issueDate True string

Kiadás dátuma, YYYY-MM-DD.
Fiz. határidő
 dueDate string

Határidő: YYYY-MM-DD. Adja meg ezt vagy fizetési feltételeket (EN 16931 SZABÁLY BR-CO-25).
Pénznem
 currencyCode True string

ISO 4217 pénznemkód, pl. EUR.
Név
 name True string
Cím 1. sora
 line1 True string
Cím 2. sora
 line2 string
City
 city True string
Irányítószám
 postalCode True string
Országkód
 countryCode True string

ISO 3166-1 alpha-2 országkód, pl. DE.
Adóazonosító
 taxId string

Áfaazonosító. Az eladó számára szükséges, ha egy sor az S áfakategóriát használja.
Email
 email string
Telefonszám
 phone string
Leírás
 description True string
Mennyiség
 quantity True number
Egységkód
 unitCode string

UN/ECE egységkód, pl. C62 (darab).
Egységár
 unitPrice True number
Sorösszeg
 lineTotal True number
Áfakulcs (%)
 vatRate number
Áfakategória
 vatCategoryCode string

Áfakategória kódja, pl. S (standard), Z (nulla), E (kivétel).
Kategóriakód
 categoryCode True string
Ráta (%)
 rate True number
Adóköteles összeg
 taxableAmount True number
Adó összege
 taxAmount True number
Fizetési feltételek
 paymentTerms string

Ingyenes szöveges fizetési feltételek. Adja meg ezt vagy a határidőt.
Kód beírása
 typeCode True string

AZ UN/ECE 4461 fizetési mód kódja, pl. 30 (átutalás).
IBAN
 iban string
BIC
 bic string
Fióknév
 accountName string
Kifizetés hivatkozása
 paymentReference string
Teljes nettó
 totalNetAmount True number
Összes adó
 totalTaxAmount True number
Bruttó összeg
 totalGrossAmount True number

Egyenlőnek kell lennie a nettó + adóval.
Megjegyzés:
 note string
Vevői referencia
 buyerReference string

Vevői referenciák / Leitweg-ID a közszektorbeli számlákhoz.
JavaScript letiltása
 disableJavascript boolean
CSS injektálása
 css string

Az oldalba beszúrt extra CSS.
JavaScript injektálása
 javascript string

A JavaScript a rögzítés előtt fut a lapon.
Várakozás a választóra
 waitForSelector string

Várjon, amíg megjelenik ez a CSS-választó.
Várakozás a függvényre
 waitForFunction string

Várja meg, amíg ez a JS-kifejezés igaz értéket ad vissza.
Médiatípus
 mediaType string
Hirdetések letiltása
 blockAds boolean
Felhasználói ügynök
 userAgent string
HTTP-fejlécek
 httpHeaders object

Extra HTTP-fejlécek kulcs/érték párként.
Név
 name True string
Érték
 value True string
URL
 url string
Szakterület
 domain string
Path
 path string
Lejár (korszak)
 expires number
Csak HTTP
 httpOnly boolean
Secure
 secure boolean
Ugyanaz a webhely
 sameSite string
Típus
 type string
Felhasználónév
 username True string
Jelszó
 password True string
Webhook URL-címe
 url True string
Async
 async boolean

Szállítson a háttérben, és azonnal adja vissza a 202-et.
Módszer
 method string
Fejlécek
 headers object

További fejlécek a webhook-kérelemhez.
Időtúllépés (ms)
 timeout number
Újrapróbálás
 retries integer
Újrapróbálkozás késleltetése (ms)
 retryDelay number
Előjeles URL-cím
 presignedUrl True string

HTTP PUT előre hozzárendelt URL-cím a társzolgáltatótól.

Válaszok

response
binary

Képernyőkép rögzítése

Műveletazonosító:
CaptureScreenshot

HTML- vagy URL-címeket vagy mentett sablonokat jeleníthet meg, és PNG-, JPEG- vagy WebP-képernyőképeket rögzíthet. Bináris tartalomként adja vissza a képet.

Paraméterek

Név Kulcs Kötelező Típus Description
Tesztkörnyezet mód
 X-Sandbox string

Futtassa a konvertálást tesztkörnyezet módban. A tesztkörnyezet kimenete vízjellel van jelölve, és egy alacsonyabb sebességkorláttal rendelkező külön kvótából származik. Használjon hamis értéket az éles dokumentumokhoz.
Source
 source True string

URL-cím (https://...), beágyazott HTML-sztring vagy mentett sablonhivatkozás [template:TEMPLATE_ID].
Fájlnév
 filename string

Kimeneti fájlnév, például screenshot.png.
Sablonadatok
 templateData object

A Liquid-sablon renderelőjének átadott kulcs-/értékadatok, ha a forrás egy [template:ID] hivatkozás.
Lemezkép típusa
 type string

Képformátum. A png alapértelmezett értéke.
Teljes oldal
 fullPage boolean

Rögzítse a teljes görgethető lapot.
Quality
 quality integer

Tömörítési minőség 0-100 JPEG/WebP esetén.
Háttér kihagyás
 omitBackground boolean

Rögzítés transzparens háttérrel (PNG/WebP).
Szélesség (px)
 width integer
Magasság (px)
 height integer
Eszköz képpontaránya
 devicePixelRatio number
X
 x number
Y
 y number
Szélesség
 width number
Magasság
 height number
Scale
 scale number
Címke
 tag string

Címke naplózáshoz és elemzéshez (max. 30 karakter).
Időtúllépés (ms)
 timeout integer

Konvertálási időtúllépés ezredmásodpercben (max. 600000).
JavaScript letiltása
 disableJavascript boolean
CSS injektálása
 css string

Az oldalba beszúrt extra CSS.
JavaScript injektálása
 javascript string

A JavaScript a rögzítés előtt fut a lapon.
Várakozás a választóra
 waitForSelector string

Várjon, amíg megjelenik ez a CSS-választó.
Várakozás a függvényre
 waitForFunction string

Várja meg, amíg ez a JS-kifejezés igaz értéket ad vissza.
Médiatípus
 mediaType string
Hirdetések letiltása
 blockAds boolean
Felhasználói ügynök
 userAgent string
HTTP-fejlécek
 httpHeaders object

Extra HTTP-fejlécek kulcs/érték párként.
Név
 name True string
Érték
 value True string
URL
 url string
Szakterület
 domain string
Path
 path string
Lejár (korszak)
 expires number
Csak HTTP
 httpOnly boolean
Secure
 secure boolean
Ugyanaz a webhely
 sameSite string
Típus
 type string
Felhasználónév
 username True string
Jelszó
 password True string
Webhook URL-címe
 url True string
Async
 async boolean

Szállítson a háttérben, és azonnal adja vissza a 202-et.
Módszer
 method string
Fejlécek
 headers object

További fejlécek a webhook-kérelemhez.
Időtúllépés (ms)
 timeout number
Újrapróbálás
 retries integer
Újrapróbálkozás késleltetése (ms)
 retryDelay number
Előjeles URL-cím
 presignedUrl True string

HTTP PUT előre hozzárendelt URL-cím a társzolgáltatótól.

Válaszok

response
binary

Definíciók

bináris

Ez a bináris alapszintű adattípus.