API d'étiquettes Amazon FBA pour backends vendeur et entrepôt
Générez des PDF d'étiquettes produit, carton et expédition de type Amazon FBA à partir de données vendeur ou entrepôt, avec codes-barres vectoriels et sortie par template.
/api/v1/pdf/render Générer des PDF d'étiquettes produit, carton ou expédition pour les workflows de préparation Amazon FBA, une fois que votre système vendeur, préparation ou entrepôt a déterminé les bons identifiants, payloads de codes-barres et règles d'étiquetage.
Quand utiliser cette API
- Votre système possède déjà les données FNSKU, carton, expédition ou étiquette du service de préparation.
- Vous avez besoin d'étiquettes avec codes-barres vectoriels en sortie PDF pour des postes d'impression vendeur ou entrepôt.
- Vous voulez transformer des mises en page répétées en contrats Template Render.
- Vous avez besoin de réimpressions déterministes pour la préparation, l'audit ou la gestion d'exceptions.
Ce qu'elle ne remplace pas
- Vous avez besoin d'une intégration Amazon officielle, d'une app ou d'un connecteur SP-API fourni par gPdf.
- Vous attendez d'Amazon qu'il certifie l'étiquette via gPdf.
- Vous avez besoin de gérer inventaire, listings ou plans d'expédition.
Quel endpoint appeler
/api/v1/pdf/render
JSON Render est le chemin par défaut pour ce workflow.
/api/v1/template-render
À utiliser si le workflow a besoin d'un chemin API lié, d'un contrat de modèle ou d'une recherche de capacités.
Requête minimale
POST /api/v1/pdf/render - étiquette produit avec payload de code-barres de type 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" }
}
]
}
]
}
Ce que gPdf prend en charge
- Rendu PDF au format étiquette à partir de payloads JSON Render.
- Codes-barres vectoriels, texte, blocs SKU, cadres et binding de template.
- Sortie d'étiquettes répétées via Template Render.
- Réponses PDF pour postes d'impression, outils vendeur ou workflows entrepôt.
Ce que votre système garde
- Intégration au compte Amazon, appels SP-API, données de plan d'expédition, valeurs FNSKU et règles marketplace.
- Payloads de codes-barres corrects, dimensions d'étiquette, données produit et acceptation au scan.
- UX vendeur, workflow de préparation, stockage et autorisation de réimpression.
Checklist de production
- Confirmer la marketplace active et les exigences de fulfillment avant le rendu.
- Valider les payloads de codes-barres et la qualité d'impression physique sur le stock d'étiquettes de production.
- Garder l'intégration Amazon et la gestion des identifiants hors de gPdf.
- Stocker les données source de l'étiquette afin que les réimpressions soient déterministes.
- Déplacer les mises en page approuvées vers Template Render pour les intégrations de postes d'impression.
Limites de la promesse
- gPdf n'est pas une app Amazon officielle ni un connecteur SP-API.
- gPdf génère les PDF ; la conformité Amazon et les règles du workflow vendeur restent sous votre responsabilité.
- Ne traitez pas le rendu PDF comme une certification d'étiquette Amazon.
Les étiquettes FBA sont des PDF pilotés par les données
Les workflows de préparation Amazon FBA ont souvent besoin d’étiquettes produit, carton ou expédition. Le problème de rendu est direct : votre système fournit les identifiants et règles d’étiquetage, puis gPdf génère le PDF.
Séparez l’intégration marketplace du rendu. Récupérez ou calculez les bons identifiants dans votre système vendeur ou entrepôt, puis appelez gPdf avec le payload final de l’étiquette.
Choix de l’endpoint
L’appel par défaut utilise /api/v1/pdf/render. Utilisez JSON Render tant que le layout évolue ou que l’appelant décrit toute la page. Une fois le layout approuvé, publiez-le comme template et envoyez seulement les données métier via Template Render.
Réservez E-Invoice Render aux paquets Factur-X / ZUGFeRD PDF/A-3b avec XML EN 16931 CII embarqué. Les PDF opérationnels, étiquettes, reçus et rapports ordinaires ne doivent pas être traités comme un flux de facture électronique.
Validation avant production
Validez API d’étiquettes Amazon FBA avec des données réelles et les systèmes qui consommeront le PDF. Conservez les request IDs, les sorties rendues et les preuves d’acceptation pour le support, l’audit et les réimpressions. gPdf rend le PDF ; les règles métier, le routage externe, la fiscalité, les transporteurs et la conformité marketplace restent dans votre système.
FAQ
- gPdf est-il une app Amazon FBA officielle ?
- Non. Un backend vendeur, préparation ou entrepôt peut appeler gPdf, mais gPdf ne revendique pas d'app Amazon officielle ni d'intégration SP-API.
- gPdf peut-il générer des étiquettes FNSKU ?
- gPdf peut générer des étiquettes PDF avec des éléments de code-barres. Votre système conserve la valeur FNSKU, les règles d'étiquette et le workflow Amazon.
- Les étiquettes FBA doivent-elles utiliser des templates ?
- Utilisez JSON Render pendant les tests de coordonnées. Utilisez Template Render une fois le design d'étiquette et le contrat de champs approuvés.
- gPdf certifie-t-il les étiquettes pour Amazon ?
- Non. La qualité d'impression, l'acceptation au scan et la conformité marketplace restent sous votre responsabilité.