API de etiqueta SSCC para PDFs logísticos GS1
Renderize etiquetas com código de barras SSCC-18 em PDF para fluxos de logística, pallet, caixa e armazém, enquanto seu sistema controla a correção dos dados GS1.
/api/v1/pdf/render Renderizar etiquetas com código de barras SSCC-18 como saída PDF vetorial para pallets, caixas ou unidades logísticas depois que seu sistema atribuiu o serial shipping container code e verificou sua semântica GS1.
Quando usar esta API
- Seu sistema já controla o valor SSCC e quaisquer identificadores de aplicação relacionados.
- Você precisa de uma etiqueta PDF com código de barras SSCC escaneável e texto legível.
- Você precisa de layouts repetidos de etiqueta SSCC para estações de impressão de armazém ou 3PL.
- Você quer conectar etiquetas SSCC a fluxos mais amplos de etiquetas de pallet ou armazém.
O que ela não substitui
- Você precisa que o gPdf emita prefixo GS1, crie dígito verificador ou forneça certificação de compliance.
- Você precisa de gestão de estado de inventário ou envio.
- Você precisa comprar ou cotar etiqueta de transportadora.
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 - código de barras de etiqueta SSCC-18.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
O que a gPdf faz
- Renderização vetorial de código de barras SSCC dentro de páginas PDF.
- Layout de etiqueta com texto, caixas, texto do código de barras e vinculação opcional a modelo.
- Saída PDF para impressão, armazenamento ou fluxos de reimpressão em armazém.
- Envelope de erro compartilhado quando uma requisição falha na validação.
O que seu sistema controla
- Prefixo de empresa GS1, dígito de extensão, referência serial, dígito verificador e dados codificados.
- Regras do processo de armazém, aceite por scanner e validação da mídia da etiqueta.
- Qualquer fluxo EDI, ASN, transportadora ou parceiro comercial que consuma o SSCC.
Checklist de produção
- Valide o valor SSCC e o dígito verificador antes de chamar o gPdf.
- Escaneie a saída com scanners de produção e mídia real de etiqueta.
- Documente quais eventos de armazém criam e reimprimem etiquetas SSCC.
- Use Template Render para layouts aprovados de etiqueta SSCC.
- Mantenha verificações de compliance de parceiros comerciais fora da chamada de renderização.
Limites da promessa
- O gPdf renderiza o código de barras SSCC como PDF; ele não emite nem certifica valores SSCC.
- Compliance GS1 e de parceiros comerciais continua sob sua responsabilidade.
- Etiquetas SSCC não implicam criação de envio de transportadora.
Etiquetas SSCC são um fluxo focado de código de barras
Etiquetas SSCC são mais específicas que etiquetas gerais de pallet. O fato importante é o próprio serial shipping container code. O gPdf renderiza o código em um PDF; seu sistema controla atribuição do código, regras GS1 e requisitos de parceiros comerciais.
FAQ
- O gPdf pode criar um número SSCC?
- Não. Seu sistema cria e valida o valor SSCC. O gPdf o renderiza como código de barras em um PDF.
- Qual formato de código de barras devo usar?
- Use um alias SSCC suportado, como sscc-18, ao renderizar um elemento de código de barras SSCC.
- Isso pode ser um modelo?
- Sim. A maioria das etiquetas SSCC deve migrar para Template Render depois que o layout e o mapeamento de campos forem aprovados.
- Isso certifica compliance GS1?
- Não. O gPdf renderiza saída de código de barras vetorial. Compliance e aceite por scanner são responsabilidades separadas.