PolyDoc (Publisher indipendente) (anteprima)
Convertire HTML o un URL in PDF e screenshot perfetti per pixel e generare fatture ibride conformi all'UE (ZUGFeRD/Factur-X). PolyDoc esegue il rendering con un motore di browser reale, quindi ciò che viene visualizzato nella pagina è quello che si ottiene nel documento.
Questo connettore è disponibile nei prodotti e nelle aree seguenti:
| Service | Class | Regioni |
|---|---|---|
| Copilot Studio | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| App per la logica | Standard | Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Apps | Di alta qualità | Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Power Automate | Di alta qualità | Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD) |
| Contatto | |
|---|---|
| Nome | PolyDoc |
| URL | https://polydoc.tech |
| hello@polydoc.tech |
| Metadati del connettore | |
|---|---|
| Server di pubblicazione | blu-d3v |
| Sito web | https://polydoc.tech |
| Informativa sulla privacy | https://polydoc.tech/legal/privacy-policy/ |
| Categorie | Contenuto e file |
PolyDoc
PolyDoc trasforma HTML o un URL in PDF e screenshot perfetti in pixel e genera fatture ibride conformi all'UE (ZUGFeRD/Factur-X). Le conversioni vengono visualizzate in un motore di browser reale, quindi ciò che viene visualizzato nella pagina è quello che si ottiene nel documento.
Server di pubblicazione
PolyDoc
Prerequisiti
Sono necessari un account PolyDoc e una chiave API. Il livello gratuito è sufficiente per valutare il connettore. I connettori personalizzati sono una funzionalità premium Power Automate, quindi i flussi che usano questo connettore necessitano di un piano Premium Power Automate (per utente o per flusso), uguale all'azione HTTP predefinita.
Recupero delle credenziali
- Accedere al dashboard.polydoc.tech.
- Aprire chiavi API e creare una chiave.
- Quando si crea la connessione, incollare la chiave nella chiave API PolyDoc. Incollare solo la chiave; il connettore aggiunge automaticamente il
Bearerprefisso.
Operazioni supportate
| Operation | Funzionamento |
|---|---|
| Converti in PDF | Eseguire il rendering di HTML, URL o un modello salvato in un PDF. Controlli per formato di pagina, margini, scala, intestazioni/piè di pagina, segnalibri, pdf accessibili (con tag), metadati, crittografia, filigrane e PDF/A. |
| Screenshot di acquisizione | Acquisire un file PNG, JPEG o WebP di HTML, un URL o un modello. Pagina intera o ritagliata, con viewport e controllo rapporto dispositivo-pixel. |
Le fatture E-invoice vengono prodotte con Converti in PDF: compilare i campi della fattura E (standard, profilo e l'oggetto strutturato invoice ) e PolyDoc incorpora una fattura ZUGFeRD/Factur-X nel PDF restituito. Per un corpo pronto per l'uso, vedere la example-flows/ cartella nel repository del connettore.
Source
Ogni operazione accetta un'unica origine che è una delle seguenti:
- un URL, ad esempio
https://example.com - stringa HTML inline
- un riferimento al modello salvato,
[template:TEMPLATE_ID], facoltativamente con i dati modello per il renderer Liquid
Consegna
Per impostazione predefinita, il file viene restituito come contenuto binario, pronto per l'inserimento in Crea file (OneDrive, SharePoint, BLOB) o in un allegato di posta elettronica. In opzioni avanzate sono disponibili due modalità di recapito alternative:
- Archiviazione cloud: fornire un URL PUT prefirmato; PolyDoc carica il file e l'azione restituisce JSON contenente l'URL archiviato.
- Webhook: PolyDoc recapita il file al webhook e l'azione restituisce un acknowledgement JSON (HTTP 202 quando async).
Quando viene usata una delle modalità di recapito, la risposta è JSON anziché un file binario.
Modalità sandbox
Ogni operazione ha un input in modalità sandbox avanzata. Impostarlo su true per generare un output con filigrana da una quota separata con un limite di velocità inferiore, utile durante la compilazione e il test di un flusso. Lasciare il file false per i documenti di produzione.
Problemi noti e limitazioni
- La risposta di ogni azione viene dichiarata come file binario. Quando è configurato l'archiviazione cloud o il recapito webhook , l'azione restituisce JSON anziché un file.
- Le pagine che caricano JavaScript da una rete CDN esterna possono rallentare significativamente il convertitore. Per HTML inline, preferisce markup autonomo (immagini CSS inline, URI dati).
- Le fatture e-mail seguono EN 16931. Specificare almeno una data di scadenza o le condizioni di pagamento (regola BR-CO-25), l'ID imposta venditore quando una riga usa la categoria
SIVA e totali coerenti (net + tax = gross). Con Verifica abilitata una fattura che non riesce la convalida restituisce un errore.
Istruzioni per la distribuzione
Questo connettore è definito come connettore personalizzato Power Platform standard (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Distribuirlo con l'interfaccia della riga di comando di 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>
È anche possibile importare apiDefinition.swagger.json direttamente dal portale di Power Automate maker (Connettori personalizzati dati >> Nuovo connettore > personalizzato Importare un file OpenAPI).
Creazione di una connessione
Il connettore supporta i tipi di autenticazione seguenti:
| Predefinita | Parametri per la creazione della connessione. | Tutte le aree geografiche | Non condivisibile |
Predefinito
Applicabile: tutte le aree
Parametri per la creazione della connessione.
Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.
| Nome | TIPO | Descrizione | Required |
|---|---|---|---|
| Chiave API PolyDoc | securestring | Chiave API PolyDoc. Crearne uno in dashboard.polydoc.tech in Chiavi API. Incollare solo la chiave; il connettore aggiunge automaticamente il prefisso "Bearer". | True |
Azioni
| Convertire in PDF |
Eseguire il rendering di HTML, URL o un modello salvato in un PDF. Popolare i campi della fattura e-mail per incorporare una fattura ibrida ZUGFeRD/Factur-X anziché un PDF normale. Restituisce il file come contenuto binario. |
| Screenshot di acquisizione |
Eseguire il rendering di html, url o un modello salvato e acquisire uno screenshot PNG, JPEG o WebP. Restituisce l'immagine come contenuto binario. |
Convertire in PDF
Eseguire il rendering di HTML, URL o un modello salvato in un PDF. Popolare i campi della fattura e-mail per incorporare una fattura ibrida ZUGFeRD/Factur-X anziché un PDF normale. Restituisce il file come contenuto binario.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Modalità sandbox
|
X-Sandbox | string |
Eseguire la conversione in modalità sandbox. L'output sandbox è limitato e viene estratto da una quota separata con un limite di velocità inferiore. Usare false per i documenti di produzione. |
|
|
Source
|
source | True | string |
URL (https://...), una stringa HTML inline o un riferimento al modello salvato nel modulo [template:TEMPLATE_ID]. |
|
Filename
|
filename | string |
Nome file di output, ad esempio invoice.pdf. |
|
|
Dati modello
|
templateData | object |
Dati chiave/valore passati al renderer del modello Liquid quando Source è un riferimento [template:ID]. |
|
|
Tag
|
tag | string |
Etichetta per la registrazione e l'analisi (massimo 30 caratteri). |
|
|
Timeout (ms)
|
timeout | integer |
Timeout di conversione in millisecondi (massimo 600000). |
|
|
Formato carta
|
format | string |
Formato carta. Il valore predefinito è A4. |
|
|
Paesaggio
|
landscape | boolean |
Usare l'orientamento orizzontale. |
|
|
Stampa sfondo
|
printBackground | boolean |
Stampa grafica e colori di sfondo. |
|
|
Scale
|
scale | number |
Scala di rendering, compresa tra 0,1 e 2. |
|
|
Intervalli di pagine
|
pageRanges | string |
Pagine da includere, ad esempio "1-5, 8". Vuoto indica tutte le pagine. |
|
|
Struttura (segnalibri)
|
outline | boolean |
Generare segnalibri PDF da intestazioni HTML. |
|
|
Tag (accessibile)
|
tagged | boolean |
Produrre un PDF con tag (accessibile). |
|
|
Preferisce le dimensioni della pagina CSS
|
preferCSSPageSize | boolean |
Rispettare le @page dimensioni dichiarate in CSS rispetto al formato Paper. |
|
|
Omettere lo sfondo
|
omitBackground | boolean |
Eseguire il rendering con uno sfondo trasparente. |
|
|
Visualizzare intestazione/piè di pagina
|
displayHeaderFooter | boolean |
Eseguire il rendering dei modelli di intestazione e piè di pagina. |
|
|
Modello di intestazione
|
headerTemplate | string |
HTML per l'intestazione di pagina. Richiede intestazione/piè di pagina di visualizzazione. |
|
|
Modello piè di pagina
|
footerTemplate | string |
HTML per il piè di pagina della pagina. Richiede intestazione/piè di pagina di visualizzazione. |
|
|
In alto
|
top | string | ||
|
Giusto
|
right | string | ||
|
In basso
|
bottom | string | ||
|
Sinistra
|
left | string | ||
|
Title
|
title | string | ||
|
Autore
|
author | string | ||
|
Subject
|
subject | string | ||
|
Parole chiave
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Creatore
|
creator | string | ||
|
Password utente
|
userPassword | string | ||
|
Password del proprietario
|
ownerPassword | string | ||
|
Source
|
source | True | string |
Testo della filigrana o URL immagine/URI dati. |
|
TIPO
|
type | True | string | |
|
Opzioni
|
options | object |
Opzioni carattere, opacità, rotazione, scala, ripetizione e offset. |
|
|
Level
|
level | True | string | |
|
Verificare la conformità
|
verify | boolean | ||
|
Verificare la conformità
|
verify | boolean |
Convalida contro veraPDF PDF/UA-1; restituisce un errore se la convalida non riesce. |
|
|
Standard
|
standard | True | string |
Standard della fattura ibrida. |
|
Profile
|
profile | True | string |
Profilo di granularità dei dati da convalidare. |
|
Verificare la conformità
|
verify | boolean |
Verificare la conformità pdf/A e fattura; restituisce un errore se la convalida non riesce. |
|
|
Numero di fattura
|
number | True | string | |
|
Data di emissione
|
issueDate | True | string |
Data di emissione, AAAA-MM-GG. |
|
Scadenza
|
dueDate | string |
Scadenza, AAAA-MM-GG. Specificare questa o condizioni di pagamento (regola BR-CO-25 EN 16931). |
|
|
Valuta
|
currencyCode | True | string |
Codice valuta ISO 4217, ad esempio EUR. |
|
Nome
|
name | True | string | |
|
Riga indirizzo 1
|
line1 | True | string | |
|
Riga indirizzo 2
|
line2 | string | ||
|
Città
|
city | True | string | |
|
Codice postale
|
postalCode | True | string | |
|
Codice paese/area geografica
|
countryCode | True | string |
Codice paese ISO 3166-1 alfa-2, ad esempio DE. |
|
ID imposta
|
taxId | string |
Identificatore iva. Obbligatorio per il venditore quando una riga utilizza la categoria IVA S. |
|
|
Email
|
string | |||
|
Telefono
|
phone | string | ||
|
Descrizione
|
description | True | string | |
|
Quantità
|
quantity | True | number | |
|
Codice unità
|
unitCode | string |
Codice unità UN/ECE, ad esempio C62 (pezzo). |
|
|
Prezzo unitario
|
unitPrice | True | number | |
|
Totale riga
|
lineTotal | True | number | |
|
Aliquota IVA (%)
|
vatRate | number | ||
|
Categoria IVA
|
vatCategoryCode | string |
Codice di categoria IVA, ad esempio S (standard), Z (zero), E (esente). |
|
|
Codice categoria
|
categoryCode | True | string | |
|
Rate (%)
|
rate | True | number | |
|
Importo impostabile
|
taxableAmount | True | number | |
|
Importo dell'imposta
|
taxAmount | True | number | |
|
Condizioni di pagamento
|
paymentTerms | string |
Condizioni di pagamento senza testo. Specificare questa o scadenza. |
|
|
Codice di tipo
|
typeCode | True | string |
Un/ECE 4461 pagamento significa codice, ad esempio 30 (bonifico di credito). |
|
IBAN
|
iban | string | ||
|
BIC
|
bic | string | ||
|
Nome dell'account
|
accountName | string | ||
|
Riferimento di pagamento
|
paymentReference | string | ||
|
Totale netto
|
totalNetAmount | True | number | |
|
Totale imposta
|
totalTaxAmount | True | number | |
|
Totale lordo
|
totalGrossAmount | True | number |
Deve essere uguale netto + imposta. |
|
Annotazioni
|
note | string | ||
|
Riferimento acquirente
|
buyerReference | string |
Riferimento acquirente/Leitweg-ID per le fatture del settore pubblico. |
|
|
Disabilitare JavaScript
|
disableJavascript | boolean | ||
|
Inserire CSS
|
css | string |
Css aggiuntivo inserito nella pagina. |
|
|
Inserire JavaScript
|
javascript | string |
JavaScript eseguito nella pagina prima dell'acquisizione. |
|
|
Attendere il selettore
|
waitForSelector | string |
Attendere che venga visualizzato questo selettore CSS. |
|
|
Attendere la funzione
|
waitForFunction | string |
Attendere fino a quando l'espressione JS non restituisce true. |
|
|
Tipo file multimediale
|
mediaType | string | ||
|
Blocca annunci
|
blockAds | boolean | ||
|
Agente utente
|
userAgent | string | ||
|
Intestazioni HTTP
|
httpHeaders | object |
Intestazioni HTTP aggiuntive come coppie chiave/valore. |
|
|
Nome
|
name | True | string | |
|
Valore
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Percorso
|
path | string | ||
|
Scadenza (periodo)
|
expires | number | ||
|
Solo HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
SameSite
|
sameSite | string | ||
|
TIPO
|
type | string | ||
|
Nome utente
|
username | True | string | |
|
Parola chiave
|
password | True | string | |
|
URL del Webhook
|
url | True | string | |
|
Async
|
async | boolean |
Recapitare in background e restituire immediatamente il 202. |
|
|
metodo
|
method | string | ||
|
Intestazioni
|
headers | object |
Intestazioni aggiuntive per la richiesta webhook. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Nuovi tentativi
|
retries | integer | ||
|
Ritardo tentativi (ms)
|
retryDelay | number | ||
|
URL prefirmato
|
presignedUrl | True | string |
URL prefirmato HTTP PUT dal provider di archiviazione. |
Valori restituiti
- response
- binary
Screenshot di acquisizione
Eseguire il rendering di html, url o un modello salvato e acquisire uno screenshot PNG, JPEG o WebP. Restituisce l'immagine come contenuto binario.
Parametri
| Nome | Chiave | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
Modalità sandbox
|
X-Sandbox | string |
Eseguire la conversione in modalità sandbox. L'output sandbox è limitato e viene estratto da una quota separata con un limite di velocità inferiore. Usare false per i documenti di produzione. |
|
|
Source
|
source | True | string |
URL (https://...), una stringa HTML inline o un riferimento al modello salvato nel modulo [template:TEMPLATE_ID]. |
|
Filename
|
filename | string |
Nome file di output, ad esempio screenshot.png. |
|
|
Dati modello
|
templateData | object |
Dati chiave/valore passati al renderer del modello Liquid quando Source è un riferimento [template:ID]. |
|
|
Tipo di immagine
|
type | string |
Formato immagine. Il valore predefinito è png. |
|
|
Pagina completa
|
fullPage | boolean |
Acquisire l'intera pagina scorrevole. |
|
|
Quality
|
quality | integer |
Qualità di compressione 0-100 per JPEG/WebP. |
|
|
Omettere lo sfondo
|
omitBackground | boolean |
Acquisire con uno sfondo trasparente (PNG/WebP). |
|
|
Width (px)
|
width | integer | ||
|
Altezza (px)
|
height | integer | ||
|
Rapporto pixel dispositivo
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
Sì
|
y | number | ||
|
Larghezza
|
width | number | ||
|
Altezza
|
height | number | ||
|
Scale
|
scale | number | ||
|
Tag
|
tag | string |
Etichetta per la registrazione e l'analisi (massimo 30 caratteri). |
|
|
Timeout (ms)
|
timeout | integer |
Timeout di conversione in millisecondi (massimo 600000). |
|
|
Disabilitare JavaScript
|
disableJavascript | boolean | ||
|
Inserire CSS
|
css | string |
Css aggiuntivo inserito nella pagina. |
|
|
Inserire JavaScript
|
javascript | string |
JavaScript eseguito nella pagina prima dell'acquisizione. |
|
|
Attendere il selettore
|
waitForSelector | string |
Attendere che venga visualizzato questo selettore CSS. |
|
|
Attendere la funzione
|
waitForFunction | string |
Attendere fino a quando l'espressione JS non restituisce true. |
|
|
Tipo file multimediale
|
mediaType | string | ||
|
Blocca annunci
|
blockAds | boolean | ||
|
Agente utente
|
userAgent | string | ||
|
Intestazioni HTTP
|
httpHeaders | object |
Intestazioni HTTP aggiuntive come coppie chiave/valore. |
|
|
Nome
|
name | True | string | |
|
Valore
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Percorso
|
path | string | ||
|
Scadenza (periodo)
|
expires | number | ||
|
Solo HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
SameSite
|
sameSite | string | ||
|
TIPO
|
type | string | ||
|
Nome utente
|
username | True | string | |
|
Parola chiave
|
password | True | string | |
|
URL del Webhook
|
url | True | string | |
|
Async
|
async | boolean |
Recapitare in background e restituire immediatamente il 202. |
|
|
metodo
|
method | string | ||
|
Intestazioni
|
headers | object |
Intestazioni aggiuntive per la richiesta webhook. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Nuovi tentativi
|
retries | integer | ||
|
Ritardo tentativi (ms)
|
retryDelay | number | ||
|
URL prefirmato
|
presignedUrl | True | string |
URL prefirmato HTTP PUT dal provider di archiviazione. |
Valori restituiti
- response
- binary
Definizioni
binary
Questo è il tipo di dati di base 'binario'.