Skip to main content

Declaration API

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.

The principle is:

External Declaration System
             │
             │ API
             ▼
      BzCtrl Declaration
             │
             ▼
       Monitoring Engine
             │
             ▼
     Monitoring Overview

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.


Minimum data 


FieldDescription
Source systemOriginating system
Source referenceUnique source-system reference
MRNCustoms declaration reference
Declaration dateDate/time
Legal entityRelevant entity
EORIRelevant EORI
ProcedureCustoms procedure
ProductCommodity code
QuantityDeclared quantity
Quantity unitMT, KG, L, etc.
Customs valueCustoms value in EUR
Original declarationOptional original declaration/message