xml RECADV (Receiving Advice)

The RECADV message address the business needs related to the goods receipt.

General usage

- The message is used to report the physical receipt of goods.
- The message allows for the reporting of discrepancies in products, quantities, terms, packages, etc.
- The message may contain only the information that the received consignment is completely in line with the consignment information given in the Despatch advice message.

Fields used in the RECADV message

Name Required Description Examples Xpath Limits Type Sort
(Header) : Delivery date

The date when the goods was delivered. Used to indicate a situation when the date/time of delivery was not the same as the date/time on which the goods were formally received (receivedDate).

 
 <receivingAdvice text="Btwentyfour Example Recadv" environment="Production" deliveryDate="2015-11-01" shipmentNumber="454545">

/b24Message/receivingAdvice/@deliveryDate

 Date/Time 1
(Header) : Received date

The date when the goods was received

 
 <receivingAdvice text="Btwentyfour Example Recadv" environment="Production" deliveryDate="2020-11-01" receivedDate="2020-11-02" shipmentNumber="454545">

/b24Message/receivingAdvice/@receivedDate

 2
(Header) : Sender Yes

The sender of the EDI message, identified by a GLN.

 
 <sender gln="2222222222222">

/b24Message/receivingAdvice/sender/@gln

 3
(Header) : Recipient Yes

The recipient of the EDI message, identified by a GLN.

 
 <recipient gln="1111111111111">

/b24Message/receivingAdvice/recipient/@gln

 4
(Header) : Receiving advice number Yes

The ID of the receiving advice.

 
 <documentReference documentType="ReceivingAdvice" id="4521" date="2020-11-02">

/b24Message/receivingAdvice/documentReference[@documentType="ReceivingAdvice"]/@id

 5
(Header) : Buyer order number No

Buyer order number for specific DESADV

 
 <documentReference documentType="BuyerOrder" id="555666" date="2020-10-01">

/b24Message/receivingAdvice/documentReference[@documentType="BuyerOrder"]/@id

 6
(Header) : Buyer order date

Buyer order date for specific DESADV

 
 <documentReference documentType="BuyerOrder" id="555666" date="2020-10-01">

/b24Message/receivingAdvice/documentReference[@documentType="BuyerOrder"]/@date

 7
(Header) : Supplier order number Yes

The sales order number set by the supplier.

 
 <documentReference documentType="SupplierOrder" id="24123456" date="2020-10-01">

/b24Message/receivingAdvice/documentReference[@documentType="SupplierOrder"]/@id

 8
(Header) : Despatch advice number Yes

The ID of the despatch advice, set by the supplier.

 
 <documentReference documentType="DespatchAdvice" id="95159" date="2020-10-30">

/b24Message/receivingAdvice/documentReference[@documentType="DespatchAdvice"]/@id

 9
(Header) : Ultimate Consignee GLN

The party to which the goods are ultimately delivered, identified by a GLN.

 
 <property name="ultimateConsignee">ultimateConsigneeGLN</property>

/b24Message/receivingAdvice/property[@name="ultimateConsignee"]

 10
(Header) : Ultimate Consignee Name

Name of the ultimate consignee.

 
 <property name="ultimateConsigneeName">ultimateConsigneeName</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeName"]

 11
(Header) : Ultimate Consignee Address

Address of the ultimate consignee.

 
 <property name="ultimateConsigneeAddress">ultimateConsigneeAddress</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeAddress"]

 12
(Header) : Ultimate Consignee Zip Code

Zip code of the ultimate consignee.

 
 <property name="ultimateConsigneeCityCode">ultimateConsigneeZipCode</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeCityCode"]

 13
(Header) : Ultimate Consignee City

City of the ultimate consignee.

 
 <property name="ultimateConsigneeCity">ultimateConsigneeCity</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeCity"]

 14
(Header) : Ultimate Consignee Country

Country of the ultimate consignee.

 
 <property name="ultimateConsigneeCountry">ultimateConsigneeCountryName</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeCountry"]

 15
(Header) : Ultimate Consignee Country Code

Country code of the ultimate consignee.

 
 <property name="ultimateConsigneeCountryCode">ultimateConsigneeCountryCode</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeCountryCode"]

 16
(Header) : Ultimate Consignee Org No

Corporate identity number of the ultimate consignee party.

 
 <property name="ultimateConsigneeOrgNo">ultimateConsigneeOrgNo</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeOrgNo"]

 17
(Header) : Ultimate Consignee VAT No

VAT number (value added tax number) of the ultimate consignee party.

 
 <property name="ultimateConsigneeVatNo">ultimateConsigneeVatNumber</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeVatNo"]

 18
(Header) : Ultimate Consignee Contact

Name of a ultimate consignee.

 
 <property name="ultimateConsigneeContact">ultimateConsigneeContact</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeContact"]

 19
(Header) : Ultimate Consignee Phone number

Telephone number of the ultimate consignee.

 
 <property name="ultimateConsigneeTelephoneNumber">ultimateConsigneeTelephoneNumber</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeTelephoneNumber"]

 20
(Header) : Ultimate Consignee Email

An e-mail address of the ultimate consignee.

 
 <property name="ultimateConsigneeEmailAddress">ultimateConsigneeEmailAddress</property>

/b24Message/receivingAdvice/property[@name="ultimateConsigneeEmailAddress"]

 21
(Header) : Supplier GLN Yes

The supplier/brand, identified by a GLN.

 
 <supplier gln="2222222222222" name="SupplierName">

/b24Message/receivingAdvice/supplier/@gln

 22
(Header) : Supplier Name

Name of the supplier party.

 
 <supplier gln="2222222222222" name="SupplierName">

/b24Message/receivingAdvice/supplier/@name

 23
(Header) : Supplier Address

Address of the supplier party.

 
 <address>StreetAddress</address>

/b24Message/receivingAdvice/supplier/location/address

 24
(Header) : Supplier Zip Code

Zip code of the supplier party.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/supplier/location/city/@code

 25
(Header) : Supplier City

City of the supplier party.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/supplier/location/city

 26
(Header) : Supplier Country

Country of the supplier party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/supplier/location/country

 27
(Header) : Supplier Country Code

Country code of the supplier party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/supplier/location/country/@code

 28
(Header) : Buyer GLN Yes

The buying party, identified by a GLN.

 
 <buyer gln="1111111111111" name="BuyerName" contact="ContactReference">

/b24Message/receivingAdvice/buyer/@gln

 29
(Header) : Buyer Name

Name of the buyer party.

 
 <buyer gln="1111111111111" name="BuyerName" contact="ContactReference">

/b24Message/receivingAdvice/buyer/@name

 30
(Header) : Buyer Contact

Name of the buyer's contact/reference person.

 
 <buyer gln="1111111111111" name="BuyerName" contact="ContactReference">

/b24Message/receivingAdvice/buyer/@contact

 31
(Header) : Buyer Address

Address of the buyer party.

 
 <address>StreetAddress</address>

/b24Message/receivingAdvice/buyer/location/address

 32
(Header) : Buyer Zip code

Zip code of the buyer party.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/buyer/location/city/@code

 33
(Header) : Buyer City

City of the buyer party.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/buyer/location/city

 34
(Header) : Buyer Country

Country of the buyer party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/buyer/location/country

 35
(Header) : Buyer Country Code

Country code of the buyer party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/buyer/location/country/@code

 36
(Header) : Shipper

The shipper of the goods, identified with a GLN.

 
 <shipper gln="2222222222222">

/b24Message/receivingAdvice/shipper/@gln

 37
(Header) : Ship from

The party from where the goods are shipped, identified with a GLN.

 
 <shipFrom gln="8888888888888">

/b24Message/receivingAdvice/shipFrom/@gln

 38
(Header) : Delivery party (Consignee) GLN

The delivery party/consignee (the receiving party of the goods), identified by a GLN.

 
 <consignee gln="3333333333333" name="ConsigneeName">

/b24Message/receivingAdvice/consignee/@gln

 39
(Header) : Delivery party (Consignee) Name

Name of the delivery party/consignee.

 
 <consignee gln="3333333333333" name="ConsigneeName">

/b24Message/receivingAdvice/consignee/@name

 40
(Header) : Delivery party (Consignee) Address

Address of the delivery party/consignee.

 
 <address>StreetAddress</address>

/b24Message/receivingAdvice/consignee/location/address

 41
(Header) : Delivery party (Consignee) Zip Code

Zip code of the delivery party/consignee.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/consignee/location/city/@code

 42
(Header) : Delivery party (Consignee) City

City of the delivery party/consignee.

 
 <city code="ZipCode">CityName</city>

/b24Message/receivingAdvice/consignee/location/city

 43
(Header) : Delivery party (Consignee) Country

Country of the delivery party/consignee.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/consignee/location/country

 44
(Header) : Delivery party (Consignee) Country Code

Country code of the delivery party/consignee.

 
 <country code="CountryCode">CountryName</country>

/b24Message/receivingAdvice/consignee/location/country/@code

 45
(Package) : Package type Yes

Package type, for example PX for pallet and BX for box. First package element should always have packageType="shipment", this is a virtual first level for the package hiearchy

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@packageType

 46
(Package) : Hierarchy identity

The package hierarchy identity.

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@hierarchyIdentity

 47
(Package) : Parent hierarchy identity

The parent package hierarchy identity. Every package except the root package must reference their parent.

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@parentHierarchyIdentity

 48
(Package) : Quantity

The number of packages within the hierarchy.

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@quantity

 49
(Package) : Tracking URL

The URL for tracking the package.

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@trackingUrl

 50
(Package) : SSCC

Serial Shipping Container Code.

 
 <package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">

/b24Message/receivingAdvice/package/@SSCC

 51
(Item/Line) : Item Id

The supplier's unique item ID of the product.

 
 <item id="1000000001111">

/b24Message/receivingAdvice/package/item/@id

 52
(Item/Line) : Quantity Yes

The number of items despatched.

 
 <item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">

/b24Message/receivingAdvice/package/item/@quantity

 53
(Item/Line) : Ordered quantity

The number of items ordered.

 
 <item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">

/b24Message/receivingAdvice/package/item/@orderedQuantity

 54
(Item/Line) : Accepted quantity

The number of items accepted.

 
 <item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">

/b24Message/receivingAdvice/package/item/@acceptedQuantity

 55
(Item/Line) : Received quantity Yes

The number of items received.

 
 <item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">

/b24Message/receivingAdvice/package/item/@receivedQuantity

 56
(Item/Line) : Supplier order number

Supplier order number.

 
 <documentReference documentType="SupplierOrder" id="24123456" date="2015-10-01" lineNo="2">

/b24Message/receivingAdvice/package/item/documentReference[@documentType="SupplierOrder"]/@id

 57
(Item/Line) : Buyer order number No

Buyer order number.

 
 <documentReference documentType="BuyerOrder" id="555666" date="2015-10-01" lineNo="2">

/b24Message/receivingAdvice/package/item/documentReference[@documentType="BuyerOrder"]/@id

 58
(Item/Line) : Unit of measure

The unit of measure for the product: such as PCE, PAIR etc.

 
 <property name="unitOfMeasure">PCE</property>

/b24Message/receivingAdvice/package/item/property[@name="unitOfMeasure"]

 59
(Item/Line) : Barcode Yes

The supplier's EAN/UPC code of the product.

 
 <itemReference registry="Supplier" coding="EAN13">1234567891123</itemReference>

/b24Message/receivingAdvice/package/item/itemReference[@registry="Supplier"]

 60
(Item/Line) : Buyer Item ID

The buyer's unique item ID of the product.

 
 <itemReference registry="Buyer" name="itemId">998877</itemReference>

/b24Message/receivingAdvice/package/item/itemReference[@registry="Buyer" and @name="itemId"]

 61
(Item/Line) : Variance quantity

The variance quantity.

 
 <variance quantity="3">

/b24Message/receivingAdvice/package/item/variance/@quantity

 62
(Item/Line) : Variance reason

The variance reason

 
 <property name="varianceReason">Goods delivered damaged</property>

/b24Message/receivingAdvice/package/item/variance/property[@name="varianceReason"]

 63