PolyDoc (Unabhängige Publisher) (Vorschau)
Konvertieren Sie HTML oder eine URL in pixelgenaue PDF-Dateien und Screenshots, und generieren Sie EU-kompatible Hybrid-E-Rechnungen (ZUGFeRD / Factur-X). PolyDoc rendert mit einem echten Browsermodul, sodass das, was Sie auf der Seite sehen, das ist, was Sie im Dokument erhalten.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | PolyDoc |
| URL | https://polydoc.tech |
| hello@polydoc.tech |
| Connectormetadaten | |
|---|---|
| Herausgeber | blau-d3v |
| Website | https://polydoc.tech |
| Datenschutzrichtlinie | https://polydoc.tech/legal/privacy-policy/ |
| Kategorien | Inhalt und Dateien |
PolyDoc
PolyDoc wandelt HTML oder eine URL in pixelgenaue PDFs und Screenshots um und generiert EU-kompatible Hybrid-E-Rechnungen (ZUGFeRD / Factur-X). Konvertierungen werden in einem echten Browsermodul gerendert, sodass sie auf der Seite sehen, was Sie im Dokument erhalten.
Herausgeber
PolyDoc
Voraussetzungen
Sie benötigen ein PolyDoc-Konto und einen API-Schlüssel. Die kostenlose Stufe reicht aus, um den Verbinder auszuwerten. Benutzerdefinierte Connectors sind ein Premium-Power Automate-Feature, sodass Flüsse, die diesen Connector verwenden, einen Power Automate Premium-Plan (pro Benutzer oder pro Fluss) benötigen, der mit der integrierten HTTP-Aktion identisch ist.
Abrufen von Anmeldeinformationen
- Melden Sie sich bei dashboard.polydoc.tech an.
- Öffnen Sie API-Schlüssel , und erstellen Sie einen Schlüssel.
- Wenn Sie die Verbindung erstellen, fügen Sie den Schlüssel in den PolyDoc-API-Schlüssel ein. Fügen Sie nur die Taste ein; der Verbinder fügt das
BearerPräfix für Sie hinzu.
Unterstützte Operationen
| Betrieb | Was es bewirkt |
|---|---|
| In PDF konvertieren | Rendern von HTML, einer URL oder einer gespeicherten Vorlage in einer PDF-Datei. Steuerelemente für Seitenformat, Ränder, Skalierung, Kopf- und Fußzeilen, Lesezeichen, barrierefreie (markierte) PDF-Dateien, Metadaten, Verschlüsselung, Wasserzeichen und PDF/A. |
| Screenshot aufzeichnen | Erfassen Sie eine PNG-, JPEG- oder WebP-Datei mit HTML, einer URL oder einer Vorlage. Ganzseitiges oder beschnittenes Steuerelement mit Viewport- und Gerätepixelverhältnis-Steuerelement. |
E-Rechnungen werden mit "In PDF konvertieren" erstellt: Füllen Sie die E-Invoice-Felder (Standard, Profil und strukturiertes invoice Objekt) aus, und PolyDoc bettet eine ZUGFeRD /Factur-X Rechnung in die zurückgegebene PDF ein.
example-flows/ Einen einsatzbereiten Text finden Sie im Ordner im Connector-Repository.
Source
Jeder Vorgang akzeptiert eine einzelne Quelle , von der eine der folgenden Ist-Vorgänge ist:
- eine URL, z. B.
https://example.com - eine Inline-HTML-Zeichenfolge
- ein gespeicherter Vorlagenverweis,
[template:TEMPLATE_ID]optional mit Vorlagendaten für den Liquid-Renderer
Lieferung
Standardmäßig wird die Datei als binärer Inhalt zurückgegeben, der zum Erstellen einer Datei (OneDrive, SharePoint, Blob) oder einer E-Mail-Anlage bereit ist. Zwei alternative Übermittlungsmodi stehen unter erweiterten Optionen zur Verfügung:
- Cloudspeicher: Bereitstellen einer vorsignierten PUT-URL; PolyDoc lädt die Datei hoch, und die Aktion gibt JSON zurück, die die gespeicherte URL enthält.
- Webhook: PolyDoc liefert die Datei an Ihren Webhook und die Aktion gibt eine JSON-Bestätigung (HTTP 202 bei asynchroner Asynchrone) zurück.
Wenn entweder der Übermittlungsmodus verwendet wird, ist die Antwort JSON anstelle einer Binärdatei.
Sandkastenmodus
Jeder Vorgang verfügt über eine erweiterte Sandkastenmoduseingabe . Legen Sie ihn fest, true um eine wasserzeichenierte Ausgabe aus einem separaten Kontingent mit einem niedrigeren Satzlimit zu generieren, was beim Erstellen und Testen eines Flusses nützlich ist. Belassen Sie sie false für Produktionsdokumente.
Bekannte Probleme und Einschränkungen
- Die Antwort jeder Aktion wird als Binärdatei deklariert. Wenn die Cloudspeicher- oder Webhook-Übermittlung konfiguriert ist, gibt die Aktion JSON anstelle einer Datei zurück.
- Seiten, die JavaScript aus einem externen CDN laden, können den Konverter erheblich verlangsamen. Bevorzugen Sie für Inline-HTML eigenständiges Markup (Inline-CSS, Daten-URI-Bilder).
- E-Rechnungen folgen EN 16931. Geben Sie mindestens ein Fälligkeitsdatum oder zahlungsbedingungen (Regel BR-CO-25), die Verkäufersteuer-ID an, wenn eine Zeile die Mehrwertsteuerkategorie
Sverwendet, und konsistente Summen (Netto + Steuern = Brutto). Wenn "Überprüfen" eine Rechnung aktiviert hat, bei der die Überprüfung fehlschlägt, wird ein Fehler zurückgegeben.
Bereitstellungsinformationen
Dieser Connector wird als standardmäßiger benutzerdefinierter Power Platform-Connector (apiDefinition.swagger.json + + apiProperties.jsonicon.png) definiert. Stellen Sie sie mit der Power Platform Connectors CLI bereit:
# 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>
Sie können auch direkt aus dem Power Automate Maker-Portal importieren apiDefinition.swagger.json (Data > Custom connectors > New custom connector > Import an OpenAPI file).
Eine Verbindung wird erstellt
Der Connector unterstützt die folgenden Authentifizierungstypen:
| Vorgabe | Parameter zum Erstellen einer Verbindung. | Alle Regionen | Nicht teilbar |
Default
Anwendbar: Alle Regionen
Parameter zum Erstellen einer Verbindung.
Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.
| Name | Typ | Beschreibung | Required |
|---|---|---|---|
| PolyDoc-API-Schlüssel | Securestring | Ihr PolyDoc-API-Schlüssel. Erstellen Sie eins unter dashboard.polydoc.tech unter API-Schlüsseln. Fügen Sie nur die Taste ein; der Verbinder fügt das Präfix "Bearer" für Sie hinzu. | True |
Aktionen
| In PDF konvertieren |
Rendern von HTML, einer URL oder einer gespeicherten Vorlage in einer PDF-Datei. Füllen Sie die E-Invoice-Felder auf, um eine ZUGFeRD/Factur-X Hybridrechnung anstelle einer einfachen PDF einzubetten. Gibt die Datei als binären Inhalt zurück. |
| Screenshot aufzeichnen |
Rendern Sie HTML, eine URL oder eine gespeicherte Vorlage, und erfassen Sie einen PNG-, JPEG- oder WebP-Screenshot. Gibt das Bild als binären Inhalt zurück. |
In PDF konvertieren
Rendern von HTML, einer URL oder einer gespeicherten Vorlage in einer PDF-Datei. Füllen Sie die E-Invoice-Felder auf, um eine ZUGFeRD/Factur-X Hybridrechnung anstelle einer einfachen PDF einzubetten. Gibt die Datei als binären Inhalt zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Sandkastenmodus
|
X-Sandbox | string |
Führen Sie die Konvertierung im Sandkastenmodus aus. Die Sandkastenausgabe ist wasserzeicheniert und zeichnet aus einem separaten Kontingent mit einem niedrigeren Satzlimit. Verwenden Sie "false" für Produktionsdokumente. |
|
|
Source
|
source | True | string |
Eine URL (https://...), eine Inline-HTML-Zeichenfolge oder ein gespeicherter Vorlagenverweis im Formular [template:TEMPLATE_ID]. |
|
Dateiname
|
filename | string |
Ausgabedateiname, z. B. invoice.pdf. |
|
|
Vorlagendaten
|
templateData | object |
Schlüssel-/Wertdaten, die an den Liquid-Vorlagenrenderer übergeben werden, wenn Source ein [template:ID]-Verweis ist. |
|
|
Tag
|
tag | string |
Bezeichnung für Protokollierung und Analyse (max. 30 Zeichen). |
|
|
Timeout (ms)
|
timeout | integer |
Konvertierungstimeout in Millisekunden (max. 600000). |
|
|
Papierformat
|
format | string |
Papierformat. Der Standardwert ist A4. |
|
|
Landschaft
|
landscape | boolean |
Verwenden Sie die Querformatausrichtung. |
|
|
Hintergrund drucken
|
printBackground | boolean |
Drucken von Hintergrundgrafiken und -farben. |
|
|
Scale
|
scale | number |
Rendermaßstab zwischen 0,1 und 2. |
|
|
Seitenbereiche
|
pageRanges | string |
Einzuschließende Seiten, z. B. "1-5, 8". Leer bedeutet alle Seiten. |
|
|
Gliederung (Textmarken)
|
outline | boolean |
Generieren Sie PDF-Lesezeichen aus HTML-Überschriften. |
|
|
Markiert (barrierefrei)
|
tagged | boolean |
Erstellen Sie eine markierte (barrierefreie) PDF-Datei. |
|
|
Css-Seitengröße bevorzugen
|
preferCSSPageSize | boolean |
Berücksichtigen Sie die größe, die @page im CSS über das Papierformat deklariert ist. |
|
|
Hintergrund weglassen
|
omitBackground | boolean |
Rendern mit transparentem Hintergrund. |
|
|
Kopf-/Fußzeile anzeigen
|
displayHeaderFooter | boolean |
Rendern Sie die Kopf- und Fußzeilenvorlagen. |
|
|
Kopfzeilenvorlage
|
headerTemplate | string |
HTML für den Seitenkopf. Erfordert Display-Kopf-/Fußzeile. |
|
|
Fußzeilenvorlage
|
footerTemplate | string |
HTML für die Seitenfußzeile. Erfordert Display-Kopf-/Fußzeile. |
|
|
Nach oben
|
top | string | ||
|
Rechts
|
right | string | ||
|
Unten
|
bottom | string | ||
|
Links
|
left | string | ||
|
Titel
|
title | string | ||
|
Autor
|
author | string | ||
|
Betreff
|
subject | string | ||
|
Schlüsselwörter
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Schöpfer
|
creator | string | ||
|
Benutzerkennwort
|
userPassword | string | ||
|
Besitzerkennwort
|
ownerPassword | string | ||
|
Source
|
source | True | string |
Wasserzeichentext oder bild-URL/Daten-URI. |
|
Typ
|
type | True | string | |
|
Options
|
options | object |
Schriftart, Deckkraft, Drehung, Skalierung, Wiederholungs- und Offsetoptionen. |
|
|
Grad
|
level | True | string | |
|
Überprüfen der Compliance
|
verify | boolean | ||
|
Überprüfen der Compliance
|
verify | boolean |
Überprüfen anhand von veraPDF PDF/UA-1; gibt einen Fehler zurück, wenn die Überprüfung fehlschlägt. |
|
|
Standard
|
standard | True | string |
Hybridrechnungsstandard. |
|
Profile
|
profile | True | string |
Datengranularitätsprofil zur Überprüfung. |
|
Überprüfen der Compliance
|
verify | boolean |
Überprüfen sie die Compliance von PDF/A und E-Rechnung; gibt einen Fehler zurück, wenn die Überprüfung fehlschlägt. |
|
|
Rechnungsnummer
|
number | True | string | |
|
Ausgabedatum
|
issueDate | True | string |
Ausgabedatum, JJJJ-MM-TT. |
|
Fällig am
|
dueDate | string |
Fälligkeitsdatum, JJJJ-MM-TT. Geben Sie diese oder Zahlungsbedingungen an (EN 16931 regel BR-CO-25). |
|
|
Währung
|
currencyCode | True | string |
ISO 4217-Währungscode, z. B. EUR. |
|
Name
|
name | True | string | |
|
Adresszeile 1
|
line1 | True | string | |
|
Adresszeile 2
|
line2 | string | ||
|
Stadt
|
city | True | string | |
|
Postleitzahl
|
postalCode | True | string | |
|
Landescode
|
countryCode | True | string |
ISO 3166-1 Alpha-2 Ländercode, z. B. DE. |
|
Steuer-ID
|
taxId | string |
Umsatzsteuer-ID. Erforderlich für den Verkäufer, wenn eine Zeile die MwSt.-Kategorie S verwendet. |
|
|
E-Mail
|
string | |||
|
Phone
|
phone | string | ||
|
Beschreibung
|
description | True | string | |
|
Menge
|
quantity | True | number | |
|
Einheitencode
|
unitCode | string |
UN/ECE Unit Code, z. B. C62 (Stück). |
|
|
Einzelpreis
|
unitPrice | True | number | |
|
Zeilensumme
|
lineTotal | True | number | |
|
Mehrwertsteuersatz (%)
|
vatRate | number | ||
|
MwSt.-Kategorie
|
vatCategoryCode | string |
MwSt.-Kategoriecode, z. B. S (Standard), Z (null), E (ausgenommen). |
|
|
Kategoriecode
|
categoryCode | True | string | |
|
Rate (%)
|
rate | True | number | |
|
Steuerpflichtige Höhe
|
taxableAmount | True | number | |
|
Steuerbetrag
|
taxAmount | True | number | |
|
Zahlungsbedingungen
|
paymentTerms | string |
Freitextzahlungsbedingungen. Geben Sie dieses oder Fälligkeitsdatum an. |
|
|
Typcode
|
typeCode | True | string |
UN/ECE 4461 Zahlung bedeutet Code, z. B. 30 (Überweisung). |
|
IBAN
|
iban | string | ||
|
BIC
|
bic | string | ||
|
Kontoname
|
accountName | string | ||
|
Zahlungsreferenz
|
paymentReference | string | ||
|
Gesamtergebnis
|
totalNetAmount | True | number | |
|
Steuern gesamt
|
totalTaxAmount | True | number | |
|
Bruttosumme
|
totalGrossAmount | True | number |
Muss gleich netto + Steuern sein. |
|
Note
|
note | string | ||
|
Käuferreferenz
|
buyerReference | string |
Käuferreferenz / Leitweg-ID für Rechnungen des öffentlichen Sektors. |
|
|
JavaScript deaktivieren
|
disableJavascript | boolean | ||
|
Einfügen von CSS
|
css | string |
Zusätzliche CSS in die Seite eingefügt. |
|
|
Einfügen von JavaScript
|
javascript | string |
JavaScript, das vor der Erfassung auf der Seite ausgeführt wird. |
|
|
Auf Auswahl warten
|
waitForSelector | string |
Warten Sie, bis diese CSS-Auswahl angezeigt wird. |
|
|
Auf Funktion warten
|
waitForFunction | string |
Warten Sie, bis dieser JS-Ausdruck "true" zurückgibt. |
|
|
Medientyp
|
mediaType | string | ||
|
Blockieren von Anzeigen
|
blockAds | boolean | ||
|
Benutzer-Agent
|
userAgent | string | ||
|
HTTP-Kopfzeilen
|
httpHeaders | object |
Zusätzliche HTTP-Header als Schlüssel-Wert-Paare. |
|
|
Name
|
name | True | string | |
|
Wert
|
value | True | string | |
|
URL
|
url | string | ||
|
Domäne
|
domain | string | ||
|
Pfad
|
path | string | ||
|
Läuft ab (Epoche)
|
expires | number | ||
|
Nur HTTP
|
httpOnly | boolean | ||
|
Sicher
|
secure | boolean | ||
|
SameSite (SameSite)
|
sameSite | string | ||
|
Typ
|
type | string | ||
|
Nutzername
|
username | True | string | |
|
Password
|
password | True | string | |
|
Webhook-URL
|
url | True | string | |
|
Async
|
async | boolean |
Liefern Sie den Hintergrund, und geben Sie 202 sofort zurück. |
|
|
Method
|
method | string | ||
|
Headers
|
headers | object |
Zusätzliche Header für die Webhook-Anforderung. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Erneute Versuche
|
retries | integer | ||
|
Wiederholungsverzögerung (ms)
|
retryDelay | number | ||
|
Vorsignierte URL
|
presignedUrl | True | string |
HTTP PUT vorsignierte URL von Ihrem Speicheranbieter. |
Gibt zurück
- response
- binary
Screenshot aufzeichnen
Rendern Sie HTML, eine URL oder eine gespeicherte Vorlage, und erfassen Sie einen PNG-, JPEG- oder WebP-Screenshot. Gibt das Bild als binären Inhalt zurück.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Sandkastenmodus
|
X-Sandbox | string |
Führen Sie die Konvertierung im Sandkastenmodus aus. Die Sandkastenausgabe ist wasserzeicheniert und zeichnet aus einem separaten Kontingent mit einem niedrigeren Satzlimit. Verwenden Sie "false" für Produktionsdokumente. |
|
|
Source
|
source | True | string |
Eine URL (https://...), eine Inline-HTML-Zeichenfolge oder ein gespeicherter Vorlagenverweis im Formular [template:TEMPLATE_ID]. |
|
Dateiname
|
filename | string |
Ausgabedateiname, z. B. screenshot.png. |
|
|
Vorlagendaten
|
templateData | object |
Schlüssel-/Wertdaten, die an den Liquid-Vorlagenrenderer übergeben werden, wenn Source ein [template:ID]-Verweis ist. |
|
|
Bildtyp
|
type | string |
Bildformat. Standardmäßig wird png verwendet. |
|
|
Ganzseitige Seite
|
fullPage | boolean |
Erfassen Sie die gesamte bildlauffähige Seite. |
|
|
Quality
|
quality | integer |
Komprimierungsqualität 0-100 für JPEG/WebP. |
|
|
Hintergrund weglassen
|
omitBackground | boolean |
Aufnahme mit transparentem Hintergrund (PNG/WebP). |
|
|
Breite (px)
|
width | integer | ||
|
Höhe (px)
|
height | integer | ||
|
Gerätepixelverhältnis
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
J
|
y | number | ||
|
Breite
|
width | number | ||
|
Höhe
|
height | number | ||
|
Scale
|
scale | number | ||
|
Tag
|
tag | string |
Bezeichnung für Protokollierung und Analyse (max. 30 Zeichen). |
|
|
Timeout (ms)
|
timeout | integer |
Konvertierungstimeout in Millisekunden (max. 600000). |
|
|
JavaScript deaktivieren
|
disableJavascript | boolean | ||
|
Einfügen von CSS
|
css | string |
Zusätzliche CSS in die Seite eingefügt. |
|
|
Einfügen von JavaScript
|
javascript | string |
JavaScript, das vor der Erfassung auf der Seite ausgeführt wird. |
|
|
Auf Auswahl warten
|
waitForSelector | string |
Warten Sie, bis diese CSS-Auswahl angezeigt wird. |
|
|
Auf Funktion warten
|
waitForFunction | string |
Warten Sie, bis dieser JS-Ausdruck "true" zurückgibt. |
|
|
Medientyp
|
mediaType | string | ||
|
Blockieren von Anzeigen
|
blockAds | boolean | ||
|
Benutzer-Agent
|
userAgent | string | ||
|
HTTP-Kopfzeilen
|
httpHeaders | object |
Zusätzliche HTTP-Header als Schlüssel-Wert-Paare. |
|
|
Name
|
name | True | string | |
|
Wert
|
value | True | string | |
|
URL
|
url | string | ||
|
Domäne
|
domain | string | ||
|
Pfad
|
path | string | ||
|
Läuft ab (Epoche)
|
expires | number | ||
|
Nur HTTP
|
httpOnly | boolean | ||
|
Sicher
|
secure | boolean | ||
|
SameSite (SameSite)
|
sameSite | string | ||
|
Typ
|
type | string | ||
|
Nutzername
|
username | True | string | |
|
Password
|
password | True | string | |
|
Webhook-URL
|
url | True | string | |
|
Async
|
async | boolean |
Liefern Sie den Hintergrund, und geben Sie 202 sofort zurück. |
|
|
Method
|
method | string | ||
|
Headers
|
headers | object |
Zusätzliche Header für die Webhook-Anforderung. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Erneute Versuche
|
retries | integer | ||
|
Wiederholungsverzögerung (ms)
|
retryDelay | number | ||
|
Vorsignierte URL
|
presignedUrl | True | string |
HTTP PUT vorsignierte URL von Ihrem Speicheranbieter. |
Gibt zurück
- response
- binary
Definitionen
binary
Dies ist der grundlegende Datentyp "binary".