3. Data Ingestion & Supply Chain
Programmatic batch ingestion and management
List Supplier Mappings
Retrieves all mapped suppliers for the enterprise.
Register Supplier Mapping
Binds an internal ERP Vendor ID to an official EU TRACES Operator UUID.
Cryptographically link a batch to a shipment (Async)
Invokes the [BATCH_SHIPMENT_GATEKEEPER] Hedera Smart Contract to lock a verified batch to a logistics shipment. Emits a 'shipment.linked' webhook upon blockchain consensus.
List Verified Polygons
Retrieves a cursor-paginated list of all verified farm boundary polygons matching the organization scope.
Ingest GeoJSON Polygons (Async)
Programmatically ingest farm/production unit polygons. Returns 202 instantly. The bulk ingestion engine runs deforestation checks and fires 'polygon.verified' webhook upon completion.
List Batches
Retrieves a cursor-paginated list of registered EUDR batches.
Register a consolidated EUDR batch (Synchronous)
Programmatically create a new EUDR batch linked to an array of pre-verified Polygon IDs. Returns a 201 response with the batch details immediately.
Run compliance risk assessment for an EUDR batch
An explicit command to lock the batch, verify all attached legal documents, and run the EUDR oracle checks. Returns 202 instantly, and triggers the `batch.risk_assessed` webhook when finished.
Get batch by ID
Returns the consolidated risk state and linked shipment IDs for a single EUDR batch.
Delete an EUDR batch
Deletes a batch if it is not cryptographically linked to a shipment or TRACES NT.
Update an EUDR batch
Updates batch details if it is not cryptographically linked to a shipment or TRACES NT.
Get Supplier Mapping
Retrieves the mapping for a specific internal ERP Vendor ID.
Get Polygon compliance status
Synchronously query the deterministic EUDR compliance status (PENDING, COMPLIANT, HIGH_RISK) of a specific polygon before linking it to a high-value shipment.
Delete Polygon
Deletes a polygon if it is not cryptographically linked to a batch or shipment.
Unlink a Batch from a Shipment (EVM Rollback)
Asynchronously rollback the Hedera smart contract lock, freeing the batch for reassignment. Essential for logistics cancellations at the port.