Skip to main content
Challenge

Build a Cross-Border Shipment Exception Evidence and Customer Notice Generator

Evaluate customs hold and physical cargo inspection exceptions across Singapore checkpoint manifests. Synthesize tamper-proof TradeTrust wrapped evidence packages and draft customer delay notices.

Business OperationsHosted by Vera
Challenge brief

What you are building

The core problem, expected build, and operating context for this challenge.

Evaluate customs hold and physical cargo inspection exceptions across Singapore checkpoint manifests. Synthesize tamper-proof TradeTrust wrapped evidence packages and draft customer delay notices.

Cross-border freight forwarder operations specialist

Ingest simplified normalized cross-border manifest records, checkpoint inspection hold logs, and seal discrepancy reports.

Detect manifest discrepancies including declared container weight drift and customs inspection hold status codes.

Wrap the structured cargo incident report into a verifiable OpenAttestation schema document.

Generate a structured delay explanation notice with mitigation steps and queue it for operational review.

A browser-based logistics incident console displaying checkpoint clearance statuses, an OpenAttestation document preview, and a customer notice editor.

Generate 25 synthetic cross-border container manifest records with checkpoint hold logs in JSON format, without requiring production credentials. Starter examples below are synthetic. They are not downloaded records.

OpenAttestation Applies the OpenAttestation wrapDocuments workflow to compute batch merkle roots and wrap exception evidence payloads.

vercel-ai-sdk, @govtechsg/open-attestation, zod. Vercel AI SDK provides streamlined streaming and structured object generation for drafting operational client notices. Requires an LLM capable of structured JSON generation via API or local serving.

Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

OpenAttestation wrapDocuments produces valid wrapped documents containing verifiable target hashes for each incident record.

Manifest inspection detects container gross weight variance exceeding declared tolerance thresholds.

The generated customer notice contains estimated hold duration, hold reason code, and immediate freight forwarder action items.

All simulated external updates are previewed in human review queues prior to mock transmission.

```json [ { "input": { "shipment_id": "SG-JB-2025-0891", "checkpoint": "Tuas Checkpoint", "declared_weight_kg": 18500, "measured_weight_kg": 20450, "seal_intact": false, "status_code": "HOLD_SEAL_MISMATCH", "consignee_name": "Lion City Electronics Pte Ltd", "cargo_description": "Precision server rack components" }, "expected_output": { "exception_detected": true, "weight_variance_kg": 1950, "oa_wrapped": true, "review_queue_item": { "shipment_id": "SG-JB-2025-0891", "action_required": "Physical re-inspection and carrier seal audit", "customer_notice_draft": "Shipment SG-JB-2025-0891 is held at Tuas Checkpoint due to a seal discrepancy and weight variance. An inspection dossier has been prepared." } } }, { "input": { "shipment_id": "SG-JB-2025-0892", "checkpoint": "Woodlands Checkpoint", "declared_weight_kg": 12000, "measured_weight_kg": 12010, "seal_intact": true, "status_code": "CLEARED_NORMAL", "consignee_name": "Jurong Cold Store Logistics", "cargo_description": "Frozen poultry cuts" }, "expected_output": { "exception_detected": false, "weight_variance_kg": 10, "oa_wrapped": false, "review_queue_item": null } } ] ```

Generates drafts for simulated operations; does not submit regulatory filings or trigger actual cargo releases. Use mock external writes. Require human review before any real deployment.

Rules

Participation guide

Generates drafts for simulated operations; does not submit regulatory filings or trigger actual cargo releases. Use mock external writes and human review.

Delivery guide

How work is evaluated

Evaluation

OpenAttestation wrapDocuments produces valid wrapped documents containing verifiable target hashes for each incident record. Manifest inspection detects container gross weight variance exceeding declared tolerance thresholds. The generated customer notice contains estimated hold duration, hold reason code, and immediate freight forwarder action items. All simulated external updates are previewed in human review queues prior to mock transmission.

Submission format

Runnable source, pinned dependencies, setup commands, working interface, example outputs, recorded demo, tests, and action logs.

Datasets

Challenge datasets

Public datasets, plus the private datasets you have access to.

Evaluation rubric

How submissions are scored

These dimensions define what the evaluator checks and which criteria separate a passable run from a strong one.

Dimensions
4 scoring checks
Binary
1 pass or fail dimensions
Ordinal
3 scaled dimensions
Dimension 1

Complete workflow

Ingest simplified normalized cross-border manifest records, checkpoint inspection hold logs, and seal discrepancy reports. Detect manifest discrepancies including declared container weight drift and customs inspection hold status codes. Wrap the structured cargo incident report into a verifiable OpenAttestation schema document. Generate a structured delay explanation notice with mitigation steps and queue it for operational review.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 2

Correctness and evidence

OpenAttestation wrapDocuments produces valid wrapped documents containing verifiable target hashes for each incident record. Manifest inspection detects container gross weight variance exceeding declared tolerance thresholds. The generated customer notice contains estimated hold duration, hold reason code, and immediate freight forwarder action items. All simulated external updates are previewed in human review queues prior to mock transmission.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 3

Review interface

A browser-based logistics incident console displaying checkpoint clearance statuses, an OpenAttestation document preview, and a customer notice editor.

Score scale
012
Score 0

Missing or incorrect.

Score 1

Partly complete, with documented gaps.

Score 2

Complete, with reproducible evidence.

Dimension 4

Safe execution

Generates drafts for simulated operations; does not submit regulatory filings or trigger actual cargo releases.

Binary check

This dimension contributes its full weight only when the submission satisfies the requirement. Partial credit is not awarded.

Learning goals

What you should walk away with

  • Ingest simplified normalized cross-border manifest records, checkpoint inspection hold logs, and seal discrepancy reports.

  • Detect manifest discrepancies including declared container weight drift and customs inspection hold status codes.

  • Wrap the structured cargo incident report into a verifiable OpenAttestation schema document.

  • Generate a structured delay explanation notice with mitigation steps and queue it for operational review.

Resources and assets

Reference links and supporting material

Dataset notes

Generate 25 synthetic cross-border container manifest records with checkpoint hold logs in JSON format, without requiring production credentials. Supplied starter examples are synthetic, not source extracts.

Challenge setup

Configuration summary for this challenge.

Challenge input

Input details are not configured.

Vercel AI SDK

TypeScript toolkit for AI apps.

Evaluated output

No output checks are configured.

Evaluation checks
  • Ingest simplified normalized cross-border manifest records, checkpoint inspection hold logs, and seal discr...
  • OpenAttestation wrapDocuments produces valid wrapped documents containing verifiable target hashes for each...
  • A browser-based logistics incident console displaying checkpoint clearance statuses, an OpenAttestation doc...
Configured evaluation evidence
  • 2 public reference cases
Configured runtime
  • 2 configured tools

Summary shows the first task, up to three tools, and up to three evidence items. Open the technical recipe to view all configured items.

View technical recipe

Configured tools

Action Space
  • Vercel AI SDK · Optional
Orchestration
  • Vercel AI SDK · Optional

Evaluation contract

  • Complete workflow · Weight 40
  • Correctness and evidence · Weight 30
  • Review interface · Weight 20
  • Safe execution · Weight 10

Reference cases

  • 2 public reference cases

Workflow tasks

No workflow tasks are configured.

Recipe freeze marker

No recipe freeze time is recorded.

Frequently Asked Questions about Build a Cross-Border Shipment Exception Evidence and Customer Notice Generator