API Endpoint & JSON functions
|
Endpoint |
| /erpservices/importdossier |
| JSON Element | Type | Spec | Description |
| applicationReferenceId | {string} | {1-255} | Your application reference id. Used to communicate about this specific item. Using unique values within your system is suggested but not required. |
| doNotSaveWhenInvalid | {boolean} | True/false | A boolean indicating whether not save the item when it is invalid for submission. (default = false, so by default invalid data will be saved). When “true,” it is especially recommended to be able to process/display feedback from the link in the ERP package, which is the reason why the data was not saved. |
| doPrintWhenValid | {boolean} | True/false | A value indicating whether to submit the declaration when it is valid (default = false) |
Stap 1: Aangifte
| Nr | Veldnaam in Shipment | TAG | Type | Spec | Opmerking |
| 1 | Aangiftevolgnummer (FRN) | {string} | {1-30} | FunctionalReference Number {string} Automatically generated | |
| 2 | Algemene gegevens Dossiernummer | dossierNumber swProvisioningDeclarations. applicationReferenceId |
{string} {string} |
{1-30} |
dossierNumber = Dossiernaam in Shipment applicationReferenceId = De referentie-id van uw toepassing. Gebruikt om te communiceren over dit specifieke item. Het gebruik van unieke waarden binnen je systeem wordt aangeraden maar is niet verplicht." |
| 3 | Geplande proviandering + Geplande tijd | swProvisioningDeclarations. borderTransportMeansPortActivity | {date-time} | Example: 2025-11- 29T04:04 :03+00:0 0 |
Gets the border transport means port activity. |
Stap 2: Aangever
| Nr | JSON Element | Type | Spec | Description |
| 1 | swProvisioningDeclarations. Declarant. eoriNumber | {string} | {1-35} | To retrieve all declarant address details (((?![Nn][Ll])([A-Za-z]{2})([0-9A-Zaz]{5,15}))|([Nn][Ll]([0-9]{9,10}))) NOTE: You cannot set an declarant to “Agent” and “Supplier” simultaneously when using API |
Stap 3: Transport
| Nr | JSON Element | TAG | Type | Spec | Description |
| 1 | Grensoverschrijdend Naam van het vlieg-/vaartuig | swProvisioningDeclarations. declarationData. borderTransportMeansName | {string} | {0-70} | Gets or sets the name of the border transport means. |
| 2 | Grensoverschrijdend Soort identificatie | swProvisioningDeclarations. declarationData. borderTransportMeansIdentificationType | {string} | {0-17} | Gets or sets the type of the border transport means identification (M03). |
| 3 | Grensoverschrijdend Identificatie van het vlieg-/vaartuig | swProvisioningDeclarations. declarationData. borderTransportMeansIdentification | {string} | {0-25} | Gets or sets the border transport means identification. |
| 4 | Grensoverschrijdend Code van de haven | swProvisioningDeclarations. declarationData. borderTransportMeansDepartureConveyanceIdentif ication | {string} | {0-35} | Gets or sets the border transport means departure conveyance identification. |
| 5 | Grensoverschrijdend Identificatie van de terminal | swProvisioningDeclarations. declarationData. borderTransportMeansStay | {string} | {0-35} | Gets or sets the border transport means stay. |
Stap 4: Bevoorrader
| Nr | JSON Element | Type | Spec | Description |
| 1 | swProvisioningDeclarations. shipChandler. internalCode | {string} | {1-450} | The internal code for identifying the address in the addressbook. To retrieve all address details, so only this value is needed. |
Stap 5: Artikelen
| Nr | Veldnaam in Shipment | TAG | Type | Spec | Opmerking |
| 1 | Master reference number (MRN) | swProvisioningDeclarations. declarationData. goodsShipments. additionalDocument. identification | {string} | {0-70} | Gets or sets the identification |
| 2 | Type douanedocument | swProvisioningDeclarations. declarationData. goodsShipments. type. | {string} | {1-3} | Gets or sets the type (A28) |
| 3 | Artikelnummer | swProvisioningDeclarations. declarationData. goodsShipments. sequenceNumber | {integer} | {1- 999} | Gets or sets the sequence number starting from 1 incremented by 1 for every item. |
| 4 | Provianderingcode goederen | swProvisioningDeclarations. declarationData. goodsShipments. governmentAgencyGoodsIte ms Commodity. classificationIdentification | {string} | {0-18} | Gets or sets the classification identification (N88). |
| 5 | Hoeveelheid aanvullende eenheden | swProvisioningDeclarations. declarationData. goodsShipments. goodsMeasure. tariffQuantity | {number} | {0- 10000 00000 00000 00} | Gets or sets the tariff quantity. |
| 6 | Soort aanvullende eenheden | swProvisioningDeclarations. declarationData. goodsShipments. goodsMeasure. tariffUnitCode | {string} | {0-3} | Gets or sets the tariff unit code. |
Stap 6: Overzicht
