eFTI ComplianceObservable Transport ConnectorsAdapter Runbook →Test vendorów

P0 · Integration Observability

Connector bez diagnozy to tylko kolejna czarna skrzynka.

Powiąż correlation ID, wersje, fingerprinty payloadów, walidację, retry i dead-letter queue. Pokaż, czy błąd powstał w source system, mapperze, providerze czy po stronie partnera.

  • Traceable
  • Version-aware
  • Owner-routed
TRACE MODECaptured fixture · fingerprints only
Fixture JSON ↓
Payload values are not displayed. Fixture przechowuje fingerprint, wersję i wynik walidacji.no live telemetry
CORRELATION IDcorr_01K58Q7N4W8X9B2M6Y3T

INTEGRATION FAILED

Shipment #LTL-US-88420

FAULT DOMAINMAPPERtarget_path_missing
FAILED STAGES1
BLOCKED DOWNSTREAM2
RETRY FAILURES3
DEAD LETTERQUARANTINED
INTEGRATION TRACEOd source contract do business gate
4 stages
  1. 01
    TMS rate requestpassed
    domain
    source
    owner
    transport_systems
    schema
    tms-rate-request-3.4.0
    mapping
    source-contract-2.2.1
    duration
    43 ms

    Required source fields present.

  2. 02
    Canonical rate mappingfailed
    domain
    mapper
    owner
    integration_engineering
    schema
    carrier-rate-response-2026-09-15
    mapping
    map-carrier-rate-1.8.2
    duration
    18 ms

    Expected rate.amount; provider fixture contains totalCharge.amount.

  3. 03
    Settlement validationblocked
    domain
    partner
    owner
    freight_settlement
    schema
    settlement-2.1.0
    mapping
    settlement-map-4.3.0
    duration
    0 ms

    Settlement comparison did not run.

  4. 04
    Invoice release gateblocked
    domain
    partner
    owner
    accounts_payable
    schema
    invoice-release-1.4.0
    mapping
    invoice-gate-2.0.0
    duration
    0 ms

    Invoice release remains blocked.

ROOT-CAUSE ROUTINGGdzie zaczęła się awaria?
high confidence
mappercanonical_mappingtarget_path_missing
owner
integration_engineering
next action
update mapping and replay from quarantine

To deterministyczne przypisanie z fixture, nie potwierdzenie dostawcy ani automatycznie wykonana naprawa.

RETRY & DLQCzy błąd został tylko powtórzony?
3 attempts
#1failedtarget_path_missing2026-09-19T07:42:12Z · not executed by this fixture
#2failedtarget_path_missing2026-09-19T07:42:42Z · not executed by this fixture
#3failedtarget_path_missing2026-09-19T07:43:42Z · not executed by this fixture
queuerate-response-mapping-dlqnot replayed
PAYLOAD EVIDENCERaw i mapped payload mają ślad bez ekspozycji wartości
TMS rate requestinputsha256:8d9930d0c81a-sourceoutputsha256:21092f8e7a8d-source
Canonical rate mappinginputsha256:0938570c163f-provideroutputsha256:e3b0c44298fc-empty
Settlement validationinputsha256:e3b0c44298fc-emptyoutputsha256:e3b0c44298fc-empty
Invoice release gateinputsha256:e3b0c44298fc-emptyoutputsha256:e3b0c44298fc-empty
EVIDENCE BOUNDARYDiagnosed fixture ≠ production root cause resolvedBrak live telemetry, payload values, retry execution, DLQ replay, provider confirmation i external mutation.

Customer evidence · EJ Group USA

Tydzień na znalezienie problemu to problem produktu.

W opublikowanym przez Shipwell customer story EJ Group opisuje, że przy integracji przez stronę trzecią samo zidentyfikowanie problemu zajmowało zwykle 1–2 tygodnie, a wdrożenie poprawki mogło potrwać kolejny tydzień. Ten materiał jest sygnałem jednego klienta, nie niezależnym benchmarkiem rynku.

Shipwell · EJ Group customer story ↗

Minimalny kontrakt observability

Każdy connector zostawia dowód.

01Correlation

Jeden identyfikator od source request do biznesowej bramki.

02Payload evidence

Kontrolowany raw capture i mapped payload z fingerprintem i polityką retencji.

03Version context

Schema, adapter i mapping version przy każdym etapie.

04Exception routing

Validation, retry, DLQ, fault domain oraz owner następnego działania.

Pre-production i runtime

Testuj vendorów i zostaw ślad po każdej awarii.

Assessment łączy scenariusze interoperacyjności z wymaganiami telemetrycznymi, zanim connector trafi do procesu krytycznego.

Zobacz Vendor Test