Faturas e documentos PDF

Gerar faturas e PDFs de um modelo

Transforme dados estruturados em faturas, recibos e relatórios perfeitos — itens de linha, totais e marca renderizados no servidor, sempre, sem necessidade de manter um navegador headless.

Leia a documentação
100 renders/mês grátis · sem cartão · planos pagos nunca são bloqueados
Northwind Co.INVOICE #2049
Design retainer$1,200
Render credits$340
Support$160
Total due$1,700.00
Um único modelo, renderizado a partir de seus dados

Como funciona

1

Estruture o documento

Defina o cabeçalho, a tabela de itens de linha e os totais como um modelo com linhas repetíveis.

2

Envie os itens de linha

Envie o cliente, itens e valores como JSON — o mecanismo lida com paginação e layout.

3

Receba um PDF

Receba um PDF pronto para impressão em segundos, em cache e pronto para anexar, armazenar ou fazer download.

Uma chamada de API

curl https://api.mostlyrender.com/v1/renders \
  -H "Authorization: Bearer mr_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"tpl_invoice","modifications":{"customer":"Northwind Co.","number":"2049","total":"$1,700.00"}}'

Perguntas

Por que não executar Puppeteer por conta própria para PDFs?

Você pode — até estar mantendo fontes, uma farm de navegadores, tentativas e uma fila. MostlyRender é esse pipeline como uma API, com latência previsível e um cache para que o mesmo documento não seja renderizado duas vezes.

Os documentos de várias páginas funcionam?

Sim. Adicione merge: true a uma solicitação em lote e cada item é renderizado como uma página e mesclado em um PDF de várias páginas — o caminho para faturas, extratos e relatórios longos.

Como faço para enviar os dados da fatura?

Como JSON. POST o id do modelo e um objeto de modificações com chave pelo nome da camada — cliente, número da fatura, totais e assim por diante — e a resposta contém a URL do PDF.

Posso renderizar faturas de forma assíncrona?

Sim. Adicione async: true (ou um webhookUrl) e você recebe um id de trabalho imediatamente com um 202; chamamos seu webhook com uma carga assinada quando o PDF estiver pronto, ou você pode consultar o trabalho.

O PDF é vetorial ou uma imagem?

Vetorial. A saída em PDF mantém o texto e as linhas nítidas em qualquer zoom e imprime perfeitamente, por isso faturas e extratos geralmente saem como PDF em vez de PNG.

Quanto custa gerar faturas em volume?

Uma fatura de uma página é um render, e um PDF de várias páginas mesclado é medido por página. Starter inclui 2.000 por mês por $19, Pro 10.000 por $49 e Scale 50.000 por $149; além disso, o excesso é cobrado a $3–$5 por 1.000 e rendering nunca para em um plano pago.

Os PDFs são armazenados para mim?

Sim, por um tempo: os arquivos renderizados são retidos por 30 dias no Free e 90 dias em planos pagos. Trate nossa URL como o link de entrega e mantenha sua própria cópia para seus registros.