invoice-main

Schema downloads

The JSON schema for this format can be downloaded here.

Use this link to download the strict schema, which will disallow unknown properties for as much as that is possible witin the schema language. Our internal processes simply ignore unknown properties but the strict schema can be usefull to notice typo's.

We will on occasion add new fields without notifying all recipients of the file. Therefore please do not use the strict schema for validation of files we send to you. If you want to validate our files at your end, the standard schema can be used. We will notify all recipients before doing a change in a file that would cause it to no longer match the standard schema.

root

metadata [O] Object
invoices [M] Array of Object

metadata

source [O] String Source system or customer code.
messageId [O] String Unique id for the message.
messageReference [O] String Customer reference for the message.
messageType [O] String Type name of the message.
messageRootId [O] String Message id of the first message in a chain of messages.
timeStamp [O] String Format: date-time Date and time the message was generated. If time zone information is omitted, is UTC.

invoices

number [M] String Max 12 char Jan de Rijk reference for this invoice.
purchaseOrderNumber [O] String Customer reference of the purchase order for this invoice.
downloadUrl [O] String Url that can be used to download the image of the invoice. Access only given after specific customer request.
isCreditNoteForInvoiceNumber [O] String Max 12 char The invoice number of the invoice for which this is a credit note.
customer [M] Object
specificationReportType [M] String Max 20 char Possible values:
  • "general"
  • "airCargo"
  • Relevant report for showing invoice specifications in the Jan de Rijk customer portal.
    currencyCode [M] String Max 3 char Currency code for the invoice as per https://en.wikipedia.org/wiki/ISO_4217.
    paymentTerm [M] Integer Number of days until payment should be done.
    invoiceDate [M] String Format: date-time Includes time zone indicator.
    exchangeDate [O] String Format: date-time Includes time zone indicator.
    legalEntity [M] Object
    exchangeRateFromEUR [M] Number The exchange rate of the invoice in relation to Euros. Multiply this with an invoice currency amount to get Euros.
    lines [M] Array of Object
    taxLines [M] Array of Object
    booked [O] Boolean True if the invoice is to be booked in the Jan de Rijk financial system.
    printed [O] Boolean
    manualTrigger [O] Boolean
    orders [O] Array of Object

    invoices.customer

    code [M] String Max 40 char
    number [M] String Max 20 char Jan de Rijk code for the customer.
    name [O] String
    eanNumber [O] String
    chamberOfCommerceNumber [O] String
    dunsNumber [O] String
    website [O] String
    blocked [O] Boolean
    enabled [O] Boolean
    types [O] Array of String
    isInterCompany [M] Boolean Boolean to figure out if the order belong to an intercompany.
    address [O] Object
    financial [O] Object
    tax [O] Object
    sector [O] Object
    holdingParty [O] Object
    charter [O] Object
    contact [O] Object

    invoices.customer.address

    locationCode [O] String Max 5 char Only to be used if the location is an airport, in whcih case it should be the IATA code.
    name [O] String Max 35 char
    name2 [O] String Max 35 char
    name3 [O] String Max 35 char
    line1 [M] String Max 35 char Street name and number.
    line2 [O] String Max 35 char
    line3 [O] String Max 35 char
    city [O] String Max 35 char
    postalCode [M] String Max 10 char
    poBox [O] String
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO Alpha-2 (https://www.nationsonline.org/oneworld/country_code_list.htm) country code.
    longitude [O] Number
    latitude [O] Number

    invoices.customer.financial

    preferredCurrency [O] String
    iban [O] String
    bic [O] String
    paymentDays [O] Integer

    invoices.customer.tax

    code [O] String
    countryCode [O] String

    invoices.customer.sector

    number [O] String
    name [O] String

    invoices.customer.holdingParty

    number [O] String
    name [O] String
    sector [O] Object

    invoices.customer.holdingParty.sector

    number [O] String
    name [O] String

    invoices.customer.charter

    permits [O] Array of String
    trackingProviderCode [O] String
    trackingId [O] String

    invoices.customer.contact

    name [O] String
    emailDetails [O] Array of Object
    telephoneDetails [O] Array of Object
    faxNumber [O] String

    invoices.customer.contact.emailDetails

    type [O] String Possible values:
  • "normal"
  • null
  • value [O] String E-mail address.

    invoices.customer.contact.telephoneDetails

    type [O] String Possible values:
  • "normal"
  • null
  • value [O] String Phone number.

    invoices.legalEntity

    code [M] String Max 3 char
    Pattern: ^[0-9]{3}$
    The code of the Jan de Rijk legal entity handling the order.
    relationCode [O] String Max 40 char
    number [M] String Max 20 char Jan de Rijk code for the customer.
    name [O] String
    eanNumber [O] String
    chamberOfCommerceNumber [O] String
    dunsNumber [O] String
    website [O] String
    blocked [O] Boolean
    enabled [O] Boolean
    types [O] Array of String
    isInterCompany [M] Boolean Boolean to figure out if the order belong to an intercompany.
    address [O] Object
    financial [O] Object
    tax [O] Object
    sector [O] Object
    holdingParty [O] Object
    charter [O] Object
    contact [O] Object

    invoices.legalEntity.address

    locationCode [O] String Max 5 char Only to be used if the location is an airport, in whcih case it should be the IATA code.
    name [O] String Max 35 char
    name2 [O] String Max 35 char
    name3 [O] String Max 35 char
    line1 [M] String Max 35 char Street name and number.
    line2 [O] String Max 35 char
    line3 [O] String Max 35 char
    city [O] String Max 35 char
    postalCode [M] String Max 10 char
    poBox [O] String
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO Alpha-2 (https://www.nationsonline.org/oneworld/country_code_list.htm) country code.
    longitude [O] Number
    latitude [O] Number

    invoices.legalEntity.financial

    preferredCurrency [O] String
    iban [O] String
    bic [O] String
    paymentDays [O] Integer

    invoices.legalEntity.tax

    code [O] String
    countryCode [O] String

    invoices.legalEntity.sector

    number [O] String
    name [O] String

    invoices.legalEntity.holdingParty

    number [O] String
    name [O] String
    sector [O] Object

    invoices.legalEntity.holdingParty.sector

    number [O] String
    name [O] String

    invoices.legalEntity.charter

    permits [O] Array of String
    trackingProviderCode [O] String
    trackingId [O] String

    invoices.legalEntity.contact

    name [O] String
    emailDetails [O] Array of Object
    telephoneDetails [O] Array of Object
    faxNumber [O] String

    invoices.legalEntity.contact.emailDetails

    type [O] String Possible values:
  • "normal"
  • value [O] String E-mail address.

    invoices.legalEntity.contact.telephoneDetails

    type [O] String Possible values:
  • "normal"
  • value [O] String Phone number.

    invoices.lines

    id [M] String The id of the invoice line. Unique within the invoice.
    chargeCode [O] String Jan de Rijk code of the type of charges.
    chargeCategory [O] String Possible values:
  • null
  • "transport"
  • "secondDriver"
  • "extraStop"
  • "waitingTime"
  • Expand
    sellingDate [M] String Format: date-time Includes time zone indicator.
    description [O] String
    additionalDescriptions [O] Array of String
    amountLocalCurrency [M] Number The amount in Euros.
    amountForeignCurrency [M] Number The amount in the currency of the invoice.
    quantity [O] Number The relevant quantity used to determine the amount.
    shipmentNumber [O] String Pattern: ^(([0-9]{12})|([0-9]{15}))$ The relevant Jan de Rijk shipment number. This refers to $.invoices.orders.shipments.number. Only filled in for shipment level charges.
    orderNumber [M] String Pattern: ^(([0-9]{12})|([0-9]{15}))$ The relevant Jan de Rijk order number. This refers to $.invoices.orders.number.

    invoices.taxLines

    id [M] String Unique within the invoice.
    taxAmountLocalCurrency [M] Number Tax amount in Euros.
    taxAmountForeignCurrency [M] Number
    baseAmountLocalCurrency [O] Number Tax amount in Euros.
    baseAmountForeignCurrency [O] Number
    invoiceLineIds [O] Array of String
    rate [O] Number
    vat [O] Object VAT information
    description [O] String

    invoices.taxLines.vat

    VAT information

    type [M] String Possible values:
  • "free"
  • "low"
  • "high"
  • "deffered"
  • "unknown"
  • typeCode [O] Number
    calculationMethodCode [O] Number

    invoices.orders

    number [M] String Pattern: ^(([0-9]{12})|([0-9]{15}))$ Internal Jan de Rijk number for the original order of the customer.
    reference [M] String Max 30 char Customer's reference for the order. This is the reference that would be used to refer to the order in any communication between the customer and Jan de Rijk. Comes from transportorder-main: $.orders.
    source [O] String Max 30 char Possible values:
  • "edi"
  • "rpa"
  • "portal"
  • "manual"
  • "automatic"
  • Expand
    Source of the order data.
    internal [M] Boolean Specifies if it concerns an internal order.
    ediReference [O] String Customer unique id for the order.
    invoiceReference [O] String Used as purchase order reference for invoicing and accounting.
    cancelled [M] Boolean Specifies if the order is cancelled.
    type [M] String Possible values:
  • "manifest"
  • "simple"
  • The type of the order.
    customerData [O] Object
    departmentCode [?] String Max 3 char
    Pattern: ^[0-9]{3}$ Possible values:
  • "100"
  • "102"
  • "104"
  • "105"
  • "130"
  • Expand
    The code of the Jan de Rijk department that should handle the order. Usually a fixed value that can be provided at the start of the integration project.
    product [?] String Possible values:
  • "generalCargo"
  • "importContainers"
  • "exportContainers"
  • null
  • The Jan de Rijk product relevant for the order. Usually a fixed value that can be provided at the start of the integration project.
    customer [M] Object
    originalLoading [?] Object
    finalUnloading [?] Object
    containerPickUp [?] Object
    containerDropOff [?] Object
    measurement [M] Object
    packageType [O] String Possible values:
  • null
  • "pallet"
  • "colli"
  • "euroPallet"
  • "trailer"
  • Expand
    tariffType [O] String Possible values:
  • null
  • "normal"
  • "adHoc"
  • "loadIndex"
  • "fullTruckLoad"
  • Expand
    tariffTypeName [O] String
    breakCode [O] String An additional invoice code in case the customer wants to split the invoices by those codes. Meaning to be discussed with Jan de Rijk finance department.
    shipments [M] Array of Object

    Conditinally required properties

    Some properties mentioned above are sometimes mandatory and sometimes optional or not available, note the [?]. These are the possible combinations of properties that can be used:

    invoices.orders.customerData

    invoices.orders.customer

    number [M] String Max 40 char
    code [M] String Max 20 char Jan de Rijk code for the customer.
    name [O] String
    isInterCompany [M] Boolean Max 20 char Boolean to figure out if the order belong to an intercompany.
    eanNumber [O] String EAN number of the customer.
    address [O] Object
    remarks [O] String

    invoices.orders.customer.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.originalLoading

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.originalLoading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.originalLoading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.originalLoading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.originalLoading.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.

    invoices.orders.originalLoading.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.finalUnloading

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.finalUnloading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.finalUnloading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.finalUnloading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.finalUnloading.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.
    earlyPossible [O] Boolean If true, Jan de Rijk can pick-up the cargo outside the time window.

    invoices.orders.finalUnloading.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.containerPickUp

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.containerPickUp.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.containerPickUp.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.containerPickUp.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.containerPickUp.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.

    invoices.orders.containerPickUp.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.containerDropOff

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.containerDropOff.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.containerDropOff.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.containerDropOff.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.containerDropOff.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.
    earlyPossible [O] Boolean If true, Jan de Rijk can pick-up the cargo outside the time window.

    invoices.orders.containerDropOff.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.measurement

    grossWeight [O] Number 3 decimals Kilograms.
    netWeight [O] Number 3 decimals Kilograms.
    chargeableWeight [O] Number 3 decimals Kilograms.
    quantity [O] Number
    volume [O] Number 3 decimals Cubic metres.
    volumeWeight [O] Number 3 decimals Kilograms. Usually only used for air freight.
    loadIndex [O] Number 3 decimals
    palletPlaces [O] Number 3 decimals

    invoices.orders.shipments

    number [M] String Pattern: ^(([0-9]{12})|([0-9]{15}))$ Internal Jan de Rijk number for the original shipment of the customer.
    reference [M] String Max 30 char Customer's reference for the shipment. This is the reference that would be used to refer to the order in any communication between the customer and Jan de Rijk. This reference also appears on invoices and status messages, and is searchable in JConnect.
    handled [M] Boolean Specifies if the shipment is handled.
    source [O] String Max 30 char Possible values:
  • "edi"
  • "rpa"
  • "portal"
  • "manual"
  • "automatic"
  • Expand
    Source of the shipment data.
    internal [M] Boolean Specifies if it concerns an internal shipment.
    forecast [O] Boolean
    requestedModalities [O] Array of String
    ecmr [O] Object
    lineService [M] Boolean Specifies if the shipment is a line service shipment.
    ediReference [O] String Customer unique id for the shipment.
    invoiceReference [O] String Used as purchase shipment reference for invoicing and accounting.
    cancelled [M] Boolean Specifies if the shipment is cancelled.
    transportInstructions [O] String
    documents [O] Array of Object
    knownCargo [O] Boolean
    route [O] Object
    planning [O] Object
    requirements [M] Object Special requirements relating to the shipment.
    security [O] Object Can be used to specify security above the standard security level of TSR 01. The actual security level is explained in the SOP and arranged by the Jan de Rijk planning team.
    airFreightExport [O] Boolean Specifies if the cargo will be transferred to a plane (to be flown to a further destination) on unloading.
    customerData [O] Object
    originalLoading [?] Object
    finalUnloading [?] Object
    containerPickUp [?] Object
    containerDropOff [?] Object
    neutralLoading [O] Object
    neutralUnloading [O] Object
    clearingIn [O] Object
    clearingOut [O] Object
    packageType [O] String Possible values:
  • null
  • "pallet"
  • "colli"
  • "euroPallet"
  • "trailer"
  • Expand
    tariffType [O] String Possible values:
  • null
  • "normal"
  • "adHoc"
  • "loadIndex"
  • "fullTruckLoad"
  • Expand
    Used when there are price agreements. Should be omitted (or null) unless a value was specifically agreed upon with the Jan de Rijk sales department.
    tariffTypeName [O] String
    vehicle [O] Object
    pulledUnit [O] Object
    measurement [M] Object
    additionalCustomerReferences [O] Array of String
    goodsLines [M] Array of Object
    breakCode [O] String An additional invoice code in case the customer wants to split the invoices by those codes. Meaning to be discussed with Jan de Rijk finance department.

    Conditinally required properties

    Some properties mentioned above are sometimes mandatory and sometimes optional or not available, note the [?]. These are the possible combinations of properties that can be used:

    invoices.orders.shipments.ecmr

    required [O] Boolean
    id [O] String
    provider [O] String

    invoices.orders.shipments.documents

    type [O] String
    sequenceNumber [O] Integer
    number [O] String

    invoices.orders.shipments.route

    distance [O] Number

    invoices.orders.shipments.planning

    characteristicCode [O] String
    characteristicName [O] String

    invoices.orders.shipments.requirements

    Special requirements relating to the shipment.

    description [O] String
    code [O] String
    freightUnitType [O] String Possible values:
  • null
  • "mega"
  • "flatBox"
  • "box"
  • "isolation"
  • Expand
    roadTrain [O] Boolean This means LZV (longer truck). It can only be selected when it is agreed in the SOP for a certain line.
    dangerousCargo [O] Boolean
    adrPoints [O] Integer
    urgent [O] Boolean
    heater [O] Boolean
    cooler [O] Boolean
    exclusive [O] Boolean If true, Jan de Rijk won't have the possibility to co-load the cargo with other customers' cargo. Co-loading regulations are taken into account regardless.
    maximumTemperature [O] Number
    minimumTemperature [O] Number
    palletSwap [O] Boolean
    pharmaceuticals [O] Boolean It concerns pharmaceutical cargo, and all requirements for that apply.

    invoices.orders.shipments.security

    Can be used to specify security above the standard security level of TSR 01. The actual security level is explained in the SOP and arranged by the Jan de Rijk planning team.

    secured [M] Boolean
    level [O] String Possible values:
  • null
  • "TAPA1"
  • "TAPA2"
  • invoices.orders.shipments.customerData

    invoices.orders.shipments.originalLoading

    party [M] Object
    reference [O] String
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.

    invoices.orders.shipments.originalLoading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.originalLoading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.originalLoading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.originalLoading.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.originalLoading.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.finalUnloading

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.shipments.finalUnloading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.finalUnloading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.finalUnloading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.finalUnloading.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.
    earlyPossible [O] Boolean If true, Jan de Rijk can pick-up the cargo outside the time window.

    invoices.orders.shipments.finalUnloading.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.containerPickUp

    party [M] Object
    reference [O] String
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.

    invoices.orders.shipments.containerPickUp.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.containerPickUp.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.containerPickUp.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.containerPickUp.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.containerPickUp.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.containerDropOff

    party [M] Object
    dateTimes [M] Object Date/time of relevant events.
    milestones [O] Object Actual date/time of relevant events. null if the event did not yet happen.
    reference [O] String

    invoices.orders.shipments.containerDropOff.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.containerDropOff.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.containerDropOff.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.containerDropOff.dateTimes

    Date/time of relevant events.

    opening [O] String Format: date-time Includes time zone indicator.
    closing [O] String Format: date-time Includes time zone indicator.
    earlyPossible [O] Boolean If true, Jan de Rijk can pick-up the cargo outside the time window.

    invoices.orders.shipments.containerDropOff.milestones

    Actual date/time of relevant events. null if the event did not yet happen.

    start [O] String Format: date-time Includes time zone indicator.
    end [O] String Format: date-time Includes time zone indicator.

    invoices.orders.shipments.neutralLoading

    party [M] Object

    invoices.orders.shipments.neutralLoading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.neutralLoading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.neutralLoading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.neutralUnloading

    party [M] Object

    invoices.orders.shipments.neutralUnloading.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.neutralUnloading.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.neutralUnloading.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.clearingIn

    party [M] Object

    invoices.orders.shipments.clearingIn.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.clearingIn.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.clearingIn.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.clearingOut

    party [M] Object

    invoices.orders.shipments.clearingOut.party

    name [O] String
    number [O] String Max 6 char
    Pattern: ^[0-9]{6}$
    Jan de Rijk number of the existing party in Jan de Rijk system.
    code [M] String Max 20 char Jan de Rijk code of the existing party in Jan de Rijk system.
    address [M] Object
    remarks [O] String
    characteristics [O] Object
    allowedAssetTypes [O] Array of String

    invoices.orders.shipments.clearingOut.party.address

    locationCode [O] String Max 100 char In case the location is an airport, this will be the IATA code.
    locationName [O] String
    name1 [O] String Max 100 char
    line1 [O] String Max 100 char Street name and number.
    line2 [O] String Max 100 char Street name and number.
    city [O] String Max 100 char
    postalCode [M] String Max 10 char
    countryName [O] String Max 100 char
    countryCode [O] String Max 2 char
    Pattern: ^[A-Z]{2}$
    ISO-2 country code.
    longitude [O] Number
    latitude [O] Number
    phone [O] String Max 100 char
    fax [O] String Max 100 char
    mail [O] String Max 100 char

    invoices.orders.shipments.clearingOut.party.characteristics

    isDepot [O] Boolean
    keyAvailable [O] Boolean

    invoices.orders.shipments.vehicle

    licensePlate [O] String Refers to the license plate of the truck.

    invoices.orders.shipments.pulledUnit

    licensePlate [O] String Refers to the license plate of the trailer.

    invoices.orders.shipments.measurement

    grossWeight [O] Number 3 decimals Kilograms.
    netWeight [O] Number 3 decimals Kilograms.
    chargeableWeight [O] Number 3 decimals Kilograms.
    quantity [O] Number
    volume [O] Number 3 decimals Cubic metres.
    volumeWeight [O] Number 3 decimals Kilograms. Usually only used for air freight.
    loadIndex [O] Number 3 decimals
    palletPlaces [O] Number 3 decimals

    invoices.orders.shipments.goodsLines

    mark [O] String Max 50 char
    packageType [O] String Possible values:
  • null
  • "pallet"
  • "colli"
  • "euroPallet"
  • "trailer"
  • Expand
    measurement [M] Object
    goodsType [O] String Possible values:
  • null
  • "airCargo"
  • "airCargoPalletized"
  • "carParts"
  • "general"
  • Expand
    goodsDescription [O] String Max 20 char
    dimensions [O] Object
    detailLines [O] Array of Object Further breakdown of the goods. If this was not provided when the shipment was created, there will be a single detail line for each goods line.
    dangerousGoods [O] Array of Object

    invoices.orders.shipments.goodsLines.measurement

    grossWeight [O] Number 3 decimals Kilograms.
    netWeight [O] Number 3 decimals Kilograms.
    chargeableWeight [O] Number 3 decimals Kilograms.
    quantity [O] Number
    volume [O] Number 3 decimals Cubic metres.
    volumeWeight [O] Number 3 decimals Kilograms. Usually only used for air freight.
    loadIndex [O] Number 3 decimals
    palletPlaces [O] Number 3 decimals

    invoices.orders.shipments.goodsLines.dimensions

    length [O] Number 3 decimals Metres.
    width [O] Number 3 decimals Metres.
    height [O] Number 3 decimals Metres.

    invoices.orders.shipments.goodsLines.detailLines

    mark [O] String Max 50 char
    packageType [O] String Possible values:
  • null
  • "pallet"
  • "colli"
  • "euroPallet"
  • "trailer"
  • Expand
    measurement [M] Object
    goodsType [O] String Possible values:
  • null
  • "airCargo"
  • "airCargoPalletized"
  • "carParts"
  • "general"
  • Expand
    goodsDescription [O] String Max 20 char
    id [O] String Unique within the detail line.
    awb [O] String

    invoices.orders.shipments.goodsLines.detailLines.measurement

    grossWeight [O] Number 3 decimals Kilograms.
    netWeight [O] Number 3 decimals Kilograms.
    chargeableWeight [O] Number 3 decimals Kilograms.
    quantity [O] Number
    volume [O] Number 3 decimals Cubic metres.
    volumeWeight [O] Number 3 decimals Kilograms. Usually only used for air freight.
    loadIndex [O] Number 3 decimals
    palletPlaces [O] Number 3 decimals

    invoices.orders.shipments.goodsLines.dangerousGoods

    code [M] String Max 4 char
    Pattern: ^[0-9]{1,4}$
    UN code.
    suffix [O] String Max 3 char
    Pattern: ^[0-9]{1,3}$
    tunnelCode [O] String