PolyDoc (Independent Publisher) (Pré-visualização)
Converta HTML ou um URL em PDFs e capturas de ecrã perfeitos em pixel, e gere faturas eletrónicas híbridas compatíveis com a UE (ZUGFeRD / Factur-X). O PolyDoc renderiza com um motor de navegador real, por isso o que vês na página é o que tens no documento.
Este conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - 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 (CCG) - 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 Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Entrar em contato | |
|---|---|
| Designação | PolyDoc |
| URL | https://polydoc.tech |
| hello@polydoc.tech |
| Metadados do conector | |
|---|---|
| Editor | Blue-D3V |
| Sítio Web | https://polydoc.tech |
| Política de privacidade | https://polydoc.tech/legal/privacy-policy/ |
| Categorias | Conteúdo e Ficheiros |
PolyDoc
O PolyDoc transforma HTML ou um URL em PDFs e capturas de ecrã perfeitos em pixel, e gera e-faturas híbridas compatíveis com a UE (ZUGFeRD / Factur-X). As conversões são renderizadas num motor de navegador real, por isso o que vês na página é o que tens no documento.
Editor
PolyDoc
Pré-requisitos
Precisas de uma conta PolyDoc e de uma chave API. O nível gratuito é suficiente para avaliar o conector. Conectores personalizados são uma funcionalidade premium do Power Automate, pelo que os fluxos que utilizam este conector precisam de um plano Power Automate Premium (por utilizador ou por fluxo), tal como a ação HTTP incorporada.
Obtenção de credenciais
- Inicia sessão no dashboard.polydoc.tech.
- Abra as Chaves API e crie uma chave.
- Quando criares a ligação, cola a chave na chave da API do PolyDoc. Cola apenas a chave; o conector adiciona o
Bearerprefixo para ti.
Operações suportadas
| Operation | O que faz |
|---|---|
| Converter para PDF | Renderize HTML, uma URL ou um modelo guardado num PDF. Controlos para formato de página, margens, escala, cabeçalhos/rodapés, favoritos, PDFs acessíveis (etiquetados), metadados, encriptação, marcas de água e PDF/A. |
| Captura de ecrã | Capture um PNG, JPEG ou WebP de HTML, uma URL ou um modelo. Página inteira ou recortada, com controlo da janela de visualização e da proporção de píxeis do dispositivo. |
As e-faturas são produzidas com Converter para PDF: preenchem os campos da E-fatura (padrão, perfil e o objeto estruturado invoice ) e o PolyDoc incorpora uma fatura ZUGFeRD / Factur-X no PDF devolvido. Consulte a example-flows/ pasta no repositório de conectores para um corpo pronto a usar.
Fonte
Cada operação requer uma única Fonte que é uma de:
- uma URL, por exemplo,
https://example.com - uma cadeia HTML inline
- uma referência de modelo guardada,
[template:TEMPLATE_ID], opcionalmente com dados de Template para o renderizador Liquid
Entrega
Por defeito, o ficheiro é devolvido como conteúdo binário, pronto para ser colocado no Create file (OneDrive, SharePoint, Blob) ou num anexo de email. Estão disponíveis dois modos alternativos de entrega em opções avançadas:
- Armazenamento na nuvem: fornece um URL PUT pré-assinado; O PolyDoc carrega o ficheiro e a ação devolve JSON contendo a URL armazenada.
- Webhook: O PolyDoc entrega o ficheiro ao seu webhook e a ação devolve um confirmante JSON (HTTP 202 quando assíncrono).
Quando qualquer um dos modos de entrega é utilizado, a resposta é JSON em vez de um ficheiro binário.
Modo sandbox
Cada operação tem uma entrada avançada em modo Sandbox . Defina-o para true gerar saída com marca de água a partir de uma quota separada com um limite de taxa mais baixo, o que é útil ao construir e testar um fluxo. Deixe para false documentos de produção.
Problemas e limitações conhecidos
- A resposta de cada ação é declarada como um ficheiro binário. Quando o armazenamento na cloud ou a entrega Webhook são configurados, a ação devolve JSON em vez de um ficheiro.
- Páginas que carregam JavaScript a partir de uma CDN externa podem atrasar significativamente o conversor. Para HTML inline, prefira marcação autónoma (CSS inline, imagens data-URI).
- As e-faturas seguem a EN 16931. No mínimo, forneça uma data de vencimento ou termos de pagamento (regra BR-CO-25), o ID fiscal do vendedor quando uma linha utiliza a categoria
SIVA e totais consistentes (líquido + imposto = bruto). Com o Verify ativado, uma fatura que falha na validação devolve um erro.
Instruções de implantação
Este conector é definido como um conector personalizado padrão da Power Platform (apiDefinition.swagger.jsonicon.png + apiProperties.json + ). Implemente-o com a CLI 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>
Também pode importar apiDefinition.swagger.json diretamente do portal maker do Power Automate (Dados > Conectores personalizados Novos > conectores > personalizados Importar um ficheiro OpenAPI).
A criar uma ligação
O conector suporta os 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.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Designação | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| Chave API do PolyDoc | securestring | A tua chave da API PolyDoc. Cria um à dashboard.polydoc.tech em Chaves API. Cola apenas a chave; o conector adiciona o prefixo 'Bearer' para ti. | Verdade |
Ações
| Captura de ecrã |
Renderize HTML, uma URL ou um modelo guardado e capture uma captura de ecrã PNG, JPEG ou WebP. Devolve a imagem como conteúdo binário. |
| Converter em PDF |
Renderize HTML, uma URL ou um modelo guardado num PDF. Preenche os campos da fatura eletrónica para incorporar uma fatura híbrida ZUGFeRD / Factur-X em vez de um PDF simples. Devolve o ficheiro como conteúdo binário. |
Captura de ecrã
Renderize HTML, uma URL ou um modelo guardado e capture uma captura de ecrã PNG, JPEG ou WebP. Devolve a imagem como conteúdo binário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Modo sandbox
|
X-Sandbox | string |
Executa a conversão em modo sandbox. A produção sandbox é marcada por watermark e retirada de uma quota separada com um limite tarifário mais baixo. Use falso para documentos de produção. |
|
|
Fonte
|
source | True | string |
Uma URL (https://...), uma cadeia HTML inline ou uma referência de modelo guardada no formulário [template:TEMPLATE_ID]. |
|
Nome do ficheiro
|
filename | string |
Nome de ficheiro de saída, por exemplo, screenshot.png. |
|
|
Dados do modelo
|
templateData | object |
Dados chave/valor passados para o renderizador Liquid template quando Source é uma referência [template:ID]. |
|
|
Tipo de imagem
|
type | string |
Formato da imagem. Por defeito, é o png. |
|
|
Página inteira
|
fullPage | boolean |
Captura toda a página deslizável. |
|
|
Quality
|
quality | integer |
Qualidade de compressão 0-100 para JPEG/WebP. |
|
|
Omitir contexto
|
omitBackground | boolean |
Captura com um fundo transparente (PNG/WebP). |
|
|
Largura (px)
|
width | integer | ||
|
Altura (px)
|
height | integer | ||
|
Razão de píxeis 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 registo e análises (máximo 30 caracteres). |
|
|
Timeout (ms)
|
timeout | integer |
Tempo de conversão em milissegundos (máximo 600000). |
|
|
Desativar 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. |
|
|
Aguarde o seletor
|
waitForSelector | string |
Espera até aparecer este seletor de CSS. |
|
|
Esperar pela função
|
waitForFunction | string |
Espera até que esta expressão JS volte a ser verdadeira. |
|
|
Tipo de multimédia
|
mediaType | string | ||
|
Bloquear anúncios
|
blockAds | boolean | ||
|
Agente de usuário
|
userAgent | string | ||
|
Cabeçalhos de HTTP
|
httpHeaders | object |
Cabeçalhos HTTP extra como pares chave/valor. |
|
|
Designação
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Apenas HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
SameSite
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nome de utilizador
|
username | True | string | |
|
Password
|
password | True | string | |
|
Webhook URL
|
url | True | string | |
|
Assíncrono
|
async | boolean |
Entrega em segundo plano e devolve o 202 imediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Cabeçalhos extra para o pedido de webhook. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Reintentos
|
retries | integer | ||
|
Atraso de retentativa (ms)
|
retryDelay | number | ||
|
URL pré-assinado
|
presignedUrl | True | string |
URL HTTP PUT pré-assinado do seu fornecedor de armazenamento. |
Devoluções
- response
- binary
Converter em PDF
Renderize HTML, uma URL ou um modelo guardado num PDF. Preenche os campos da fatura eletrónica para incorporar uma fatura híbrida ZUGFeRD / Factur-X em vez de um PDF simples. Devolve o ficheiro como conteúdo binário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
Modo sandbox
|
X-Sandbox | string |
Executa a conversão em modo sandbox. A produção sandbox é marcada por watermark e retirada de uma quota separada com um limite tarifário mais baixo. Use falso para documentos de produção. |
|
|
Fonte
|
source | True | string |
Uma URL (https://...), uma cadeia HTML inline ou uma referência de modelo guardada no formulário [template:TEMPLATE_ID]. |
|
Nome do ficheiro
|
filename | string |
Nome de ficheiro de saída, por exemplo, invoice.pdf. |
|
|
Dados do modelo
|
templateData | object |
Dados chave/valor passados para o renderizador Liquid template quando Source é uma referência [template:ID]. |
|
|
Tag
|
tag | string |
Rótulo para registo e análises (máximo 30 caracteres). |
|
|
Timeout (ms)
|
timeout | integer |
Tempo de conversão em milissegundos (máximo 600000). |
|
|
Formato em papel
|
format | string |
Formato em papel. Por defeito é A4. |
|
|
Paisagem
|
landscape | boolean |
Use a orientação horizontal. |
|
|
Contexto impresso
|
printBackground | boolean |
Imprimir gráficos de fundo e cores. |
|
|
Scale
|
scale | number |
Escala de renderização, entre 0.1 e 2. |
|
|
Intervalos de páginas
|
pageRanges | string |
Páginas a incluir, por exemplo, "1-5, 8". Vazio significa todas as páginas. |
|
|
Esboço (favoritos)
|
outline | boolean |
Gerar marcadores PDF a partir de títulos HTML. |
|
|
Etiquetado (acessível)
|
tagged | boolean |
Produza um PDF etiquetado (acessível). |
|
|
Prefiro o tamanho da página CSS
|
preferCSSPageSize | boolean |
Respeite o @page tamanho declarado em CSS em vez do formato Paper. |
|
|
Omitir contexto
|
omitBackground | boolean |
Renderize com um fundo transparente. |
|
|
Cabeçalho/rodapé de exibição
|
displayHeaderFooter | boolean |
Renderize os templates de cabeçalho e rodapés. |
|
|
Modelo de cabeçalho
|
headerTemplate | string |
HTML para o cabeçalho da página. Requer cabeçalho/rodapé de visualização. |
|
|
Modelo de rodapé
|
footerTemplate | string |
HTML para o rodapé da página. Requer cabeçalho/rodapé de visualização. |
|
|
Início
|
top | string | ||
|
Certo
|
right | string | ||
|
Parte inferior
|
bottom | string | ||
|
Esquerda
|
left | string | ||
|
Title
|
title | string | ||
|
Author
|
author | string | ||
|
Assunto
|
subject | string | ||
|
Palavras-chave
|
keywords | array of string | ||
|
Producer
|
producer | string | ||
|
Criador
|
creator | string | ||
|
Palavra-passe de utilizador
|
userPassword | string | ||
|
Palavra-passe do proprietário
|
ownerPassword | string | ||
|
Fonte
|
source | True | string |
Marca de água no texto, ou uma URL de imagem / URI de dados. |
|
Tipo
|
type | True | string | |
|
Opções
|
options | object |
Opções de fonte, opacidade, rotação, escala, repetição e deslocamento. |
|
|
Nível
|
level | True | string | |
|
Verificar conformidade
|
verify | boolean | ||
|
Verificar conformidade
|
verify | boolean |
Validar contra veraPDF PDF/UA-1; devolve um erro se a validação falhar. |
|
|
Standard
|
standard | True | string |
Padrão de fatura híbrida. |
|
Profile
|
profile | True | string |
Perfil de granularidade dos dados para validar. |
|
Verificar conformidade
|
verify | boolean |
Verificar a conformidade com PDF/A e fatura eletrónica; devolve um erro se a validação falhar. |
|
|
Número da fatura
|
number | True | string | |
|
Data de emissão
|
issueDate | True | string |
Data de emissão, YYYY-MM-DD. |
|
Data limite
|
dueDate | string |
Data de parto, YYYY-MM-DD. Forneça este ou termos de pagamento (regra EN 16931 BR-CO-25). |
|
|
Moeda
|
currencyCode | True | string |
Código de moeda ISO 4217, por exemplo, EUR. |
|
Designação
|
name | True | string | |
|
Linha 1 do endereço
|
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. |
|
CNPJ
|
taxId | string |
Identificador de IVA. Exigido para o vendedor quando uma linha utiliza IVA categoria S. |
|
|
Email
|
string | |||
|
Telemóvel
|
phone | string | ||
|
Descrição
|
description | True | string | |
|
Quantidade
|
quantity | True | number | |
|
Código de unidade
|
unitCode | string |
Código de 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 | |
|
Montante tributável
|
taxableAmount | True | number | |
|
Montante do imposto
|
taxAmount | True | number | |
|
Termos de pagamento
|
paymentTerms | string |
Condições de pagamento em texto livre. Indique esta data ou data de vencimento. |
|
|
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 | ||
|
Líquido líquido total
|
totalNetAmount | True | number | |
|
Total do imposto
|
totalTaxAmount | True | number | |
|
Bruto total
|
totalGrossAmount | True | number |
Deve ser igual líquido + imposto. |
|
Observação
|
note | string | ||
|
Referência do comprador
|
buyerReference | string |
Referência do comprador / Leitweg-ID para faturas do setor público. |
|
|
Desativar 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. |
|
|
Aguarde o seletor
|
waitForSelector | string |
Espera até aparecer este seletor de CSS. |
|
|
Esperar pela função
|
waitForFunction | string |
Espera até que esta expressão JS volte a ser verdadeira. |
|
|
Tipo de multimédia
|
mediaType | string | ||
|
Bloquear anúncios
|
blockAds | boolean | ||
|
Agente de usuário
|
userAgent | string | ||
|
Cabeçalhos de HTTP
|
httpHeaders | object |
Cabeçalhos HTTP extra como pares chave/valor. |
|
|
Designação
|
name | True | string | |
|
Valor
|
value | True | string | |
|
URL
|
url | string | ||
|
Domain
|
domain | string | ||
|
Path
|
path | string | ||
|
Expira (época)
|
expires | number | ||
|
Apenas HTTP
|
httpOnly | boolean | ||
|
Secure
|
secure | boolean | ||
|
SameSite
|
sameSite | string | ||
|
Tipo
|
type | string | ||
|
Nome de utilizador
|
username | True | string | |
|
Password
|
password | True | string | |
|
Webhook URL
|
url | True | string | |
|
Assíncrono
|
async | boolean |
Entrega em segundo plano e devolve o 202 imediatamente. |
|
|
Método
|
method | string | ||
|
Headers
|
headers | object |
Cabeçalhos extra para o pedido de webhook. |
|
|
Timeout (ms)
|
timeout | number | ||
|
Reintentos
|
retries | integer | ||
|
Atraso de retentativa (ms)
|
retryDelay | number | ||
|
URL pré-assinado
|
presignedUrl | True | string |
URL HTTP PUT pré-assinado do seu fornecedor de armazenamento. |
Devoluções
- response
- binary
Definições
binário
Este é o tipo de dados básico 'binário'.