Un guide pratique, spécifique à l’Indonésie, pour transformer vos journaux WPP, enregistrements STELINA/MDPI et documents d’usine en fichiers EPCIS 2.0 conformes à GDST 1.1. Comprend la cartographie WPP→FAO, les options d’identifiants de navire, le flux CSV→JSON et des exemples d’événements.
Si votre acheteur vient de demander GDST 1.1, vous n’avez pas besoin d’acheter un logiciel demain. Vous pouvez être prêt pour l’acheteur avec les documents que vous conservez déjà en Indonésie : zones WPP-NRI, journaux de voyage, notes d’atterrissage, documents BKIPM et fiches de production d’usine. Nous avons livré des fichiers GDST pour le thon, le vivaneau, la crevette et des espèces de récif mixtes de cette façon. Voici exactement comment nous le cartographions.
Les trois piliers d’un fichier GDST prêt pour l’acheteur
-
Des identités de source sur lesquelles vous pouvez vous appuyer. Utilisez des identifiants de navire que vos équipages portent réellement et qui figurent sur les licences. Utilisez des identifiants de récolte d’élevage que l’on peut retrouver sur papier. N’inventez pas d’identifiants qui n’apparaissent jamais dans vos documents.
-
Une logique de lot propre. Décidez comment vous suivez les lots à la réception et lors du parage/conditionnement. Si vous ne pouvez pas expliquer une scission/fusion sur papier, elle ne validera pas dans EPCIS.
-
Un empaquetage EPCIS approprié. Les acheteurs demandent de plus en plus de l’EPCIS 2.0 en JSON-LD. Vous pouvez commencer dans Excel, mais concevez vos colonnes pour qu’elles se convertissent 1:1 en événements plus tard.
Conclusion pratique : avant de toucher au JSON, confirmez votre définition de lot et quel document prouve chaque KDE. Ensuite, vous aurez fait 80 % du chemin.
Quels sont les KDEs minimaux que les acheteurs demandent réellement ?
Nous observons deux scénarios courants en Indonésie.
-
Poissons capturés en milieu sauvage : thon, vivaneau, espèces de récif
- Espèce (nom scientifique + nom commun), méthode de production = capture en milieu sauvage
- Zone de capture en code FAO, type d’engin
- Identifiant du navire et État pavillon. Dates de début/fin de voyage
- Date et port d’atterrissage. En cas de transbordement, le navire transporteur et la date
- Code de lot/lot du transformateur, date de production, quantité et UoM
- Identifiant de l’établissement (GLN si vous l’avez, ou numéro d’agrément de l’usine)
- Références de certificats/autorisation (le cas échéant)
-
Crevette vannamei d’élevage
- Espèce, méthode de production = aquaculture
- Identifiant du site de la ferme (étang/cluster), date de récolte, emplacement (province/coordonnées si disponibles)
- Identifiants d’écloserie et de fournisseur d’aliments si le client les demande
- Code de lot/lot du transformateur, date de production, quantité
- Identifiant de l’établissement
Si votre acheteur est strict sur GDST, ajoutez : identifiants uniques pour chaque événement, fuseau horaire, étape commerciale (businessStep) et readPoint (le lieu où cela s’est produit). Nous avons constaté que lorsque ces éléments sont présents, même les acheteurs exigeants avancent rapidement.
Cartographie WPP-NRI vers FAO acceptée par les acheteurs
Vous enregistrez WPP-NRI. Les acheteurs veulent FAO. Voici une cartographie simple et largement acceptée utilisée dans les fichiers GDST indonésiens :
- WPP 571, 572, 573 → FAO 57 (océan Indien, Est)
- WPP 711, 712, 713, 714, 715, 716, 717 → FAO 71 (Pacifique, centre-ouest)
- WPP 718 → Souvent mixte. Les mers de Timor/Sawu sont typiquement FAO 57. L’Arafura est typiquement FAO 71. Si vous n’avez pas de coordonnées, de nombreux acheteurs acceptent d’indiquer à la fois FAO 57 et 71 avec une note.
Deux conseils non évidents :
- Si votre note d’atterrissage contient des coordonnées ou un banc nommé, incluez-les. Les cas ambigus de WPP 718 se résolvent rapidement lorsque vous ajoutez lat/long.
- Conservez le WPP original dans un champ « notes ». Les auditeurs aiment voir votre référence native.
Besoin d’une vérification rapide de votre cartographie pour une pêcherie spécifique ? Vous pouvez nous contacter sur WhatsApp.
Nos navires n’ont pas de numéros IMO. Quels identifiants sont acceptables ?
En pratique, les petites embarcations de jour indonésiennes n’ont que rarement un IMO. GDST 1.1 autorise plusieurs types d’identifiants :
- Numéro d’immatriculation national ou numéro de licence (p. ex. issu des documents MMAF)
- Indicatif d’appel radio (IRCS) ou MMSI si disponible
- UVI (Unique Vessel Identifier) si attribué via un programme ou un registre
- CFR pour les navires battant pavillon de l’UE (rare dans les flottilles côtières indonésiennes)
Notre règle : choisissez l’identifiant qui figure sur votre note d’atterrissage ou votre licence et qui reste stable d’une année à l’autre. Pour les petits bateaux dans les FIP gérés par MDPI, utilisez le code de navire employé dans le programme et liez-le à votre licence papier dans les notes.
Pouvons‑nous démarrer dans Excel/CSV et basculer vers EPCIS plus tard ?
Oui. Nous le recommandons. Concevez une feuille de calcul qui reflète les événements EPCIS afin que la conversion soit mécanique.
Colonnes minimales qui se convertissent proprement :
- eventType, eventTime, timeZone, bizStep, disposition, readPointId
- inputLot, inputQty, inputUoM, outputLot, outputQty, outputUoM
- species, productionMethod, FAOArea, gearType, vesselId, flagState
- landingPort, landingDate, farmId, harvestDate
- facilityId, processType (peeling, filleting), certificateRefs, notes
Puis convertissez en EPCIS 2.0 JSON-LD. Un ObjectEvent très simple pour la réception d’un lot de thon peut ressembler à :
{
"@context": [
"https://ref.gs1.org/standards/epcis/2.0.0/epcis-context.jsonld",
{"gdst": "https://traceability-dialogue.org/ontologies/gdst#"}
],
"type": "EPCISDocument",
"schemaVersion": "2.0",
"epcisBody": {
"eventList": [
{
"type": "ObjectEvent",
"eventTime": "2025-08-01T07:15:00+07:00",
"eventTimeZoneOffset": "+07:00",
"action": "observe",
"bizStep": "receiving",
"disposition": "in_progress",
"readPoint": {"id": "urn:epc:id:sgln:8999999.00001.0"},
"quantityList": [{
"epcClass": "urn:epc:class:lgtin:08999999.00001.20250801TUNALOT01",
"quantity": 1200,
"uom": "KGM"
}],
"gdst:kde": {
"gdst:species": "Thunnus albacares",
"gdst:productionMethod": "wild-capture",
"gdst:FAOArea": ["71"],
"gdst:gearType": "HANDLINE",
"gdst:vesselId": "ID-BA-12345",
"gdst:flagState": "IDN",
"gdst:landingPort": "Bitung",
"gdst:landingDate": "2025-07-31"
}
}
]
}
}
Nous avons utilisé une approche similaire pour des expéditions de détail comme Filet de mérou (IQF) et des programmes sashimi utilisant Saku thon jaune (qualité sushi).
Comment représenter le parage/épluchage avec mélanges ou scissions ?
Représentez les mélanges et rendements avec TransformationEvent. Les intrants sont des lots bruts. Les extrants sont des lots transformés.
Exemple : épluchage de crevettes qui mélange deux récoltes d’étang en un seul lot fini.
{
"type": "TransformationEvent",
"eventTime": "2025-08-02T10:00:00+07:00",
"eventTimeZoneOffset": "+07:00",
"bizStep": "processing",
"readPoint": {"id": "urn:epc:id:sgln:8999999.00001.0"},
"inputQuantityList": [
{"epcClass": "urn:epc:class:lgtin:08999999.00001.20250801POND01", "quantity": 800, "uom": "KGM"},
{"epcClass": "urn:epc:class:lgtin:08999999.00001.20250801POND02", "quantity": 600, "uom": "KGM"}
],
"outputQuantityList": [
{"epcClass": "urn:epc:class:lgtin:08999999.00001.20250802SHRIMPPEELED01", "quantity": 1000, "uom": "KGM"}
],
"gdst:kde": {
"gdst:processingType": "peeling",
"gdst:productionMethod": "aquaculture",
"gdst:farmIds": ["FARM-A-01","FARM-B-07"],
"gdst:harvestDates": ["2025-07-29","2025-07-30"]
}
}
Les scissions utilisent le même type d’événement avec un intrant et plusieurs extrants. Conservez des codes de lots de sortie traçables jusqu’aux étiquettes.
Validation rapide avant d’envoyer un fichier à un acheteur
Nous recommandons une vérification en deux étapes :
- Validation du schéma. Confirmez que c’est un EPCIS 2.0 JSON-LD valide. N’importe quel validateur de schéma JSON peut exécuter localement le schéma EPCIS 2.0. Si vous utilisez un script, interrompez la construction lorsqu’il ne valide pas.
- Règles métier GDST. Vérifiez la présence des KDEs par type de produit et par événement. Par exemple, les événements de capture en milieu sauvage doivent comporter la zone FAO, l’engin et un identifiant de navire.
Options gratuites que nous utilisons ou voyons utilisées :
- Validateurs et linters de schéma JSON pour la structure
- Outils EPCIS 2.0 open source pour vérifier la cohérence des événements et du contexte
- Un script Python ou Node simple pour affirmer la présence des KDEs par type d’événement avant l’envoi
Si votre acheteur fournit son propre vérificateur, exécutez toujours votre fichier dessus d’abord pour éviter les échanges fastidieux.
GDST peut‑il extraire des données STELINA ou MDPI que nous collectons déjà ?
Oui, et vous devriez le faire. Nous cartographions comme suit en Indonésie :
- STELINA voyage/atterrissage : ID de voyage, date/port d’atterrissage, espèces, quantités et licence du navire deviennent des KDEs pour les ObjectEvents à l’atterrissage/réception. Conservez l’ID STELINA dans les notes.
- Applications MDPI ou FIP : code du navire, palangre à main, WPP et détails du voyage alimentent vos KDEs de capture et la cartographie FAO. Si des coordonnées sont présentes, incluez-les.
Vous n’avez pas besoin de ressaisir. Référencez les identifiants originaux dans vos notes KDE afin que les auditeurs puissent retracer jusqu’à STELINA ou MDPI.
Cartographie des champs du certificat sanitaire BKIPM vers les KDEs GDST
Nous extrayons régulièrement ces champs directement :
- Description du produit, code HS, nom scientifique → KDEs espèce/produit
- Poids net et type d’emballage → quantité et UoM
- Date de production et lot/batch → identifiants de lot et eventTime lors du traitement
- Numéro d’agrément de l’exportateur/transformateur → identifiant de l’établissement
- Destination, conteneur et scellé → ObjectEvent au niveau expédition (bizStep shipping) si vous incluez la logistique
Il est intéressant de constater combien un certificat BKIPM couvre déjà pour les KDEs de la chaîne finale. Servez‑vous en.
Erreurs courantes qui ralentissent les approbations
- Confusion FAO 57/71 pour WPP 718. Si vous n’êtes pas sûr, incluez des coordonnées ou listez les deux avec une note.
- Identifiants de navire qui n’apparaissent dans aucun document. Utilisez la licence ou l’indicatif d’appel que votre équipe peut photographier.
- Codes de lot qui changent en cours de processus. Si le parage crée de nouveaux lots, montrez-les avec un TransformationEvent.
- Fuseaux horaires manquants. Indiquez toujours eventTimeZoneOffset pour les usines indonésiennes.
Quand ce conseil s’applique (et quand il ne s’applique pas)
Cette approche fonctionne pour les flottilles côtières indonésiennes, le thon à la palangre, les poissons de récif et la crevette vannamei d’élevage. Si vous gérez des transbordements en mer ou des flottilles hauturières, vous aurez probablement besoin de KDEs supplémentaires pour les navires transporteurs et le reporting RFMO. Pour une chaîne complète jusqu’au détail avec sérialisation au niveau article, vous aurez également besoin d’une intégration d’étiquetage au‑delà de ce guide.
Si vous souhaitez une revue rapide de vos colonnes CSV et un modèle EPCIS prêt à copier/coller adapté au thon ou à la crevette, contactez‑nous par e‑mail.
Conclusions principales
- Commencez par les documents en lesquels vous avez confiance. Les journaux WPP, les enregistrements STELINA/MDPI et les certificats BKIPM peuvent remplir 90 % des KDEs GDST.
- Cartographiez WPP vers FAO en utilisant 57 pour l’océan Indien et 71 pour le Pacifique, en surveillant de près WPP 718.
- Utilisez des TransformationEvents pour tout parage, épluchage, scission ou mélange. Si cela s’est produit dans votre atelier, montrez‑le.
- Validez la structure et les règles métier avant l’envoi. Les acheteurs avancent plus vite lorsque les fichiers sont propres dès la première soumission.
Lorsque vous serez prêt, votre payload GDST peut voyager avec n’importe quelle ligne d’exportation, qu’il s’agisse d’un programme de thon qualité sashimi ou de filets congelés pour la distribution au détail. Si vous avez besoin d’exemples de produits, parcourez nos gammes actuelles et voyez comment les KDEs s’alignent avec les spécifications d’emballage. Voir nos produits.