openapi: 3.2.0
info:
title: BSM (TEST2) HTTP International Customs International Customs API
description: Thank you for using our HTTP API documentation.
version: '1.0'
servers:
- url: https://rz3.aeb.de/test2bsm/rest
security:
- SWAGGER_AUTH_KEY: []
- BASIC_AUTH: []
tags:
- name: International Customs API
description: Interface overview for Customs Management
paths:
/InternationalCustomsBFBean/acknowledgeGetChangedDeclarations:
post:
tags:
- International Customs API
summary: Acknowledge call of get changed declarations
description: 'Acknowledge, that the result of calling {@link #getChangedDeclarations(ICGetChangedDeclarationsRequestDTO)} was processed.'
operationId: acknowledgeGetChangedDeclarations
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ICAcknowledgeGetChangedDeclarationsRequestDTO'
application/xml:
schema:
$ref: '#/components/schemas/ICAcknowledgeGetChangedDeclarationsRequestDTO'
responses:
default:
description: default response
content:
application/json:
schema:
$ref: '#/components/schemas/ICAcknowledgeGetChangedDeclarationsResponseDTO'
application/xml:
schema:
$ref: '#/components/schemas/ICAcknowledgeGetChangedDeclarationsResponseDTO'
security:
- BASIC_AUTH: []
/InternationalCustomsBFBean/addDeclarationAttachments:
post:
tags:
- International Customs API
summary: Add declaration attachments
description: Add attachments (files) to declarations. The size of the files are limited to a configurable size (e.g. 20 MB)
This operation is deprecated, use createConsignment with attachments instead.
operationId: addDeclarationAttachments
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ICAddDeclarationAttachmentsRequestDTO'
application/xml:
schema:
$ref: '#/components/schemas/ICAddDeclarationAttachmentsRequestDTO'
responses:
default:
description: default response
content:
application/json:
schema:
$ref: '#/components/schemas/ICAddDeclarationAttachmentsResponseDTO'
application/xml:
schema:
$ref: '#/components/schemas/ICAddDeclarationAttachmentsResponseDTO'
deprecated: true
security:
- BASIC_AUTH: []
/InternationalCustomsBFBean/cancelConsignment:
post:
tags:
- International Customs API
summary: Cancel consignment
description: 'Initiates a cancellation process for the requested consignment.
The consignment can be addressed via the consignment id from the client system (field ''consignmentIdClientSystem'') or via the businessObjectId which is the reference of the ICI system. If both fields are entered the businessObjectId will be used.
There are two possible outcomes:
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' consignment: $ref: '#/components/schemas/ICConsignmentResultDTO' description: The response DTO after processing the request. Contains the resulting consignment DTO. ICDeliveryBrokerDTO: type: object properties: extraFields: type: array description: Extra fields for the delivery. items: $ref: '#/components/schemas/ICExtraFieldDTO' description: DTO to hold Broker extension data for a ICDeliveryDTO. ICAddDeclarationAttachmentsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' description: Result data for the add-declaration-attachments operation. OutwardProcessingIdentificationMeansFieldDTO: type: object properties: type: maxLength: 1 type: string description: Commodity code description: maxLength: 350 type: string description: Description of identification means for type S description: Represents an identification means field for outward processing ICGetDeclarationsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' declarations: type: array description: Data of the requested declarations. items: $ref: '#/components/schemas/ICDeclarationDTO' description: Response containing requested declarations. ICTransportEquipmentDTO: type: object properties: equipmentType: maxLength: 35 type: string description: Specific equimpment type.Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' declarationTypeCode: type: string description: 'Type of declarations to acknowledge. Possible values: EXPDECL, IMPDECL, TRANSDECL, ENSDECL and GOODSMOVERECORD' syncId: maxLength: 20 type: string description: Synchronization ID for acknowledging. Use the value received with synchronization ID for delta-transmission of the changed declarations response with the last call to return all changed (modified) declarations, which were not yet acknowledged to acknowledge the processing of the declarations. description: Request parameter for IInternationalCustomsBF#acknowledgeGetChangedDeclarations ICDeliveryTransitEUDTO: type: object properties: producedDocuments: type: array description: List of transport documents, supporting documents and additional references items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' guarantees: type: array description: List of guarantees items: $ref: '#/components/schemas/ICGuaranteeDTO' description: Holds delivery data that is specific to the EU NCTS / transit processes. ICDeliveryGMRCHDTO: type: object properties: producedDocuments: type: array description: List of produced documents. items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' additionalOperations: type: array description: List of additional operations. items: $ref: '#/components/schemas/ICAdditionalOperationCHDTO' otherRecipients: type: array description: List of other recipients identification numbers. items: type: string description: List of other recipients identification numbers. emptyJourney: type: boolean description: Indicates the goods movement is an empty journey. additionalInformation: type: string description: Additional information for the goods movement. direction: type: string description: Direction of movement. Valid values are ENTRY and EXIT. voyageId: maxLength: 79 type: string description: Voyage ID for the goods movement. loadingUnitContainerType: maxLength: 35 type: string description: Loading unit container type for the goods movement. loadingUnitType: maxLength: 35 type: string description: Loading unit type for the goods movement.Specific customs process.
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' description: The response DTO after setting an attachment status. ICAdditionDeductionDTO: type: object properties: adjustmentType: maxLength: 35 type: string description: 'Specific adjustment type:Specific customs process.
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' consignmentInfos: type: array description: Ids of the consignments that are linked to the manifest requested. items: $ref: '#/components/schemas/ICConsignmentInfoDTO' description: Response containing consignments of a manifest ICDeliveryItemExportDEDTO: type: object properties: transactionNatureCode: maxLength: 2 type: string description: Code specifying the nature of transaction. producedDocuments: type: array description: List of produced documents. The number of items per documentType must not exceed 99. items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' preferentialData: $ref: '#/components/schemas/ICPreferentialDataEUDTO' originCountryRegionCode: maxLength: 4 type: string description: ISO code of country region where the goods of this item originate from. templateName: type: string description: Item template name in AES terminationCustomsWarehouse: $ref: '#/components/schemas/ICCustomsWarehouseTerminationDEDTO' additionalInfoForCustoms: maxLength: 512 type: string description: Additional information for customs description: DTO to hold Export DE specific extension data for a ICDeliveryItemDTO. ICDeliveryItemDTO: type: object properties: itemIdClientSystem: maxLength: 255 type: string description: ID of the item in ERP system. itemNumber: maxLength: 20 type: string description: No. of item material: $ref: '#/components/schemas/ICMaterialDTO' materialNumber: type: string description: 'DEPRECATED: Use ICDeliveryItemDTO.material instead. Typically for internal use and not needed for customs declaration.' deprecated: true invoiceIdClientSystem: maxLength: 255 type: string description: References to the invoice for further processing grossMass: $ref: '#/components/schemas/QuantityDTO' netMass: $ref: '#/components/schemas/QuantityDTO' netPrice: $ref: '#/components/schemas/AmountOfMoneyDTO' originCountryCode: maxLength: 2 type: string description: ISO code of country where the goods of this item originate from. preferentialOriginCountryCode: maxLength: 2 type: string description: ISO code of the preferential origin country. dispatchCountryCode: maxLength: 2 type: string description: ISO code of the country from which the goods are originally dispatched/exported without any commercial transaction taken place in intermediate countries. destinationCountryCode: maxLength: 2 type: string description: ISO code of the country at which the goods are destined isEligiblePreference: type: boolean description: Indicates if the item is eligible for preference statisticalValue: $ref: '#/components/schemas/AmountOfMoneyDTO' additionalAggregationKey: maxLength: 100 type: string description: Additional aggregation key considered during transmutation additionalSplitCriteria: maxLength: 100 type: string description: Additional split criteria considered during transmutation extension: $ref: '#/components/schemas/ICDeliveryItemExtensionDataDTO' freeTemplateCriteria: type: array description: List of ICFreeTemplateCriterion, including a string for the criterion and the corresponding customs process. items: $ref: '#/components/schemas/ICFreeTemplateCriterionDTO' clientSpecificFields: $ref: '#/components/schemas/ClientSpecificFieldsDTO' classifications: type: array description: List of classifications (e.g. commodity codes) items: $ref: '#/components/schemas/ICClassificationDTO' goodsDescription: type: array description: Description of goods in different languages (if available) items: $ref: '#/components/schemas/TextInLanguageDTO' parties: type: array description: List of parties, including their role within the consignment. items: $ref: '#/components/schemas/ICPartyDTO' costs: type: array description: A list of costs like freight cost, insurance or additonal cost for the delivery item items: $ref: '#/components/schemas/ICCostDTO' adjustments: type: array description: A list of additions and deductions to a base value for the delivery item items: $ref: '#/components/schemas/ICAdditionDeductionDTO' quantities: type: array description: A list of quantities, like item quantity, statisticalquantity... items: $ref: '#/components/schemas/ICQuantityDTO' additionalReferences: type: array description: List of additional references which belong to the delivery. items: $ref: '#/components/schemas/ICAdditionalReferenceDTO' customsProcedures: type: array description: List of customs procedure codes. items: $ref: '#/components/schemas/ICCustomsProcedureDTO' locations: type: array description: List of locations, including their role within the consignment. items: $ref: '#/components/schemas/ICLocationDTO' freeTemplateCriterion: maxLength: 50 type: string description: 'DEPRECATED: Use freeTemplateCriteria.value instead. Free textual criterion which can be referenced in template selectors.' tradeTerms: $ref: '#/components/schemas/ICTradeTermsDTO' returns: $ref: '#/components/schemas/ICReturnsHandlingDTO' customsSpecialProcedures: $ref: '#/components/schemas/ICCustomsSpecialProceduresDTO' licenseData: $ref: '#/components/schemas/ICLicenseDataDTO' description: DTO to hold data of a delivery item. ICPackageDTO: type: object properties: packageIdClientSystem: maxLength: 255 type: string description: ID of the package in the ERP system. quantity: maxLength: 8 type: integer description: Number of packages format: int32 typeCode: maxLength: 40 type: string description: Client specific package type. typeUneceCode: maxLength: 3 type: string description: Common valid UN/ECE package type. grossMass: $ref: '#/components/schemas/QuantityDTO' netMass: $ref: '#/components/schemas/QuantityDTO' marks: maxLength: 70 type: string description: Shipping marks - deprecated use marksAndNumbers instead marksAndNumbers: $ref: '#/components/schemas/TextInLanguageDTO' seals: type: array description: List of seals which belong to the transport equipment. items: $ref: '#/components/schemas/ICSealDTO' packedItems: type: array description: Information about the items which are packed into this package. items: $ref: '#/components/schemas/ICPackedItemDTO' description: DTO to hold data of a package. ICManifestDeliveryExtensionGVMSBG: type: object properties: isUnaccompanied: type: boolean description: 'Indicates that the vehicle will not be accompanying the trailer(s) during the crossing. ' plannedCrossingRouteId: maxLength: 200 type: string description: ID of the crossing route. plannedCrossingDepartureDate: $ref: '#/components/schemas/DateAndZoneDTO' description: GB specific extension data for a goods movement record. ICDeliveryItemSTIDTO: type: object properties: transactionNatureCode: maxLength: 2 type: string description: Code specifying the nature of transaction. producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' preferentialData: $ref: '#/components/schemas/ICPreferentialDataEUDTO' originCountryRegionCode: maxLength: 4 type: string description: ISO code of country region where the goods of this item originate from. postalValue: $ref: '#/components/schemas/AmountOfMoneyDTO' description: DTO to hold STI specific extension data for a ICDeliveryItemDTO. ICCustomsIdentifcationDTO: type: object properties: identificationType: maxLength: 35 type: string description: 'Specific identification type:Specific customs process.
String representation of the date/time stamp in the format yyyy-MM-dd HH:mm:ss
Length: 19
' timezone: type: string description: 'Time zone of the time stamp.
Examples of valid time zones: "GMT+01:00" or "GMT-02:00".
Maximum length: 50
' description: Date and timezone. ICDeliveryItemEUDTO: type: object properties: transactionNatureCode: maxLength: 2 type: string description: Code specifying the nature of transaction. producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' preferentialData: $ref: '#/components/schemas/ICPreferentialDataEUDTO' originCountryRegionCode: maxLength: 4 type: string description: ISO code of country region where the goods of this item originate from. description: DTO to hold EU specific extension data for a ICDeliveryItemDTO. ICCurrencyRateDTO: type: object properties: rate: type: number description: Rate value.length=18, 6
rateDate: $ref: '#/components/schemas/DateAndZoneDTO' description: DTO to hold data of currency rate. OutwardProcessingFieldDTO: type: object properties: authNumber: maxLength: 35 type: string description: Outward processing authorisation number dateOfReImport: $ref: '#/components/schemas/DateAndZoneDTO' countriesOfReImport: type: array description: List of iso codes for countries of re-import items: type: string description: List of iso codes for countries of re-import products: type: array description: List of processed products items: $ref: '#/components/schemas/OutwardProcessingCommodityCodeFieldDTO' identities: type: array description: List of identification methods. items: $ref: '#/components/schemas/OutwardProcessingIdentificationMeansFieldDTO' description: Represents an outward processing field ICGetBrokerDeclarationsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' instructions: type: array description: Data of the instructions which contain requested declarations. items: $ref: '#/components/schemas/ICBrokerInstructionDTO' description: Response containing requested declarations. ICAcknowledgeGetChangedDeclarationsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' description: Response for IInternationalCustomsBF#acknowledgeGetChangedDeclarations ICCustomsControlMeasureDTO: type: object properties: type: maxLength: 35 type: string description:Type of control measures.
length=7,2
dutyAssessmentCode: maxLength: 2 type: string description: Assessment code for customs duty. isNetDuty: maxLength: 1 type: string description: Net duty tareSupplement: type: number description: Tare supplement.length=4,1
tareSupplementConfirmation: maxLength: 1 type: string description: Confirmation code for tare supplement isEligiblePreference: maxLength: 1 type: string description: Preferential flag. customsNetWeight: $ref: '#/components/schemas/QuantityDTO' description: CH specific extension data for a declaration item. ICQuantityDTO: type: object properties: quantityType: maxLength: 10 type: string description: 'Specific quantity type:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' declarations: type: array description: The next changed declarations. items: $ref: '#/components/schemas/ICDeclarationDTO' syncId: maxLength: 20 type: string description: Synchronization ID for for acknowledging. Use this syncId in subsequent calls to IInternationalCustomsBF#acknowledgeGetChangedDeclarations to acknowledge the processing of the changed declarations. This syncId may be null if no declarations were found to synchronize. In this case no call to IInternationalCustomsBF#acknowledgeGetChangedDeclarations is necessary. isComplete: type: boolean description: True, if the synchronization is complete and currently no further modified declarations are available. False if not. In this case, after acknowledging with IInternationalCustomsBF#acknowledgeGetChangedDeclarations, an immediate second call to IInternationalCustomsBF#getChangedDeclarations would be sensible. Because a maximum of 10 declarations are returned with one call of IInternationalCustomsBF#getChangedDeclarations, the result may be incomplete. description: Response (result) for IInternationalCustomsBF#getChangedDeclarations. ICConsignmentDTO: required: - consignmentIdClientSystem - consignmentNumber type: object properties: consignmentIdClientSystem: maxLength: 255 type: string description: Unique id of the consignment within the ERP system organizationUnitClientSystem: maxLength: 255 type: string description: Additional criteria two separate different organisational units within one Engine's client. consignmentNumber: maxLength: 70 type: string description: Reference number of the consignment. internalReference: maxLength: 255 type: string description: Internal reference of the consignment. remark: maxLength: 1000 type: string description: Optional textual remark profileCode: maxLength: 50 type: string description: Ident code of the consignment profile which is configured in the Engine. The consignment profile manages mainly the transmutation. personInCharge: $ref: '#/components/schemas/ICPersonDTO' deliveries: minItems: 1 type: array items: $ref: '#/components/schemas/ICDeliveryDTO' costs: type: array description: A list of costs like freight cost, insurance or additonal cost for the consignment items: $ref: '#/components/schemas/ICCostDTO' adjustments: type: array description: A list of additions and deductions to a base value for the consignment items: $ref: '#/components/schemas/ICAdditionDeductionDTO' attachments: type: array description: List of attached documents. items: $ref: '#/components/schemas/ICAttachmentDTO' attachmentLinks: type: array description: List of corresponding links. items: $ref: '#/components/schemas/ICAttachmentLinkDTO' description: DTO to hold data of a consignment. xml: name: consignment ICCustomsSpecialProceduresDTO: type: object properties: referencesRemoval: type: array description: List of references to booking requests. Only relevant for removal bookings (outbound). items: $ref: '#/components/schemas/ICCustomsSpecialProceduresReferencesDTO' identitiesEntry: type: array description: 'List of identities (German: Nämlichkeiten) used for an inbound entry booking. Maximum length of an identity = 50.' items: type: string description: 'List of identities (German: Nämlichkeiten) used for an inbound entry booking. Maximum length of an identity = 50.' description: DTO to hold data for customs special procedures. OutwardProcessingCommodityCodeFieldDTO: type: object properties: commodityCode: maxLength: 8 type: string description: Commodity code description: maxLength: 512 type: string description: Description of the product description: Represents a commodity code field for outward processing ICDeliveryEUDTO: type: object properties: goodsLocation: $ref: '#/components/schemas/ICLocationDTO' expectedArrivalTime: $ref: '#/components/schemas/DateAndZoneDTO' expectedDepartureTime: $ref: '#/components/schemas/DateAndZoneDTO' deferredPayments: type: array description: Deferred payments. items: $ref: '#/components/schemas/ICDeferredPaymentDTO' departureAirportCode: pattern: ^[A-Z]{3}$ type: string description: Code (IATA key) for the airport of departure producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' description: DTO to hold EU extension data for a ICDeliveryDTO. ICConsignmentManifestResultDTO: type: object properties: businessObjectId: maxLength: 20 type: string description: The business object id of the manifest in the system. installationIdClientSystem: maxLength: 20 type: string description: Id of the ERP system. Important so separate two different ERP systems within on Engine's client. decisiveDate: $ref: '#/components/schemas/DateAndZoneDTO' consManifestNumber: maxLength: 70 type: string description: Reference number of the consignment. description: Data of the manifest created. ICGetConsignmentsOfManifestRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectId: maxLength: 50 type: string description: The unique business object id of the desired consignment manifest. BusinessObjectId or consignmentIdClientSystem must be filled. consignmentIdClientSystem: maxLength: 255 type: string description: The consignment manifest id of the ERP system of the client. BusinessObjectId or consignmentIdClientSystem must be filled. description: Body for requesting consignments of a manifest NamedGenericDataRecordDTO: type: object properties: name: type: string description: The name of this record, i.e. the role the record plays in the enclosing record.length=15, scale=2
currencyIso: type: string description: The three letter ISO code of the currency of the amount of money.length=3
description: An amount of money with a value and an currency ISO code. ICCreateConsignmentManifestRequestDTO: required: - manifest type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' manifest: $ref: '#/components/schemas/ICConsignmentManifestDTO' description: Body data for creating a consignment manifest. ICReturnsHandlingDTO: type: object properties: returnProcessItemId: maxLength: 50 type: string description: Unique ID of the delivery item as an identification of the item through the whole return process. isReturn: type: boolean description: Indicates that the item is a return to an originally exported or imported good. refundEntity: maxLength: 50 type: string description: ID of the refund entity, e.g. a (web) shop or retailer. description: DTO to hold data related to a returns process. ICBusinessObjectStatusDTO: type: object properties: statusCode: maxLength: 20 type: string description: Status code. Use API call getCodes with codeListCode 'STATUS_TYPE' to discover all valid codes. progressCode: maxLength: 20 type: string description: 'Progress code. Valid codes are: USER_ACTION, ERROR, WAITING, ACCEPTED and COMPLETE.' progressInformation: type: array description: Optional human readable information on the current progress e.g. what kind of user action is required.length = 100
items: $ref: '#/components/schemas/TextInLanguageDTO' variantCode: maxLength: 20 type: string description: Variant code. Use API call getCodes with codeListCode 'DECLARATION_VARIANT_TYPE' to discover all valid codes. description: DTO to hold data of a status. ICSendDeclarationMessageRequestDTO: required: - customsProcessType type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' customsProcessType: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' businessObjectIds: maxLength: 20 type: array description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. items: maxLength: 20 type: string description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. consignmentIdClientSystem: maxLength: 255 type: string description: The consignment id of the ERP system of the client. Either the businessObjectId or the consignmentIdClientSystem must be filled. updateDecisiveDate: type: boolean description: If set to true, the decisive date of the declaration will be set to the current time before sending. example: true description: Body data containing references to declarations that shall be sent to customs. ICCodeDTO: type: object properties: code: maxLength: 50 type: string description: The ident code value. descriptions: maxLength: 50 type: array description: List of Human readable description of the code in the requested languages. items: $ref: '#/components/schemas/TextInLanguageDTO' description: The DTO object containing information of a code and its descriptions in given languages. ICCustomsWarehouseItemReferenceDEDTO: type: object properties: entryInATLAS: type: boolean description: Indicates that the referenced account was registered in the ATLAS IT procedure. customsRegistrationNumber: maxLength: 22 type: string description: Customs registration number (ATLAS registration number or MRN) of access to customs warehouse source process to which the item of the termination refers. itemNumber: maxLength: 5 type: integer description: Number of the item of the entry to the customs warehouse source procedure, to which the item of the termination refers. format: int32 usualTreatment: type: boolean description: Indicates that the goods were subjected to usual treatment. additionalInformation: maxLength: 100 type: string description: Additional information from the owner of the customs warehouse process on an item of the termination (e.g., on a usual treatment that was applied). commodityCode: maxLength: 11 minLength: 11 type: string description: Commodity code (11 digits) according to the german electronic customs tariff (EZT). removalQuantity: $ref: '#/components/schemas/QuantityDTO' removalQuantityAfterTreatment: $ref: '#/components/schemas/QuantityDTO' description: DTO to hold specific item reference data for a customs warehouse termination. ICDeliveryItemExportCHDTO: type: object properties: producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' description: DTO to hold CH specific extension data for a ICDeliveryItemDTO. ICAttachmentLinkDTO: type: object properties: name: maxLength: 50 type: string description: The displayed name of the link. url: maxLength: 1000 type: string description: URL description: DTO to hold link data. ICCustomsWarehouseTerminationDEDTO: type: object properties: authorisationNumber: maxLength: 35 type: string description: Authorization number of the customs warehouse. Slashes allowed, will be removed automatically. items: type: array description: List of termination items items: $ref: '#/components/schemas/ICCustomsWarehouseItemReferenceDEDTO' description: Customs warehouse termination ICCustomsOfficeDTO: type: object properties: officeType: maxLength: 35 type: string description: 'Specific office type:Specific customs process.
Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' declarationTypeCode: type: string description: 'Type of declarations to get. The client system must be configured as subscriber to the change of that declaration type in ICI to receive changes. If no subscription is present, the call will fail. Possible values: EXPDECL, IMPDECL, TRANSDECL, ENSDECL and GOODSMOVERECORD' scenarios: type: array description: 'Scenarios defining the data to be included. If no scenario is given, BASE is assumed. Possible values: BASE - Some basic data, ATTACHMENTS - Documents (e.g. EAD), HEAD - Basic values and data from head level, ITEM - basic values head level data and item level data' items: type: string description: 'Scenarios defining the data to be included. If no scenario is given, BASE is assumed. Possible values: BASE - Some basic data, ATTACHMENTS - Documents (e.g. EAD), HEAD - Basic values and data from head level, ITEM - basic values head level data and item level data' description: Request parameter for IInternationalCustomsBF#getChangedDeclarations ICTransportMeansDTO: type: object properties: meansType: maxLength: 35 type: string description: 'Specific means type:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' codes: type: array description: List of possible codes. items: $ref: '#/components/schemas/ICCodeDTO' description: Response for the requested code list. ICDeliveryItemConsumerShipmentXIDTO: type: object properties: producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' description: GB specific extension data for Consumer shipments XI. ICReferencedItemDTO: type: object properties: sequenceNumberDeclarationItem: type: integer description: The sequence number of the referenced item. format: int32 sequenceNumberHouseConsignment: type: integer description: The sequence number within the house consignment. format: int32 description: Referenced item data for a house consignment. ICAdditionalFiscalReferenceDTO: type: object properties: roleCode: maxLength: 3 type: string description: Fiscal reference role code identifier: maxLength: 17 type: string description: Fiscal reference identifier description: Data for additional fiscal references ICTransitDeclarationDTO: type: object properties: houseConsignments: type: array description: House consignments. items: $ref: '#/components/schemas/ICHouseConsignmentDTO' description: Extension data for a transit. ICAmountOfMoneyDTO: type: object properties: amountCode: maxLength: 50 type: string description: 'Specific amount type:Message type
If not stated otherwise, the possible types are:
Maximum length: 50
' example: WARNING messageIdentCode: type: string description: 'Optional identification code for further classification of the message type.
Maximum length: 50
' example: '5627' messageTexts: type: array description:Detailed message texts in the requested languages.
items: $ref: '#/components/schemas/TextInLanguageDTO' indentationLevel: type: integer description:The indentation level of the message.
'0' indicates a top level message.
format: int32 example: 0 description: Result messages like errors or warnings. ICPreferentialDataEUDTO: type: object properties: preferenceType: maxLength: 3 type: string description: Preferential request code. description: DTO to hold data for preferential request (EU). ClientSpecificFieldsDTO: type: object properties: fields: type: array description: List of client specific fields (key/value pairs).Fields need to be defined for the respective process/declaration, otherwise they will be ignored.
items: $ref: '#/components/schemas/ClientSpecificFieldDTO' description: Represents the container for client specific fields. ICCustomsBrokerDeclarationDTO: type: object properties: customsRegistrationNumber: maxLength: 35 type: string description: ' Customs registration numbers (CRN/MRN).' description: DTO to hold data for customs broker declaration ICConsignmentResultDTO: type: object properties: businessObjectId: maxLength: 20 type: string description: The business object id of the consignment in the system. installationIdClientSystem: maxLength: 20 type: string description: Id of the ERP system. Important so separate two different ERP systems within on Engine's client. decisiveDate: $ref: '#/components/schemas/DateAndZoneDTO' consignmentNumber: maxLength: 70 type: string description: Reference number of the consignment. deliveryNumber: maxLength: 70 type: string description: Reference number of the delivery. description: The result DTO which contains the information to the consignment created on the system. ICPersonDTO: type: object properties: forename: maxLength: 20 type: string description: Forename of the person in charge surname: maxLength: 30 type: string description: Surname of the person in charge email: maxLength: 255 type: string description: Email address of the person in charge phone: maxLength: 20 type: string description: Phone number of the person in charge supplement: maxLength: 10 type: string description: Phone number of the person in charge initials: maxLength: 20 type: string description: Initials/login of the person in charge professionalTitle: maxLength: 35 type: string description: Professional title of the person in charge description: DTO to hold data of a person. ICDeliverySumDecWriteOffInfoDEDTO: type: object properties: assignmentCriteria: type: string description: The assignment criteria for the summary declaration items. numberOfPackages: type: integer description: Number of packages to be written off. format: int32 description: DTO to hold the write off data for summary declaration assignment. ICCustomsProcessTypeDTO: type: object properties: customsProcess: maxLength: 35 type: string description:Specific customs process.
Country setup ident code for the customs process (Broker).
Only used in response DTOs (ICDeclarationDTO)
example: CN description: DTO to hold the customs process type. ICDeliveryConsumerShipmentXIDTO: type: object properties: producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' qualifiesForReturn: type: boolean description: Indicator of whether the delivery qualifies for returns deliveryPlace: $ref: '#/components/schemas/ICLocationDTO' description: GB specific extension data for Consumer shipments items XI. ICDateDTO: type: object properties: dateCode: maxLength: 20 type: string description: Code specifying the type of date. date: $ref: '#/components/schemas/DateAndZoneDTO' description: DTO to hold data representing an date with optional time. ICDeliveryExportCHDTO: type: object properties: producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' isFirstShipment: type: boolean description: Indicates that this is the first partial shipment. firstShipmentReference: maxLength: 18 type: string description: Reference to the first partial shipment. description: DTO to hold CH extension data for a ICDeliveryDTO. ICGetCodesRequestDTO: required: - codeListCode - customsProcessType type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' customsProcess: maxLength: 20 type: string description: The identification of the customs process. deprecated: true customsProcessType: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' codeListCode: maxLength: 50 type: string description: Ident code of the code list which will be returned. To retrieve a possible list of inputs use {@code CODELISTS} as input. example: CODELISTS description: Request for a desired code list. ICDeliverySTIDTO: type: object properties: goodsLocation: $ref: '#/components/schemas/ICLocationDTO' expectedArrivalTime: $ref: '#/components/schemas/DateAndZoneDTO' expectedDepartureTime: $ref: '#/components/schemas/DateAndZoneDTO' deferredPayments: type: array description: Deferred payments. items: $ref: '#/components/schemas/ICDeferredPaymentDTO' departureAirportCode: pattern: ^[A-Z]{3}$ type: string description: Code (IATA key) for the airport of departure producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' previousDocuments: type: array description: List of previous documents items: $ref: '#/components/schemas/ICPreviousDocumentDTO' actualDepartureTime: $ref: '#/components/schemas/DateAndZoneDTO' postalCharges: $ref: '#/components/schemas/AmountOfMoneyDTO' description: DTO to hold STI specific extension data for a ICDeliveryDTO. ICConsignmentForManifestDTO: required: - consignmentIdClientSystem type: object properties: consignmentIdClientSystem: maxLength: 255 type: string description: Unique id of the consignment within the ERP system description: Data to reference an existing consignment. ICPreviousDocumentDTO: type: object properties: type: maxLength: 6 type: string description: Code specifying the type of a previous document. category: maxLength: 1 type: string description: Code specifying the type of a previous document. reference: maxLength: 70 type: string description: Free text field for a document reference. complementaryInfo: maxLength: 70 type: string description: Additional free text field. typeOfPackages: maxLength: 2 type: string description: Type of packages. numberOfPackages: maxLength: 8 type: integer description: Number of packages. format: int32 measurementUnitAndQualifier: maxLength: 4 type: string description: Measurement unit and qualifier. quantity: type: number description: Measurement unit and qualifier.length=22, scale=6
goodsItemIdentifier: maxLength: 5 type: integer description: Goodsitem identifier. format: int32 description: DTO to hold data for previous documents. ICGetDeclarationsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' declarationTypeCode: type: string description: Type of declaration. enum: - EXPDECL - EXTDECL - IMPDECL - TRANSDECL - ENSDECL - SUMDECL - GOODSMOVERECORD - TRANSARR - CONSSHIP customsProcess: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' businessObjectIds: type: array description: IDs of the declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored.length=20
items: type: string description: IDs of the declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored.length=20
consignmentIdClientSystem: type: string description: ConsignmentID of the client system of the declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored.length=255
scenarios: type: array description: 'Scenarios defining the data to be included. If no scenario is given, BASE is assumed.Possible values:
Possible values:
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' isSuccessful: type: boolean description: Identifier if the cancellation was successful or not. description: The response dto for cancellation of declarations. ICBrokerDeclarationDTO: type: object properties: declarationTypeCode: type: string description: Type of declaration. enum: - EXPORT - IMPORT - TRANSIT_DEPARTURE - ENSDECL localReference: maxLength: 35 type: string description: Local unique reference number. customsRegistrationNumber: maxLength: 35 type: string description: Registration number given by customs (e.g. MRN, CRN, ...) statusCode: type: string description: Current status code of the declaration. totalGrossMass: $ref: '#/components/schemas/QuantityDTO' totalNumberItems: type: integer description: Total number of items in the declaration. format: int32 totalNumberPackages: type: integer description: Total number of packages in the declaration. format: int32 additionalReferences: type: array description: Additional references of the customs declaration. items: $ref: '#/components/schemas/ICAdditionalReferenceDTO' declarationAmounts: type: array description: Amounts of the customs declaration. items: $ref: '#/components/schemas/ICAmountOfMoneyDTO' attachments: type: array description: List of attachments.Name of this field, i.e. the role the field plays in the enclosing record.
When the same name is repeated in the context of the same parent record, it is assumed that the parent defines this element as a repeatable (array) element.
value: type: string description:Value of the field.
The format follows the conventions of xml schema encoding, see http://www.w3.org/TR/xmlschema-2/.
Data type of the field.
This is not strictly necessary since the receiving entity should be able to infer the structure with its own meta data; it may be used however for sanity checks.
The format follows the conventions of xml schema encoding, see http://www.w3.org/TR/xmlschema-2/.
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' delivery: $ref: '#/components/schemas/ICDeliveryResultDTO' description: The response DTO after processing the request. Contains the resulting delivery information. ICInvoiceDTO: type: object properties: invoiceIdClientSystem: maxLength: 255 type: string description: Unique id of the invoice within the ERP system invoiceNumber: maxLength: 70 type: string description: Reference number of the invoice. invoiceDate: $ref: '#/components/schemas/DateAndZoneDTO' invoicePrice: $ref: '#/components/schemas/AmountOfMoneyDTO' invoicePriceRate: $ref: '#/components/schemas/ICCurrencyRateDTO' description: DTO to hold data of an invoice. ICDeclarationDTO: type: object properties: clientSystemId: maxLength: 20 type: string description: Id of the sending client system. customsProcessCode: maxLength: 20 type: string description: Customs process the object belongs to. deprecated: true customsProcess: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' businessObjectId: maxLength: 10 type: string description: ID of the declaration. declarationTypeCode: type: string description: 'Type of declaration.Possible values:
Since FP Nov. 2017.
' declarationProcedureTypeCode: type: string description: Type of declaration procedure.Possible values differ between the customs processes.
isDeleted: type: boolean description: Indicates whether the object has been logically deleted. decisiveDate: $ref: '#/components/schemas/DateAndZoneDTO' localReference: maxLength: 35 type: string description: Local unique reference number. customsRegistrationNumber: maxLength: 35 type: string description: Registration number given by customs (e.g. MRN, CRN, ...) linkedProcessInfos: type: array description:Registration numbers of linked processes.
Currently only supported for port notifications created in Customs Management.
items: $ref: '#/components/schemas/ICLinkedProcessInfoDTO' declarationVersion: maxLength: 10 type: string description: The current version of the declaration. Only filled if supported by customs. commercialReferenceNumber: maxLength: 35 type: string description: Commercial reference number. deliveryNumber: maxLength: 70 type: string description: Reference number of the delivery. deliveryReferences: type: array description: Reference numbers of the declaration's deliveries. items: $ref: '#/components/schemas/ICDeliveryReferencesDTO' invoiceNumber: maxLength: 70 type: string description: Reference number of the invoice. organizationUnitClientSystem: maxLength: 255 type: string description: Additional criteria two separate different organizational units within one client. consignmentUid: maxLength: 20 type: string description: The business object UID of the consignment. consignmentNumber: maxLength: 70 type: string description: Reference number of the consignment. internalReference: maxLength: 255 type: string description: Internal reference of the declaration. consignmentIdClientSystem: maxLength: 255 type: string description: Unique id of the consignment within the ERP system status: $ref: '#/components/schemas/ICBusinessObjectStatusDTO' isValid: type: boolean description: True, if the business object is (still) valid. Else false. personInCharge: $ref: '#/components/schemas/ICPersonDTO' totalGrossMass: $ref: '#/components/schemas/QuantityDTO' totalNetMass: $ref: '#/components/schemas/QuantityDTO' totalInvoicePrice: $ref: '#/components/schemas/AmountOfMoneyDTO' totalNumberItems: type: integer description: Total number of items in the declaration. format: int32 totalNumberPackages: maxLength: 9 type: integer description: Total number of packages in the declaration. format: int32 dispatchCountryCode: maxLength: 2 type: string description: Country ISO code of the dispatch country. destinationCountryCode: maxLength: 2 type: string description: Country ISO code of the destination country. additionalReference1: type: string description: Additional reference. representationStatusCode: type: string description: Representation. extension: $ref: '#/components/schemas/ICDeclarationExtensionDataDTO' parties: type: array description: List of involved parties. items: $ref: '#/components/schemas/ICPartyDTO' customsOffices: type: array description: List of involved customs offices. items: $ref: '#/components/schemas/ICCustomsOfficeDTO' amountsOfMoney: type: array description: List of amount of moneys. items: $ref: '#/components/schemas/ICAmountOfMoneyDTO' transportMeans: type: array description: List of involved transport means. items: $ref: '#/components/schemas/ICTransportMeansDTO' dates: type: array description: List of dates with times. items: $ref: '#/components/schemas/ICDateDTO' items: type: array description: List of items. items: $ref: '#/components/schemas/ICDeclarationItemDTO' attachments: type: array description: List of attachments.length=11,3
description: DTO to hold data of a packed item. ICLicenseDTO: type: object properties: customsProcessCountryCode: maxLength: 2 type: string description: The country of the customs process for which the applies, e.g. "US", "GB" or "DE". The special value "EU" is used for licenses which may be used for declarations in all EU countries. licenseTypeCode: maxLength: 81 type: string description: ' A code for the customs system for the license type. E.g., for EU and GB, this is the concatenation of code/qualifier of a produced document for the license type.' licenseNumber: maxLength: 100 type: string description: The license number or the ID of a license exception (US) or a common license (EU). licenseItemNumber: maxLength: 100 type: string description: The license item number. licenseValidFromDate: $ref: '#/components/schemas/DateAndZoneDTO' licenseExpirationDate: $ref: '#/components/schemas/DateAndZoneDTO' holder: $ref: '#/components/schemas/ICPartyDTO' decrementValue: $ref: '#/components/schemas/AmountOfMoneyDTO' decrementQuantity: $ref: '#/components/schemas/QuantityDTO' extension: $ref: '#/components/schemas/GenericDataRecordDTO' description: DTO to hold data of an license for a transaction. ICDeclarationCHDTO: type: object properties: orderNumber: type: string description: The internal order number, length=50 selectionResultCode: maxLength: 1 type: string description: Selection result. customsStatusCodeCode: maxLength: 3 type: string description: Customs status code. releaseStatus: maxLength: 1 type: string description: Release status. materialCheckStatus: maxLength: 1 type: string description: Material check status. items: type: array description: Additional item data items: $ref: '#/components/schemas/ICDeclarationItemCHDTO' description: CH specific extension data for a declaration. ICGetDeclarationAttachmentsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' customsProcess: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' businessObjectId: type: string description: ID of the declaration.length=20
attachmentCodes: type: array description: Attachment codes. items: type: string description: Attachment codes. description: Request for declaration attachments. ICDeclarationGBDTO: type: object properties: declarationMethodCode: maxLength: 3 type: string description: Declaration method code. declarationUniqueConsignmentReference: maxLength: 35 type: string description: DUCR. ducrPartNumber: maxLength: 4 type: string description: DUCR part number. masterUniqueConsignmentReference: maxLength: 35 type: string description: MUCR. acaReference: maxLength: 12 type: string description: ACA reference of the cargo report. entryProcessingUnit: maxLength: 3 type: string description: CHIEF Entry EPU. entryNumber: maxLength: 7 type: string description: CHIEF Entry Number. entryDate: $ref: '#/components/schemas/DateAndZoneDTO' departedDate: $ref: '#/components/schemas/DateAndZoneDTO' deferredPayments: type: array description: Deferred payments. items: $ref: '#/components/schemas/ICDeferredPaymentDTO' additionalFiscalReferences: type: array description: Additonal fiscal references items: $ref: '#/components/schemas/ICAdditionalFiscalReferenceDTO' description: GB specific extension data for a declaration. ICTradeTermsDTO: type: object properties: incotermCode: maxLength: 3 type: string description: Code specifying the delivery or transport terms. See EDIFACT codes. country: type: string description: ISO code of the country of the point or port of departure, shipment or destination, as required under the applicable terms of delivery, e.g. Incoterm. place: maxLength: 256 type: string description: Name of the point or port of departure, shipment or destination, as required under the applicable terms of delivery, e.g. Incoterm. placeCode: maxLength: 256 type: string description: UN/LOCODE of the point or port of departure, shipment or destination, as required under the applicable terms of delivery, e.g. Incoterm. info: maxLength: 100 type: string description: Additional information e.g. for type 'XXX'. description: DTO to hold data of trade terms. ICBrokerInstructionDTO: type: object properties: clientSystemId: maxLength: 20 type: string description: Id of the sending client system. localReference: maxLength: 35 type: string description: Local unique reference number. commercialReferenceNumber: maxLength: 35 type: string description: Commercial reference number. businessObjectId: maxLength: 10 type: string description: ID of the declaration. consignmentIdClientSystem: maxLength: 255 type: string description: Unique id of the consignment within the ERP system consignmentNumber: maxLength: 70 type: string description: Reference number of the consignment. deliveryReferences: type: array description: Reference numbers of the declaration's deliveries. items: $ref: '#/components/schemas/ICDeliveryReferencesDTO' status: $ref: '#/components/schemas/ICBusinessObjectStatusDTO' numberOfDeclarations: maxLength: 3 type: integer description: Expected number of declarations format: int32 attachments: type: array description: List of attachments.True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' isSuccessful: type: boolean description: Identifier if the cancellation was successful or not. description: The response dto of the cancellation of consignments or consignment manifests. ICSendDeclarationMessageResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' description: Result data for the send-declaration-message operation. ICGetBrokerDeclarationsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' instructionTypeCode: type: string description: 'Type of instruction. Possible values: EXPINST (Export instruction), IMPINST (Import instruction)' enum: - EXPINST - IMPINST businessObjectIds: type: array description: IDs of the instructions. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored.length=20
items: type: string description: IDs of the instructions. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored.length=20
consignmentIdClientSystem: maxLength: 255 type: string description: ConsignmentID of the client system of the instructions. Either the businessObjectIds or the consignmentIdClientSystem must be filled. If the consignmentIdClientSystem is filled the businessObjectsIds will be ignored. scenarios: type: array items: type: string description: 'Scenarios defining the data to be included. If no scenario is given, BASE is assumed. Possible values: BASE (Some basic data), ATTACHMENTS (Documents, e.g. EAD)' enum: - BASE - ATTACHMENTS description: Request for broker declaration data. ICProducedDocumentBrokerDTO: type: object properties: typeCode: maxLength: 9 type: string description: Code specifying the name of a document. Qualifier has to be separated with a "/". reference: maxLength: 35 type: string description: Free text field for a document reference. informationDate: $ref: '#/components/schemas/DateAndZoneDTO' expiryDate: $ref: '#/components/schemas/DateAndZoneDTO' quantity: $ref: '#/components/schemas/QuantityDTO' amount: $ref: '#/components/schemas/AmountOfMoneyDTO' complementaryInfo: maxLength: 35 type: string description: Additional free text field. statusCode: maxLength: 2 type: string description: Code specifying the status of a document. detail: maxLength: 12 type: string description: Provides detailed information on the document. issuingAuthorityName: maxLength: 70 type: string description: Issuing authority name. documentLineItemNumber: maxLength: 5 type: integer description: Document line item number. format: int32 description: DTO to hold data for produced documents. ICManifestDeliveryExtensionDataDTO: type: object properties: ensXI: $ref: '#/components/schemas/ICManifestDeliveryExtensionICS' ensBE: $ref: '#/components/schemas/ICManifestDeliveryExtensionICS' ensFR: $ref: '#/components/schemas/ICManifestDeliveryExtensionICS' ensIE: $ref: '#/components/schemas/ICManifestDeliveryExtensionICS' ensGB: $ref: '#/components/schemas/ICManifestDeliveryExtensionICS' gvmsGB: $ref: '#/components/schemas/ICManifestDeliveryExtensionGVMSBG' ensSTI: $ref: '#/components/schemas/ICManifestDeliveryExtensionSTI' description: DTO to hold additional delivery extension data for customs processes. Extension data is only required in very rare cases. Not all customs processes are supported. ICDeliveryItemIntrastatDEDTO: type: object properties: transactionNatureCode: maxLength: 2 type: string description: Nature of transaction invoicePrice: $ref: '#/components/schemas/AmountOfMoneyDTO' destinationCountryRegionCode: maxLength: 2 type: string description: Destination region goodsMovementDate: $ref: '#/components/schemas/DateAndZoneDTO' originCountryRegionCode: maxLength: 2 type: string description: Code specifying the origin region. description: DTO to hold Intrastat DE specific extension data for a ICDeliveryItemDTO. ICDeliveryImportDEDTO: type: object properties: producedDocuments: type: array description: List of produced documents items: $ref: '#/components/schemas/ICProducedDocumentEUDTO' sumDecWriteOffInfo: type: array description: List of write off data for summary declaration assignment items: $ref: '#/components/schemas/ICDeliverySumDecWriteOffInfoDEDTO' destinationCountryRegionCode: maxLength: 2 type: string description: Country region code of destination (ATLAS code list A1270) departureAirport: pattern: ^[A-Z]{3}$ type: string description: Code (IATA key) for the airport of departure proportionateAirFreightInEU: $ref: '#/components/schemas/AmountOfMoneyDTO' proportionateAirFreightOutEU: $ref: '#/components/schemas/AmountOfMoneyDTO' discount: $ref: '#/components/schemas/AmountOfMoneyDTO' discountPercent: type: number description: Discount in percent (cost distribution) cashDiscount: $ref: '#/components/schemas/AmountOfMoneyDTO' cashDiscountPercent: type: number description: Cash discount in percent (cost distribution) promilleInsurance: type: number description: Permill rate of the insurance premium for the transport insurance in relation to the invoice value (cost distribution) additionalInfoForCustoms: maxLength: 2000 type: string description: Additional information for customs- In case of IMPOST this will be cut at 512 characters description: DTO to hold Import DE specific extension data for a ICDeliveryDTO. ICDeliveryReferencesDTO: type: object properties: deliveryIdClientSystem: maxLength: 255 type: string description: Unique id of the delivery within the ERP system deliveryNumber: maxLength: 70 type: string description: Reference number of the delivery. description: 'DTO to hold data of a delivery that has been transitioned into the declaration. ' ICAddDeclarationAttachmentsRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectIds: maxLength: 20 type: array description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. items: maxLength: 20 type: string description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled. consignmentIdClientSystem: maxLength: 255 type: string description: The consignment id of the ERP system of the client. Either the businessObjectId or the consignmentIdClientSystem must be filled. mode: type: string description: 'Manages how the system should react if an attachment already exists. If empty ADD will be used.Possible values:
2-letter ISO code of the language.
length=2
example: en text: type: string description: The translated text. example: Some free-form text description: A translated text in one of the specified languages. ICProducedDocumentEUDTO: type: object properties: documentType: maxLength: 25 type: string description: Specific document type.this field might be omitted
Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' customsProcess: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' businessObjectIds: type: array description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled.length=20
items: type: string description: One or more unique business object ids of the desired declarations. Either the businessObjectIds or the consignmentIdClientSystem must be filled.length=20
consignmentIdClientSystem: type: string description: The consignment id of the ERP system of the client. Either the businessObjectId or the consignmentIdClientSystem must be filled.length=255
attachmentCode: type: string description: Code of the attachment.length=250
statusCode: type: string description: 'The new status of the attachment. Supported values are: NEW, PRINTED.length=20
' description: The request DTO to set the status of an attachment. ICPartyDTO: type: object properties: partyType: maxLength: 40 type: string description: Specific party type.Specific customs process.
length=70
For NL used as optional Address, length=22
streetNumber: maxLength: 10 type: string description: Street number city: maxLength: 35 type: string description: City postCode: maxLength: 7 type: string description: Postal code country: maxLength: 2 type: string description: Country Iso code complement: maxLength: 4 type: string description: Complementing data unLocode: maxLength: 17 type: string description: UN/LOCODE type: maxLength: 1 type: string description: Type of location, coded gnss: $ref: '#/components/schemas/ICGnssDTO' qualifierOfIdentification: maxLength: 1 type: string description: Qualifier of identification authorisationNumber: maxLength: 35 type: string description: Authorisation number contactPerson: $ref: '#/components/schemas/ICPersonDTO' customsProcess: maxLength: 20 type: string description:Specific customs process.
Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectId: maxLength: 50 type: string description: The unique business object id of the declaration which has to be cancelled. This field is mandatory.length=50
reason: maxLength: 300 type: string description: The reason for the cancellation. Must also be specified.length=300
reasonCode: maxLength: 3 type: string description: The reason code for the cancellation. For list of possible reason codes see /InternationalCustomsBFBean/getCodes for CANCELLATION_REASON_CODEmax. length=3
requestCancelAtCustoms: type: boolean description: ' Specifies that Customs Management may request a cancellation in the customs system with the given reason.Currently only supported by some customs processes.' customsProcess: $ref: '#/components/schemas/ICCustomsProcessTypeDTO' description: The request dto for the cancellation of declarations BF. ICDeliveryGVMSGBDTO: type: object properties: isUnaccompanied: type: boolean description: 'Indicates that the vehicle will not be accompanying the trailer(s) during the crossing. ' plannedCrossingRouteId: maxLength: 200 type: string description: ID of the crossing route. plannedCrossingDepartureDate: $ref: '#/components/schemas/DateAndZoneDTO' description: GB specific extension data for a goods movement record. ICCancelConsignmentRequestDTO: type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' businessObjectId: maxLength: 50 type: string description: The unique business object id of the desired consignment or consignment manifest. BusinessObjectId or consignmentIdClientSystem must be filled. consignmentIdClientSystem: maxLength: 255 type: string description: The consignment or consignment manifest id of the ERP system of the client. BusinessObjectId or consignmentIdClientSystem must be filled. reason: maxLength: 300 type: string description: Mandatory field. The reason for the cancellation. reasonCode: maxLength: 3 type: string description: The reason code for the cancellation. For list of possible reason codes see /InternationalCustomsBFBean/getCodes for CANCELLATION_REASON_CODEmax. length=3
requestCancelAtCustoms: type: boolean description: Specifies that for declarations, linked to this consignment or consignment manifest, Customs Management may request a cancellation in the customs system with the given reason. Currently only supported by some customs processes. description: Body data for the cancellation of a consignment or consignment manifest. ICGetDeclarationAttachmentsResponseDTO: type: object properties: hasErrors: type: boolean description:True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' attachments: type: array description: Data of the requested attachments. items: $ref: '#/components/schemas/ICAttachmentDTO' description: Response containing requested attachments. ICDeclarationItemDTO: type: object properties: sequenceNumber: maxLength: 5 type: integer description: Sequence number of the item. format: int32 status: $ref: '#/components/schemas/ICBusinessObjectStatusDTO' grossMass: $ref: '#/components/schemas/QuantityDTO' netMass: $ref: '#/components/schemas/QuantityDTO' extension: $ref: '#/components/schemas/ICDeclarationItemExtensionDataDTO' clientSystemIds: type: array description: IDs of contained items from the sending client system. items: type: string description: IDs of contained items from the sending client system. goodsDescription: type: array description: Goods description in requested languages. items: $ref: '#/components/schemas/TextInLanguageDTO' classifications: type: array description: List of classifications. items: $ref: '#/components/schemas/ICClassificationDTO' quantities: type: array description: List of quantites. items: $ref: '#/components/schemas/ICQuantityDTO' amountsOfMoney: type: array description: List of amount of moneys. items: $ref: '#/components/schemas/ICAmountOfMoneyDTO' parties: type: array description: List of involved parties. items: $ref: '#/components/schemas/ICPartyDTO' customsProcedures: type: array description: List of customs procedure codes. items: $ref: '#/components/schemas/ICCustomsProcedureDTO' customsSpecialProcedures: $ref: '#/components/schemas/ICDeclarationItemSpecialProceduresDTO' clientSpecificFields: $ref: '#/components/schemas/ClientSpecificFieldsDTO' description: DTO to hold data of a declaration item. ICGuaranteeDTO: type: object properties: guaranteeType: maxLength: 1 type: string description: Guarantee type otherGuaranteeReference: maxLength: 35 type: string description: Reference for other type of guarantee guaranteeReferenceNumber: maxLength: 24 type: string description: Guarantee reference number accessCode: maxLength: 4 type: string description: Access code amountToBeCovered: $ref: '#/components/schemas/AmountOfMoneyDTO' description: DTO to hold data of a guarantee. ICDeliveryImportCHDTO: type: object description: DTO to hold CH import extension data for a ICDeliveryDTO. ICClassificationDTO: type: object properties: classificationType: maxLength: 35 type: string description: 'Specific classification type:Specific customs process.
True, if there are any error messages.
An error usually means that the request could not be performed.
Error details are provided in the messages[] array.
example: false hasOnlyRetryableErrors: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true hasWarnings: type: boolean description:True, if there are any error messages.
Error details are provided in the messages[] array.
example: true messages: type: array description:Error or warning messages at the request level.
There may be additional messages[] arrays at lower data levels as specified in the documentation.
items: $ref: '#/components/schemas/ResponseMessageDTO' manifest: $ref: '#/components/schemas/ICConsignmentManifestResultDTO' description: The response DTO after processing the request. Contains the resulting consignment DTO. ICCreateDeliveryRequestDTO: required: - delivery type: object properties: clientSystemId: type: string description: 'Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' delivery: $ref: '#/components/schemas/ICDeliveryDTO' description: The DTO for the request. ICCustomsProcedureDTO: type: object properties: customsProcedureType: maxLength: 35 type: string description: "Specific types are:Value of the client specific field.
Supported data types:
If the value cannot be parsed according to the configured data type, the value will be ignored and an error will be logged.
customsProcess: maxLength: 20 type: string description:Specific customs process.
Id of the sending client system.
e.g. Installation ID of the sending host or ERP system.
Maximum length: 20
' example: TEST_ID clientIdentCode: type: string description: 'Client identification code.
Maximum length: 10
' example: APITEST userName: type: string description:User who initiated the request from the client system.
If the user is found either in the system's user management or in a connected LDAP directory, the request runs under this user's roles.
If the user is not found, the request is only granted the basic 'I_EVERYONE' role. The user name may be used for logging purposes in this case.
Actual authentication is handled separately via the request's headers, so no password is required in the request's data.
example: API_TEST resultLanguageIsoCodes: type: array description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: - en - de items: type: string description:2-letter ISO codes of the languages in which texts will be returned.
English ('en') and German ('de') are typically supported by default. Other languages may be supported.
Translations will be looked up in the order of the provided language codes. If a translation is not available in one language, the next language is used instead.
example: '["en","de"]' consignment: $ref: '#/components/schemas/ICConsignmentDTO' description: The DTO for the request. ICDeliveryExportUSDTO: type: object properties: carrierCode: maxLength: 4 type: string description: Code specifying the carrier. consigneeRelatedIndicator: maxLength: 3 type: string description: Code specifying the consignee related indicator. consigneeType: maxLength: 2 type: string description: Code specifying the consignee type. expectedDepartureTime: $ref: '#/components/schemas/DateAndZoneDTO' exportationPort: maxLength: 4 type: string description: Code specifying the exportation port. unladingPort: maxLength: 5 type: string description: Code specifying the unlading port. originRegion: maxLength: 2 type: string description: Code specifying the origin region. soldEnRouteIndicator: maxLength: 2 type: string description: Code specifying the sold en route indicator. transportationReferenceNumber: maxLength: 30 type: string description: Code specifying the transportation reference. inbondCode: maxLength: 2 type: string description: Code specifying the in-bond status. description: DTO to hold Export US specific extension data for a ICDeliveryDTO. securitySchemes: SWAGGER_AUTH_KEY: type: apiKey name: X-XNSG_WEB_TOKEN in: header BASIC_AUTH: type: http scheme: basic x-proxy-enabled: false