Decision owner
Screening service with specialist review
The named role remains accountable for the consequential decision.
Transportation & Logistics
Designed for Compliance specialist
Let the trade compliance specialist classify goods, validate restricted-party and licensing exposure, and assemble a defensible customs declaration file where every HS code, duty rate and exemption is traceable to a binding ruling, tariff schedule note or explanatory note.
Contract TRA-03 · primary aggregate CustomsDeclaration · mode loading
Decision brief
This brief starts with the decision, evidence, and accountable owner. The guided workflow then shows how the recommendation was produced.
The evidence and control points that shape this recommendation.
Decision owner
Screening service with specialist review
The named role remains accountable for the consequential decision.
Governed evidence
6 record types
Structured records and cited text ground the recommendation.
Workflow
5 controlled stages
Each transition records its input, output, status, and audit context.
Human controls
2 approval gates
Approval gates prevent the copilot from making consequential decisions.
An importer files a declaration covering 14 lines of lithium-ion battery modules assembled in Vietnam from Chinese cells.
Let the trade compliance specialist classify goods, validate restricted-party and licensing exposure, and assemble a defensible customs declaration file where every HS code, duty rate and exemption is traceable to a binding ruling, tariff schedule note or explanatory note.
filedDeclaration gives Compliance specialist the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Step 1 of 5
| Field | Value |
|---|
| Field | Value |
|---|
The output appears here immediately. More technical evidence remains available below.
The demonstration keeps deterministic controls, AI assistance, and approval separate.
Source systems enforce identity, workflow order, policy filters, and record updates.
Retrieval and generation assemble relevant evidence into a cited recommendation or draft.
Screening service with specialist review verifies material claims and approves the consequential action.
Run the stages in order before using the Copilot. Every stage explains what happens, why it matters, the evidence it uses, and the complete API request and response.
Automated stage
What happens: Document ingestion pipeline performs commercial document extraction using commercialInvoicePdf and produces LineItem. The transition is deterministic and does not require autonomous model approval.
Why it matters: LineItem gives Classification retriever the evidence needed to begin Candidate heading retrieval, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/commercial-document-extraction
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Classification retriever performs candidate heading retrieval using LineItem and produces candidateHeadingSet. The transition is deterministic and does not require autonomous model approval.
Why it matters: candidateHeadingSet gives Trade compliance copilot the evidence needed to begin Ruling and rule-of-origin grounding, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/candidate-heading-retrieval
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Trade compliance copilot performs ruling and rule-of-origin grounding using candidateHeadingSet and produces ClassificationOpinion. The transition is deterministic and does not require autonomous model approval.
Why it matters: ClassificationOpinion gives Screening service with specialist review the evidence needed to begin Restricted-party and license screening, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/ruling-and-rule-of-origin-grounding
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Screening service with specialist review performs restricted-party and license screening using Declaration and produces ScreeningResult. A named human approver must review the evidence before the transition completes.
Why it matters: ScreeningResult gives Compliance specialist the evidence needed to begin Specialist sign-off and broker filing, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/restricted-party-and-license-screening
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Compliance specialist performs specialist sign-off and broker filing using ClassificationOpinion and produces filedDeclaration. A named human approver must review the evidence before the transition completes.
Why it matters: filedDeclaration gives Compliance specialist the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/specialist-sign-off-and-broker-filing
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Run a stage to see its explanation, evidence, full request, and full response.
Ask a question and receive an answer grounded in retrieved CustomsDeclaration evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
customsDeclarations/tenantId + /declarationIdAn importer files a declaration covering 14 lines of lithium-ion battery modules assembled in Vietnam from Chinese cells. The copilot proposes heading 8507.60 for twelve lines, flags two lines as contested because the modules include an integrated battery management board, and cites the chapter 85 note plus a 2023 binding ruling on comparable BMS-integrated packs. Separately, a consignee screening run returns a 0.87 fuzzy match against a denied-persons entry. The specialist clears the match as a false positive with a recorded rationale, accepts the 8507.60 opinion for twelve lines, reclassifies the two contested lines after reading the cited ruling, and signs the declaration for broker filing.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
customsDeclarations |
Primary | /tenantId + /declarationId |
Declaration, LineItem, ScreeningResult, ClassificationOpinion |
tariffScheduleCatalog |
Reference | /tenantId + /hsChapter |
TariffRuleChunk |
customsRulingIndex |
Reference | /tenantId + /rulingId |
BindingRulingChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
Declaration |
customsDeclarations |
/tenantId + /declarationId |
declaration::{declarationId} |
None |
LineItem |
customsDeclarations |
/tenantId + /declarationId |
declaration::{declarationId}::line::{lineNumber} |
descriptionVector |
TariffRuleChunk |
tariffScheduleCatalog |
/tenantId + /hsChapter |
tariff::{hsChapter}::{ruleDocId}::{chunkOrdinal} |
chunkVector |
BindingRulingChunk |
customsRulingIndex |
/tenantId + /rulingId |
ruling::{rulingId}::{chunkOrdinal} |
chunkVector |
ScreeningResult |
customsDeclarations |
/tenantId + /declarationId |
declaration::{declarationId}::screening::{partyRole}::{screeningRunId} |
None |
ClassificationOpinion |
customsDeclarations |
/tenantId + /declarationId |
declaration::{declarationId}::opinion::{opinionId} |
rationaleVector |
List the lines still needing a classification decision before the declaration can be filed.
customsDeclarations
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.declarationId = @declarationId AND c.type = 'LineItem' AND c.classificationState IN ('unclassified','contested') ORDER BY c.lineNumber ASC
Retrieve chapter notes and rules of origin relevant to a candidate heading in the importing jurisdiction.
tariffScheduleCatalog
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.hsChapter = @candidateChapter AND c.type = 'TariffRuleChunk' AND c.jurisdiction = @countryOfImport AND c.effectiveFromUtc <= @filingDateUtc ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))
Surface binding rulings on similar commodities to support or challenge the proposed heading. Application-side partition-key fan-out across the customsRulingIndex reference container, bounded by the tenant prefix, the candidate heading prefix and a precedent lookback window, returning only the top-ranked ruling chunks.
customsRulingIndex
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'BindingRulingChunk' AND STARTSWITH(c.ruledHsCode, @candidateHeadingPrefix) AND c.rulingDateUtc >= @precedentLookbackUtc ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))
Show unresolved restricted-party matches that block filing.
customsDeclarations
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.declarationId = @declarationId AND c.type = 'ScreeningResult' AND c.matchDisposition = 'pending' AND c.matchScore >= @reviewThreshold ORDER BY c.matchScore DESC