AEP Redevelopment - Note for Traders Inputting a XML SAD Message

Note for Traders Inputting a XML SAD IE/IM515 message: Introduction:

The commencement of Public Interface Testing has highlighted a number of items that need to be clarified. The main issues are detailed in “Points to note” below and the table on the following page maps SAD fields to Schema elements.

The AEP Trader Guide indicates which SAD boxes must be completed, the rules for their completion and the business level codes to be used. In addition there are certain message elements (see * below) that need to be completed. The codes for these elements are contained in the Customs Technical Reference lists

Points to Note:

The Import and Export schemas can be used to  File a customs declaration,  Correct a previously filed customs declaration,  And retrieve a copy of a previously filed SAD

The elements CustomsReferenceIdentifier, AcceptanceDate and IERiskRouting should not be included when submitting an initial SAD. The values for these elements will be returned by the AEP system in the Sad Response Message. CustomsReferenceIdentifier and AcceptanceDate need to be completed when correcting a previously filed SAD and for Supplementary Declarations for a previously filed incomplete SAD. CustomsReferenceIdentifier, AcceptanceDate and IERiskRouting will be included in retrieved copies of previously files SADs.

There are two “message level” elements defined in the Import and Export schema that are not mentioned in the Trader Guide*. These are  IEMessageType - must be completed using codes from the Message Type Codes in Customs Technical Reference List.  IEMessageSendingDate. - Optional for the trade

Certain fields/SAD Boxes are concatenated in the Schemas. These are Box 1.1 and Box 1.2 are contained in the element TypeCode Box 49 (made up of code for warehouse type (A1), warehouse identification number (AN.14) and country code (A2)) maps to the element GoodsShipment.Warehouse.IdentificationIdentifier

Not all fields on the SAD are always required. Some are optional and some are conditional. Please DO NOT send empty XML tags for fields that are not completed. Sending empty XML tags can cause problems.

The SAD import schema has been extended to cater for Excise Duty Entries (EDEs) and now contains some elements unique to EDEs that should not be completed when submitting a SAD declaration. These elements are.

 GoodsShipment.DispatchDate  GoodsShipment.Consignee.IEIERTNumber  GoodsShipment.Consignee.IELocalNumber  Agent.PhoneNumber In certain cases the size of a schema element, based on the World Customs Organisation data model, can be longer than the corresponding definition in the Trader Guide. In all such cases the length given in the trader guide must be adhered to.

Mapping Guidelines

The table on the following page maps the SAD fields to the Import and Export Schema elements under the headings:  SAD Box Numbers  SAD Box Name  SAD Schema name  Code lists

This is provided as an aid for construction of XML messages. Please refer to the AEP Trader Guides for business rules and field sizes. SAD IMPORT AND EXPORT SCHEMA

MAPPING GUIDE SAD SAD IMPORT/EXPORT SCHEMA ELEMENT CODE LISTS NOTES SAD BOX BOX NAME NO CustomsReferenceIdentifier This Number is Customs TYPE: WCO 020 assigned by the AEP Declaration A system, and returned reference in the AEP response number message. AcceptanceDate This date is assigned TYPE: WCO 023 by the AEP system, Acceptance A and returned in the Date AEP response message. IERiskRouting See Risk Routing codes This routing is TYPE: IERiskRouting in Customs Technical assigned by the AEP A Risk Routing Reference List system, and returned in the AEP response message. IEMessageSendingDate Optional for the Sending Date TYPE: IEDateTime Trade IEMessageType See Message Type Message Type TYPE: IEMessageType Codes in Customs Code Technical Reference List Specific SpecificCircumstanceIndicator Circumstance TYPE: SpecificCircumstanceIndicator Indicator TypeCode This field is a See Type of TYPE: WCO 001 concatenation of box Importation/Exportation Type of 1.1 Trade 1 codes in Trader Guide Declaration Movement(A2) and See Declaration Type box 1.2 Type of codes in Trader Guide Declaration(A1) 2/1 Consignor GoodsShipment.Consignor.IdentityIdentifier The trader must Registration TYPE: WCO 072 enter a Registration Number number OR N/R and a name and address. Please do not send empty tags for elements that are not completed. Consignor GoodsShipment.Consignor.NameText 2/2 Business TYPE: WCO 071 Name Consignor GoodsShipment.Consignor.Address. LineText 2/2 Address Line 1 TYPE: WCO 239 Consignor GoodsShipment.Consignor.Address.CityName 2/2 Address Line 2 TYPE: WCO 241 Consignor GoodsShipment.Consignor.Address.CountrySubEntityNameName 2/2 Address Line 3 TYPE: WCO 243 Consignor GoodsShipment.Consignor.Address.PostcodeIdentifier 2/2 Post Code TYPE: WCO 245 Consignor GoodsShipment.Consignor.Address.CountryCode See ISO Alpha 2 Country 2/2 Country TYPE: WCO 242 codes in Trader Guide Number of GoodsItemQuantity 5 Items TYPE: WCO 228 Total DeclarationPackaging.QuantityQuantity 6 Packages TYPE: WCO146 Commercial GoodsShipment.Ucr.TraderReferenceIdentifier 7 Reference TYPE: WCO 009 Number GoodsShipment.Consignee.IdentityIdentifier The trader must TYPE: WCO 052 enter a Registration number OR N/R and Consignee a name and address. 8/1 Registration Please do not send Number empty tags for elements that are not completed. Consignee GoodsShipment.Consignee.NameText 8/2 Business TYPE: WCO 051 Name Consignee GoodsShipment.Consignee.Address.LineText 8/2 Address Line 1 TYPE: WCO 239 Consignee GoodsShipment.ConsigneeAddress.CityName 8/2 Address Line 2 TYPE: WCO 241 Consignee GoodsShipment.Consignee.Address.CountrySubEntityNameName 8/2 Address Line 3 TYPE: WCO 243 Consignee GoodsShipment.Consignee.Address.PostcodeIdentifier 8/2 Post Code TYPE: WCO 245 Consignee GoodsShipment.Consignee.Address.CountryCode See ISO Alpha 2 Country 8/2 Country TYPE: WCO 242 codes in Trader Guide Valuation GoodsShipment.IEValueDetailsCode See Valuation codes in 12 Details TYPE: IEValueDetails Trader Guide Declarant/ Agent.StatusCode See Status of 14/1 Representative TYPE: WCO 102 Declarant/Representative Status codes in Trader Guide Agent.IdentityIdentifier The trader must TYPE: WCO 061 enter a Registration number OR N/R and Declarant a name and address. 14/2 Registration Please do not send Number empty tags for elements that are not completed. Declarant Agent.NameText 14/3 Business TYPE: WCO 060 Name Declarant Agent. Address.LineText 14/3 Address Line 1 TYPE: WCO 239 Declarant Agent.Address.CityName 14/3 Address Line 2 TYPE: WCO 241 Declarant Agent. Address.CountrySubEntityNameName 14/3 Address Line 3 TYPE: WCO 243 Declarant Post Agent. Address.PostcodeIdentifier 14/3 Code TYPE: WCO 245 Declarant Agent. Address.CountryCode See ISO Alpha 2 Country 14/3 Country TYPE: WCO 242 codes in Trader Guide Total Gross TotalGrossMassMeasure Mass TYPE: cus:Wco131 Number of NumberOfSeals. QuantityQuantity Seals TYPE: cus:Wco227 Control Result ControlResult.ControlResultCode Code TYPE: cus:Wco235 Date Limit ControlResult.DateLimit TYPE: cus:Wco264 Country of GoodsShipment.ExportationCountryIdentifier See ISO Alpha 2 Country 15a Dispatch / TYPE: WCO 062 codes in Trader Guide Export Code Destination GoodsShipment.DeliveryDestination.CountryCode See ISO Alpha 2 Country 17a Country TYPE: WCO 242 codes in Trader Guide For Import: See Region codes in Destination 17b GoodsShipment.DeliveryDestination.CountrySubEntityIdentifier Trader Guide Region TYPE: WCO 244 For Import: Identity of the GoodsShipment.Consignment.ArrivalTransportMeans.IdentificationText means of TYPE: WCO 184 18/1 transport at For Export departure / GoodsShipment.Consignment.DepartureTransportMeans.IdentificationText arrival TYPE: WCO 158 Delivery GoodsShipment.TradeTerm.ConditionCode See Incoterm codes in 20/1 Terms: TYPE: WCO 090 Trader Guide Incoterm Delivery GoodsShipment.TradeTerm.LocationNameText 20/2 Terms: Named TYPE: WCO 037 Place Delivery GoodsShipment.TradeTerm.CountryRelationshipCode See Delivery Destination 20/3 Terms: TYPE: WCO 106 Location codes in Trader Situation Guide Identity of the IdentityText active means TYPE: WCO 160 21/1 of transport crossing the border Nationality of GoodsShipment.Consignment.BorderTransportMeans.RegistrationNationalityIdentifier the active TYPE: WCO 175 means of See ISO Alpha 2 Country 21/2 transport codes in Trader Guide crossing the border GoodsShipment.Consignment.BorderTransportMeans.TransportType TYPE: cus:Wco183 CurrencyExchange.CurrencyTypeIdentifier See Currency codes in 22/1 Currency code TYPE: WCO 135 Trader Guide 22/2 Total amount InvoiceAmount invoiced TYPE: WCO 109 Exchange CurrencyExchange.RateNumeric 23 Rate TYPE: WCO 118 GoodsShipment.TransactionNatureCode See Nature of the Nature of the 24 TYPE: WCO 103 Transaction codes in transaction Trader Guide Mode of GoodsShipment.Consignment.BorderTransportMeans.ModeAndTypeCode See Mode of Transport 25 transport at the TYPE: WCO 183 codes in Trader Guide border Country of GoodsShipment.Consignment.BorderTransportMeans.Itineray. CountryCode Routing TYPE: cus:Wco242 Inland mode of GoodsShipment.Consignment.IEInlandModeOfTransportCode See Mode of Transport 26 transport TYPE: IEInlandModeOfTransportCode codes in Trader Guide For Import: See Office of Entry/Exit GoodsShipment.EntryCustomsOffice.CodeIdentifier codes in Trader Guide Office of TYPE: WCO 046 29 exit/entry For Export: GoodsShipment.ExitCustomsOffice.CodeIdentifier TYPE: WCO 047 Location of GoodsShipment.Consignment.GoodsLocation.LocationIdentifier See Location of Goods 30 Goods TYPE: WCO 079 codes in Trader Guide GoodsShipment.Consignment.GoodsLocation.TransportEquipment.SealsIdentity Seals Identitiy TYPE: cus:Wco165 Method of GoodsShipment.IEMethodOfPaymentCode See Method of Payment 47/5 Payment TYPE: IEMethodOfPaymentCode codes in Trader Guide Deferred GoodsShipment.IEPayer.IEPayerIdentifier 48 Payment TYPE: IEPayerIdentifier GoodsShipment.Warehouse.IdentificationIdentifier See Type of Warehouse This element has a TYPE: WCO 053 codes in Trader Guide concatenated value See ISO Alpha 2 Country made up of code for Warehouse codes in Trader Guide warehouse type 49 code (A1), warehouse identification number (AN..14) and country code (A2) Customs OfficeIdentifier See Office of A Office of TYPE: WCO 065 Import/Export codes in Import/Export Trader Guide 31 Container GoodsShipment.ConsignmentCustomsGoodsItem.TransportEquipment.EquipmentIdentification.IdentificationIdentifie Number r TYPE: WCO 159 GoodsShipment.Consignment.TransportContractDocument.TypeCode See Type of transport Transport 31 TYPE: WCO 250 Document codes in Type Trader Guide GoodsShipment.Consignment.TransportContractDocument.ReferenceIdentifier See Port of Loading Transport 31 TYPE: WCO 015 codes (if bill of lading) in Document Trader Guide Summary GoodsShipment.Consignment.IESummaryDeclarationIdentifier Declaration TYPE: WCO 003 31 Registration Number GoodsShipment.AdditionalDocument.TypeCode See Attached Additional TYPE: WCO 170 Documents, Certificates, 44/1 Document Authorisation codes in Trader Guide GoodsShipment.AdditionalDocument.ReferenceIdentifier See Attached Additional TYPE: IEReferenceIdentifierList Documents, Certificates, 44/2 Document Authorisation codes in Trader Guide GoodsShipment. AdditionalInformationStatementCode See Additional Additional 44/1 TYPE: WCO 226 Information codes in Information Trader Guide GoodsShipment.AdditionalInformation.ContentText See Additional Additional 44/2 TYPE: WCO 105 Information codes in Information Trader Guide Transport GoodsShipment. TransportMethodOfPaymentCode charges - TYPE: cus:IEMethodOfPaymentCode Method of Payment code GoodsShipment.CustomsGoodsItem.SequenceIdentifier 32 Item number TYPE: WCO 006 Packages in GoodsShipment.CustomsGoodsItem.IEPcksDescSequenceIdentifier 31 item TYPE: WCO 006 33/1 Nomenclature GoodsShipment.CustomsGoodsItem.Commodity.TariffClassificationCode 33/2 Code TYPE: WCO 145 TARIC GoodsShipment.CustomsGoodsItem.Commodity.EUTariffClassificationAdd1Code 33/3 additional code TYPE: WCO - EUAdditionalCode 1 33/4 TARIC GoodsShipment.CustomsGoodsItem.Commodity.EUTariffClassificationAdd2Code additional code TYPE: WCO - EUAdditionalCode 2 GoodsShipment.CustomsGoodsItem.Commodity.EUTariffClassificationNatCode 33.5 National Code TYPE: WCO - EUAdditionalCode UN Dangerous GoodsShipment.CustomsGoodsItem.Commodity.DangerousGoodsCodeIdentifier Goods Code TYPE: cus:Wco143 Country of GoodsShipment.CustomsGoodsItem.Origin.OriginCountryIdentifier See ISO Alpha 2 Country 34a Origin TYPE: WCO 063 codes in Trader Guide For Export Region of See Region codes in 34b GoodsShipment.CustomsGoodsItem.Origin OriginRegionIdentifier Origin Trader Guide TYPE: WCO 066 GoodsShipment.CustomsGoodsItem.GoodsMeasure.GrossMassMeasure 35 Gross Mass TYPE: WCO 126 GoodsShipment.CustomsGoodsItem.Commodity.EUDutyRegimeCode See Preference codes in 36 Preference TYPE: WCO 164 Trader Guide Customs GoodsShipment.CustomsGoodsItem.CustomsProcedure.CurrentCode See Procedure/ Procedure TYPE: WCO 166 37a/1 Procedure Category Requested codes in Trader Guide Code GoodsShipment.CustomsGoodsItem.CustomsProcedure.PreviousCode See Procedure/ Procedure Sub 37a/2 TYPE: WCO 161 Procedure Category Category Code codes in Trader Guide GoodsShipment.CustomsGoodsItem.CustomsProcedure.CategoryCode See Procedure/ Procedure – 37b TYPE: WCO - EUProcedureSubCategory Procedure Category Category codes in Trader Guide GoodsShipment.CustomsGoodsItem.GoodsMeasure.NetNetWeightMeasure 38 Net Mass TYPE: WCO 128 GoodsShipment.CustomsGoodsItem.Commodity.EUQuotaIdentifier 39 Quota TYPE: WCO - EUQuotaIdentifier GoodsShipment.CustomsGoodsItem.PreviousCustomsDocument.ReferenceIdentifier See Summary TYPE: WCO 007 Declaration/Previous Previous 40 Document and Document Document Abbreviation codes in Trader Guide Supplementary GoodsShipment.CustomsGoodsItem.GoodsMeasure.TariffQuantity 41 Units TYPE: WCO 130 GoodsShipment.CustomsGoodsItem.EUItemPriceAmount 42 Item Price TYPE: WCO 112 Valuation GoodsShipment.CustomsGoodsItem.EUCustomsValuation.MethodCode See Valuation Method 43 Method TYPE: WCO 122 codes in Trader Guide GoodsShipment.CustomsGoodsItem.ValuationAdjustmentAmountAmount 45 Adjustment TYPE: WCO 125 Statistical GoodsShipment.CustomsGoodsItem.StatisticalValueAmount 46 Value TYPE: WCO 114 Type of GoodsShipment.CustomsGoodsItem.GoodsPackaging.TypeCode See Type of Packages 31 Package TYPE: WCO 141 codes in Trader Guide Unique LP GoodsShipment.CustomsGoodsItem.IEUniqueLPRef 31 reference TYPE: IEUniqueLPRef Declared GoodsShipment.CustomsGoodsItem.GoodsPackaging.QuantityQuantity 31 Quantity of TYPE: WCO 144 Packages Number of GoodsShipment.CustomsGoodsItem.GoodsPackaging.NumberOfPieces 31 Pieces cus:EUPiecesNumber Marks of the GoodsShipment.CustomsGoodsItem.GoodsPackaging.MarkNumberText 31 Packages TYPE: WCO 142 Description of GoodsShipment.CustomsGoodsItem.Commodity.DescriptionText 31 Goods TYPE: WCO 137 GoodsShipment.CustomsGoodsItem.AdditionalDocument. TypeCode See Attached Additional TYPE: WCO170 Documents, Certificates, 44/1 Documents Authorisation codes in Trader Guide GoodsShipment.CustomsGoodsItem.AdditionalDocument. ReferenceIdentifier See Attached Additional TYPE: IEReferenceIdentifierList Documents, Certificates, 44/2 Documents Authorisation codes in Trader Guide GoodsShipment.CustomsGoodsItem.AdditionalInformation.StatementCode See Additional Additional 44/1 TYPE: WCO226 Information codes in Information Trader Guide GoodsShipment.CustomsGoodsItem.AdditionalInformation.ContentText See Additional Additional 44/2 TYPE: WCO105 Information codes in Information Trader Guide GoodsShipment.CustomsGoodsItem.Commodity.DutyTaxFee.TypeCode See Tax Type codes in 47/1 Tax Type TYPE: WCO 113 Trader Guide GoodsShipment.CustomsGoodsItem.Commodity.DutyTaxFee.IETaxBase 47/2 Tax Base TYPE: IETaxBase GoodsShipment.CustomsGoodsItem.Commodity.DutyTaxFee.TaxText 47/3 Tax Rate TYPE: WCO 115 GoodsShipment.CustomsGoodsItem.Commodity.DutyTaxFee.Payment.TaxAssessedAmount 47/4 Tax Amount TYPE: WCO 120 Method of GoodsShipment.CustomsGoodsItem.Commodity.DutyTaxFee.Payment.MethodCode See Method of Payment 47/5 Payment TYPE: WCO 107 codes in Trader Guide