PolyDoc (Publisher Independente) (versão prévia)
Converta HTML ou uma URL em PDFs e capturas de tela perfeitas para pixels e gere faturas e-invoices híbridas compatíveis com a UE (ZUGFeRD/Factur-X). O PolyDoc é renderizado com um mecanismo de navegador real, portanto, o que você vê na página é o que você obtém no documento.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | PolyDoc |
| URL | https://polydoc.tech |
| hello@polydoc.tech |
| Metadados do conector | |
|---|---|
| Publicador | blue-d3v |
| Site | https://polydoc.tech |
| Política de privacidade | https://polydoc.tech/legal/privacy-policy/ |
| Categories | Conteúdo e arquivos |
PolyDoc
O PolyDoc transforma HTML ou uma URL em PDFs e capturas de tela perfeitas para pixels e gera faturas e-invoices híbridas compatíveis com a UE (ZUGFeRD/Factur-X). As conversões são renderizadas em um mecanismo de navegador real, portanto, o que você vê na página é o que você obtém no documento.
Publicador
PolyDoc
Pré-requisitos
Você precisa de uma conta PolyDoc e uma chave de API. A camada gratuita é suficiente para avaliar o conector. Conectores personalizados são um recurso de Power Automate premium, portanto, os fluxos que usam esse conector precisam de um plano Power Automate Premium (por usuário ou por fluxo), o mesmo que a ação HTTP interna.
Obtendo credenciais
- Entre no dashboard.polydoc.tech.
- Abra chaves de API e crie uma chave.
- Ao criar a conexão, cole a chave na chave da API polyDoc. Cole apenas a chave; o conector adiciona o
Bearerprefixo para você.
Operações com suporte
| Operação | O que faz |
|---|---|
| Converter em PDF | Renderize HTML, uma URL ou um modelo salvo em um PDF. Controles para formato de página, margens, escala, cabeçalhos/rodapés, indicadores, PDFs acessíveis (marcados), metadados, criptografia, marcas d'água e PDF/A. |
| Captura de tela de captura | Capture um PNG, JPEG ou WebP de HTML, uma URL ou um modelo. Página inteira ou recortada, com visor e controle de taxa de pixel de dispositivo. |
As faturas E são produzidas com Converter em PDF: preencha os campos da fatura E (padrão, perfil e objeto estruturado invoice ) e o PolyDoc insira uma fatura ZUGFeRD/Factur-X no PDF retornado. Consulte a example-flows/ pasta no repositório do conector para obter um corpo pronto para uso.
Fonte
Cada operação usa uma única origem que é uma das seguintes:
- uma URL, por exemplo,
https://example.com - uma cadeia de caracteres HTML embutida
- uma referência de modelo salva,
[template:TEMPLATE_ID]opcionalmente com dados de modelo para o renderizador Liquid
Entrega
Por padrão, o arquivo é retornado como conteúdo binário, pronto para ser removido para Criar arquivo (OneDrive, SharePoint, Blob) ou um anexo de email. Dois modos de entrega alternativos estão disponíveis em opções avançadas:
- Armazenamento em nuvem: forneça uma URL PUT pré-atribuída; O PolyDoc carrega o arquivo e a ação retorna JSON que contém a URL armazenada.
- Webhook: PolyDoc entrega o arquivo para o webhook e a ação retorna uma confirmação JSON (HTTP 202 quando assíncrona).
Quando um dos modos de entrega é usado, a resposta é JSON em vez de um arquivo binário.
Modo de área restrita
Cada operação tem uma entrada avançada no modo de área restrita. Defina-o para gerar a saída com marca d'água de uma cota separada com um limite de taxa mais baixo, o que é útil durante a true criação e teste de um fluxo. Deixe-o false para documentos de produção.
Limitações e problemas conhecidos
- A resposta de cada ação é declarada como um arquivo binário. Quando a entrega de armazenamento em nuvem ou webhook é configurada, a ação retorna JSON em vez de um arquivo.
- Páginas que carregam JavaScript de uma CDN externa podem diminuir significativamente o conversor. Para HTML embutido, prefira marcação autocontida (CSS embutido, imagens de URI de dados).
- As faturas eletrônicos seguem o EN 16931. No mínimo, forneça uma data de vencimento ou termos de pagamento (regra BR-CO-25), a ID do imposto do vendedor quando uma linha usa a categoria
Sde IVA e totais consistentes (líquido + imposto = bruto). Com o Verify habilitado, uma fatura que falha na validação retorna um erro.
Instruções de implementação
Esse conector é definido como um conector personalizado padrão do Power Platform (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Implante-o com a CLI dos Conectores do 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>
Você também pode importar apiDefinition.swagger.json diretamente do portal do criador de Power Automate (conectores personalizados > de dados>, novo conector > personalizado, importe um arquivo OpenAPI).
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Chave de API PolyDoc | securestring | Sua chave de API PolyDoc. Crie um em dashboard.polydoc.tech em Chaves de API. Cole apenas a chave; o conector adiciona o prefixo 'Portador' para você. | True |
Ações
| Captura de tela de captura |
Renderize HTML, uma URL ou um modelo salvo e capture uma captura de tela PNG, JPEG ou WebP. Retorna a imagem como conteúdo binário. |
| Converter em PDF |
Renderize HTML, uma URL ou um modelo salvo em um PDF. Preencha os campos da fatura E para inserir uma fatura híbrida do ZUGFeRD/Factur-X em vez de um PDF sem formatação. Retorna o arquivo como conteúdo binário. |
Captura de tela de captura
Renderize HTML, uma URL ou um modelo salvo e capture uma captura de tela PNG, JPEG ou WebP. Retorna a imagem como conteúdo binário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Modo de área restrita
|
X-Sandbox | string |
Execute a conversão no modo de área restrita. A saída da área restrita é marcada por água e extrai de uma cota separada com um limite de taxa mais baixo. Use false para documentos de produção. |
|
|
Fonte
|
source | True | string |
Uma URL (https://...), uma cadeia de caracteres HTML embutida ou uma referência de modelo salva no formulário [template:TEMPLATE_ID]. |
|
Nome do Arquivo
|
filename | string |
Nome do arquivo de saída, por exemplo, screenshot.png. |
|
|
Dados do modelo
|
templateData | object |
Dados de chave/valor passados para o renderizador de modelo Liquid quando a origem é uma referência [template:ID]. |
|
|
Tipo de imagem
|
type | string |
Formato de imagem. O padrão é png. |
|
|
Página inteira
|
fullPage | boolean |
Capture toda a página rolável. |
|
|
Quality
|
quality | integer |
Qualidade de compactação 0-100 para JPEG/WebP. |
|
|
Omitir plano de fundo
|
omitBackground | boolean |
Captura com uma tela de fundo transparente (PNG/WebP). |
|
|
Largura (px)
|
width | integer | ||
|
Altura (px)
|
height | integer | ||
|
Taxa de pixels do dispositivo
|
devicePixelRatio | number | ||
|
X
|
x | number | ||
|
Y
|
y | number | ||
|
Largura
|
width | number | ||
|
Altura
|
height | number | ||
|
Scale
|
scale | number | ||
|
Tag
|
tag | string |
Rótulo para registro em log e análise (no máximo 30 caracteres). |
|
|
Tempo limite (ms)
|
timeout | integer |
Tempo limite de conversão em milissegundos (máximo de 600000). |
|
|
Desabilitar o JavaScript
|
disableJavascript | boolean | ||
|
Injetar CSS
|
css | string |
CSS extra injetado na página. |
|
|
Injetar JavaScript
|
javascript | string |
JavaScript executado na página antes da captura. |
|
|
Aguardar o seletor
|
waitForSelector | string |
Aguarde até que este seletor CSS apareça. |
|
|
Aguardar a função
|
waitForFunction | string |
Aguarde até que essa expressão JS retorne true. |
|
|
Tipo de mídia
|
mediaType | string | ||
|
Bloquear anúncios
|
blockAds | boolean | ||
|
Agente do Usuário
|
userAgent | string | ||
|
Cabeçalhos HTTP
|
httpHeaders | object |
Cabeçalhos HTTP extras como pares chave/valor. |
|
|
Nome
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domínio
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Somente HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
MesmoSite
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nome de usuário
|
username | True | string | |
|
Senha
|
password | True | string | |
|
Webhook URL
|
url | True | string | |
|
Async
|
async | boolean |
Entregue em segundo plano e retorne 202 imediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Cabeçalhos extras para a solicitação de webhook. |
|
|
Tempo limite (ms)
|
timeout | number | ||
|
Repetições
|
retries | integer | ||
|
Atraso de repetição (ms)
|
retryDelay | number | ||
|
URL pré-atribuída
|
presignedUrl | True | string |
URL pré-atribuída HTTP PUT do seu provedor de armazenamento. |
Retornos
- response
- binary
Converter em PDF
Renderize HTML, uma URL ou um modelo salvo em um PDF. Preencha os campos da fatura E para inserir uma fatura híbrida do ZUGFeRD/Factur-X em vez de um PDF sem formatação. Retorna o arquivo como conteúdo binário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Modo de área restrita
|
X-Sandbox | string |
Execute a conversão no modo de área restrita. A saída da área restrita é marcada por água e extrai de uma cota separada com um limite de taxa mais baixo. Use false para documentos de produção. |
|
|
Fonte
|
source | True | string |
Uma URL (https://...), uma cadeia de caracteres HTML embutida ou uma referência de modelo salva no formulário [template:TEMPLATE_ID]. |
|
Nome do Arquivo
|
filename | string |
Nome do arquivo de saída, por exemplo, invoice.pdf. |
|
|
Dados do modelo
|
templateData | object |
Dados de chave/valor passados para o renderizador de modelo Liquid quando a origem é uma referência [template:ID]. |
|
|
Tag
|
tag | string |
Rótulo para registro em log e análise (no máximo 30 caracteres). |
|
|
Tempo limite (ms)
|
timeout | integer |
Tempo limite de conversão em milissegundos (máximo de 600000). |
|
|
Formato de papel
|
format | string |
Formato de papel. O padrão é A4. |
|
|
Paisagem
|
landscape | boolean |
Use a orientação paisagem. |
|
|
Imprimir plano de fundo
|
printBackground | boolean |
Imprima elementos gráficos e cores de plano de fundo. |
|
|
Scale
|
scale | number |
Escala de renderização, entre 0,1 e 2. |
|
|
Intervalos de páginas
|
pageRanges | string |
Páginas a serem incluídas, por exemplo, "1-5, 8". Vazio significa todas as páginas. |
|
|
Estrutura de tópicos (indicadores)
|
outline | boolean |
Gere indicadores PDF de títulos HTML. |
|
|
Marcado (acessível)
|
tagged | boolean |
Produza um PDF marcado (acessível). |
|
|
Preferir o tamanho da página do CSS
|
preferCSSPageSize | boolean |
Ateste o @page tamanho declarado no CSS no formato Papel. |
|
|
Omitir plano de fundo
|
omitBackground | boolean |
Renderize com um plano de fundo transparente. |
|
|
Exibir cabeçalho/rodapé
|
displayHeaderFooter | boolean |
Renderize os modelos de cabeçalho e rodapé. |
|
|
Modelo de cabeçalho
|
headerTemplate | string |
HTML para o cabeçalho da página. Requer cabeçalho/rodapé de exibição. |
|
|
Modelo de rodapé
|
footerTemplate | string |
HTML para o rodapé da página. Requer cabeçalho/rodapé de exibição. |
|
|
TOP
|
top | string | ||
|
Right
|
right | string | ||
|
Parte inferior
|
bottom | string | ||
|
Esquerda
|
left | string | ||
|
Title
|
title | string | ||
|
Autor
|
author | string | ||
|
Subject
|
subject | string | ||
|
Keywords
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Criador
|
creator | string | ||
|
Palavra-passe de utilizador
|
userPassword | string | ||
|
Senha do proprietário
|
ownerPassword | string | ||
|
Fonte
|
source | True | string |
Texto de marca d'água ou uma URL de imagem/URI de dados. |
|
Tipo
|
type | True | string | |
|
Opções
|
options | object |
Opções de fonte, opções de |
|
|
Level
|
level | True | string | |
|
Verificar a conformidade
|
verify | boolean | ||
|
Verificar a conformidade
|
verify | boolean |
Validar no veraPDF PDF/UA-1; retornará um erro se a validação falhar. |
|
|
Standard
|
standard | True | string |
Padrão de fatura híbrida. |
|
Profile
|
profile | True | string |
Perfil de granularidade de dados com o qual validar. |
|
Verificar a conformidade
|
verify | boolean |
Verificar a conformidade do PDF/A e da fatura eletrônico; retornará um erro se a validação falhar. |
|
|
Número da fatura
|
number | True | string | |
|
Data de emissão
|
issueDate | True | string |
Data do problema, YYYY-MM-DD. |
|
Data de conclusão
|
dueDate | string |
Data de conclusão, YYYY-MM-DD. Forneça esta ou as condições de pagamento (regra EN 16931 BR-CO-25). |
|
|
Moeda
|
currencyCode | True | string |
Código de moeda ISO 4217, por exemplo, EUR. |
|
Nome
|
name | True | string | |
|
Linha de endereço 1
|
line1 | True | string | |
|
Linha de endereço 2
|
line2 | string | ||
|
City
|
city | True | string | |
|
Código postal
|
postalCode | True | string | |
|
Código do país
|
countryCode | True | string |
Código de país alfa-2 ISO 3166-1, por exemplo, DE. |
|
Identificação fiscal
|
taxId | string |
Identificador de IVA. Necessário para o vendedor quando uma linha usa a categoria de IVA S. |
|
|
Email
|
string | |||
|
Telefone
|
phone | string | ||
|
Descrição
|
description | True | string | |
|
Quantidade
|
quantity | True | number | |
|
Código de unidade
|
unitCode | string |
Código da unidade UN/ECE, por exemplo, C62 (peça). |
|
|
Preço unitário
|
unitPrice | True | number | |
|
Total de linhas
|
lineTotal | True | number | |
|
Taxa de IVA (%)
|
vatRate | number | ||
|
Categoria de IVA
|
vatCategoryCode | string |
Código de categoria de IVA, por exemplo, S (padrão), Z (zero), E (isento). |
|
|
Código de categoria
|
categoryCode | True | string | |
|
Taxa (%)
|
rate | True | number | |
|
Valor tributável
|
taxableAmount | True | number | |
|
Valor do imposto
|
taxAmount | True | number | |
|
Condições de pagamento
|
paymentTerms | string |
Termos de pagamento de texto livre. Forneça esta data ou data de conclusão. |
|
|
Código de tipo
|
typeCode | True | string |
Pagamento UN/ECE 4461 significa código, por exemplo, 30 (transferência de crédito). |
|
IBAN
|
iban | string | ||
|
BIC
|
bic | string | ||
|
Nome da conta
|
accountName | string | ||
|
Referência de pagamento
|
paymentReference | string | ||
|
Rede total
|
totalNetAmount | True | number | |
|
Total do imposto
|
totalTaxAmount | True | number | |
|
Total bruto
|
totalGrossAmount | True | number |
Deve ser igual a líquido + imposto. |
|
Note
|
note | string | ||
|
Referência do comprador
|
buyerReference | string |
Referência/Leitweg-ID do comprador para faturas do setor público. |
|
|
Desabilitar o JavaScript
|
disableJavascript | boolean | ||
|
Injetar CSS
|
css | string |
CSS extra injetado na página. |
|
|
Injetar JavaScript
|
javascript | string |
JavaScript executado na página antes da captura. |
|
|
Aguardar o seletor
|
waitForSelector | string |
Aguarde até que este seletor CSS apareça. |
|
|
Aguardar a função
|
waitForFunction | string |
Aguarde até que essa expressão JS retorne true. |
|
|
Tipo de mídia
|
mediaType | string | ||
|
Bloquear anúncios
|
blockAds | boolean | ||
|
Agente do Usuário
|
userAgent | string | ||
|
Cabeçalhos HTTP
|
httpHeaders | object |
Cabeçalhos HTTP extras como pares chave/valor. |
|
|
Nome
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domínio
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Somente HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
MesmoSite
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nome de usuário
|
username | True | string | |
|
Senha
|
password | True | string | |
|
Webhook URL
|
url | True | string | |
|
Async
|
async | boolean |
Entregue em segundo plano e retorne 202 imediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Cabeçalhos extras para a solicitação de webhook. |
|
|
Tempo limite (ms)
|
timeout | number | ||
|
Repetições
|
retries | integer | ||
|
Atraso de repetição (ms)
|
retryDelay | number | ||
|
URL pré-atribuída
|
presignedUrl | True | string |
URL pré-atribuída HTTP PUT do seu provedor de armazenamento. |
Retornos
- response
- binary
Definições
binário
Esse é o tipo de dados básico 'binary'.