PolyDoc (Onafhankelijke Publisher) (preview)
Converteer HTML of een URL naar pixel-perfecte PDF-bestanden en schermopnamen en genereer hybride e-facturen (ZUGFeRD/Factur-X). PolyDoc wordt weergegeven met een echte browserengine, dus wat u op de pagina ziet, is wat u in het document krijgt.
Deze connector is beschikbaar in de volgende producten en regio's:
| Service | Class | Regio's |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logische apps | Standard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Azure Government-regio's - Azure China-regio's - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC) - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Naam | PolyDoc |
| URL | https://polydoc.tech |
| E-mailadres | hello@polydoc.tech |
| Connectormetagegevens | |
|---|---|
| Uitgever | blue-d3v |
| Website | https://polydoc.tech |
| Privacybeleid | https://polydoc.tech/legal/privacy-policy/ |
| Categorieën | Inhoud en bestanden |
PolyDoc
PolyDoc verandert HTML of een URL in pixel-perfecte PDF-bestanden en schermopnamen en genereert eu-compatibele hybride e-invoices (ZUGFeRD/Factur-X). Conversies worden weergegeven in een echte browserengine, dus wat u op de pagina ziet, is wat u in het document krijgt.
Uitgever
PolyDoc
Prerequisites
U hebt een PolyDoc-account en een API-sleutel nodig. De gratis laag is voldoende om de connector te evalueren. Aangepaste connectors zijn een Premium-Power Automate-functie, zodat stromen die gebruikmaken van deze connector een Power Automate Premium-abonnement (per gebruiker of per stroom) nodig hebben, hetzelfde als de ingebouwde HTTP-actie.
Referenties verkrijgen
- Meld u aan bij dashboard.polydoc.tech.
- Open API-sleutels en maak een sleutel.
- Wanneer u de verbinding maakt, plakt u de sleutel in de PolyDoc-API-sleutel. Alleen de sleutel plakken; de verbindingslijn voegt het
Bearervoorvoegsel voor u toe.
Ondersteunde bewerkingen
| Operation | Wat het doet |
|---|---|
| Converteren naar PDF | HTML, een URL of een opgeslagen sjabloon weergeven in een PDF. Besturingselementen voor pagina-indeling, marges, schaal, kop- en voetteksten, bladwijzers, toegankelijke (gelabelde) PDF-bestanden, metagegevens, versleuteling, watermerken en PDF/A. |
| Schermopname vastleggen | Leg een PNG-, JPEG- of WebP-code van HTML, een URL of een sjabloon vast. Volledige pagina of geknipt, met viewport en apparaat-pixelverhouding. |
E-facturen worden geproduceerd met Converteren naar PDF: vul de velden E-factuur (standaard, profiel en het gestructureerde invoice object) in en PolyDoc sluit een ZUGFeRD/Factur-X factuur in de geretourneerde PDF in. Zie de example-flows/ map in de connectoropslagplaats voor een kant-en-klare hoofdtekst.
bron
Elke bewerking maakt gebruik van één bron die een van de volgende is:
- een URL, bijvoorbeeld
https://example.com - een inline HTML-tekenreeks
- een opgeslagen sjabloonreferentie,
[template:TEMPLATE_ID]eventueel met sjabloongegevens voor de Liquid-renderer
Levering
Standaard wordt het bestand geretourneerd als binaire inhoud, klaar om te worden neergezet in Bestand maken (OneDrive, SharePoint, Blob) of een e-mailbijlage. Er zijn twee alternatieve leveringsmodi beschikbaar onder geavanceerde opties:
- Cloudopslag: geef een vooraf ondertekende PUT-URL op; PolyDoc uploadt het bestand en de actie retourneert JSON die de opgeslagen URL bevat.
- Webhook: PolyDoc levert het bestand aan uw webhook en de actie retourneert een JSON-bevestiging (HTTP 202 wanneer asynchroon).
Wanneer een van beide bezorgingsmodus wordt gebruikt, is het antwoord JSON in plaats van een binair bestand.
Sandbox-modus
Elke bewerking heeft een geavanceerde invoer in de sandboxmodus . Stel deze in op true het genereren van uitvoer met watermerken van een afzonderlijk quotum met een lagere frequentielimiet, wat handig is bij het bouwen en testen van een stroom. Laat deze staan false voor productiedocumenten.
Bekende problemen en beperkingen
- Het antwoord van elke actie wordt gedeclareerd als een binair bestand. Wanneer cloudopslag of webhooklevering is geconfigureerd, retourneert de actie JSON in plaats van een bestand.
- Pagina's die JavaScript van een extern CDN laden, kunnen het conversieprogramma aanzienlijk vertragen. Voor inline-HTML geeft u de voorkeur aan zelfstandige markeringen (inline CSS, gegevens-URI-afbeeldingen).
- E-facturen volgen EN 16931. Geef minimaal een vervaldatum of betalingsvoorwaarden op (regel BR-CO-25), het btw-nummer van de verkoper wanneer een regel btw-categorie
Sgebruikt en consistente totalen (netto + belasting = bruto). Als Controleren is ingeschakeld, wordt er een fout geretourneerd wanneer de validatie mislukt.
Implementatie-instructies
Deze connector wordt gedefinieerd als een standaard aangepaste Power Platform-connector (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Implementeer deze met de CLI van Power Platform-connectors:
# 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>
U kunt ook rechtstreeks importeren vanuit de Power Automate Maker-portal (Gegevens > aangepaste connectors > Nieuwe aangepaste connector > Een OpenAPI-bestand importerenapiDefinition.swagger.json).
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| standaard | Parameters voor het maken van verbinding. | Alle regio's | Niet deelbaar |
Verstek
Van toepassing: Alle regio's
Parameters voor het maken van verbinding.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Type | Beschrijving | Required |
|---|---|---|---|
| PolyDoc-API-sleutel | beveiligde string | Uw PolyDoc API-sleutel. Maak er een op dashboard.polydoc.tech onder API-sleutels. Alleen de sleutel plakken; de verbindingslijn voegt het voorvoegsel 'Bearer' voor u toe. | True |
Acties
| Converteren naar PDF |
HTML, een URL of een opgeslagen sjabloon weergeven in een PDF. Vul de E-factuurvelden in om een ZUGFeRD/Factur-X hybride factuur in te sluiten in plaats van een gewone PDF. Retourneert het bestand als binaire inhoud. |
| Schermopname vastleggen |
Html, een URL of een opgeslagen sjabloon weergeven en een PNG-, JPEG- of WebP-schermopname vastleggen. Retourneert de afbeelding als binaire inhoud. |
Converteren naar PDF
HTML, een URL of een opgeslagen sjabloon weergeven in een PDF. Vul de E-factuurvelden in om een ZUGFeRD/Factur-X hybride factuur in te sluiten in plaats van een gewone PDF. Retourneert het bestand als binaire inhoud.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Sandbox-modus
|
X-Sandbox | string |
Voer de conversie uit in de sandboxmodus. Sandbox-uitvoer wordt watermerkt en trekt uit een afzonderlijk quotum met een lagere frequentielimiet. Gebruik false voor productiedocumenten. |
|
|
bron
|
source | True | string |
Een URL (https://...), een inline HTML-tekenreeks of een opgeslagen sjabloonreferentie in het formulier [sjabloon:TEMPLATE_ID]. |
|
Bestandsnaam
|
filename | string |
Bestandsnaam van uitvoer, bijvoorbeeld invoice.pdf. |
|
|
Sjabloongegevens
|
templateData | object |
Sleutel-/waardegegevens die worden doorgegeven aan de liquid-sjabloon-renderer wanneer bron een verwijzing [sjabloon:ID] is. |
|
|
Tag
|
tag | string |
Label voor logboekregistratie en analyse (maximaal 30 tekens). |
|
|
Time-out (ms)
|
timeout | integer |
Time-out voor conversie in milliseconden (max. 600000). |
|
|
Papierformaat
|
format | string |
Papierformaat. De standaardwaarde is A4. |
|
|
Landschap
|
landscape | boolean |
Gebruik de afdrukstand Liggend. |
|
|
Achtergrond afdrukken
|
printBackground | boolean |
Achtergrondafbeeldingen en kleuren afdrukken. |
|
|
Scale
|
scale | number |
Renderschaal, tussen 0,1 en 2. |
|
|
Paginabereiken
|
pageRanges | string |
Pagina's die moeten worden opgenomen, bijvoorbeeld '1-5, 8'. Leeg betekent dat alle pagina's. |
|
|
Overzicht (bladwijzers)
|
outline | boolean |
PDF-bladwijzers genereren op basis van HTML-koppen. |
|
|
Gelabeld (toegankelijk)
|
tagged | boolean |
Een gelabeld (toegankelijk) PDF-bestand maken. |
|
|
Voorkeur geven aan CSS-paginaformaat
|
preferCSSPageSize | boolean |
Eer de @page grootte die in CSS is gedeclareerd via de paper-indeling. |
|
|
Achtergrond weglaten
|
omitBackground | boolean |
Renderen met een transparante achtergrond. |
|
|
Koptekst/voettekst weergeven
|
displayHeaderFooter | boolean |
Geef de kop- en voettekstsjablonen weer. |
|
|
Koptekstsjabloon
|
headerTemplate | string |
HTML voor de paginakoptekst. Vereist weergavekoptekst/voettekst. |
|
|
Voettekstsjabloon
|
footerTemplate | string |
HTML voor de paginavoettekst. Vereist weergavekoptekst/voettekst. |
|
|
Boven
|
top | string | ||
|
Rechts
|
right | string | ||
|
Onderkant
|
bottom | string | ||
|
Links
|
left | string | ||
|
Titel
|
title | string | ||
|
Author
|
author | string | ||
|
Onderwerp
|
subject | string | ||
|
Zoekwoorden
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Ontwerper
|
creator | string | ||
|
Gebruikerswachtwoord
|
userPassword | string | ||
|
Wachtwoord van eigenaar
|
ownerPassword | string | ||
|
bron
|
source | True | string |
Watermerktekst of een afbeeldings-URL/gegevens-URI. |
|
Type
|
type | True | string | |
|
Opties
|
options | object |
Opties voor lettertype, dekking, draaiing, schaal, herhalen en offset. |
|
|
Level
|
level | True | string | |
|
Naleving controleren
|
verify | boolean | ||
|
Naleving controleren
|
verify | boolean |
Valideren op veraPDF PDF/UA-1; retourneert een fout als de validatie mislukt. |
|
|
Standard
|
standard | True | string |
Standaard hybride factuur. |
|
Profile
|
profile | True | string |
Gegevensgranulariteitsprofiel om mee te valideren. |
|
Naleving controleren
|
verify | boolean |
PDF/A en e-factuurnaleving controleren; retourneert een fout als de validatie mislukt. |
|
|
Factuurnummer
|
number | True | string | |
|
Uitgiftedatum
|
issueDate | True | string |
Uitgiftedatum, JJJJ-MM-DD. |
|
Vervaldatum
|
dueDate | string |
Einddatum, JJJJ-MM-DD. Geef deze of betalingsvoorwaarden op (EN 16931 regel BR-CO-25). |
|
|
Valuta
|
currencyCode | True | string |
ISO 4217-valutacode, bijvoorbeeld EUR. |
|
Naam
|
name | True | string | |
|
Adresregel 1
|
line1 | True | string | |
|
Adresregel 2
|
line2 | string | ||
|
City
|
city | True | string | |
|
Postcode
|
postalCode | True | string | |
|
Landnummer
|
countryCode | True | string |
ISO 3166-1 alfa-2 landcode, bijvoorbeeld DE. |
|
Belastingnummer
|
taxId | string |
BTW-id. Vereist voor de verkoper wanneer een regel btw-categorie S gebruikt. |
|
|
E-mailadres
|
string | |||
|
Telefoon
|
phone | string | ||
|
Beschrijving
|
description | True | string | |
|
Hoeveelheid
|
quantity | True | number | |
|
Eenheidscode
|
unitCode | string |
UN/ECE-eenheidscode, bijvoorbeeld C62 (stuk). |
|
|
Eenheidsprijs
|
unitPrice | True | number | |
|
Regeltotaal
|
lineTotal | True | number | |
|
BTW-tarief (%)
|
vatRate | number | ||
|
BTW-categorie
|
vatCategoryCode | string |
Btw-categoriecode, bijvoorbeeld S (standaard), Z (nul), E (vrijgesteld). |
|
|
Categoriecode
|
categoryCode | True | string | |
|
Rate (%)
|
rate | True | number | |
|
Belastbaar bedrag
|
taxableAmount | True | number | |
|
Belastingbedrag
|
taxAmount | True | number | |
|
Betalingsvoorwaarden
|
paymentTerms | string |
Betalingsvoorwaarden voor gratis tekst. Geef deze of einddatum op. |
|
|
Code typen
|
typeCode | True | string |
UN/ECE 4461 betaling betekent code, bijvoorbeeld 30 (kredietoverdracht). |
|
IBAN
|
iban | string | ||
|
BIC
|
bic | string | ||
|
Accountnaam
|
accountName | string | ||
|
Betalingsreferentie
|
paymentReference | string | ||
|
Totaal netto
|
totalNetAmount | True | number | |
|
Totale belasting
|
totalTaxAmount | True | number | |
|
Totaal bruto
|
totalGrossAmount | True | number |
Moet gelijk zijn aan netto + belasting. |
|
Opmerking
|
note | string | ||
|
Referentie koper
|
buyerReference | string |
Koperverwijzing/Leitweg-ID voor overheidsfacturen. |
|
|
JavaScript uitschakelen
|
disableJavascript | boolean | ||
|
CSS injecteren
|
css | string |
Extra CSS geïnjecteerd in de pagina. |
|
|
JavaScript injecteren
|
javascript | string |
JavaScript uitgevoerd op de pagina voordat deze wordt vastgelegd. |
|
|
Wachten op selector
|
waitForSelector | string |
Wacht tot deze CSS-selector wordt weergegeven. |
|
|
Wachten op functie
|
waitForFunction | string |
Wacht tot deze JS-expressie waar retourneert. |
|
|
Mediatype
|
mediaType | string | ||
|
Advertenties blokkeren
|
blockAds | boolean | ||
|
Gebruikersagent
|
userAgent | string | ||
|
HTTP-kopteksten
|
httpHeaders | object |
Extra HTTP-headers als sleutel-waardeparen. |
|
|
Naam
|
name | True | string | |
|
Waarde
|
value | True | string | |
|
URL
|
url | string | ||
|
Domein
|
domain | string | ||
|
Path
|
path | string | ||
|
Verloopt (epoch)
|
expires | number | ||
|
Alleen HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Dezelfde site
|
sameSite | string | ||
|
Type
|
type | string | ||
|
Gebruikersnaam
|
username | True | string | |
|
Wachtwoord
|
password | True | string | |
|
Webhook-URL
|
url | True | string | |
|
Async
|
async | boolean |
Lever op de achtergrond en retourneer 202 onmiddellijk. |
|
|
Methode
|
method | string | ||
|
Headers
|
headers | object |
Extra headers voor de webhookaanvraag. |
|
|
Time-out (ms)
|
timeout | number | ||
|
Hernieuwde pogingen
|
retries | integer | ||
|
Vertraging voor opnieuw proberen (ms)
|
retryDelay | number | ||
|
Vooraf ondertekende URL
|
presignedUrl | True | string |
HTTP PUT presigned URL van uw opslagprovider. |
Retouren
- response
- binary
Schermopname vastleggen
Html, een URL of een opgeslagen sjabloon weergeven en een PNG-, JPEG- of WebP-schermopname vastleggen. Retourneert de afbeelding als binaire inhoud.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Sandbox-modus
|
X-Sandbox | string |
Voer de conversie uit in de sandboxmodus. Sandbox-uitvoer wordt watermerkt en trekt uit een afzonderlijk quotum met een lagere frequentielimiet. Gebruik false voor productiedocumenten. |
|
|
bron
|
source | True | string |
Een URL (https://...), een inline HTML-tekenreeks of een opgeslagen sjabloonreferentie in het formulier [sjabloon:TEMPLATE_ID]. |
|
Bestandsnaam
|
filename | string |
Bestandsnaam van uitvoer, bijvoorbeeld screenshot.png. |
|
|
Sjabloongegevens
|
templateData | object |
Sleutel-/waardegegevens die worden doorgegeven aan de liquid-sjabloon-renderer wanneer bron een verwijzing [sjabloon:ID] is. |
|
|
Afbeeldingstype
|
type | string |
Afbeeldingsindeling. Standaard ingesteld op PNG. |
|
|
Volledige pagina
|
fullPage | boolean |
Leg de hele schuifbare pagina vast. |
|
|
Kwaliteit
|
quality | integer |
Compressiekwaliteit 0-100 voor JPEG/WebP. |
|
|
Achtergrond weglaten
|
omitBackground | boolean |
Vastleggen met een transparante achtergrond (PNG/WebP). |
|
|
Breedte (px)
|
width | integer | ||
|
Hoogte (px)
|
height | integer | ||
|
Pixelverhouding van apparaat
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
J
|
y | number | ||
|
Breedte
|
width | number | ||
|
Hoogte
|
height | number | ||
|
Scale
|
scale | number | ||
|
Tag
|
tag | string |
Label voor logboekregistratie en analyse (maximaal 30 tekens). |
|
|
Time-out (ms)
|
timeout | integer |
Time-out voor conversie in milliseconden (max. 600000). |
|
|
JavaScript uitschakelen
|
disableJavascript | boolean | ||
|
CSS injecteren
|
css | string |
Extra CSS geïnjecteerd in de pagina. |
|
|
JavaScript injecteren
|
javascript | string |
JavaScript uitgevoerd op de pagina voordat deze wordt vastgelegd. |
|
|
Wachten op selector
|
waitForSelector | string |
Wacht tot deze CSS-selector wordt weergegeven. |
|
|
Wachten op functie
|
waitForFunction | string |
Wacht tot deze JS-expressie waar retourneert. |
|
|
Mediatype
|
mediaType | string | ||
|
Advertenties blokkeren
|
blockAds | boolean | ||
|
Gebruikersagent
|
userAgent | string | ||
|
HTTP-kopteksten
|
httpHeaders | object |
Extra HTTP-headers als sleutel-waardeparen. |
|
|
Naam
|
name | True | string | |
|
Waarde
|
value | True | string | |
|
URL
|
url | string | ||
|
Domein
|
domain | string | ||
|
Path
|
path | string | ||
|
Verloopt (epoch)
|
expires | number | ||
|
Alleen HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Dezelfde site
|
sameSite | string | ||
|
Type
|
type | string | ||
|
Gebruikersnaam
|
username | True | string | |
|
Wachtwoord
|
password | True | string | |
|
Webhook-URL
|
url | True | string | |
|
Async
|
async | boolean |
Lever op de achtergrond en retourneer 202 onmiddellijk. |
|
|
Methode
|
method | string | ||
|
Headers
|
headers | object |
Extra headers voor de webhookaanvraag. |
|
|
Time-out (ms)
|
timeout | number | ||
|
Hernieuwde pogingen
|
retries | integer | ||
|
Vertraging voor opnieuw proberen (ms)
|
retryDelay | number | ||
|
Vooraf ondertekende URL
|
presignedUrl | True | string |
HTTP PUT presigned URL van uw opslagprovider. |
Retouren
- response
- binary
Definities
binary
Dit is het basisgegevenstype 'binair'.