P0 · Before the ramp

Transport Data
Preflight Engine

Sprawdź, czy przesyłka przejdzie cały cyfrowy workflow zanim kierowca pojawi się na rampie: właściwe dane, właściwa rola, właściwy etap, spójny czas i jawny kontrakt providera.

Role-aware
Lifecycle-aware
Provider-aware

Dane zostają w tej przeglądarce. Publiczny moduł nie wysyła fixture do eFTI Compliance ani providera.max 2 MB

CONTROLLED TRANSPORT RECORDSHP-2026-0917

transport_preflight_demo_v1

{
  "record_type": "transport_data_preflight_fixture",
  "profile_version": "transport_preflight_demo_v1",
  "shipment_reference": "SHP-2026-0917",
  "workflow": {
    "current_state": "proposed",
    "requested_transition": "reviewed",
    "target_operational_stage": "carrier_handoff",
    "actor_role": "carrier",
    "source_timezone": "Europe/Warsaw",
    "allowed_transitions": {
      "draft": [
        "proposed"
      ],
      "proposed": [
        "draft",
        "reviewed"
      ],
      "reviewed": [
        "proposed",
        "approved"
      ],
      "approved": [
        "reviewed",
        "signed"
      ],
      "signed": [
        "amended"
      ],
      "amended": [
        "reviewed",
        "approved",
        "signed"
      ]
    }
  },
  "fields": [
    {
      "field_id": "consignment.id",
      "label": "Identyfikator przesyłki",
      "value": "SHP-2026-0917",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper",
        "forwarder"
      ]
    },
    {
      "field_id": "document.reference",
      "label": "Referencja dokumentu",
      "value": "ECMR-DRAFT-0917",
      "field_owner": "forwarder",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "forwarder"
      ],
      "editable_by_roles": [
        "forwarder"
      ]
    },
    {
      "field_id": "sender.name",
      "label": "Nadawca",
      "value": "Demo Shipper sp. z o.o.",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper"
      ]
    },
    {
      "field_id": "sender.country",
      "label": "Kraj nadawcy",
      "value": "PL",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper"
      ]
    },
    {
      "field_id": "consignee.name",
      "label": "Odbiorca",
      "value": "Demo Retail GmbH",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper",
        "consignee"
      ]
    },
    {
      "field_id": "consignee.country",
      "label": "Kraj odbiorcy",
      "value": "DE",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper",
        "consignee"
      ]
    },
    {
      "field_id": "pickup.site",
      "label": "Miejsce odbioru",
      "value": "Poznań DC-04",
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse",
        "shipper"
      ]
    },
    {
      "field_id": "pickup.country",
      "label": "Kraj odbioru",
      "value": "PL",
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse"
      ]
    },
    {
      "field_id": "delivery.site",
      "label": "Miejsce dostawy",
      "value": "Berlin Hub-2",
      "field_owner": "shipper",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper",
        "consignee"
      ]
    },
    {
      "field_id": "delivery.country",
      "label": "Kraj dostawy",
      "value": "DE",
      "field_owner": "shipper",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper",
        "consignee"
      ]
    },
    {
      "field_id": "goods.description",
      "label": "Opis towaru",
      "value": "Consumer goods — demo fixture",
      "field_owner": "shipper",
      "source_system": "ERP",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "shipper"
      ],
      "editable_by_roles": [
        "shipper"
      ]
    },
    {
      "field_id": "goods.package_count",
      "label": "Liczba opakowań",
      "value": 36,
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse"
      ]
    },
    {
      "field_id": "goods.package_type",
      "label": "Typ opakowania",
      "value": "PALLET",
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse"
      ]
    },
    {
      "field_id": "goods.gross_weight_kg",
      "label": "Masa brutto",
      "value": 8420,
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse"
      ]
    },
    {
      "field_id": "carrier.name",
      "label": "Przewoźnik",
      "value": "Demo Carrier S.A.",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "forwarder"
      ]
    },
    {
      "field_id": "carrier.vat_id",
      "label": "Identyfikator przewoźnika",
      "value": "PL0000000000",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "forwarder"
      ]
    },
    {
      "field_id": "driver.name",
      "label": "Kierowca",
      "value": "Jan Demo",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "driver"
      ]
    },
    {
      "field_id": "driver.contact",
      "label": "Kontakt operacyjny kierowcy",
      "value": "+48 000 000 000",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "driver"
      ]
    },
    {
      "field_id": "vehicle.registration_number",
      "label": "Numer rejestracyjny pojazdu",
      "value": "",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "driver"
      ]
    },
    {
      "field_id": "vehicle.trailer_number",
      "label": "Numer naczepy",
      "value": "",
      "field_owner": "carrier",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "carrier"
      ],
      "editable_by_roles": [
        "carrier",
        "driver"
      ]
    },
    {
      "field_id": "transport.mode",
      "label": "Gałąź transportu",
      "value": "ROAD",
      "field_owner": "forwarder",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "forwarder"
      ],
      "editable_by_roles": [
        "forwarder"
      ]
    },
    {
      "field_id": "transport.route_reference",
      "label": "Referencja trasy",
      "value": "PL-DE-0917",
      "field_owner": "forwarder",
      "source_system": "TMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "forwarder"
      ],
      "editable_by_roles": [
        "forwarder"
      ]
    },
    {
      "field_id": "instructions.loading",
      "label": "Instrukcja załadunku",
      "value": "Rampa 12; zgłoszenie w ochronie",
      "field_owner": "warehouse",
      "source_system": "WMS",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "warehouse"
      ],
      "editable_by_roles": [
        "warehouse"
      ]
    },
    {
      "field_id": "provider.document_type",
      "label": "Typ dokumentu providera",
      "value": "ECMR",
      "field_owner": "integration",
      "source_system": "Gateway",
      "required_at_stage": [
        "carrier_handoff"
      ],
      "required_by_role": [
        "integration"
      ],
      "editable_by_roles": [
        "integration"
      ]
    }
  ],
  "timestamps": [
    {
      "event_id": "handoff_created",
      "label": "Utworzenie przekazania",
      "value": "2026-09-08T00:30:00+02:00",
      "source_system": "TMS"
    },
    {
      "event_id": "pickup_window_start",
      "label": "Początek okna odbioru",
      "value": "2026-09-08T08:00:00+02:00",
      "source_system": "WMS"
    },
    {
      "event_id": "carrier_arrival",
      "label": "Planowany przyjazd przewoźnika",
      "value": "2026-09-08T08:30:00+02:00",
      "source_system": "TMS"
    },
    {
      "event_id": "delivery_window_start",
      "label": "Początek okna dostawy",
      "value": "2026-09-09T09:00:00+02:00",
      "source_system": "TMS"
    }
  ],
  "temporal_constraints": [
    {
      "before": "handoff_created",
      "after": "pickup_window_start",
      "label": "Przekazanie musi powstać przed oknem odbioru"
    },
    {
      "before": "pickup_window_start",
      "after": "carrier_arrival",
      "label": "Okno odbioru nie może zaczynać się po przyjeździe"
    },
    {
      "before": "carrier_arrival",
      "after": "delivery_window_start",
      "label": "Dostawa musi następować po przyjeździe na załadunek"
    }
  ],
  "provider_profile": {
    "name": "Provider Sandbox Profile A",
    "profile_version": "2026.09-demo",
    "evidence_status": "fixture_only",
    "required_fields": [
      "consignment.id",
      "document.reference",
      "sender.name",
      "consignee.name",
      "pickup.site",
      "delivery.site",
      "goods.description",
      "goods.package_count",
      "goods.gross_weight_kg",
      "carrier.name",
      "vehicle.registration_number",
      "vehicle.trailer_number"
    ],
    "supported_lifecycle_states": [
      "draft",
      "proposed",
      "reviewed",
      "approved",
      "signed",
      "amended"
    ]
  },
  "fixture_notice": "Dane są demonstracyjne. Profil nie reprezentuje potwierdzonego kontraktu żadnego rzeczywistego providera."
}

przykład obliczony przy otwarciu

CARRIER HANDOFF READINESS

handoff blocked

2 pola, które przewoźnik musi uzupełnić przed przekazaniem.

92%

stage fields22/24ramp fields2temporalreview requiredprovider fixture83%

PRE-SIGNATURE APPROVALproposed → reviewed jest dozwolone przez politykę fixture.

allowed

✓draft
02proposed
03reviewed
04approved
05signed
06amended

Podgląd ocenia politykę przejścia. Nie zmienia stanu dokumentu i nie wykonuje podpisu.

ROLE / STAGE COMPLETENESSPola do uzupełnienia przed handoffem

vehicle.registration_numberNumer rejestracyjny pojazdusource: TMS

owner: carrieraktor może uzupełnić

vehicle.trailer_numberNumer naczepysource: TMS

owner: carrieraktor może uzupełnić

TEMPORAL CONSISTENCYŹródło → UTC → Europe/Warsaw

review required

Utworzenie przekazaniaTMS · 2026-09-08T00:30:00+02:00

UTC2026-09-07T22:30:00.000Z

LOCAL08.09.2026, 00:30:00

day shift

Początek okna odbioruWMS · 2026-09-08T08:00:00+02:00

UTC2026-09-08T06:00:00.000Z

LOCAL08.09.2026, 08:00:00

✓

Planowany przyjazd przewoźnikaTMS · 2026-09-08T08:30:00+02:00

UTC2026-09-08T06:30:00.000Z

LOCAL08.09.2026, 08:30:00

✓

Początek okna dostawyTMS · 2026-09-09T09:00:00+02:00

UTC2026-09-09T07:00:00.000Z

LOCAL09.09.2026, 09:00:00

✓

handoff_created: dzień źródłowy 2026-09-08, dzień UTC 2026-09-07. Sprawdź reprezentację w dokumencie.

PROVIDER-SPECIFIC CONFORMANCEProvider Sandbox Profile A2026.09-demo · fixture_only

10/12fixture fields

blocked

EVIDENCE BOUNDARYFixture result ≠ provider acceptanceBez realnego API, zmiany workflow, podpisu i potwierdzenia zgodności eFTI.

Cztery bramki przed wysłaniem

Schema valid to za mało, jeśli błąd ujawni się dopiero przy pickupie.

Preflight wiąże pole z momentem procesu, odpowiedzialną rolą, prawem edycji i wymaganiem kontraktu. Reguły czasu są wersjonowanymi warunkami procesu, a nie ukrytą logiką interfejsu.

01Role / stage completeness
field_owner, required_at_stage, required_by_role i wskazanie danych pozostawionych na rampę.
02Approval lifecycle
draft → proposed → reviewed → approved → signed → amended z jawnymi przejściami i prawem edycji.
03Temporal consistency
Offset ISO 8601, UTC i czas lokalny, kolejność zdarzeń oraz ostrzeżenie o przesunięciu dnia.
04Provider conformance
Wersjonowany profil wejściowy i brakujące pola bez deklaracji produkcyjnej kompatybilności.

Dlaczego ten zakres

Problemy są już opisane w realnych backlogach eCMR.

Open Logistics Foundation opisuje zarówno brakujące pola pojazdu ukryte w widoku mobile i niedziałający przycisk podpisu, jak też potrzebę review przed pierwszym podpisem oraz niespójne konwersje dat do UTC. To uzasadnia preflight przed handoffem, nie budowę kolejnej aplikacji kierowcy.

OLF · mobile carrier flow ↗OLF · review przed podpisem ↗OLF · UTC i format dat ↗

Pozycja B2B2B

Warstwa dla TMS i providerów — nie własny eCMR.

TransFollow rozwija partnerstwo z IRU i integracje osadzone w istniejących TMS-ach. Nasz defensywny zakres to kontrola danych przed tymi workflow: mapping, reguły kraju, monitoring wersji, conformance tests i preflight.

IRU · partnerstwo z TransFollow ↗Alpega · eCMR w TMS ↗Qargo · eCMR w workflow ↗

Linki dokumentują kierunek rynku. Nie potwierdzają integracji ani partnerstwa tych firm z eFTI Compliance.

Pre-production integration testing

Przetestuj jeden prawdziwy handoff, zanim stanie się problemem kierowcy.

Zaczynamy od zanonimizowanego fixture, właścicieli pól, jednego etapu operacyjnego i profilu docelowego API. Produkcyjny zakres wymaga dostępu do sandboxa i właścicieli procesu.

Sprawdź zakres audytu

Transport DataPreflight Engine