# Declaration API

<div id="bkmrk-because-declaration-">Because declaration processes are increasingly automated, BzCtrl should provide an API through which external declaration systems can submit declaration information.

The API should be system-neutral.

Potential source systems include:

- SAP;
- Oracle;
- customs management systems;
- customs brokers;
- terminal systems;
- other ERP/WMS systems.

<div>  
</div>The principle is:

```
<div class="relative w-full mt-4 mb-1"><div class=""><div class="contents"><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-(--code-block-surface) corner-superellipse/1.1 overflow-clip rounded-3xl [--code-block-surface:var(--bg-elevated-secondary)] dark:[--code-block-surface:var(--composer-surface-primary)] lxnfua_clipPathFallback"><div class="relative"><div class="pe-11 pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼd ͼr" dir="ltr" id="bkmrk-external-declaration"><div class="cm-scroller"><code><span>External Declaration System
             │
             │ API
             ▼
      BzCtrl Declaration
             │
             ▼
       Monitoring Engine
             │
             ▼
     Monitoring Overview</span></code></div></div></div></div></div></div></div></div></div></div></div></div></div>
```

The API should allow the source system to provide structured declaration data.

It should also support, where technically appropriate, the original declaration/message so that BzCtrl can retain the source evidence and/or extract the relevant monitoring data.

The source system should provide a unique reference so that duplicate messages can be detected.

<div>  
</div>#### Minimum data 

<div>  
</div><div><table class="e-rte-table"><thead><tr><th class="">Field</th><th>Description</th></tr></thead><tbody><tr><td>Source system</td><td>Originating system</td></tr><tr><td>Source reference</td><td>Unique source-system reference</td></tr><tr><td>MRN</td><td>Customs declaration reference</td></tr><tr><td>Declaration date</td><td>Date/time</td></tr><tr><td class="">Legal entity</td><td class="">Relevant entity</td></tr><tr><td>EORI</td><td>Relevant EORI</td></tr><tr><td class="">Procedure</td><td class="">Customs procedure</td></tr><tr><td class="">Product</td><td class=""><span>Commodity code</span></td></tr><tr><td>Quantity</td><td>Declared quantity</td></tr><tr><td class="">Quantity unit</td><td>MT, KG, L, etc.</td></tr><tr><td>Customs value</td><td class="">Customs value in EUR</td></tr><tr><td class="">Original declaration</td><td>Optional original declaration/message</td></tr></tbody></table>

</div></div>