PolyDoc (Publisher independiente) (versión preliminar)
Convierta HTML o una dirección URL en PDF y capturas de pantalla perfectas para píxeles y genere facturas electrónicas híbridas compatibles con la UE (ZUGFeRD/Factur-X). PolyDoc se representa con un motor de explorador real, por lo que lo que ve en la página es lo que obtiene en el documento.
Este conector está disponible en los siguientes productos y regiones:
| Service | Clase | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | PolyDoc |
| URL | https://polydoc.tech |
| Correo Electrónico | hello@polydoc.tech |
| Metadatos del conector | |
|---|---|
| Publicador | blue-d3v |
| Sitio web | https://polydoc.tech |
| Directiva de privacidad | https://polydoc.tech/legal/privacy-policy/ |
| Categorías | Contenido y archivos |
PolyDoc
PolyDoc convierte HTML o una dirección URL en archivos PDF y capturas de pantalla perfectos para píxeles, y genera facturas electrónicas híbridas compatibles con la UE (ZUGFeRD /Factur-X). Las conversiones se representan en un motor de explorador real, por lo que lo que ve en la página es lo que obtiene en el documento.
Publicador
PolyDoc
Prerequisites
Necesita una cuenta de PolyDoc y una clave de API. El nivel gratis es suficiente para evaluar el conector. Los conectores personalizados son una característica de Power Automate premium, por lo que los flujos que usan este conector necesitan un plan premium de Power Automate (por usuario o por flujo), igual que la acción HTTP integrada.
Obtención de credenciales
- Inicie sesión en dashboard.polydoc.tech.
- Abra claves de API y cree una clave.
- Al crear la conexión, pegue la clave en la clave de API de PolyDoc. Pegue solo la clave; el conector agrega el
Bearerprefijo por usted.
Operaciones soportadas
| Operación | Qué hace |
|---|---|
| Convertir a PDF | Representar HTML, una dirección URL o una plantilla guardada en un PDF. Controles para formato de página, márgenes, escala, encabezados y pies de página, marcadores, ARCHIVOS PDF accesibles (etiquetados), metadatos, cifrado, marcas de agua y PDF/A. |
| Captura de pantalla de captura | Capture un PNG, JPEG o WebP de HTML, una dirección URL o una plantilla. Página completa o recortada, con control de ventanilla y relación de píxeles del dispositivo. |
Las facturas electrónicas se generan con Convert to PDF (Convertir en PDF): rellena los campos de factura electrónica (estándar, perfil y el objeto estructurado invoice ) y PolyDoc inserta una factura ZUGFeRD/Factur-X en el PDF devuelto. Consulte la example-flows/ carpeta del repositorio del conector para obtener un cuerpo listo para usar.
Source
Cada operación toma un único origen que es uno de los siguientes:
- una dirección URL, por ejemplo,
https://example.com - una cadena HTML insertada
- una referencia de plantilla guardada,
[template:TEMPLATE_ID], opcionalmente con datos de plantilla para el representador liquid
Entrega
De forma predeterminada, el archivo se devuelve como contenido binario, listo para colocarse en Crear archivo (OneDrive, SharePoint, Blob) o datos adjuntos de correo electrónico. Hay dos modos de entrega alternativos disponibles en opciones avanzadas:
- Almacenamiento en la nube: proporcione una dirección URL PUT presignada; PolyDoc carga el archivo y la acción devuelve JSON que contiene la dirección URL almacenada.
- Webhook: PolyDoc entrega el archivo al webhook y la acción devuelve una confirmación JSON (HTTP 202 cuando asincrónico).
Cuando se usa cualquiera de los modos de entrega, la respuesta es JSON en lugar de un archivo binario.
Modo de espacio aislado
Cada operación tiene una entrada avanzada del modo de espacio aislado . Establézcalo en true para generar una salida con marca de agua a partir de una cuota independiente con un límite de velocidad inferior, lo que resulta útil al compilar y probar un flujo. Déjelo false para los documentos de producción.
Limitaciones y problemas conocidos
- La respuesta de cada acción se declara como un archivo binario. Cuando se configura el almacenamiento en la nube o la entrega de webhook , la acción devuelve JSON en lugar de un archivo.
- Las páginas que cargan JavaScript desde una red CDN externa pueden ralentizar significativamente el convertidor. Para HTML insertado, prefiera el marcado autocontenida (css insertado, imágenes de URI de datos).
- Las facturas electrónicas siguen EN 16931. Como mínimo, proporcione una fecha de vencimiento o condiciones de pago (regla BR-CO-25), el identificador fiscal del vendedor cuando una línea usa la categoría
Siva y totales coherentes (neto + impuesto = bruto). Con Verify enabled an invoice that fails validation returns an error.
Instrucciones de implementación
Este conector se define como un conector personalizado estándar de Power Platform (apiDefinition.swagger.json + + apiProperties.jsonicon.png). Impleméntelo con la CLI de 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>
También puede importar apiDefinition.swagger.json directamente desde el portal de Power Automate maker (conectores personalizados de datos > Nuevos conectores > personalizados > Importar un archivo OpenAPI).
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación Power se comparte con otro usuario, se le solicitará a otro usuario que cree una nueva conexión explícitamente.
| Nombre | Tipo | Descripción | Required |
|---|---|---|---|
| Clave de API de PolyDoc | securestring | Clave de API de PolyDoc. Cree uno en dashboard.polydoc.tech en Claves de API. Pegue solo la clave; el conector agrega el prefijo "Portador". | True |
Acciones
| Captura de pantalla de captura |
Representar HTML, una dirección URL o una plantilla guardada y capturar una captura de pantalla PNG, JPEG o WebP. Devuelve la imagen como contenido binario. |
| Convertir a PDF |
Representar HTML, una dirección URL o una plantilla guardada en un PDF. Rellene los campos de factura electrónica para insertar una factura HÍBRIDA ZUGFeRD o Factur-X en lugar de un PDF sin formato. Devuelve el archivo como contenido binario. |
Captura de pantalla de captura
Representar HTML, una dirección URL o una plantilla guardada y capturar una captura de pantalla PNG, JPEG o WebP. Devuelve la imagen como contenido binario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Modo de espacio aislado
|
X-Sandbox | string |
Ejecute la conversión en modo de espacio aislado. La salida del espacio aislado está marca de agua y se extrae de una cuota independiente con un límite de velocidad inferior. Use false para documentos de producción. |
|
|
Source
|
source | True | string |
Una dirección URL (https://...), una cadena HTML insertada o una referencia de plantilla guardada con el formato [template:TEMPLATE_ID]. |
|
Nombre de archivo
|
filename | string |
Nombre de archivo de salida, por ejemplo, screenshot.png. |
|
|
Datos de plantilla
|
templateData | object |
Los datos de clave y valor pasados al representador de plantillas liquid cuando Source es una referencia [template:ID]. |
|
|
Tipo de imagen
|
type | string |
Formato de imagen. El valor predeterminado es png. |
|
|
Página completa
|
fullPage | boolean |
Capture toda la página desplazable. |
|
|
Quality
|
quality | integer |
Calidad de compresión 0-100 para JPEG/WebP. |
|
|
Omitir fondo
|
omitBackground | boolean |
Captura con un fondo transparente (PNG/WebP). |
|
|
Ancho (px)
|
width | integer | ||
|
Alto (px)
|
height | integer | ||
|
Relación de píxeles del dispositivo
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
Y
|
y | number | ||
|
Ancho
|
width | number | ||
|
Altura
|
height | number | ||
|
Scale
|
scale | number | ||
|
Tag
|
tag | string |
Etiqueta para el registro y el análisis (máximo de 30 caracteres). |
|
|
Tiempo de espera (ms)
|
timeout | integer |
Tiempo de espera de conversión en milisegundos (máximo 600000). |
|
|
Deshabilitar JavaScript
|
disableJavascript | boolean | ||
|
Inserción de CSS
|
css | string |
CSS adicional insertado en la página. |
|
|
Inserción de JavaScript
|
javascript | string |
JavaScript ejecutado en la página antes de la captura. |
|
|
Esperar selector
|
waitForSelector | string |
Espere hasta que aparezca este selector css. |
|
|
Esperar función
|
waitForFunction | string |
Espere hasta que esta expresión JS devuelva true. |
|
|
Tipo de elemento multimedia
|
mediaType | string | ||
|
Bloquear anuncios
|
blockAds | boolean | ||
|
Agente de usuario
|
userAgent | string | ||
|
Encabezados HTTP
|
httpHeaders | object |
Encabezados HTTP adicionales como pares clave-valor. |
|
|
Nombre
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Solo HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Mismo sitio
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nombre de usuario
|
username | True | string | |
|
Password
|
password | True | string | |
|
URL del Webhook
|
url | True | string | |
|
Async
|
async | boolean |
Entregar en segundo plano y devolver 202 inmediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Encabezados adicionales para la solicitud de webhook. |
|
|
Tiempo de espera (ms)
|
timeout | number | ||
|
Reintentos
|
retries | integer | ||
|
Retraso de reintento (ms)
|
retryDelay | number | ||
|
Dirección URL presignada
|
presignedUrl | True | string |
DIRECCIÓN URL presignada HTTP PUT del proveedor de almacenamiento. |
Devoluciones
- response
- binary
Convertir a PDF
Representar HTML, una dirección URL o una plantilla guardada en un PDF. Rellene los campos de factura electrónica para insertar una factura HÍBRIDA ZUGFeRD o Factur-X en lugar de un PDF sin formato. Devuelve el archivo como contenido binario.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Modo de espacio aislado
|
X-Sandbox | string |
Ejecute la conversión en modo de espacio aislado. La salida del espacio aislado está marca de agua y se extrae de una cuota independiente con un límite de velocidad inferior. Use false para documentos de producción. |
|
|
Source
|
source | True | string |
Una dirección URL (https://...), una cadena HTML insertada o una referencia de plantilla guardada con el formato [template:TEMPLATE_ID]. |
|
Nombre de archivo
|
filename | string |
Nombre de archivo de salida, por ejemplo, invoice.pdf. |
|
|
Datos de plantilla
|
templateData | object |
Los datos de clave y valor pasados al representador de plantillas liquid cuando Source es una referencia [template:ID]. |
|
|
Tag
|
tag | string |
Etiqueta para el registro y el análisis (máximo de 30 caracteres). |
|
|
Tiempo de espera (ms)
|
timeout | integer |
Tiempo de espera de conversión en milisegundos (máximo 600000). |
|
|
Formato de papel
|
format | string |
Formato de papel. El valor predeterminado es A4. |
|
|
Paisaje
|
landscape | boolean |
Use orientación horizontal. |
|
|
Imprimir fondo
|
printBackground | boolean |
Imprimir gráficos y colores de fondo. |
|
|
Scale
|
scale | number |
Escala de representación, entre 0,1 y 2. |
|
|
Intervalos de páginas
|
pageRanges | string |
Páginas que se van a incluir, por ejemplo, "1-5, 8". Vacío significa todas las páginas. |
|
|
Esquema (marcadores)
|
outline | boolean |
Genere marcadores PDF a partir de encabezados HTML. |
|
|
Etiquetado (accesible)
|
tagged | boolean |
Genere un PDF etiquetado (accesible). |
|
|
Preferir el tamaño de página CSS
|
preferCSSPageSize | boolean |
Respeta el @page tamaño declarado en CSS sobre el formato Paper. |
|
|
Omitir fondo
|
omitBackground | boolean |
Representar con un fondo transparente. |
|
|
Mostrar encabezado/pie de página
|
displayHeaderFooter | boolean |
Representar las plantillas de encabezado y pie de página. |
|
|
Plantilla de encabezado
|
headerTemplate | string |
HTML para el encabezado de página. Requiere Mostrar encabezado o pie de página. |
|
|
Plantilla de pie de página
|
footerTemplate | string |
HTML para el pie de página. Requiere Mostrar encabezado o pie de página. |
|
|
Mejores
|
top | string | ||
|
Right
|
right | string | ||
|
Abajo
|
bottom | string | ||
|
Izquierda
|
left | string | ||
|
Title
|
title | string | ||
|
Autor
|
author | string | ||
|
Asunto
|
subject | string | ||
|
Keywords
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Creador
|
creator | string | ||
|
Contraseña de usuario
|
userPassword | string | ||
|
Contraseña del propietario
|
ownerPassword | string | ||
|
Source
|
source | True | string |
Texto de marca de agua o un URI de dirección URL o datos de imagen. |
|
Tipo
|
type | True | string | |
|
Opciones
|
options | object |
Opciones de fuente, opacidad, rotación, escala, repetición y desplazamiento. |
|
|
Level
|
level | True | string | |
|
Comprobación del cumplimiento
|
verify | boolean | ||
|
Comprobación del cumplimiento
|
verify | boolean |
Validar con veraPDF PDF/UA-1; devuelve un error si se produce un error en la validación. |
|
|
Estándar
|
standard | True | string |
Estándar de factura híbrida. |
|
Profile
|
profile | True | string |
Perfil de granularidad de datos con el que se va a validar. |
|
Comprobación del cumplimiento
|
verify | boolean |
Comprobar el cumplimiento de PDF/A y factura electrónica; devuelve un error si se produce un error en la validación. |
|
|
Número de factura
|
number | True | string | |
|
Fecha de emisión
|
issueDate | True | string |
Fecha de emisión, AAAA-MM-DD. |
|
Fecha de vencimiento
|
dueDate | string |
Fecha de vencimiento, AAAA-MM-DD. Proporcione esta o condiciones de pago (regla EN 16931 BR-CO-25). |
|
|
Divisa
|
currencyCode | True | string |
Código de moneda ISO 4217, por ejemplo, EUR. |
|
Nombre
|
name | True | string | |
|
Línea de dirección 1
|
line1 | True | string | |
|
Línea de dirección 2
|
line2 | string | ||
|
Ciudad
|
city | True | string | |
|
Código postal
|
postalCode | True | string | |
|
Código de país
|
countryCode | True | string |
Código de país iso 3166-1 alfa-2, por ejemplo, DE. |
|
ID fiscal
|
taxId | string |
Identificador de IVA. Necesario para el vendedor cuando una línea utiliza la categoría de IVA S. |
|
|
Correo Electrónico
|
string | |||
|
Teléfono
|
phone | string | ||
|
Descripción
|
description | True | string | |
|
Cantidad
|
quantity | True | number | |
|
Código de unidad
|
unitCode | string |
Código de unidad UN/ECE, por ejemplo, C62 (pieza). |
|
|
Precio unitario
|
unitPrice | True | number | |
|
Total de líneas
|
lineTotal | True | number | |
|
Tipo de IVA (%)
|
vatRate | number | ||
|
Categoría iva
|
vatCategoryCode | string |
Código de categoría iva, por ejemplo, S (estándar), Z (cero), E (exento). |
|
|
Código de categoría
|
categoryCode | True | string | |
|
Rate (%)
|
rate | True | number | |
|
Importe sujeto pasivo
|
taxableAmount | True | number | |
|
Importe del impuesto
|
taxAmount | True | number | |
|
Condiciones de pago
|
paymentTerms | string |
Términos de pago de texto libre. Proporcione esta fecha o fecha de vencimiento. |
|
|
Código de tipo
|
typeCode | True | string |
Un/ECE 4461 significa código de pago, por ejemplo, 30 (transferencia de crédito). |
|
IBAN
|
iban | string | ||
|
BIC
|
bic | string | ||
|
Nombre de la cuenta
|
accountName | string | ||
|
Referencia del pago
|
paymentReference | string | ||
|
Total neto
|
totalNetAmount | True | number | |
|
Impuesto total
|
totalTaxAmount | True | number | |
|
Total bruto
|
totalGrossAmount | True | number |
Debe ser igual a neto + impuestos. |
|
Note
|
note | string | ||
|
Referencia del comprador
|
buyerReference | string |
Referencia de comprador/Leitweg-ID para facturas del sector público. |
|
|
Deshabilitar JavaScript
|
disableJavascript | boolean | ||
|
Inserción de CSS
|
css | string |
CSS adicional insertado en la página. |
|
|
Inserción de JavaScript
|
javascript | string |
JavaScript ejecutado en la página antes de la captura. |
|
|
Esperar selector
|
waitForSelector | string |
Espere hasta que aparezca este selector css. |
|
|
Esperar función
|
waitForFunction | string |
Espere hasta que esta expresión JS devuelva true. |
|
|
Tipo de elemento multimedia
|
mediaType | string | ||
|
Bloquear anuncios
|
blockAds | boolean | ||
|
Agente de usuario
|
userAgent | string | ||
|
Encabezados HTTP
|
httpHeaders | object |
Encabezados HTTP adicionales como pares clave-valor. |
|
|
Nombre
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Solo HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
Mismo sitio
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nombre de usuario
|
username | True | string | |
|
Password
|
password | True | string | |
|
URL del Webhook
|
url | True | string | |
|
Async
|
async | boolean |
Entregar en segundo plano y devolver 202 inmediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Encabezados adicionales para la solicitud de webhook. |
|
|
Tiempo de espera (ms)
|
timeout | number | ||
|
Reintentos
|
retries | integer | ||
|
Retraso de reintento (ms)
|
retryDelay | number | ||
|
Dirección URL presignada
|
presignedUrl | True | string |
DIRECCIÓN URL presignada HTTP PUT del proveedor de almacenamiento. |
Devoluciones
- response
- binary
Definiciones
binario
Este es el tipo de datos básico "binary".