As part of an interface integration Scope is able to send events back which occur during the declaration process.These events are being triggered by a customs response message.
These message will alway be returned real-time directly after the event occured.
The format of the messages is the same like the already known "Scope Event" interface in Forwarding. Für customs purposes there are only additional codes, and some addition reference information.
Active and Configure in Scope
The return of the desired events can be defined in the Scope partner profile:
- for Customs-DE in the role "ATLAS-Declarant"
- for Customs-NL in the role "Netherlands Customs Partner"
- for Customs-CH in the role "EZV Declarant.
In this screen you can choose, Which Events shall be returned to your system; assiging / de-assigning is done by selecting an event then click "Add", or "Remove" respesctively. Multi-seletion via CTRL-Click is possible.
The receiving system needs to be entered as receiver in the top field. It must be the same like the one which send in the interface messages; if not, Scope does not have a valid remote links to this system.
Available Events / Codes
Scope can return the following events. Boxes in YELLOW are the same in all customs procedures, and hence universally valid. BLUE events are by nature only available in dertain processes. Which processes is mentioned in the rightmost column.
| Code | Short Description | Relates To | Long Description | Only in |
|---|---|---|---|---|
| CDS | Customs Declaration Sent | Declaration | A customs declaration has been sent to customs. This signals that Scope will not accept updates or cancellations to the related shipment any longer. | |
| CAP | Customs Declaration Accepted | Acceptance | This event is sent when a customs declaration has been accepted by customs. | |
| COK | Customs Declaration Registered | Registration | This event is sent when a customs declaration has been successfully transmitted to customs and has thus gained a customs entry number. This event can occur multiple times if the customs entry number changes. | |
| CLD | Customs cleared | Release | The declaration is cleared and OK. | |
| CGL | Guarantee loaded | Guarantee load | My guarantee has been charged after a release of a Transit | Transit |
| CRR | Declaration Error Message | Error | The declaration received a customs error message. Usually means that it must be reset. | |
| CPR | Exceptions during customs clearance | Exception | This event is sent if exceptions have occured during the clearance process. In particular rejections or document / goods inspections. | |
| CTX | Tax Assessment received | Tax assessment | Tax assessment has been issued initially. | Import, incl, Bonded Warehouse |
| CRV | Tax Assessment reversed | Tax assessment | The tax assessment has been cancelled by customs. However, the declaration is not necessarily rejected. This event may contain a new customs entry number. | |
| CDR | Customs Duties Re-assessed | Tax assessment | New / Corrected Tax assessment submitted (SRATAX) | |
| CCE | Customs Examination | Inspection | Customs has ordered an examination of the goods | |
| CCL | Customs Declaration Cancelled | Cancellation | This event is sent when a customs declaration has been cancelled. | |
| CTA | Transit Arrived Export Shipment Arrived at Point Of Exit | Presentation | An NCTS declaration has received an Unload Permission after sending the Arrival Notification An Export Shipment has received an Allowance for Exit after Presentation | Transirt, Export |
| CFN | Customs Procedure Finished | Finishing | This event is sent when a customs procedure has been completed. | Transit, Export, SumA |
| CGL | Guarantee released after finishing | Guarantee load | My guarantee has been cleared after a finishing of a Transit | Transit |
Information Content in the Event message
The following Reference Informationen is returned:
| Field | contains |
|---|---|
| scopeCode | Event code |
| description | Event description |
| location/name | Scope-Partner's Branchcode |
| customsReferenceNumber | Declaration reference number |
| customsRegistrationNumber | Declaration registration number |
| customsItemNumber | Number of the goods item line, if required |
| customsGRN | Guarantee number (for Transit procedures) |
In addition, further information is returned in the event, provided it is available:
| Field | contains |
|---|---|
| shipper | Consignor |
| consignee | Consignee |
| shipmentNumber | Shipment Number |
| shipmentReference | Shipment Identification |
| houseDocumentNumber | House-BL / HAWB |
| transportDocumentNumber | Nr. of the Transport Document |
| mutuallyAgreed | Agreed Reference |
| invoiceNumbers | invoice number(s) |