Developer reference

Build against an explicit scope, version and evidence trail.

The design goal is a stable integration contract with transparent ownership, mapped input, rule version, result and review boundary.

Canonical object

A record can represent more than one delivery.

{
  "trip_id": "example-trip",
  "consignments": [{
    "consignment_id": "example-consignment",
    "stops": [],
    "parties": [],
    "documents": []
  }],
  "provenance": {
    "source_system": "example-tms",
    "mapping_version": "example-v1"
  }
}

This is an illustrative internal shape, not a new exchange standard. Real integration profiles must adopt relevant external specifications and handle multi-stop, multi-consignment access boundaries.

Result design

Every failed rule should be actionable.

RULE

Profile and version

Identify the exact subset, rule and profile version being evaluated.

FIELD

Source and owner

Link a missing or conflicting value to the system and party that can fix it.

TRACE

Evidence and correlation

Retain the check time, fixture or payload reference and review state.

Capability status

Do not mistake a sample for a production integration.

CapabilityStatusMeaning
Browser assessment and field-name scannerPUBLIC DEMOLocal educational tools only
Paid software entitlementNOT AVAILABLENo account, live checkout or paid tool release
Document Runtime PreflightTEST DESIGNSpain DeCA conformance design; scope and limitations
Public preflight API / SDKPLANNEDNo public endpoint
Read-only Compliance MCPPLANNEDSame scoped, permissioned rules and evidence as API; no MCP server is deployed
Authority submissionsNOT AVAILABLEDo not treat this project as a certified platform or Gate
See conceptual API contract
Proposed agent surface

Read-only answers with cited rule evidence.

A future Compliance MCP Server would expose get_shipment_readiness, explain_blocking_issue, get_country_requirements, get_rule_source, get_gate_status, check_document_runtime and get_evidence_pack. Every response must carry tenant and user authorization, scope, rule version, source, observed time and UNKNOWN or REVIEW REQUIRED where evidence is missing. No write tools or authority submissions are in the current scope.

Software direction

Make transport data issues visible before the handoff.

Explore the public demo and compare proposed software plans. Paid access is not open yet.

Compare plans