Panduan praktis spesifik Indonesia untuk mengubah log WPP, catatan STELINA/MDPI, dan dokumen pabrik Anda menjadi file EPCIS GDST 1.1 yang diterima pembeli. Termasuk pemetaan WPP-ke-FAO, opsi ID kapal, alur CSV-ke-JSON, dan contoh event.
Jika pembeli Anda baru saja meminta “GDST 1.1,” Anda tidak perlu membeli perangkat lunak besok. Anda dapat menjadi siap-pembeli dengan catatan yang sudah Anda simpan di Indonesia: area WPP-NRI, log trip, nota pelabuhan (landing notes), dokumen BKIPM, dan lembar produksi pabrik. Kami telah mengirimkan file GDST untuk tuna, kakap, udang, dan spesies terumbu campuran dengan cara ini. Berikut tepatnya bagaimana kami melakukan pemetaan.
Tiga pilar file GDST siap pembeli
-
Identitas sumber yang dapat Anda pertanggungjawabkan. Gunakan ID kapal yang benar-benar dibawa dan dilisensikan kru Anda. Gunakan ID panen tambak yang dapat ditemukan orang pada dokumen kertas. Jangan membuat ID yang tidak pernah muncul di dokumen Anda.
-
Logika lot yang bersih. Tentukan bagaimana Anda melacak lot saat penerimaan dan selama pemotongan/packing. Jika Anda tidak dapat menjelaskan pembagian/ penggabungan pada kertas, itu tidak akan tervalidasi di EPCIS.
-
Pengemasan EPCIS yang tepat. Pembeli semakin menginginkan EPCIS 2.0 JSON-LD. Anda bisa memulai di Excel, tetapi rencanakan kolom Anda sehingga dapat dikonversi 1:1 menjadi event nanti.
Intisari praktis: Sebelum Anda menyentuh JSON, konfirmasi definisi lot Anda dan dokumen mana yang membuktikan setiap KDE. Setelah itu Anda sudah 80% siap.
Apa KDE minimal yang sebenarnya diminta pembeli?
Kami melihat dua skenario umum di Indonesia.
-
Ikan tangkapan liar: tuna, kakap, spesies terumbu
- Spesies (nama ilmiah + umum), metode produksi = tangkapan-liar
- Area penangkapan sebagai kode FAO, jenis alat tangkap
- Identifikasi kapal dan negara bendera. Tanggal mulai/akhir trip
- Tanggal dan pelabuhan pendaratan. Jika transhipment, cantumkan kapal pengangkut dan tanggal
- Kode lot/batch pengolah, tanggal produksi, kuantitas dan Satuan Ukur (UoM)
- Identifikasi fasilitas (GLN jika Anda memilikinya, atau nomor persetujuan pabrik)
- Referensi sertifikat/izin (jika relevan)
-
Udang vannamei budidaya
- Spesies, metode produksi = budidaya
- Identifikasi lokasi tambak (kolam/klaster), tanggal panen, lokasi (provinsi/koordinat jika tersedia)
- ID hatchery dan pemasok pakan jika diminta pembeli
- Kode lot/batch pengolah, tanggal produksi, kuantitas
- Identifikasi fasilitas
Jika pembeli Anda ketat menerapkan GDST, tambahkan: ID unik untuk setiap event, zona waktu, langkah bisnis (business step), dan readPoint (tempat kejadian). Kami menemukan bahwa ketika ini hadir, pembeli yang agresif pun bergerak lebih cepat.
Pemetaan WPP-NRI ke FAO yang diterima pembeli
Anda mencatat WPP-NRI. Pembeli menginginkan FAO. Berikut pemetaan sederhana yang luas diterima dan digunakan dalam file GDST Indonesia:
- WPP 571, 572, 573 → FAO 57 (Samudra Hindia, Bagian Timur)
- WPP 711, 712, 713, 714, 715, 716, 717 → FAO 71 (Pasifik, Tengah Barat)
- WPP 718 → Seringkali campuran. Laut Timor/Sawu biasanya FAO 57. Arafura biasanya FAO 71. Jika Anda tidak memiliki koordinat, banyak pembeli menerima pencantuman kedua FAO 57 dan 71 dengan catatan.
Dua tip yang tidak langsung terlihat:
- Jika nota pendaratan Anda memiliki koordinat atau ground yang bernama, sertakan. Kasus WPP 718 yang ambigu cepat terselesaikan ketika Anda menambahkan lat/long.
- Simpan WPP asli di bidang “notes”. Auditor suka melihat referensi asli Anda.
Perlu pemeriksaan cepat terhadap pemetaan untuk suatu fishery spesifik? Anda dapat Hubungi kami di whatsapp.
Kapal kami tidak memiliki nomor IMO. ID apa yang dapat diterima?
Dalam praktiknya, perahu handline/hari di Indonesia jarang memiliki IMO. GDST 1.1 memperbolehkan beberapa tipe identifier:
- Nomor registrasi nasional atau nomor lisensi (mis. dari dokumen KKP/MMAF)
- Radio call sign (IRCS) atau MMSI jika tersedia
- UVI (Unique Vessel Identifier) jika diberikan melalui program atau registri
- CFR untuk kapal berbendera UE (jarang pada armada pesisir Indonesia)
Aturan kami: pilih identifier yang muncul pada nota pendaratan atau lisensi Anda dan tetap stabil dari tahun ke tahun. Untuk perahu kecil dalam FIP yang dikelola oleh MDPI, gunakan kode kapal yang dipakai dalam program tersebut dan tautkan ke lisensi kertas Anda di kolom notes.
Bisakah kami memulai di Excel/CSV dan beralih ke EPCIS nanti?
Bisa. Kami menyarankan demikian. Rancang spreadsheet yang mencerminkan event EPCIS sehingga konversinya bersifat mekanis.
Kolom minimal yang dapat dikonversi dengan baik:
- 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
Kemudian konversi ke EPCIS 2.0 JSON-LD. Sebuah ObjectEvent yang sangat sederhana untuk penerimaan lot tuna dapat terlihat seperti:
{
"@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"
}
}
]
}
}
Kami telah menggunakan pendekatan serupa untuk pengiriman ritel seperti Fillet Kerapu (IQF) dan program sashimi menggunakan Yellowfin Saku (Kualitas Sushi).
Bagaimana kami menunjukkan pengupasan/pemotongan dengan penggabungan atau pemisahan?
Representasikan penggabungan dan yield dengan TransformationEvent. Input adalah lot mentah. Output adalah lot yang diproses.
Contoh: pengupasan udang yang menggabungkan dua panen kolam menjadi satu lot jadi.
{
"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"]
}
}
Pemisahan (splits) adalah tipe event yang sama dengan satu input dan beberapa output. Jaga kode lot output Anda dapat ditelusuri ke label.
Validasi cepat sebelum Anda mengirim email ke pembeli
Kami merekomendasikan pemeriksaan dua langkah:
- Validasi skema. Pastikan valid EPCIS 2.0 JSON-LD. Validator JSON Schema mana pun dapat menjalankan skema EPCIS 2.0 secara lokal. Jika Anda menggunakan skrip, gagalkan build ketika tidak valid.
- Aturan bisnis GDST. Periksa keberadaan KDE menurut tipe produk dan event. Contohnya, event tangkapan-liar harus memiliki area FAO, alat tangkap, dan ID kapal.
Opsi gratis yang kami gunakan atau lihat digunakan:
- Validator dan linter JSON Schema untuk struktur
- Alat tes EPCIS 2.0 open-source untuk memeriksa kewajaran event dan konteks
- Skrip Python atau Node sederhana untuk memastikan KDE per tipe event sebelum dikirim
Jika pembeli Anda menyediakan checker mereka sendiri, selalu jalankan file Anda melalui itu terlebih dahulu untuk menghindari bolak-balik.
Bisakah GDST menarik data dari STELINA atau MDPI yang sudah kami kumpulkan?
Bisa, dan sebaiknya Anda lakukan. Kami memetakan seperti ini di Indonesia:
- Trip/pendaratan STELINA: ID trip, tanggal/pelabuhan pendaratan, spesies, kuantitas, dan lisensi kapal menjadi KDE untuk ObjectEvents pada pendaratan/penerimaan. Simpan ID STELINA di notes.
- Aplikasi MDPI atau FIP: kode kapal, alat handline, WPP, dan detail trip memasok KDE tangkapan Anda dan pemetaan ke FAO. Jika koordinat ada, sertakan.
Anda tidak perlu memasukkan dua kali. Referensikan ID asli di notes KDE Anda sehingga auditor dapat melacak kembali ke STELINA atau MDPI.
Memetakan bidang sertifikat kesehatan BKIPM ke KDE GDST
Kami secara rutin mengangkat bidang-bidang ini secara langsung:
- Deskripsi produk, kode HS, nama ilmiah → KDE spesies/produk
- Berat bersih dan tipe kemasan → kuantitas dan UoM
- Tanggal produksi dan lot/batch → ID lot dan eventTime pada pemrosesan
- Nomor persetujuan eksportir/pengolah → identifikasi fasilitas
- Tujuan, kontainer, dan segel → ObjectEvent tingkat pengiriman (bizStep shipping) jika Anda memasukkan logistik
Yang menarik adalah seberapa besar sertifikat BKIPM sudah mencakup untuk KDE end-of-chain GDST. Gunakan itu.
Kesalahan umum yang memperlambat persetujuan
- Kebingungan FAO 57/71 untuk WPP 718. Jika Anda ragu, sertakan koordinat atau cantumkan kedua FAO dengan catatan.
- ID kapal yang tidak muncul di dokumen mana pun. Gunakan lisensi atau call sign yang tim Anda dapat foto.
- Kode lot berubah di tengah proses. Jika pemotongan menghasilkan lot baru, tunjukkan dengan TransformationEvent.
- Zona waktu hilang. Selalu atur eventTimeZoneOffset untuk pabrik di Indonesia.
Kapan saran ini berlaku (dan kapan tidak)
Pendekatan ini bekerja untuk armada pesisir Indonesia, tuna handline, ikan terumbu, dan udang vannamei budidaya. Jika Anda menangani transshipment di laut atau armada jauh, kemungkinan Anda akan membutuhkan KDE tambahan untuk kapal pengangkut dan pelaporan RFMO. Untuk chain-to-retail penuh dengan serialisasi tingkat item, Anda juga akan memerlukan integrasi label di luar panduan ini.
Jika Anda menginginkan tinjauan cepat terhadap kolom CSV Anda dan template EPCIS copy/paste yang disesuaikan untuk tuna atau udang, Hubungi kami via email.
Kesimpulan akhir
- Mulailah dengan dokumen yang Anda percayai. Log WPP, catatan STELINA/MDPI, dan sertifikat BKIPM dapat mengisi 90% KDE GDST.
- Peta WPP ke FAO menggunakan 57 untuk Samudra Hindia dan 71 untuk Pasifik, perhatikan WPP 718 dengan seksama.
- Gunakan TransformationEvents untuk setiap trim, kupas, split, atau blend. Jika itu terjadi di lantai Anda, tunjukkan.
- Validasi struktur dan aturan bisnis sebelum mengirim. Pembeli bergerak lebih cepat ketika file bersih pada percobaan pertama.
Ketika Anda siap, payload GDST Anda dapat berjalan bersama jalur ekspor mana pun, apakah itu program tuna kualitas sashimi atau fillet beku ritel. Jika Anda membutuhkan contoh produk, telusuri lini kami saat ini dan lihat bagaimana KDE selaras dengan spesifikasi kemasan. Lihat produk kami.