PolyDoc (Publisher indépendant) (préversion)

Convertissez du code HTML ou une URL en fichiers PDF et captures d’écran parfaits en pixels, et générez des factures électroniques hybrides compatibles avec l’UE (ZUGFeRD / Factur-X). PolyDoc s’affiche avec un moteur de navigateur réel, donc ce que vous voyez dans la page est ce que vous obtenez dans le document.

Ce connecteur est disponible dans les produits et régions suivants :

Service Class Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom PolyDoc
URL https://polydoc.tech
Email hello@polydoc.tech
Métadonnées du connecteur
Éditeur blue-d3v
Website https://polydoc.tech
Politique de confidentialité https://polydoc.tech/legal/privacy-policy/
Categories Contenu et fichiers

PolyDoc

PolyDoc transforme HTML ou une URL en fichiers PDF et captures d’écran parfaits en pixels, et génère des factures électroniques hybrides compatibles avec l’UE (ZUGFeRD / Factur-X). Les conversions s’affichent dans un moteur de navigateur réel, de sorte que ce que vous voyez dans la page est ce que vous obtenez dans le document.

Éditeur

PolyDoc

Prerequisites

Vous avez besoin d’un compte PolyDoc et d’une clé API. Le niveau gratuit est suffisant pour évaluer le connecteur. Les connecteurs personnalisés sont une fonctionnalité de Power Automate Premium, de sorte que les flux qui utilisent ce connecteur ont besoin d’un plan Power Automate Premium (par utilisateur ou par flux), identique à l’action HTTP intégrée.

Obtention d’informations d’identification

  1. Connectez-vous à dashboard.polydoc.tech.
  2. Ouvrez les clés API et créez une clé.
  3. Lorsque vous créez la connexion, collez la clé dans la clé API PolyDoc. Collez uniquement la clé ; le connecteur ajoute le Bearer préfixe pour vous.

Opérations prises en charge

Operation Qu’est-ce que cela fait ?
Convertir au format PDF Affichez du code HTML, une URL ou un modèle enregistré dans un fichier PDF. Contrôles pour le format de page, les marges, l’échelle, les en-têtes/pieds de page, les signets, les fichiers PDF accessibles (marqués), les métadonnées, le chiffrement, les filigranes et PDF/A.
Capture d’écran Capturez un fichier PNG, JPEG ou WebP html, une URL ou un modèle. Page complète ou clippée, avec la fenêtre d’affichage et le contrôle de ratio de pixels d’appareil.

Les factures électroniques sont produites au format PDF : renseignez les champs de facture électronique (standard, profil et objet structuré invoice ) et PolyDoc incorpore une facture ZUGFeRD / Factur-X dans le PDF retourné. Consultez le example-flows/ dossier du référentiel du connecteur pour obtenir un corps prêt à l’emploi.

Source

Chaque opération prend une seule source qui est l’une des suivantes :

  • une URL, par exemple https://example.com
  • une chaîne HTML inline
  • référence de modèle enregistrée, [template:TEMPLATE_ID]éventuellement avec des données de modèle pour le renderer Liquid

Livraison

Par défaut, le fichier est retourné en tant que contenu binaire, prêt à être inséré dans Créer un fichier (OneDrive, SharePoint, Blob) ou une pièce jointe par e-mail. Deux modes de livraison alternatifs sont disponibles sous des options avancées :

  • Stockage cloud : fournissez une URL PUT présignée ; PolyDoc charge le fichier et l’action retourne json contenant l’URL stockée.
  • Webhook : PolyDoc remet le fichier à votre webhook et l’action retourne un accusé de réception JSON (HTTP 202 quand async).

Lorsque l’un ou l’autre mode de remise est utilisé, la réponse est JSON plutôt qu’un fichier binaire.

Mode bac à sable

Chaque opération a une entrée en mode bac à sable avancée. Définissez-le pour true générer une sortie en filigrane à partir d’un quota distinct avec une limite de débit inférieure, ce qui est utile lors de la création et du test d’un flux. Laissez-le false pour les documents de production.

Problèmes connus et limitations

  • La réponse de chaque action est déclarée en tant que fichier binaire. Lorsque la remise du stockage cloud ou du Webhook est configurée, l’action retourne JSON au lieu d’un fichier.
  • Les pages qui chargent JavaScript à partir d’un CDN externe peuvent ralentir considérablement le convertisseur. Pour le code HTML inline, préférez le balisage autonome (CSS inline, images d’URI de données).
  • Les factures électroniques suivent EN 16931. Au minimum, fournissez une date d’échéance ou des conditions de paiement (règle BR-CO-25), l’ID fiscal du vendeur lorsqu’une ligne utilise la catégorie STVA et les totaux cohérents (net + tax = brut). Une fois la vérification activée, une facture qui échoue à la validation retourne une erreur.

Instructions de déploiement

Ce connecteur est défini comme un connecteur personnalisé Power Platform standard (apiDefinition.swagger.json + + apiProperties.jsonicon.png). Déployez-le avec l’interface CLI des connecteurs 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>

Vous pouvez également importer apiDefinition.swagger.json directement à partir du portail Power Automate maker (Connecteurs > personnalisés de données > Nouveau connecteur > personnalisé Importer un fichier OpenAPI).

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Valeur par défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom Type Description Required
Clé API PolyDoc Securestring Votre clé API PolyDoc. Créez-en un à dashboard.polydoc.tech sous Clés API. Collez uniquement la clé ; le connecteur ajoute le préfixe « Porteur » pour vous. True

Actions

Capture d’écran

Affichez du code HTML, une URL ou un modèle enregistré et capturez une capture d’écran PNG, JPEG ou WebP. Retourne l’image en tant que contenu binaire.

Convertir au format PDF

Affichez du code HTML, une URL ou un modèle enregistré dans un fichier PDF. Remplissez les champs E-invoice pour incorporer une facture MDMFeRD / Factur-X hybride au lieu d’un fichier PDF brut. Retourne le fichier en tant que contenu binaire.

Capture d’écran

Affichez du code HTML, une URL ou un modèle enregistré et capturez une capture d’écran PNG, JPEG ou WebP. Retourne l’image en tant que contenu binaire.

Paramètres

Nom Clé Obligatoire Type Description
Mode bac à sable
X-Sandbox string

Exécutez la conversion en mode bac à sable. La sortie du bac à sable est délimitée et tire d’un quota distinct avec une limite de débit inférieure. Utilisez false pour les documents de production.

Source
source True string

URL (https://...), chaîne HTML inline ou référence de modèle enregistrée sous la forme [template :TEMPLATE_ID].

Filename
filename string

Nom de fichier de sortie, par exemple screenshot.png.

Données de modèle
templateData object

Données de clé/valeur transmises au renderer de modèle Liquid lorsque la source est une référence [template :ID].

Type d’image
type string

Format d’image. La valeur par défaut est png.

Page complète
fullPage boolean

Capturez l’intégralité de la page défilante.

Qualité
quality integer

Qualité de compression 0-100 pour JPEG/WebP.

Omettre l’arrière-plan
omitBackground boolean

Capture avec un arrière-plan transparent (PNG/WebP).

Largeur (px)
width integer
Hauteur (px)
height integer
Taux de pixels de l’appareil
devicePixelRatio number
X
x number
O
y number
Largeur
width number
Hauteur
height number
Scale
scale number
Tag
tag string

Étiquette pour la journalisation et l’analytique (30 caractères maximum).

Délai d’expiration (ms)
timeout integer

Délai de conversion en millisecondes (maximum 6000000).

Désactiver JavaScript
disableJavascript boolean
Injecter CSS
css string

CSS supplémentaire injecté dans la page.

Injecter JavaScript
javascript string

JavaScript exécuté dans la page avant la capture.

Attendre le sélecteur
waitForSelector string

Attendez que ce sélecteur CSS s’affiche.

Attendre la fonction
waitForFunction string

Attendez que cette expression JS retourne true.

Type de média
mediaType string
Bloquer les publicités
blockAds boolean
Agent utilisateur
userAgent string
En-têtes HTTP
httpHeaders object

En-têtes HTTP supplémentaires en tant que paires clé/valeur.

Nom
name True string
Valeur
value True string
URL
url string
Domaine
domain string
Path
path string
Expire (époque)
expires number
HTTP uniquement
httpOnly boolean
Secure
secure boolean
SameSite (en anglais)
sameSite string
Type
type string
Nom d’utilisateur
username True string
Password
password True string
URL de webhook
url True string
Asynchrone
async boolean

Fournir en arrière-plan et retourner 202 immédiatement.

Method
method string
headers
headers object

En-têtes supplémentaires pour la demande de webhook.

Délai d’expiration (ms)
timeout number
Nouvelle tentatives
retries integer
Délai de nouvelle tentative (ms)
retryDelay number
URL présignée
presignedUrl True string

URL présignée HTTP PUT de votre fournisseur de stockage.

Retours

response
binary

Convertir au format PDF

Affichez du code HTML, une URL ou un modèle enregistré dans un fichier PDF. Remplissez les champs E-invoice pour incorporer une facture MDMFeRD / Factur-X hybride au lieu d’un fichier PDF brut. Retourne le fichier en tant que contenu binaire.

Paramètres

Nom Clé Obligatoire Type Description
Mode bac à sable
X-Sandbox string

Exécutez la conversion en mode bac à sable. La sortie du bac à sable est délimitée et tire d’un quota distinct avec une limite de débit inférieure. Utilisez false pour les documents de production.

Source
source True string

URL (https://...), chaîne HTML inline ou référence de modèle enregistrée sous la forme [template :TEMPLATE_ID].

Filename
filename string

Nom de fichier de sortie, par exemple invoice.pdf.

Données de modèle
templateData object

Données de clé/valeur transmises au renderer de modèle Liquid lorsque la source est une référence [template :ID].

Tag
tag string

Étiquette pour la journalisation et l’analytique (30 caractères maximum).

Délai d’expiration (ms)
timeout integer

Délai de conversion en millisecondes (maximum 6000000).

Format papier
format string

Format papier. La valeur par défaut est A4.

Paysage
landscape boolean

Utilisez l’orientation paysage.

Imprimer l’arrière-plan
printBackground boolean

Imprimer des graphiques et des couleurs d’arrière-plan.

Scale
scale number

Échelle de rendu comprise entre 0,1 et 2.

Plages de pages
pageRanges string

Pages à inclure, par exemple « 1-5, 8 ». Vide signifie toutes les pages.

Plan (signets)
outline boolean

Générez des signets PDF à partir de titres HTML.

Étiqueté (accessible)
tagged boolean

Produire un PDF étiqueté (accessible).

Préférer la taille de page CSS
preferCSSPageSize boolean

Respectez la @page taille déclarée en CSS au format Papier.

Omettre l’arrière-plan
omitBackground boolean

Rendu avec un arrière-plan transparent.

Afficher l’en-tête/pied de page
displayHeaderFooter boolean

Affichez les modèles d’en-tête et de pied de page.

Modèle d’en-tête
headerTemplate string

HTML pour l’en-tête de page. Nécessite l’en-tête/pied de page d’affichage.

Modèle pied de page
footerTemplate string

HTML pour le pied de page. Nécessite l’en-tête/pied de page d’affichage.

Haut
top string
Droit
right string
Bas
bottom string
Gauche
left string
Titre
title string
Auteur
author string
Sujet
subject string
Mots clés
keywords array of string
Producer
producer string
Créateur
creator string
Mot de passe de l’utilisateur
userPassword string
Mot de passe du propriétaire
ownerPassword string
Source
source True string

Texte en filigrane ou URL d’image/URI de données.

Type
type True string
Options
options object

Police, opacité, rotation, mise à l’échelle, répétition et options de décalage.

Level
level True string
Vérifier la conformité
verify boolean
Vérifier la conformité
verify boolean

Valider par rapport à veraPDF PDF/UA-1 ; retourne une erreur en cas d’échec de la validation.

Norme
standard True string

Standard de facture hybride.

Profile
profile True string

Profil de granularité des données à valider.

Vérifier la conformité
verify boolean

Vérifiez la conformité pdf/A et e-facture ; retourne une erreur en cas d’échec de la validation.

Numéro de facture
number True string
Date d’émission
issueDate True string

Date du problème, AAAA-MM-DD.

Échéance
dueDate string

Date d’échéance, AAAA-MM-JJ. Fournissez ces conditions de paiement (RÈGLE EN 16931 BR-CO-25).

Devise
currencyCode True string

Code monétaire ISO 4217, par exemple EUR.

Nom
name True string
Ligne d’adresse 1
line1 True string
Ligne d'adresse 2
line2 string
Ville
city True string
Code postal
postalCode True string
Code de pays
countryCode True string

Code pays ISO 3166-1 alpha-2, par exemple DE.

Numéro d'identification fiscale
taxId string

Identificateur de TVA. Obligatoire pour le vendeur lorsqu’une ligne utilise la catégorie TVA S.

Email
email string
Téléphone
phone string
Description
description True string
Quantité
quantity True number
Code d’unité
unitCode string

Code d’unité UN/ECE, par exemple C62 (pièce).

Prix unitaire
unitPrice True number
Total des lignes
lineTotal True number
Taux de TVA (%)
vatRate number
Catégorie TVA
vatCategoryCode string

Code de catégorie DE TVA, par exemple S (standard), Z (zéro), E (exempt).

Code de catégorie
categoryCode True string
Taux (%)
rate True number
Montant imposable
taxableAmount True number
Montant de l’impôt
taxAmount True number
Conditions de paiement
paymentTerms string

Conditions de paiement en texte libre. Indiquez cette date ou échéance.

Code de type
typeCode True string

Le code de paiement 4461 de l’ONU/EAH 4461 signifie le code, par exemple 30 (transfert de crédit).

IBAN
iban string
BIC
bic string
Nom du compte
accountName string
Référence de paiement
paymentReference string
Total net
totalNetAmount True number
Total des taxes
totalTaxAmount True number
Total brut
totalGrossAmount True number

Doit être égal à net + taxe.

Note
note string
Référence acheteur
buyerReference string

Référence de l’acheteur / Leitweg-ID pour les factures du secteur public.

Désactiver JavaScript
disableJavascript boolean
Injecter CSS
css string

CSS supplémentaire injecté dans la page.

Injecter JavaScript
javascript string

JavaScript exécuté dans la page avant la capture.

Attendre le sélecteur
waitForSelector string

Attendez que ce sélecteur CSS s’affiche.

Attendre la fonction
waitForFunction string

Attendez que cette expression JS retourne true.

Type de média
mediaType string
Bloquer les publicités
blockAds boolean
Agent utilisateur
userAgent string
En-têtes HTTP
httpHeaders object

En-têtes HTTP supplémentaires en tant que paires clé/valeur.

Nom
name True string
Valeur
value True string
URL
url string
Domaine
domain string
Path
path string
Expire (époque)
expires number
HTTP uniquement
httpOnly boolean
Secure
secure boolean
SameSite (en anglais)
sameSite string
Type
type string
Nom d’utilisateur
username True string
Password
password True string
URL de webhook
url True string
Asynchrone
async boolean

Fournir en arrière-plan et retourner 202 immédiatement.

Method
method string
headers
headers object

En-têtes supplémentaires pour la demande de webhook.

Délai d’expiration (ms)
timeout number
Nouvelle tentatives
retries integer
Délai de nouvelle tentative (ms)
retryDelay number
URL présignée
presignedUrl True string

URL présignée HTTP PUT de votre fournisseur de stockage.

Retours

response
binary

Définitions

binary

Il s’agit du type de données de base "binaire".