Customs
Customs Common Objects

Customs Common Objects

Create declarations in our customs system.

CustomsDeclaration

"...": {
	"accountId": 9999,
	"orderId": "I-12345678909",
	"deliveryTerm": {...},
	"eoriNumber": "",
	"invoice": {...},
	"packaging":  {...}
}
PropertyTypeLengthMandatoryDescription
accountIdInteger8MWill be provided by us. Identification for each customer (i.e. exporter).
orderIdString20MUnique identifier for invoice.
deliveryTermDeliveryTermM3-letter Incoterms® code.
eoriNumberString17OEORI number.
invoiceInvoiceMMain invoice part.
packagingPackagingMPackaging of invoice.

Invoice

"...": {
	"invoiceHeader": {...},
	"invoicePositions": [{...}],
	"invoiceFooter": {...}
}
PropertyTypeMandatoryDescription
invoiceHeaderInvoiceHeaderMHeader of invoice.
invoicePositionArray[InvoicePosition]MPositions of invoice.
invoiceFooterInvoiceFooterMFooter of invoice.

InvoiceHeader

"...": {
    "clientCustomerNumber": "164825",
    "clientEmailAddress": "test@customermail.com",
    "clientEmailAddresses":{
      "clientEmailAddress": 
            [
            "test1@company.com",
            "test2@company.com",
            "test3@company.com"
           ]},
    "invoiceDate": {...},
    "invoiceNumber": "2011406",
    "shipper": {...},
    "consignee": {...},
    "documents": [{...}],
	"transportIdentification": {...}
}
PropertyTypeLengthMandatoryDescription
customerIdString20OCustomer's optional reference number.
invoiceDateDate10MDate of the invoice.
invoiceNumberString8MInvoice number.
shipperCustomsPartyMShipper.
consigneeCustomsPartyMConsignee.
documentsCustomsDocumentsMDocuments for customs declaration.
transportIdentificationTransportIdentificationOTransport Identification

InvoicePosition

"...": {
		"itemCode": "1513",
		"itemDescription": "Printer",
		"customsTariffNumber": "8514684153",
		"deliveryNoteNumber": "11156",
		"quantity": 3,
		"totalPrice": 185.20,
		"netWeight": 2.48,
		"countryOfOrigin": "AT"
	}
PropertyTypeLengthMandatoryDescription
itemCodeString30MItem code.
itemDescriptionString30MDescription of item.
customsTariffNumberString10MCustoms tariff code.
deliveryNoteNumberString20ODelivery note number.
quantityBigDecimal13MQuantity of items. The unit (e.g. litres, meters, kilograms, etc.) is implied by the field "customsTariffNumber" according to authority's guideline.
totalPriceBigDecimal16MTotal price of position.
netWeightBigDecimal10OWeight of item (i.e. for each position) in KG w/o packaging.
procedureCodeString4OProcedure code for the customs process. NC_36000 standard.
additionalProcedureCodeString3OAdditional code for detailed specification of the procedure. NC_37000 standard.
countryOfOriginString2OCountry of origin for position
documentsArray[CustomsDocuments]CDocuments for customs declaration.

InvoiceFooter

"...": {
	"freightCosts": 45.66,
	"currencyCode": "EUR",
	"invoiceTotal": 196.25
}
PropertyTypeLengthMandatoryDescription
freightCostsBigDecimal10ODeductible costs of freight can be provided if necessary. If this field is left empty, the amount "0" is assumed.
currencyCodeString3MISO 4217 three letter currency code.
invoiceTotalBigDecimalMGrand total of invoice.

Packaging

"...": [{
	"packageType": "PK",
	"grossWeight": 196.25,
	"packagesTotal": 15,
	"packageReference": "1232344"
}]
PropertyTypeLengthMandatoryDescription
packageTypestring20OPackaging units of the article. This value needs to be always "PK".
grossWeightBigDecimal10CTotal weight of all articles in KG with packaging.
packagesTotalBigDecimal8MTotal packages of invoice.
packageReferenceString42OPackaging identification. E.g. MAWB

CustomsParty

"...": {
	"partyCode": 654684,
	"name": "",
	"address": "Teststreet 20",
	"city": "Vienna",
	"zipCode": "1010",
	"countryCode": "AT"
}
PropertyTypeLengthMandatoryDescription
partyCodeInteger20OCustomer account number, can be retrieved from operational business contact
nameString70M
addressString35M
cityString35M
zipCodeString9O
countryCodeString2MISO country code (ISO 3166-1 Alpha-2).

CustomsDocuments

A customs clearance requires documents. Here can you place which document will be used.

"...": {
	"documentType": "N325",
	"referenceNumber": "a12345678"
}
PropertyTypeLengthMandatoryDescription
documentTypeString4MA list of all document types can be found on this PAGE (opens in a new tab). Download the Current Report (Aktueller Report) PDF document available under the Code lists (Codelisten) section.
referenceNumberString20MReference for each document must be provided here.

ClientEmailAddress

A customs clearance requires documents. Here can you place which document will be used.

"...": {
            "clientEmailAddress": 
			[
              "test1@company.com",
              "test2@company.com",
              "test3@company.com"
            ]
}
PropertyTypeLengthMandatoryDescription
clientEmailAddressString60MClient Email address.

TransportIdentification

Transport Identification

"...":{
	"transportTypeAtDeparture": "3",
    "transportIdentityAtDeparture": "LKW",
    "transportNationalityAtDeparture": "AT",
    "transportTypeCrossingBorder": "3",
    "transportIdentityCrossingBorder": "LKW",
    "transportNationalityCrossingBorder": "AT"
}
PropertyTypeLengthMandatoryDescription
transportTypeAtDepartureString2MType of means of transport at departure. NC_20000 one letter code , like valid values: 3 (LKW), 4 (AIR), etc.
transportIdentityAtDepartureString27MIdentity of means of transport at departure. In case of LKW the licence plate number.
transportNationalityAtDepartureString2MNationality of means of transport at departure, e.g. AT.
transportTypeCrossingBorderString2MType of means of transport crossing border. NC_20000 one letter code , like valid values: 3 (LKW), 4 (AIR), etc.
transportIdentityCrossingBorderString27MIdentity of means of transport crossing border. In case of LKW the licence plate number.
transportNationalityCrossingBorderString2MNationality of means of transport crossing border, e.g. DE.