API de packing slips em PDF para sistemas de produção
Gere packing slips em PDF a partir de dados estruturados do backend, sem navegador, com fronteira clara entre o PDF renderizado pela gPdf e as regras do seu sistema.
/api/v1/template-render Gerar packing slips em PDF como PDF reproduzível a partir de dados estruturados. Seu sistema mantém a lógica de negócio; a gPdf cuida do rendering PDF.
Quando usar esta API
- Seu backend já possui os dados de packing slips em PDF e precisa de uma resposta PDF estável.
- Você quer evitar Chromium ou HTML-to-PDF em documentos operacionais.
- Você precisa de saída repetível para reimpressão, auditoria ou lotes.
O que ela não substitui
- Você precisa que a gPdf compre frete, liquide impostos, crie pedidos externos ou atue como sistema fiscal.
- Você precisa substituir validação de dados, regras de negócio ou integrações com marketplaces.
Qual endpoint chamar
/api/v1/template-render
Template Render é o caminho padrão para este fluxo.
/api/v1/pdf/render
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
/api/v1/template-render - packing slips em PDF
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
O que a gPdf faz
- Rendering PDF de packing slips em PDF a partir de requests estruturados.
- Texto, tabelas, linhas, códigos de barras, páginas, metadados e opções de saída conforme o request.
- Saída determinística para retries, reimpressões e auditoria.
O que seu sistema controla
- Dados corretos de packing slips em PDF, regras de negócio e estado operacional.
- Autenticação, persistência, integrações externas e validação com receptores finais.
Checklist de produção
- Teste com dados reais e com os sistemas que receberão o PDF.
- Armazene request IDs e evidências para suporte, auditoria e reimpressão.
- Promova o layout aprovado para template quando vários sistemas forem reutilizá-lo.
Limites da promessa
- A gPdf renderiza PDFs operacionais; não é conector oficial de marketplace nem OMS.
- Seu sistema mantém pedidos, fulfillment, chamadas marketplace e regras de cliente.
Formato da API
API de packing slips em PDF é um workflow de produção sobre as APIs públicas da gPdf. O request descreve dados, layout, settings e partes do PDF que devem ser renderizadas. A gPdf renderiza o PDF; seu sistema mantém a semântica do evento de negócio.
Escolha do endpoint
Para este fluxo, o endpoint padrão é /api/v1/template-render. Use Template Render quando o layout estiver aprovado e reutilizado entre sistemas. Use E-Invoice Render apenas quando precisar do pacote Factur-X / ZUGFeRD PDF/A-3b com EN 16931 CII XML incorporado.
Validação antes da produção
Valide packing slips em PDF com dados reais e com os sistemas que vão consumi-lo. Guarde request IDs, saída renderizada e evidências de validação para suporte, auditoria e reimpressão.
FAQ
- É um endpoint separado?
- API de packing slips em PDF mapeia o fluxo para uma API pública da gPdf. A página mostra qual caminho chamar e o que o request deve fornecer.
- Posso usar templates?
- Sim. Use JSON Render enquanto o layout muda; use Template Render quando o layout estiver aprovado e os callers enviarem apenas dados de negócio.
- O que validar antes da produção?
- Valide com dados reais e com impressoras, scanners, validadores, sistemas contábeis ou marketplaces do fluxo.