API de etiqueta Amazon FBA para backends de vendedores e armazéns
Renderize PDFs de etiquetas no estilo Amazon FBA para produto, caixa e envio a partir de dados de vendedor ou armazém, com códigos de barras vetoriais e saída por modelo.
/api/v1/pdf/render Renderizar PDFs de etiquetas de produto, caixa ou envio para fluxos de preparação Amazon FBA depois que seu sistema de vendedor, preparação ou armazém determinou os identificadores corretos, os dados dos códigos de barras e as regras de etiqueta.
Quando usar esta API
- Seu sistema já tem dados de FNSKU, caixa, envio ou etiqueta do serviço de preparação.
- Você precisa de etiquetas com código de barras vetorial como saída em PDF para estações de impressão de vendedor ou armazém.
- Você quer que layouts de etiqueta repetidos se tornem contratos Template Render.
- Você precisa de reimpressões determinísticas para preparação, auditoria ou tratamento de exceções.
O que ela não substitui
- Você precisa de uma integração oficial Amazon, app ou conector SP-API fornecido pelo gPdf.
- Você precisa que a Amazon certifique a etiqueta por meio do gPdf.
- Você precisa de gestão de inventário, listagens ou plano de envio.
Qual endpoint chamar
/api/v1/pdf/render
JSON Render é o caminho padrão para este fluxo.
/api/v1/template-render
Use quando o fluxo precisar da API relacionada, de um contrato de template ou de uma consulta de capacidades.
Request mínimo
POST /api/v1/pdf/render - etiqueta de produto com dados de código de barras no estilo FNSKU.
{
"pages": [
{
"width": 70,
"height": 35,
"elements": [
{
"type": "text",
"x": 4,
"y": 4,
"content": "FNSKU X00ABC1234",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "X00ABC1234",
"x": 4,
"y": 12,
"width": 60,
"height": 12,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 4,
"y": 29,
"content": "SKU: ACME-FILTER-01",
"style": { "font_size": 6, "font_family": "NotoSans-Regular" }
}
]
}
]
}
O que a gPdf faz
- Renderização de PDF em tamanho de etiqueta a partir de corpos de requisição JSON Render.
- Códigos de barras vetoriais, texto, blocos de SKU, caixas e vinculação a modelo.
- Saída repetida de etiquetas por Template Render.
- Respostas em PDF para estações de impressão, ferramentas de vendedor ou fluxos de armazém.
O que seu sistema controla
- Integração com conta Amazon, chamadas SP-API, dados de plano de envio, valores FNSKU e regras de marketplace.
- Dados corretos para códigos de barras, dimensões de etiqueta, dados de produto e aceite de leitura.
- Experiência do vendedor, fluxo de preparação, armazenamento e autorização de reimpressão.
Checklist de produção
- Confirme o marketplace ativo e os requisitos de fulfillment antes de renderizar.
- Valide dados de código de barras e qualidade física de impressão na mídia de produção.
- Mantenha integração Amazon e tratamento de credenciais fora do gPdf.
- Armazene os dados de origem da etiqueta para que reimpressões sejam determinísticas.
- Migre layouts aprovados para Template Render em integrações de estações de impressão.
Limites da promessa
- O gPdf não é um app oficial da Amazon nem um conector SP-API.
- O gPdf renderiza PDFs; regras de compliance da Amazon e de fluxo do vendedor continuam sob sua responsabilidade.
- Não trate renderização de PDF como certificação de etiqueta pela Amazon.
Etiquetas FBA são etiquetas PDF orientadas por dados
Fluxos de preparação Amazon FBA muitas vezes precisam de etiquetas de produto, caixa ou envio. O problema de renderização é direto: seu sistema fornece os identificadores e as regras de etiqueta, e o gPdf renderiza o PDF.
Mantenha a integração com o marketplace separada da renderização. Busque ou calcule os identificadores corretos no seu sistema de vendedor ou armazém e só então chame o gPdf com os dados finais da etiqueta.
FAQ
- O gPdf é um app oficial Amazon FBA?
- Não. Um backend de vendedor, preparação ou armazém pode chamar o gPdf, mas o gPdf não declara ser um app oficial da Amazon nem uma integração SP-API.
- O gPdf pode renderizar etiquetas FNSKU?
- O gPdf pode renderizar etiquetas PDF com elementos de código de barras. Seu sistema controla o valor FNSKU, as regras de etiqueta e o fluxo Amazon.
- Etiquetas FBA devem usar modelos?
- Use JSON Render enquanto testa coordenadas. Use Template Render depois que o design da etiqueta e o contrato de campos forem aprovados.
- O gPdf certifica etiquetas para a Amazon?
- Não. Qualidade de impressão, aceite de leitura e compliance de marketplace continuam sob sua responsabilidade.