API de etiquetas Amazon FBA para backends de vendedores y almacenes
Renderice PDF de etiquetas de producto, caja y envío al estilo Amazon FBA desde datos de vendedores o almacenes, con códigos de barras vectoriales y salida mediante plantillas.
/api/v1/pdf/render Renderizar PDF de etiquetas de producto, caja o envío para flujos de preparación Amazon FBA después de que su sistema de vendedor, preparación o almacén haya determinado los identificadores, datos de código de barras y reglas de etiqueta correctos.
Cuándo usar esta API
- Su sistema ya tiene datos de FNSKU, caja, envío o etiqueta del servicio de preparación.
- Necesita etiquetas con códigos de barras vectoriales como salida PDF para estaciones de impresión de vendedores o almacén.
- Quiere que los diseños de etiquetas repetidos se conviertan en contratos de Template Render.
- Necesita reimpresiones deterministas para preparación, auditoría o gestión de excepciones.
Qué no sustituye
- Necesita una integración oficial de Amazon, una app o un conector SP-API proporcionado por gPdf.
- Necesita que Amazon certifique la etiqueta a través de gPdf.
- Necesita gestión de inventario, listings o planes de envío.
Qué endpoint llamar
/api/v1/pdf/render
JSON Render es la ruta predeterminada para este flujo.
/api/v1/template-render
Úsalo cuando el flujo necesite la ruta API relacionada, un contrato de plantilla o una consulta de capacidades.
Solicitud mínima
POST /api/v1/pdf/render - etiqueta de producto con datos de código de barras 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" }
}
]
}
]
}
Qué gestiona gPdf
- Renderizado de PDF con tamaño de etiqueta desde datos de JSON Render.
- Códigos de barras vectoriales, texto, bloques SKU, cajas y vinculación con plantillas.
- Salida de etiquetas repetidas mediante Template Render.
- Respuestas PDF para estaciones de impresión, herramientas de vendedores o flujos de almacén.
Qué controla su sistema
- Integración con la cuenta de Amazon, llamadas SP-API, datos del plan de envío, valores FNSKU y reglas de marketplace.
- Corrección de los datos del código de barras, dimensiones de etiqueta, datos de producto y aceptación por escaneo.
- UX del vendedor, flujo de preparación, almacenamiento y autorización de reimpresión.
Checklist de producción
- Confirme el marketplace activo y los requisitos de fulfillment antes de renderizar.
- Valide los datos del código de barras y la calidad física de impresión en material de etiquetas de producción.
- Mantenga la integración con Amazon y el manejo de credenciales fuera de gPdf.
- Guarde los datos fuente de la etiqueta para que las reimpresiones sean deterministas.
- Mueva los diseños aprobados a Template Render para integraciones con estaciones de impresión.
Límites de la promesa
- gPdf no es una app oficial de Amazon ni un conector SP-API.
- gPdf renderiza PDF; el cumplimiento con Amazon y las reglas del flujo del vendedor siguen siendo su responsabilidad.
- No trate el renderizado PDF como certificación de etiquetas de Amazon.
Las etiquetas FBA son etiquetas PDF basadas en datos
Los flujos de preparación Amazon FBA suelen necesitar etiquetas de producto, caja o envío. El problema de renderizado es directo: su sistema aporta los identificadores y las reglas de etiqueta, y gPdf renderiza el PDF.
Mantenga la integración con el marketplace separada del renderizado. Obtenga o calcule los identificadores correctos en su sistema de vendedor o almacén y después llame a gPdf con los datos finales de etiqueta.
FAQ
- ¿gPdf es una app oficial de Amazon FBA?
- No. Un backend de vendedor, preparación o almacén puede llamar a gPdf, pero gPdf no afirma ser una app oficial de Amazon ni una integración SP-API.
- ¿gPdf puede renderizar etiquetas FNSKU?
- gPdf puede renderizar etiquetas PDF con elementos de código de barras. Su sistema conserva la responsabilidad sobre el valor FNSKU, las reglas de etiqueta y el flujo de Amazon.
- ¿Las etiquetas FBA deberían usar plantillas?
- Use JSON Render mientras prueba coordenadas. Use Template Render después de aprobar el diseño de etiqueta y el contrato de campos.
- ¿gPdf certifica etiquetas para Amazon?
- No. La calidad de impresión, la aceptación por escaneo y el cumplimiento con el marketplace siguen siendo su responsabilidad.