Body

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

# Field Name Required Field Description Xpath Example
1 Delivery date   The date when the goods was delivered /b24Message/receivingAdvice/@deliveryDate
<receivingAdvice text="Btwentyfour Example Recadv" environment="Production" deliveryDate="2015-11-01" shipmentNumber="454545">
2 Received date   The date when the goods was received /b24Message/receivingAdvice/@receivedDate
<receivingAdvice text="Btwentyfour Example Recadv" environment="Production" deliveryDate="2020-11-01" receivedDate="2020-11-02" shipmentNumber="454545">
3 Sender Yes The sender of the EDI message, identified by a GLN. /b24Message/receivingAdvice/sender/@gln
<sender gln="2222222222222">
4 Recipient Yes The recipient of the EDI message, identified by a GLN. /b24Message/receivingAdvice/recipient/@gln
<recipient gln="1111111111111">
5 Receiving advice number Yes The ID of the receiving advice. /b24Message/receivingAdvice/documentReference[@documentType="ReceivingAdvice"]/@id
<documentReference documentType="ReceivingAdvice" id="4521" date="2020-11-02">
6 Buyer order number   Buyer order number for specific DESADV /b24Message/receivingAdvice/documentReference[@documentType="BuyerOrder"]/@id
<documentReference documentType="BuyerOrder" id="555666" date="2020-10-01">
7 Buyer order date   Buyer order date for specific DESADV /b24Message/receivingAdvice/documentReference[@documentType="BuyerOrder"]/@date
<documentReference documentType="BuyerOrder" id="555666" date="2020-10-01">
8 Supplier order number Yes The sales order number set by the supplier. /b24Message/receivingAdvice/documentReference[@documentType="SupplierOrder"]/@id
<documentReference documentType="SupplierOrder" id="24123456" date="2020-10-01">
9 Despatch advice number Yes The ID of the despatch advice, set by the supplier. /b24Message/receivingAdvice/documentReference[@documentType="DespatchAdvice"]/@id
<documentReference documentType="DespatchAdvice" id="95159" date="2020-10-30">
10 Ultimate Consignee GLN   The party to which the goods are ultimately delivered, identified by a GLN. /b24Message/receivingAdvice/property[@name="ultimateConsignee"]
<property name="ultimateConsignee">ultimateConsigneeGLN</property>
11 Ultimate Consignee Name   Name of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeName"]
<property name="ultimateConsigneeName">ultimateConsigneeName</property>
12 Ultimate Consignee Address   Address of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeAddress"]
<property name="ultimateConsigneeAddress">ultimateConsigneeAddress</property>
13 Ultimate Consignee Zip Code   Zip code of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeCityCode"]
<property name="ultimateConsigneeCityCode">ultimateConsigneeZipCode</property>
14 Ultimate Consignee City   City of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeCity"]
<property name="ultimateConsigneeCity">ultimateConsigneeCity</property>
15 Ultimate Consignee Country   Country of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeCountry"]
<property name="ultimateConsigneeCountry">ultimateConsigneeCountryName</property>
16 Ultimate Consignee Country Code   Country code of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeCountryCode"]
<property name="ultimateConsigneeCountryCode">ultimateConsigneeCountryCode</property>
17 Ultimate Consignee Org No   Corporate identity number of the ultimate consignee party. /b24Message/receivingAdvice/property[@name="ultimateConsigneeOrgNo"]
<property name="ultimateConsigneeOrgNo">ultimateConsigneeOrgNo</property>
18 Ultimate Consignee VAT No   VAT number (value added tax number) of the ultimate consignee party. /b24Message/receivingAdvice/property[@name="ultimateConsigneeVatNo"]
<property name="ultimateConsigneeVatNo">ultimateConsigneeVatNumber</property>
19 Ultimate Consignee Contact   Name of a ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeContact"]
<property name="ultimateConsigneeContact">ultimateConsigneeContact</property>
20 Ultimate Consignee Phone number   Telephone number of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeTelephoneNumber"]
<property name="ultimateConsigneeTelephoneNumber">ultimateConsigneeTelephoneNumber</property>
21 Ultimate Consignee Email   An e-mail address of the ultimate consignee. /b24Message/receivingAdvice/property[@name="ultimateConsigneeEmailAddress"]
<property name="ultimateConsigneeEmailAddress">ultimateConsigneeEmailAddress</property>
22 Supplier GLN Yes The supplier/brand, identified by a GLN. /b24Message/receivingAdvice/supplier/@gln
 <supplier gln="2222222222222" name="SupplierName">
23 Supplier Name   Name of the supplier party. /b24Message/receivingAdvice/supplier/@name
 <supplier gln="2222222222222" name="SupplierName">
24 Supplier Address   Address of the supplier party. /b24Message/receivingAdvice/supplier/location/address
<address>StreetAddress</address>
25 Supplier Zip Code   Zip code of the supplier party. /b24Message/receivingAdvice/supplier/location/city/@code
<city code="ZipCode">CityName</city>
26 Supplier City   City of the supplier party. /b24Message/receivingAdvice/supplier/location/city
<city code="ZipCode">CityName</city>
27 Supplier Country   Country of the supplier party. /b24Message/receivingAdvice/supplier/location/country
<country code="CountryCode">CountryName</country>
28 Supplier Country Code   Country code of the supplier party. /b24Message/receivingAdvice/supplier/location/country/@code
<country code="CountryCode">CountryName</country>
29 Buyer GLN Yes The buying party, identified by a GLN. /b24Message/receivingAdvice/buyer/@gln
<buyer gln="1111111111111" name="BuyerName" contact="ContactReference">
30 Buyer Name   Name of the buyer party. /b24Message/receivingAdvice/buyer/@name
<buyer gln="1111111111111" name="BuyerName" contact="ContactReference">
31 Buyer Contact   Name of the buyer's contact/reference person. /b24Message/receivingAdvice/buyer/@contact
<buyer gln="1111111111111" name="BuyerName" contact="ContactReference">
32 Buyer Address   Address of the buyer party. /b24Message/receivingAdvice/buyer/location/address
<address>StreetAddress</address>
33 Buyer Zip code   Zip code of the buyer party. /b24Message/receivingAdvice/buyer/location/city/@code
<city code="ZipCode">CityName</city>
34 Buyer City   City of the buyer party. /b24Message/receivingAdvice/buyer/location/city
<city code="ZipCode">CityName</city>
35 Buyer Country   Country of the buyer party. /b24Message/receivingAdvice/buyer/location/country
<country code="CountryCode">CountryName</country>
36 Buyer Country Code   Country code of the buyer party. /b24Message/receivingAdvice/buyer/location/country/@code
<country code="CountryCode">CountryName</country>
37 Shipper   The shipper of the goods, identified with a GLN. /b24Message/receivingAdvice/shipper/@gln
<shipper gln="2222222222222">
38 Ship from   The party from where the goods are shipped, identified with a GLN. /b24Message/receivingAdvice/shipFrom/@gln
<shipFrom gln="8888888888888">
39 Delivery party (Consignee) GLN   The delivery party/consignee (the receiving party of the goods), identified by a GLN. /b24Message/receivingAdvice/consignee/@gln
<consignee gln="3333333333333" name="ConsigneeName">
40 Delivery party (Consignee) Name   Name of the delivery party/consignee. /b24Message/receivingAdvice/consignee/@name
<consignee gln="3333333333333" name="ConsigneeName">
41 Delivery party (Consignee) Address   Address of the delivery party/consignee. /b24Message/receivingAdvice/consignee/location/address
<address>StreetAddress</address>
42 Delivery party (Consignee) Zip Code   Zip code of the delivery party/consignee. /b24Message/receivingAdvice/consignee/location/city/@code
<city code="ZipCode">CityName</city>
43 Delivery party (Consignee) City   City of the delivery party/consignee. /b24Message/receivingAdvice/consignee/location/city
<city code="ZipCode">CityName</city>
44 Delivery party (Consignee) Country   Country of the delivery party/consignee. /b24Message/receivingAdvice/consignee/location/country
<country code="CountryCode">CountryName</country>
45 Delivery party (Consignee) Country Code   Country code of the delivery party/consignee. /b24Message/receivingAdvice/consignee/location/country/@code
<country code="CountryCode">CountryName</country>
46 Package type Yes Package type, for example ?PX? for pallet and ?CT? for box/carton. /b24Message/receivingAdvice/package/@packageType
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
47 Hierarchy identity   The package hierarchy identity. /b24Message/receivingAdvice/package/@hierarchyIdentity
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
48 Parent hierarchy identity   The parent package hierarchy identity. Every package except the root package must reference their parent. /b24Message/receivingAdvice/package/@parentHierarchyIdentity
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
49 Quantity   The number of packages within the hierarchy. /b24Message/receivingAdvice/package/@quantity
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
50 Tracking URL   The URL for tracking the package. /b24Message/receivingAdvice/package/@trackingUrl
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
51 SSCC   Serial Shipping Container Code. /b24Message/receivingAdvice/package/@SSCC
<package packageType="" quantity="1" hierarchyIdentity="1" SSCC="" trackingUrl="http:/findPackageStatus.nu/454545">
52 Item Id   The supplier's unique item ID of the product. /b24Message/receivingAdvice/package/item/@id
<item id="1000000001111">
53 Quantity Yes The number of items despatched. /b24Message/receivingAdvice/package/item/@quantity
<item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">
54 Ordered quantity   The number of items ordered. /b24Message/receivingAdvice/package/item/@orderedQuantity
<item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">
55 Accepted quantity   The number of items accepted. /b24Message/receivingAdvice/package/item/@acceptedQuantity
<item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">
56 Received quantity Yes The number of items received. /b24Message/receivingAdvice/package/item/@receivedQuantity
<item quantity="5" orderedQuantity="5" acceptedQuantity="5" receivedQuantity="5">
57 Supplier order number   Supplier order number. /b24Message/receivingAdvice/package/item/documentReference[@documentType="SupplierOrder"]/@id
<documentReference documentType="SupplierOrder" id="24123456" date="2015-10-01" lineNo="2">
58 Buyer order number Yes Buyer order number. /b24Message/receivingAdvice/package/item/documentReference[@documentType="BuyerOrder"]/@id
<documentReference documentType="BuyerOrder" id="555666" date="2015-10-01" lineNo="2">
59 Unit of measure   The unit of measure for the product: such as PCE, PAIR etc. /b24Message/receivingAdvice/package/item/property[@name="unitOfMeasure"]
<property name="unitOfMeasure">PCE</property>
60 Barcode with Type Yes The supplier's EAN/UPC code of the product. /b24Message/receivingAdvice/package/item/itemReference[@coding="EAN13"]
<itemReference registry="Supplier" coding="EAN13">1234567891123</itemReference>
61 Buyer Item ID   The buyer's unique item ID of the product. /b24Message/receivingAdvice/package/item/itemReference[@registry="Buyer" and @name="itemId"]
<itemReference registry="Buyer" name="itemId">998877</itemReference>
62 Variance quantity   The variance quantity. /b24Message/receivingAdvice/package/item/variance/@quantity
<variance quantity="3">
63 Variance reason   The variance reason /b24Message/receivingAdvice/package/item/variance/property[@name="varianceReason"]
<property name="varianceReason">Goods delivered damaged</property>