ShipCore — Industry Standards Compliance Matrix¶
Phase 1 research deliverable. Це попередня карта стандартизаційного ландшафту, у якому має жити ShipCore. Мета — зафіксувати до того, як почалась реальна імплементація: (а) які організації пишуть правила, (б) які identifiers є must-have у master data, (в) які документи генеруємо, (г) які EDI-повідомлення мусимо вміти, (д) що юридично обов'язкове vs watch-list, (е) пріоритети по фазах.
Невпевнені факти позначено
(?)і будуть перевалідовані у Phase 2 при роботі з конкретною інтеграцією.Source-of-truth для: - стратегічних виборів між «build vs buy» (наприклад eCMR провайдер vs власна реалізація UNECE) - product roadmap (Phase 4-9 priorities) - sales conversations («так, ShipCore покриває SOLAS VGM, ICS2 Release 3, NCTS Phase 5...») - master data моделювання у
backend/shipcore/(які поля identifiers додавати наперед)
0. TL;DR¶
ShipCore оперує у regulatory ландшафті, що формується 16+ організаціями. Класифікація:
| Тип стандарту | Кількість | Приклади | Наша зона ризику |
|---|---|---|---|
| Identifiers (must-have у master data) | ~16 | ISO 6346, UN/Locode, SCAC, IMO, IATA, EORI, РНОКПП, HS/УКТЗЕД | Master data design — додаємо одразу всі поля у shipcore.Carrier/Vessel/Port/... |
| Documents (PDF + signing) | ~14 | CMR, eCMR, B/L, eBL, AWB, СМГС/CIM, TIR, FIATA FBL/FCR, eTTN | Print Framework + EDI generation; eCMR/eBL — третя сторона (TransFollow / DCSA hub) |
| Messaging / EDI | 12+ EDIFACT, 6+ X12, DCSA REST, IATA ONE Record | IFTMIN/IFTSTA/COPARN/BAPLIE/CODECO | Carrier connectivity hub (REST + EDIFACT + SFTP) |
| Mandatory regulations | ~7 критичних | SOLAS VGM, NCTS Phase 5, eTTN, EU CBAM 2026, ICS2 Release 3, EUDR | Gap = клієнт не може працювати; пропуск = втрата ринку |
| Watch-list / emergent | ~7 | IATA ONE Record (Jan 2026 deadline), DCSA eBL, GAIA-X, EUDR, W3C VC | Моніторити, готувати adapters наперед |
Найгостріші 2026-2027 deadlines: - 2026-01-01 — IATA Cargo-IMP/Cargo-XML входять у "containment" (no further development); ONE Record стає preferred standard для air cargo - 2026-01-01 — EU CBAM definitive phase (annual declarations замість quarterly, surrender certificates) - 2025-09-01 — ICS2 Release 3 повністю operational для всіх transport modes (вже відбулось) - 2025-01-21 — NCTS Phase 5 definitive period (вже відбулось, ShipCore EU-expansion стартує вже тут) - 2026-12-30 — EUDR обов'язкова для великих/середніх компаній (timber, soy, coffee, cocoa, palm oil, rubber, cattle) - 2026 (orientative) — eTTN UA mandatory (currently testing phase з провайдерами Vchasno/M.E.Doc/EDI NETWORK) - 2026 (orientative) — eCMR EU mandatory (8 EU member states зобов'язані ратифікувати до кінця 2026)
Part 1 — Стандартизаційні організації¶
1.1 UN/CEFACT (United Nations Centre for Trade Facilitation and Electronic Business)¶
- Scope: Глобальні стандарти trade facilitation і e-business для UN.
- Jurisdiction: Світ (UN-level), розробляється під егідою UNECE.
- Видає:
- UN/EDIFACT — найбільший EDI-стандарт у світі (12+ повідомлень для логістики, див. § 4)
- UN/Locode — кодифікація портів/станцій/аеропортів/inland points (~110000 кодів, формат
UA ODS,UA KBP,RO CND) - MMT Reference Data Model (Multi-Modal Transport) — концептуальна модель для multimodal logistics
- Buy-Ship-Pay Reference Data Model — глобальна data model для всього supply chain
- ShipCore взаємодіє:
shipcore.Port.code,shipcore.Station.code— UN/Locode якunique=True, db_index=True- EDIFACT парсер у carrier connectivity hub (Phase 5+)
- MMT як inspiration для
shipcore.ShipmentEventevent vocabulary
1.2 ISO (International Organization for Standardization)¶
- Scope: Глобальні технічні стандарти для всіх галузей.
- Релевантні TC:
- TC 104 (Freight Containers) — ISO 6346, ISO 668, ISO 1496
- TC 204 (Intelligent Transport Systems / ITS) — ITS communications, e-toll, vehicle telematics
- TC 8 (Ships and Marine Technology) — IMO-aligned shipping standards
- Видає:
- ISO 6346 — Container identification (BIC code: 4 letters owner + 6 digits serial + 1 check digit, e.g.
MAEU1234567) - ISO 668 — Container dimensions classification (1A, 1AA, 1B, 1C, ...)
- ISO 1496 — Container specification (load testing, lashing points, doors)
- ISO/IEC 7372 — UN/EDIFACT trade data elements
- ISO 28005 — Maritime port community electronic port clearance
- ShipCore взаємодіє:
shipcore.Container.container_number— валідація формату ISO 6346 (regex + check digit)shipcore.ContainerType.iso_code— ISO 668 type code (22G1, 42G1, 45G1, 22R1 ...)
1.3 IATA (International Air Transport Association)¶
- Scope: Standards для air transport (passenger + cargo) і airline-related процесів.
- Jurisdiction: Глобальна асоціація 300+ авіакомпаній.
- Видає:
- AWB (Air Waybill) — IATA Resolution 600a, формат:
prefix (3) + serial (8) + check digit - Cargo-IMP (Cargo Interchange Message Procedures) — legacy text-based EDI для авіакарго (з 1980s)
- Cargo-XML — XML evolution Cargo-IMP, основний у 2010s-2020s
- ONE Record — НОВИЙ стандарт (REST + linked data JSON-LD), preferred з 2026-01-01
- IATA 2-letter airline code (LH, KL, LO), IATA 3-letter airport code (KBP, FRA)
- DGR (Dangerous Goods Regulations) — для air cargo dangerous goods
- Critical 2026 deadline:
- З 2026-01-01 Cargo-IMP/Cargo-XML входять у "containment" (no further development); ONE Record стає preferred standard. Жоден з legacy форматів не "помирає" миттєво, але new development має вестись на ONE Record.
- ShipCore взаємодіє:
shipcore.Airport.iata_code,shipcore.Airport.icao_codeshipcore.Carrier.iata_code(для airlines, 2-letter)shipcore_avia.AWB— stub у v1, повна реалізація — Phase 9+ (потрібен domain expert per decisions-2026-05-12 § 6)- Watch-list для ONE Record: підготувати JSON-LD-friendly data model одразу
1.4 DCSA (Digital Container Shipping Association) — НАЙВАЖЛИВІШИЙ для shipcore_sea¶
- Scope: Digital standards specifically для container shipping; альтернатива legacy EDIFACT-only підходу.
- Founded: 2019 (Maersk, MSC, Hapag-Lloyd, ONE — потім приєдналися CMA CGM, ZIM, Evergreen, HMM, Yang Ming = 9 carriers).
- Видає (всі OpenAPI на GitHub
dcsaorg/DCSA-OpenAPI, SwaggerHubdcsa.org): - eBL (electronic Bill of Lading) — Bill of Lading v3.0 final (Feb 2025), доступний для production integration
- Track & Trace — TNT v2.2 (Dec 2024) — стандартизовані shipment events
- Booking — Booking v2.0 final (Feb 2025)
- Just-in-Time Port Call — стандарт для port calls (PortCall API)
- VGM — VGM v1.0 (Nov 2025) — REST API standard для verified container weights, заміна VERMAS EDIFACT
- ⚠️ Не використовуйте маркіровку "DCSA v2.0.1" — це GitHub repo tag датований May 2021, застарілий. Завжди референсіть конкретний product version (BL 3.0, Booking 2.0, TNT 2.2, VGM 1.0).
- Adoption status (May 2025):
- Перша interoperable eBL transaction відбулась 2025-05-15 між HMM, Suzano, двома різними платформами
- 9 carrier members зобов'язались 100% eBL adoption до 2030
- До end of 2025 — 6 member carriers заплановано complete implementation
- Market uptake eBL ~5.7% січень 2025, ~11% всього electronic B/L пізніше (?)
- ShipCore взаємодіє:
shipcore_sea.OceanBooking,shipcore_sea.BillOfLading— модель данних має бути DCSA-compatible (поля, structure)- Phase 5 — Maersk Spot first integration (REST, OAuth2)
- Phase 8+ — повна DCSA eBL via interoperability hubs (CargoX, WaveBL, Enigio, TradeGo, IQAX/GSBN)
1.5 WCO (World Customs Organization)¶
- Scope: Customs standards globally.
- Jurisdiction: 184 member countries.
- Видає:
- HS (Harmonized System) Codes — 6-digit базовий + national 2+2 (UA УКТЗЕД = 10 digits, EU CN = 8 digits, US HTS = 10 digits)
- WCO Data Model — стандартизована customs declaration model (NCTS, AES, ICS2 базуються на ньому)
- SAFE Framework — security standards, AEO program
- Revised Kyoto Convention — customs procedures simplification
- ShipCore взаємодіє:
essentials.Item.uktzed_code— вже є через M.E.Doc bridgeessentials.Item.hs_code(?) — додати для EU/global expansionshipcore_forwarder.Booking.mrn— для NCTS-tracked shipments
1.6 IRU (International Road Transport Union)¶
- Scope: Стандарти road transport globally; адміністрація TIR Convention.
- Founded: 1948.
- Видає:
- TIR Carnet — паперовий + електронний eTIR, для customs transit через 70+ countries
- TIR-EPD (Electronic Pre-Declaration) — IRU's free application для TIR-операторів подавати pre-arrival cargo data
- eTIR International System — нова цифрова інфраструктура (specifications adopted 2022)
- CMR Convention (1956) — у партнерстві з UNECE; IRU as guardian of road transport
- eCMR Protocol — у партнерстві з UNECE
- 2026 update:
- З 2026-02-21 — Kazakhstan вимагає всі EPDs через нову KEDEN customs system
- 2026 — countries applying ICS2 для road transport: Ireland, Spain, France, Italy, Lithuania, Hungary, Finland, Greece, Bulgaria (з 1 січня); Croatia, Latvia, Poland, Romania, Slovakia (з 1 червня)
- ShipCore взаємодіє:
shipcore.Carrier.tir_holder_id— для UA-EU operators- Phase 8 — TIR-EPD integration (через IRU portal)
shipcore_auto— TIR Carnet workflow
1.7 UNECE (United Nations Economic Commission for Europe)¶
- Scope: Trade and transport facilitation у UNECE region (56 countries: EU + UK + Швейцарія + Норвегія + Балкани + Туреччина + Кавказ + Центральна Азія + Росія + США + Канада + Ізраїль).
- Видає:
- eCMR Protocol (2008) — Additional Protocol до CMR Convention для electronic consignment notes
- TIR Convention (1975) — depository
- CMR Convention (1956) — depository
- AGR / AGTC / AGN — agreements щодо road / combined transport / inland water
- Host UN/CEFACT (UN/EDIFACT, UN/Locode)
- eCMR ratification status (UA):
- Україна ратифікувала eCMR Protocol 2020-07-13
- 36 countries ратифікували
- Очікується mandatory у EU до кінця 2026 (8 EU member states ще не ратифікували)
- ShipCore взаємодіє:
shipcore_auto.ETTNDocument(через Fleet) + майбутнійshipcore_auto.ECMRDocumentдля EUshipcore.ShipmentEvent.event_code— UNECE Recommendation N. 24 transport status codes
1.8 OTIF (Intergovernmental Organisation for International Carriage by Rail)¶
- Scope: Rail transport, EU + Middle East + North Africa.
- Members: 50 states.
- Видає:
- CIM (Convention Internationale concernant le transport des Marchandises par chemins de fer) — railway consignment note для Європи, North Africa, Middle East
- CUV — uniform rules для wagon use contracts
- CUI — uniform rules для infrastructure use contracts
- COTIF — overarching convention
- ShipCore взаємодіє:
shipcore_rail.RailwayWaybill— CIM format generation для UA-EU rail flows- Phase 6+ — CIM integration
1.9 OSJD (Organisation for Cooperation of Railways) — для UA + CIS + Asia rail¶
- Scope: Rail cooperation East Europe, CIS, Mongolia, China, North Korea, Vietnam.
- HQ: Warsaw.
- Видає:
- СМГС (Соглашение о Международном Грузовом Сообщении) — railway consignment note для CIS / Asia (UA, BY, RU, KZ, MN, CN, KP, VN)
- CIM/СМГС Combined Consignment Note — bilingual document для bridging EU CIM ↔ CIS СМГС у Україні / Польщі / Прибалтиці (вирішує проблему перевантаження документів на кордоні)
- ShipCore взаємодіє:
shipcore_rail.RailwayWaybill— СМГС formatshipcore_rail.CombinedWaybill— CIM/СМГС combined для UA-EU intermodal flows (стратегічно важливо post-2022)
1.10 GS1¶
- Scope: Глобальні standards для product identification, supply chain visibility, traceability.
- Видає:
- GTIN (Global Trade Item Number) — 8/12/13/14 digits, продукт identification
- GLN (Global Location Number) — 13 digits, locations (warehouses, ports, addresses)
- SSCC (Serial Shipping Container Code) — 18 digits, shipment unit (pallet/container shipment)
- GS1-128 / DataMatrix — barcode standards для logistics labels
- GS1 Digital Link — нова URL-based representation для GTIN/SSCC (для traceability)
- EPCIS — Event-based supply chain visibility standard
- ShipCore взаємодіє:
shipcore.LocationPoint.gln— optional поле (для warehouses/portals/складів)- Watch-list: SSCC для майбутнього
shipcore.ShipmentUnit(pallet/case-level tracking) — Phase 9+
1.11 ICC (International Chamber of Commerce)¶
- Scope: Глобальні комерційні правила.
- Видає:
- Incoterms 2020 — найважливіші правила в логістиці (EXW, FCA, CPT, CIP, DAP, DPU, DDP, FAS, FOB, CFR, CIF)
- UCP 600 — Uniform Customs and Practice for Documentary Credits (banking, але важливо для shipping documents)
- eUCP — electronic supplement до UCP
- ShipCore взаємодіє:
shipcore_forwarder.Booking.incoterm— choices (incoterm_2020)shipcore_pricing.Quote— pricing affected by Incoterm (EXW vs DAP vs DDP — different cost components)
1.12 NMFTA (National Motor Freight Traffic Association) — US¶
- Scope: US road carrier standards.
- Видає:
- SCAC (Standard Carrier Alpha Code) — 4-letter код для sea/road carriers (
MAEU= Maersk,HLCU= Hapag-Lloyd,MSCU= MSC) - NMFC — US road freight classification
- ShipCore взаємодіє:
shipcore.Carrier.scac_code— обов'язкове поле для будь-якого ocean/road carrier (use widely навіть поза US)
1.13 IMO (International Maritime Organization)¶
- Scope: UN agency для maritime safety + environmental protection.
- Видає:
- IMO number — 7-digit unique vessel identifier (e.g.
IMO9876543) - IMDG Code (International Maritime Dangerous Goods) — обов'язкове для dangerous goods sea transport
- MARPOL — environmental conventions (oil, sewage, garbage, air emissions)
- SOLAS (Safety of Life at Sea) — включаючи VGM (Verified Gross Mass) mandatory з 2016-07-01
- STCW — seafarer training
- SOLAS VGM (mandatory з 2016-07-01):
- Shipper зобов'язаний надати verified gross mass (контейнер + вантаж + кріплення) terminal'у достатньо завчасно для stowage planning
- Без VGM — контейнер не вантажиться на судно
- Forwarder TMS має автоматизувати збір VGM data (з shipper) і передачу terminal'у (через VGM message — EDI або email)
- ShipCore взаємодіє:
shipcore.Vessel.imo_number,shipcore.Vessel.mmsi(ITU-asssigned radio identifier)shipcore_terminal.GateTransaction.vgm_kg+vgm_method(1=weighing, 2=calculation) +vgm_signed_byshipcore_sea.OceanBooking.vgm_statusworkflowshipcore.DangerousGoodsmodel — UN number, IMDG class, packing group
1.14 АсМАП України (Асоціація міжнародних автомобільних перевізників України)¶
- Scope: UA road carriers асоціація, член IRU.
- Видає / адмініструє:
- DOZVIL_UA — система видачі дозволів (CEMT, двосторонні дозволи на перевезення)
- TIR Carnets для UA carriers — як IRU partner
- ShipCore взаємодіє:
shipcore.Carrier.asmap_id— для UA road carriers- Phase 6+ — DOZVIL_UA інтеграція (?)
1.15 BIMCO (Baltic and International Maritime Council)¶
- Scope: Maritime standard form contracts.
- Видає:
- Charter party templates (GENCON, NYPE, ASBATIME, ...)
- BIMCO B/L templates
- Industry-standard clauses (war risk, sanctions, BIMCO bunker clause)
- ShipCore взаємодіє:
- Watch-list для
shipcore_seaadvanced features (charter party management) — Phase 9+
1.16 FIATA (International Federation of Freight Forwarders Associations)¶
- Scope: Forwarder asociation, standard forwarder documents.
- Members: 40000+ forwarders у 150+ countries.
- Видає:
- FBL (FIATA Negotiable Multimodal Transport Bill of Lading) — multimodal B/L for forwarders
- FCR (Forwarder's Certificate of Receipt) — receipt of goods
- FCT (Forwarder's Certificate of Transport) — confirmation of transport
- FWR (FIATA Warehouse Receipt) — для warehousing
- SDT (Shipper's Declaration for the Transport of Dangerous Goods) — для DG shipments
- FIATA Model Rules — standard contract terms
- ShipCore взаємодіє:
shipcore_forwarder— FBL/FCR/FCT як print templates (Phase 7+)
Part 2 — Identifiers (must-have у master data)¶
Принцип design: додаємо поля одразу у
backend/shipcore/моделі при Phase 4 refactor, навіть якщо у v1 не використовуються. Дешевше додати nullable поле зараз, ніж робити migration через рік під тиском конкретного клієнта.
| Стандарт | Об'єкт | Формат | Authority | ShipCore модель/поле | Status у v1 | Validation |
|---|---|---|---|---|---|---|
| ISO 6346 | Container | 4 letters + 6 digits + 1 check digit (MAEU1234567) |
BIC (Bureau International des Containers) | shipcore.Container.container_number |
✅ є у containerhub.Container |
Regex + check digit алгоритм |
| ISO 668 | Container type | 22G1, 42G1, 45G1 (ISO size+type) |
ISO TC 104 | shipcore.ContainerType.iso_code |
📋 NEW (зараз string у containerhub) | choices з master list |
| UN/Locode | Port / Station / Airport / Inland point | 5 chars: UA ODS, RO CND, PL GDY, UA KBP |
UNECE | shipcore.Port.code, shipcore.Station.code, shipcore.Airport.code |
📋 NEW (Port/Airport — нові моделі) | unique per type |
| SCAC | Sea/Road carrier | 4 letters (MAEU, HLCU, MSCU, CMDU) |
NMFTA (US) | shipcore.Carrier.scac_code |
📋 NEW | unique, regex ^[A-Z]{4}$ |
| IMO number | Vessel | 7 digits, prefix IMO (IMO9876543) |
IHS Markit / IMO | shipcore.Vessel.imo_number |
📋 NEW | unique, check digit (?) |
| MMSI | Vessel radio | 9 digits | ITU | shipcore.Vessel.mmsi |
📋 NEW | unique, regex ^\d{9}$ |
| IATA 3-letter | Airport | KBP, IEV, JFK, FRA |
IATA | shipcore.Airport.iata_code |
📋 NEW (avia stub) | unique |
| ICAO 4-letter | Airport | UKBB, UKKK, EDDF |
ICAO | shipcore.Airport.icao_code |
📋 NEW | unique |
| IATA 2-letter | Airline | LO, LH, KL, PS |
IATA | shipcore.Carrier.iata_code (для airline) |
📋 NEW | unique |
| HS Code | Cargo classification | 6+2+2 (УКТЗЕД UA = 10 digits, EU CN = 8 digits) | WCO / Держмитслужба UA | essentials.Item.uktzed_code |
✅ (UKTZED через M.E.Doc) | length validation |
| EORI | EU Customs operator | UA1234567890123 (CC + 15 digits / variable) | EU Commission / national customs | essentials.Client.eori, essentials.Organization.eori |
📋 NEW | optional, format per country |
| РНОКПП / ЄДРПОУ | UA контрагент | 10 digits (РНОКПП фізична), 8 digits (ЄДРПОУ юр.) | Держфінмоніторинг UA | essentials.Client.rnokpp |
✅ | check digit algorithm |
| VAT ID (EU) | EU VAT-payer | DE123456789, PL1234567890 |
EU Commission | essentials.Client.vat_id |
✅ (?) | VIES validation API |
| MRN (Movement Reference Number) | EU Customs declaration | 18 chars: 25DE12345678901234 |
EU customs (issued at submission) | shipcore_forwarder.Booking.mrn (multiple — список MRN per leg) |
📋 NEW | regex per format |
| AWB number | Air waybill | 3-digit airline prefix + 8-digit serial + check digit (125-12345678) |
Airline | shipcore_avia.AWB.number |
💡 deferred (Phase 9+) | format |
| MBL/HBL (Master/House B/L) | Bill of lading | Carrier-defined (typically 8-12 chars: MAEU123456789) |
Carrier (MBL) / Forwarder (HBL) | shipcore_sea.BillOfLading.number (з prefix MBL/HBL) |
📋 NEW | unique per carrier |
| GLN | Location | 13 digits, GS1 prefix + location ref + check | GS1 | shipcore.LocationPoint.gln |
📋 NEW (optional) | check digit |
| SSCC | Shipment unit (pallet/container shipment instance) | 18 digits | GS1 | shipcore.ShipmentUnit.sscc (майбутній) |
💡 deferred | check digit |
| TIR Carnet number | TIR transport | XB 12345678 (2 letters + 8 digits) |
IRU via national associations | shipcore.TIRCarnet.number |
📋 NEW (Phase 8) | format |
| NMFC class | US road freight | 50-500 (class code) | NMFTA | (skip — US-only, не у v1) | — | — |
| Booking number (carrier) | Ocean booking reference | Carrier-defined (8-12 chars typically) | Carrier | shipcore_sea.OceanBooking.carrier_booking_ref |
📋 NEW | per-carrier validation |
| D-U-N-S Number | Business entity | 9 digits (Dun & Bradstreet) | D&B | essentials.Client.duns |
💡 deferred | optional |
Identifiers коментарі¶
- Container check digit (ISO 6346): modulo 11 algorithm. Backend має validation у model
clean(). Frontend — live-validate як user друкує. - MRN формат: перші 2 digits = year (25 = 2025), наступні 2 letters = country (DE/UA/PL), решта 14 = customs office reference + sequence + check.
- EORI для UA контрагентів: після ассоціації UA-EU customs (?) — UA-вантажовідправники можуть отримати EORI через EU country of registration.
- GLN не обов'язково: використовується якщо клієнт працює з GS1-enabled supply chains (retail, pharma). Optional поле.
- SSCC: для майбутнього
shipcore.ShipmentUnit— пакувальна одиниця (палета, кейс, контейнер shipment instance), яка треба для traceability у GS1-світі.
Part 3 — Document Standards (для генерації PDF + EDI)¶
3.1 Road documents¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| CMR (Convention relative au contrat de transport international de marchandises par route, 1956) | UNECE / IRU | Yes — для будь-якого international road transport у CMR-state | shipcore_auto + shipcore_forwarder |
📋 print template (Phase 7) |
| eCMR (Additional Protocol 2008) | UNECE / IRU | Поетапно mandatory у EU 2026 | shipcore_auto (через TransFollow / DigiCMR partnership) |
📋 NEW (Phase 8 — EU expansion) |
| eTTN (Україна) | Мінінфраструктури UA / Дія | Поетапно mandatory 2024-2026; зараз тестування | shipcore_auto (вже є у Fleet через eTTN module з 9 моделями) |
✅ existing |
| TTN (паперова, UA) | Мінінфраструктури UA | Mandatory наразі (eTTN ще не повністю замінив) | shipcore_auto |
✅ existing |
| ТТН (RU/BY) | National | National only | (skip у v1) | — |
| ATA Carnet | ICC / WCO | Optional — temporary import/export | shipcore_forwarder |
💡 Phase 9+ |
| TIR Carnet | IRU | Mandatory if using TIR transit | shipcore_auto + shipcore_forwarder |
📋 Phase 8 |
| CMR Insurance Certificate | National | Optional | shipcore_auto |
💡 Phase 9+ |
3.2 Sea documents¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| B/L (Bill of Lading) — Hague-Visby Rules / Hamburg Rules / Rotterdam Rules (depending on jurisdiction) | IMO + national + BIMCO templates | Yes — primary contract document | shipcore_sea.BillOfLading |
📋 NEW (Phase 5) |
| MBL (Master B/L) | Carrier | Yes якщо carrier issues | shipcore_sea.BillOfLading (bl_type=master) |
📋 NEW |
| HBL (House B/L) | Forwarder | Yes якщо forwarder consolidates | shipcore_sea.BillOfLading (bl_type=house) |
📋 NEW |
| eBL DCSA | DCSA (9 carriers) | Optional now, push до 100% by 2030 | shipcore_sea.BillOfLading (DCSA-compatible structure) |
📋 Phase 8+ via interop hubs (CargoX/WaveBL/...) |
| Sea Waybill | Carrier | Optional — non-negotiable alternative до B/L | shipcore_sea.SeaWaybill |
💡 Phase 9+ |
| Booking Confirmation | Carrier | Standard practice | shipcore_sea.OceanBooking.confirmation_doc |
📋 NEW (Phase 5) |
| Manifest | Carrier | Yes — для customs at destination | shipcore_sea.Manifest |
💡 Phase 9+ |
| VGM Declaration | Shipper | Mandatory (SOLAS) | shipcore_sea.VGMDeclaration (optional model) або field на Booking |
📋 NEW (Phase 5) |
| Letter of Indemnity (LOI) | Shipper / Forwarder | Optional but common | shipcore_sea print template |
💡 Phase 9+ |
| DG Declaration (IMO IMDG) | Shipper | Mandatory if dangerous goods | shipcore.DangerousGoodsDeclaration |
📋 Phase 6+ |
3.3 Air documents¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| AWB (Air Waybill) — IATA Resolution 600a | IATA / Airline | Yes — primary air contract | shipcore_avia.AWB |
💡 deferred (Phase 9+) |
| HAWB (House AWB) | Forwarder | Yes якщо consolidation | shipcore_avia.AWB (type=house) |
💡 deferred |
| MAWB (Master AWB) | Airline | Yes якщо master | shipcore_avia.AWB (type=master) |
💡 deferred |
| DGD (Dangerous Goods Declaration) — IATA DGR | IATA | Mandatory if DG | shipcore.DangerousGoodsDeclaration |
💡 deferred |
3.4 Rail documents¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| CIM (Convention Internationale concernant le transport des Marchandises par chemins de fer) | OTIF | Yes — Europe rail | shipcore_rail.RailwayWaybill (cim format) |
📋 NEW (Phase 6+) |
| СМГС (Соглашение о Международном Грузовом Сообщении) | OSJD | Yes — CIS / Asia rail | shipcore_rail.RailwayWaybill (smgs format) |
⚠️ partial (containerhub.RailwayWaybill — refactor у Phase 6) |
| CIM/СМГС combined | OSJD + OTIF agreement | Yes для cross-border UA-EU rail | shipcore_rail.CombinedWaybill |
📋 NEW (Phase 6+) — стратегічно важливо post-2022 |
3.5 Customs documents¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| T1 (NCTS) — EU транзит non-Union goods | EU customs | Mandatory для EU транзиту non-Union goods | shipcore_forwarder.CustomsDeclaration (через broker або direct connect) |
📋 Phase 8 (EU expansion) |
| T2 (NCTS) — EU транзит Union goods | EU customs | Mandatory in specific cases | (same) | 📋 Phase 8 |
| EX (Export declaration) | National customs | Mandatory at export | (через M.E.Doc bridge для UA, через AES для EU) | ⚠️ partial (M.E.Doc) |
| IM (Import declaration) | National customs | Mandatory at import | (same) | ⚠️ partial (M.E.Doc) |
| CMR + T1 combined | de-facto industry practice | Standard для UA-EU road | print template | 📋 Phase 8 |
| ATA Carnet | ICC / WCO | Optional — temp import/export | print template | 💡 Phase 9+ |
3.6 Forwarder documents (FIATA family)¶
| Standard | Issuing org | Mandatory | ShipCore модуль | Status у v1 |
|---|---|---|---|---|
| FBL (FIATA Negotiable Multimodal Transport B/L) | FIATA | Optional — used for multimodal forwarder consolidation | shipcore_forwarder.FBL |
📋 Phase 7 |
| FCR (Forwarder's Certificate of Receipt) | FIATA | Optional — receipt confirmation | shipcore_forwarder.FCR |
📋 Phase 7 |
| FCT (Forwarder's Certificate of Transport) | FIATA | Optional | shipcore_forwarder.FCT |
💡 Phase 9+ |
| FWR (FIATA Warehouse Receipt) | FIATA | Optional | (skip — warehousing не у v1 ShipCore scope) | — |
| SDT (Shipper's Declaration for DG) | FIATA | Mandatory if DG | shipcore.DangerousGoodsDeclaration |
📋 Phase 6+ |
3.7 eTTN UA — детально¶
- Регулятор: Мінінфраструктури України (тепер Мінрозвитку громад, територій та інфраструктури).
- Підпис: КЕП (кваліфікований електронний підпис) або Дія.Підпис (ed25519, мобільний).
- Status (вересень 2025+):
- Ministry authorised перші e-document operators у кінці 2025: Vchasno.TTN, M.E.Doc, EDI NETWORK
- Перші реальні eTTN зареєстровані у січні 2026
- Mandatory переход — заплановано до кінця 2026 (legislative regulation)
- Зараз — testing period; компанії можуть продовжувати paper TTN
- ShipCore status:
- Fleet eTTN module — 9 моделей, інтегровано (✅)
- Phase 4 task — як
shipcore_forwarderпише ETTNDocument (зараз FK тільки наFleet.TransportInvoice)
Part 4 — Messaging / EDI Standards¶
4.1 UN/EDIFACT (for ocean / road / rail / customs)¶
| Message | Назва | Напрямок | Use case | ShipCore use |
|---|---|---|---|---|
| IFTMIN | Forwarding instruction message | Shipper/Forwarder → Carrier | Передача інструкцій по shipment (з усіма деталями) | Phase 5 — для legacy carriers без REST API |
| IFTMBP | Provisional booking message | Shipper/Forwarder → Carrier | Попередній booking | Phase 5+ |
| IFTMBF | Firm booking message | Shipper/Forwarder → Carrier | Підтверджений booking request | Phase 5+ |
| IFTMBC | Booking confirmation message | Carrier → Shipper/Forwarder | Carrier confirms booking | Phase 5 (inbound parsing) |
| IFTMCS | Instruction contract status message | Carrier → Forwarder | Status update on contract/instruction | Phase 5+ |
| IFTSTA | International multimodal status report | Carrier / Visibility provider → Forwarder | Status events (gate-in, loaded, departed, arrived) | Phase 5 (inbound) |
| IFTRIN | Forwarding and transport rate information | Carrier → Forwarder | Rate response (?) | 💡 Phase 9+ |
| IFTMAN | Arrival notice | Carrier → Forwarder/Consignee | ETA notification | Phase 5+ |
| IFTMCA | Cancellation message | Either direction | Cancel previously sent message | Phase 5+ |
| CUSCAR | Customs cargo report | Carrier → Customs | Manifest для customs | 💡 Phase 9+ (через broker) |
| CUSDEC | Customs declaration | Declarant → Customs | Customs declaration submission | 💡 Phase 9+ (через broker) |
| COPARN | Container announcement | Forwarder/Carrier ↔ Terminal | Release notes / pre-advice | ✅ partial (containerhub) |
| COPRAR | Container discharge/loading order | Carrier → Terminal | Discharge/load instructions | 📋 Phase 8 |
| CODECO | Container gate-in/out report | Terminal → Carrier/Forwarder | Gate event reporting | ✅ partial (containerhub) |
| COREOR | Container release order | Carrier → Terminal | Authorize container release | 📋 Phase 8 |
| BAPLIE | Bay plan / Stowage plan | Carrier ↔ Terminal | Vessel stowage plan | ✅ partial (containerhub) |
| MOVINS | Stowage instruction | Carrier → Terminal | Loading/discharge sequence | 💡 Phase 9+ |
| VERMAS | Verified gross mass | Shipper/Forwarder → Carrier | SOLAS VGM submission | 📋 Phase 5 (paired with VGM declaration) |
4.2 ANSI X12 (US-analogue до EDIFACT)¶
| Message | Назва | EDIFACT-аналог | ShipCore use |
|---|---|---|---|
| 204 | Motor carrier load tender | IFTMIN | (skip — US trucking, не у v1) |
| 214 | Transportation carrier shipment status | IFTSTA | (skip — US-only) |
| 315 | Status details (ocean) | IFTSTA | Phase 9+ якщо US-customers |
| 410 | Rail carrier freight details and invoice | (rail invoicing) | (skip) |
| 856 | Advance ship notice (ASN) | DESADV | (skip — retail-domain) |
| 990 | Response to load tender | IFTMBC | (skip) |
ANSI X12 у v1 — skip. US trucking/rail = McLeod / Trimble TMW territory, не наш wedge. Якщо у Phase 9+ з'явиться US client — adapter buildable.
4.3 DCSA REST APIs (нова заміна EDIFACT для морських ліній)¶
Конкретний документ: GitHub
dcsaorg/DCSA-OpenAPI(всі OpenAPI 3 specifications), SwaggerHubdcsa.org.
| API | Версія | Notes |
|---|---|---|
| Track & Trace (TNT) | v3.x | Стандартизовані shipment events |
| Booking | v2.0 (Beta 2 May 2025) | Booking lifecycle |
| Bill of Lading (eBL) | v3.0 (final May 2025) | Issuance, surrender, transfer |
| Just-in-Time Port Call | v1.x | Vessel port call coordination |
| VGM | v1.x (Nov 2025) | API standard for verified container weights |
ShipCore Phase 5 deliverable: DCSAAdapter interface — імплементація під першого carrier (Maersk Spot), потім reuse для Hapag, CMA, MSC, ONE.
4.4 IATA Cargo standards¶
| Standard | Status | ShipCore use |
|---|---|---|
| Cargo-IMP (legacy text-based EDI) | "Containment" з 2026-01-01 (no further development) | Skip (legacy maintenance only якщо клієнт примусить) |
| Cargo-XML | "Containment" з 2026-01-01 | Skip |
| ONE Record (REST + JSON-LD) | Preferred з 2026-01-01 | Watch-list, prepare data model JSON-LD-friendly. Реальна імплементація — Phase 9+ коли є avia domain expert |
4.5 Maritime tracking aggregator APIs¶
Не EDI, але важлива messaging-layer для tracking.
| Provider | API type | ShipCore use |
|---|---|---|
| project44 | REST | Phase 5+ as fallback для non-direct carriers |
| Vizion | REST | Phase 5 — cheaper alternative ($200-500/міс per ~1000 containers) |
| Terminal49 | REST | Phase 5+ alternative до Vizion |
| FourKites | REST | Phase 9+ (US-first, deprioritized) |
| GoComet | REST | 💡 Phase 9+ |
4.6 Other messaging¶
| Standard | Use case | ShipCore use |
|---|---|---|
| AS2 / AS4 | Secure EDI transport | Carrier connectivity hub може використовувати як transport layer |
| SFTP | Legacy bulk EDI delivery | Required для багатьох carriers (Phase 5+) |
| PEPPOL | EU e-invoicing standard | Watch-list (e-invoicing мандат у багатьох EU countries з 2025-2027) |
Part 5 — Mandatory Standards (юридично обов'язкові — gap risk)¶
Це критичні standards. Пропуск = клієнт не може юридично працювати у відповідній юрисдикції. Кожен — must-have для ShipCore у відповідній фазі.
5.1 SOLAS VGM (Verified Gross Mass)¶
- Регулятор: IMO (International Maritime Organization).
- Mandatory since: 2016-07-01.
- Scope: Всі ocean containers globally.
- Vendors of compliance: Будь-який ocean shipper.
- Гарантійний gap: Container не вантажиться на судно без VGM.
- ShipCore coverage:
shipcore_sea.OceanBooking.vgm_status(pending/submitted/verified/loaded)shipcore_terminal.GateTransaction.vgm_kg+vgm_method(1=weighing / 2=calculation)- VGM PDF declaration (signed by shipper representative)
- VERMAS EDIFACT message generation для transmission to terminal
- Phase 5 — обов'язково ship з shipcore_sea release
5.2 IMO IMDG Code (International Maritime Dangerous Goods)¶
- Регулятор: IMO.
- Mandatory: Yes — для будь-якого dangerous goods sea transport.
- Coverage required: UN number (е.g. UN1203 for petrol), IMDG class (1-9), packing group (I/II/III), proper shipping name, EmS code, marine pollutant flag, flash point.
- ShipCore coverage:
shipcore.DangerousGoodsmodel з усіма IMDG fieldsshipcore_sea.DangerousGoodsDeclarationPDF- Phase 6+ (post-Maersk integration) — when клієнт почне DG shipments
5.3 NCTS Phase 5 (New Computerised Transit System)¶
- Регулятор: EU Commission (DG TAXUD).
- Mandatory since: 2024-12-02 (legal deadline), definitive period 2025-01-21.
- Status (May 2025): 85%+ transit declarations через NCTS5; всі member states + CTC contracting parties live.
- Scope: EU + Common Transit Convention countries (Швейцарія, Норвегія, Ісландія, Туреччина, UK post-Brexit, Сербія, Північна Македонія, Україна (?)).
- ShipCore coverage:
shipcore_forwarder.CustomsDeclaration(T1/T2)- Direct connect (через QDPro/M.E.Doc) vs broker — Phase 2 task для рішення (per decisions-2026-05-12)
- Phase 8 — EU expansion v1
5.4 eTTN UA¶
- Регулятор: Мінрозвитку громад, територій та інфраструктури України.
- Mandatory: Поетапно (тестування 2024-2025, повноцінна mandatory — заплановано кінець 2026).
- Підпис: КЕП / Дія.Підпис (ed25519).
- ShipCore coverage: ✅ existing у Fleet (9 моделей, integrated).
5.5 EU CBAM (Carbon Border Adjustment Mechanism)¶
- Регулятор: EU Commission.
- Transitional phase: 2023-10 → 2025-12 (quarterly reports).
- Definitive phase: 2026-01-01 (annual declaration, surrender CBAM certificates, financial liability for embedded emissions).
- Scope (commodities): Steel, aluminum, cement, fertilizers, electricity, hydrogen.
- First annual declaration: 2027-09-30 за 2026 calendar year.
- Logistics forwarder role: Не safe-harbor — forwarder є information manager (per ICS2 framing). Forwarder TMS має tracking CO2 footprint along supply chain (origin smelter → port → vessel → port → road → final destination).
- ShipCore coverage:
- 💡 Phase 9+ (advanced) —
shipcore.EmissionEventmodel для CO2 tracking per leg - Watch-list. Не блокує v1, але якщо клієнт працює з steel/aluminum imports — критично
5.6 EU ICS2 Release 3 (Import Control System 2)¶
- Регулятор: EU Commission.
- Mandatory timeline:
- 2024-06-03 — Maritime + inland waterways (Phase 3 part 1)
- 2025-04-01 — Road + rail (Phase 3 part 2)
- 2025-09-01 — Fully operational all transport modes
- 2026-01-01 / 2026-06-01 — Member-state-specific rollouts continue (Ireland/Spain/France/Italy/Lithuania/Hungary/Finland/Greece/Bulgaria — 1 січня 2026; Croatia/Latvia/Poland/Romania/Slovakia — 1 червня 2026)
- Scope: Pre-arrival ENS (Entry Summary Declaration) для всіх goods entering EU + Norway + Switzerland + Northern Ireland.
- ShipCore coverage:
shipcore_forwarder.ENSDeclarationmodel- Phase 8 — EU expansion v1
- Direct submit vs broker — Phase 2 task
5.7 EUDR (EU Deforestation Regulation)¶
- Регулятор: EU Commission.
- Mandatory:
- 2026-12-30 — Large/medium companies
- 2027-06-30 — Micro/small enterprises
- Scope: Palm oil, cattle, soy, coffee, cocoa, rubber, wood (та похідні: leather, chocolate, paper).
- Requirement: Geolocation coordinates of source plot + due diligence statement у EU IT system.
- Logistics forwarder role: Якщо клієнт imports targeted commodities — forwarder TMS має зберігати geolocation metadata + DDS reference per shipment.
- ShipCore coverage:
- 💡 Phase 9+ (advanced) —
shipcore.EUDRMetadatamodel - Watch-list. Не блокує v1, але є real risk для EU clients
5.8 UA Decree (UA paperwork обов'язкові форми)¶
- Регулятор: Кабмін UA + Мінінфраструктури.
- Mandatory: Усі офіційні форми перевізних документів (TTN, дорожній лист, путівка) мають відповідати затвердженим зразкам.
- ShipCore coverage: ✅ Fleet існуючі форми відповідають (waybill, eTTN).
5.9 EU Mobility Package (Driver hours + tachograph + posting)¶
- Регулятор: EU Commission.
- Mandatory: Tachograph regulations (EU 165/2014), driver posting rules (EU 2020/1057).
- ShipCore coverage:
- 💡 Phase 9+ —
shipcore_auto.DriverTachoEvent(driver hours/rest tracking) - Watch-list. Mandatory якщо UA carrier їздить у EU regularly
Part 6 — Emergent / Watch-list standards¶
Не mandatory зараз, але можуть стати у 2026-2028. Готувати adapters наперед — дешевше.
| Standard | Watch reason | ShipCore action |
|---|---|---|
| IATA ONE Record | Preferred standard з 2026-01-01; Cargo-IMP/XML "containment" | Підготувати JSON-LD-friendly data model у shipcore_avia stub. Реальна реалізація — Phase 9+ |
| DCSA eBL Reference Implementation | 9 carriers зобов'язались 100% adoption до 2030, відкритий код на GitHub | Phase 5 design shipcore_sea.BillOfLading як DCSA-compatible. Phase 8+ — interop через CargoX/WaveBL/Enigio |
| GAIA-X / Mobility Data Space / Catena-X | EU data spaces ініціативи; automotive supply chain (Catena-X) — потенційні clients | Watch-list, не критично у v1 |
| Open Logistics Foundation (Eclipse-hosted) | OSS реалізація eCMR, eDelivery — потенційний build-vs-buy partner | Watch-list. Можемо contribute після власної eCMR реалізації |
| GS1 Digital Link | URL-based GTIN/SSCC representation — для traceability use cases | Watch-list. Реалізація — коли з'явиться shipcore.ShipmentUnit (Phase 9+) |
| W3C Verifiable Credentials | Digital trust framework для signed e-documents (eBL, eCMR) | Watch-list. DCSA eBL вже use cryptographic signatures — тут можна стандартизувати |
| EUDR (deforestation) | Mandatory 2026-12-30 (large/medium) — як вище | 💡 Phase 9+, watch якщо EU clients з timber/coffee/cocoa |
| eFTI (electronic Freight Transport Information, EU Regulation 2020/1056) | Mandatory з 2025-08-21 для public authorities, з 2029 для всіх — для всіх freight transport modes | Critical watch — це EU equivalent eCMR на стероїдах для всіх modes. Потрібен Phase 8+ adapter |
| EU AES (Automated Export System) | EU export declarations — analogue NCTS for export | Phase 8+ — паралельно з NCTS T1 |
eFTI окремо: EU Regulation 2020/1056 створює стандартизований data exchange framework для всіх freight (road, rail, inland water, sea, air). На відміну від eCMR (тільки road), eFTI охоплює multimodal. Ratified 2020, mandatory для public authorities з 2025-08-21, очікується mandatory для economic operators з 2027-2029. Це майбутній baseline для всього EU multimodal e-document exchange. Має бути watch-list priority №1.
Part 7 — Mapping ShipCore модулів до стандартів¶
7.1 backend/shipcore/ (thin core, ALWAYS installed)¶
| Aspect | Coverage |
|---|---|
| Identifiers used | UN/Locode (Port/Station/Airport), ISO 6346 (Container), ISO 668 (ContainerType), IMO/MMSI (Vessel), IATA/ICAO (Airport), SCAC (Carrier), GLN (LocationPoint), EORI / РНОКПП / ЄДРПОУ / VAT (через Essentials) |
| Master data | Carrier, Vessel, Container, Wagon, Port, Station, Airport, Route, MarketCorridor, ShipmentEvent (UNECE Recommendation 24 codes) |
| Documents generated | (none directly — модуль провайдить master data) |
| EDI messages | (none directly) |
| Mandatory standards covered | (foundation для VGM, Dangerous Goods declarations) |
7.2 shipcore_auto¶
| Aspect | Coverage |
|---|---|
| Identifiers | Carrier (SCAC + AsMAP/IRU/TIR ID), Vehicle VIN, Driver license |
| Documents | TTN (paper UA), eTTN (UA mandatory), CMR (international road), eCMR (EU mandatory 2026), TIR Carnet, дорожній лист |
| EDI messages | TIR-EPD (IRU), eTTN signing (Дія.Підпис), eCMR transactions (TransFollow API) |
| Mandatory standards | UA Decree forms, eTTN UA, EU Mobility Package (tacho, driver hours — Phase 9+) |
7.3 shipcore_terminal¶
| Aspect | Coverage |
|---|---|
| Identifiers | ISO 6346 (Container), ISO 668 (ContainerType), UN/Locode (Terminal location) |
| Documents | EIR (Equipment Interchange Receipt), gate pass, weighing ticket |
| EDI messages | COPARN, COPRAR, CODECO, COREOR, BAPLIE, MOVINS, VERMAS (VGM) |
| Mandatory standards | SOLAS VGM (через VGM workflow), IMO IMDG (через DG yard zones) |
7.4 shipcore_forwarder¶
| Aspect | Coverage |
|---|---|
| Identifiers | EORI, MRN, Booking number, MBL/HBL number |
| Documents | Quote, Booking confirmation, FBL (FIATA), FCR, FCT, T1/T2 (NCTS), ENS (ICS2), commercial invoice, packing list, certificate of origin |
| EDI messages | IFTMIN, IFTMBP, IFTMBF, IFTMBC, IFTSTA, IFTMAN, IFTMCA |
| Mandatory standards | NCTS Phase 5 (T1/T2), ICS2 Release 3 (ENS), Incoterms 2020, sanctions screening (EU + OFAC) |
7.5 shipcore_sea¶
| Aspect | Coverage |
|---|---|
| Identifiers | IMO/MMSI (Vessel), Booking number, MBL/HBL (B/L), VGM declaration |
| Documents | Booking confirmation, B/L (paper), eBL DCSA, Sea Waybill, VGM declaration, manifest, IMO DG declaration |
| EDI messages | IFTMIN/IFTSTA/IFTMBC (legacy), DCSA REST APIs (Maersk/Hapag/CMA/MSC), VERMAS |
| Mandatory standards | SOLAS VGM, IMO IMDG, BIMCO clauses (через templates), Hague-Visby/Hamburg/Rotterdam Rules |
7.6 shipcore_rail¶
| Aspect | Coverage |
|---|---|
| Identifiers | UN/Locode (Station), wagon number (UIC numbering for EU, OSJD for CIS) |
| Documents | СМГС waybill, CIM waybill, CIM/СМГС combined waybill |
| EDI messages | (rail EDI specific — DB Cargo / PKP / RNE PCS — Phase 6+) |
| Mandatory standards | OTIF CIM / OSJD СМГС rules |
7.7 shipcore_avia¶
| Aspect | Coverage |
|---|---|
| Identifiers | IATA 3-letter (Airport), IATA 2-letter (Airline), AWB number, ICAO 4-letter |
| Documents | AWB, HAWB, MAWB, IATA DG declaration |
| EDI messages | Cargo-IMP / Cargo-XML (legacy, "containment"), IATA ONE Record (preferred з 2026) |
| Mandatory standards | IATA DGR (dangerous goods) |
7.8 shipcore_pricing¶
| Aspect | Coverage |
|---|---|
| Identifiers | (uses всі identifiers вище для cost categorization) |
| Documents | Tariff plan, Quote, Cost sheet, Lane rate report |
| EDI messages | (none — pricing у v1 internal, не передається via EDI) |
| Mandatory standards | Incoterms 2020 (CPT/CIP/DAP/DDP/EXW affects pricing structure) |
Part 8 — Priorities for ShipCore implementation (P0/P1/P2/P3)¶
P0 — Phase 4-5 must-have (foundation)¶
Identifiers (master data design): - ISO 6346 (Container) — refactor з containerhub - UN/Locode (Port, Station) — нові моделі - SCAC (Carrier) — нове поле - IMO + MMSI (Vessel) — нова модель - EORI (Client) — нове поле - РНОКПП / ЄДРПОУ / VAT (Client) — вже є
Documents: - eTTN — ✅ existing (Fleet) - TTN/CMR (UA paper) — print template Phase 7 - Booking confirmation — Phase 5 - VGM declaration — Phase 5
EDI: - IFTMIN basic (для legacy carriers без REST) — Phase 5 - DCSA Track & Trace REST — Phase 5 з Maersk - Vizion REST (tracking aggregator fallback) — Phase 5
Mandatory: - eTTN UA — ✅ - SOLAS VGM — Phase 5 (з shipcore_sea release) - Incoterms 2020 — Phase 5 (Quote/Booking field)
P1 — Phase 5-7 (significant coverage)¶
Identifiers: - IATA 3-letter (Airport) — навіть у avia stub - HS Code/EU CN (Item) — для EU expansion - TIR Carnet number — Phase 8 - MRN — Phase 8
Documents: - B/L (paper) — Phase 5 - DCSA eBL (через interop hub) — Phase 8+ - IFTMBC inbound parsing — Phase 5 - IFTSTA inbound parsing — Phase 5 - T1 (NCTS) — Phase 8 - ENS (ICS2) — Phase 8 - eCMR (через TransFollow / DigiCMR) — Phase 8 - СМГС / CIM rail waybills — Phase 6+
EDI: - IFTMBP/IFTMBF/IFTMBC outbound — Phase 5+ - IFTSTA inbound — Phase 5 - IFTMAN — Phase 5+ - COPARN/CODECO/BAPLIE — ✅ partial (containerhub) - VERMAS (paired with VGM) — Phase 5 - PortCall (DCSA) — Phase 6+
Mandatory: - NCTS Phase 5 — Phase 8 (must для EU operators) - ICS2 Release 3 — Phase 8
P2 — Phase 8+ (operational maturity)¶
Identifiers: - GLN (Location) — optional - ICAO 4-letter (Airport) — для avia stub - IATA 2-letter (Airline) — для avia stub
Documents: - IMO IMDG declaration — Phase 6+ - ATA Carnet — Phase 9+ - FBL/FCR/FCT (FIATA) — Phase 7 - AES (EU export declaration) — Phase 8+ - IATA AWB (через avia stub partnership з Awery?) — Phase 9+
EDI: - Hapag-Lloyd / CMA CGM / MSC REST — Phase 8 - COPRAR / COREOR — Phase 8 - CUSCAR / CUSDEC — Phase 9+ - DB Cargo / PKP rail EDI — Phase 8+
Mandatory: - EU CBAM (CO2 tracking per leg) — Phase 9+ - EU AES — Phase 8+
P3 — deferred / watch-list¶
- IATA ONE Record (full implementation) — Phase 9+
- GAIA-X / Catena-X — when клієнт примусить
- EUDR (EU Deforestation) — Phase 9+, watch
- W3C Verifiable Credentials — watch
- US ANSI X12 — only if US client
- CHIEF/CDS (UK customs) — only if UK client
- eFTI (EU multimodal e-document) — critical watch для post-2027 EU baseline
- Open Logistics Foundation OSS — потенційний contribution after own eCMR
- GS1 Digital Link / SSCC — Phase 9+
Part 9 — Sources¶
Standardization organizations (primary)¶
- UN/CEFACT — unece.org/cefact
- UNECE — unece.org/transport
- ISO — iso.org
- IMO — imo.org
- IATA — iata.org
- DCSA — dcsa.org + GitHub dcsaorg/DCSA-OpenAPI
- WCO — wcoomd.org
- IRU — iru.org + tirepd.iru.org
- OTIF — otif.org
- OSJD — osjd.org
- GS1 — gs1.org
- ICC — iccwbo.org (Incoterms 2020)
- NMFTA — nmfta.org (SCAC registry)
- АсМАП України — asmap.org.ua
- BIMCO — bimco.org
- FIATA — fiata.org
EU-specific¶
- EU CBAM — taxation-customs.ec.europa.eu/carbon-border-adjustment-mechanism
- EU ICS2 — taxation-customs.ec.europa.eu/customs/customs-security/import-control-system-2
- EU NCTS — taxation-customs.ec.europa.eu/online-services/online-services-and-databases-customs/new-computerised-transit-system-ncts
- EU EUDR — environment.ec.europa.eu/topics/forests/deforestation/regulation-deforestation-free-products
UA-specific¶
- eTTN — vchasno.ua/ttn (operator), Мінрозвитку громад — для regulator updates
- УКТЗЕД — customs.gov.ua (Держмитслужба)
- M.E.Doc — me-doc.com.ua (UA EDI hub partnership)
- АсМАП України — asmap.org.ua (DOZVIL_UA, TIR for UA carriers)
Reference reading (research articles)¶
- DCSA eBL milestone (May 2025) — dcsa.org/newsroom/ebl-interoperability-milestone
- ICS2 Release 3 status — taxation-customs.ec.europa.eu/news/transition-ics2-release-3-complete
- NCTS Phase 5 take-off — taxation-customs.ec.europa.eu/news/full-take-ncts-p5-being-achieved
- IATA ONE Record fact sheet — iata.org/en/iata-repository/pressroom/fact-sheets/fact-sheet-one-record
- EU CBAM definitive phase — bsigroup.com/en-US/insights-and-media/insights/blogs/preparing-for-eu-cbam-the-20262027-transition-explained
- eCMR Ukraine ratification — iru.org/news-resources/newsroom/ukraine-latest-country-ratify-e-cmr-protocol
- EUDR 2026 timeline — hqts.com/eudr-postponed
- SOLAS VGM (forwarder TMS) — riege.com/resources/blog/vgm-in-ocean-freight
- TIR-EPD user guide — iru.org/resources/iru-library/tir-epd-user-guide
Linkbacks¶
- README.md — ShipCore programmatic overview
- integration-matrix.md — карта зовнішніх API/EDI/регуляторних інтеграцій
- decisions-2026-05-12.md — 12 архітектурних/бізнес-рішень Phase 0
- market-research.md — рисерч ринку (Phase 1)
- roadmap.md — детальні фази імплементації (Phase 3)
Phase 1 research draft — 2026-05-12. Перевалідувати конкретні факти позначені (?) у Phase 2 при першій реальній інтеграції з відповідним carrier/regulator.