RECADV — Receiving Advice
Version: 2.0 — June 2026
EDIfact Standard: EANCOM D.01B
XML: v2.0
XSD: `Azuvio-CRMconnect-EDIconnect-RECADV-v2.0.xsd`
Direction: Inbound (Partner → CRMconnect)
Trigger: Partner confirms goods receipt (NIR)
CRMconnect Module: Warehouse → Reconciliation
In response to: DESADV
The RECADV message covers three scenarios:
- Goods receipt (NIR) —
BGM_1001: 632 - Goods return —
DocumentType: R - Goods confiscation —
BGM_1001: 70E
The three scenarios are processed differently in CRMconnect: NIR updates stock, Return creates a return order in the warehouse, Confiscation triggers a goods disposal workflow without physical return.
EDIfact D.01B
The following schema represents the list of elements in sequential order, not a complete syntactic form of the EANCOM message. It is based on the EANCOM D.01B standard. According to the GS1 instruction, additional information may be included, but only the elements mentioned in this document will be transmitted.
| Status | EANCOM Segment | Description |
|---|---|---|
UNA:+.? ' |
Separator specification | |
| Mandatory | UNB+UNOD:3+{GLN_Sender}:14+{GLN_Receiver}:14+{YYMMDD}:{HHMM}+{RefNo}++++++1' |
Physical file start. UNB_0010 = receiver GLN |
| Mandatory | UNH+00001+RECADV:D:01B:UN:EAN010' |
Start of a goods receiving advice |
| Mandatory | BGM+632+{NIRNo}+9' or BGM+70E+{NIRNo}+9' |
Advice type and number. BGM_1001: 632=goods receiving advice (NIR) or confiscation notification; BGM_1225: 9=original |
| Mandatory | DTM+137:{YYYYMMDD}:102' |
Goods receiving advice date |
| Mandatory | DTM+50:{YYYYMMDD}:102' |
Goods delivery date |
| Conditional/Optional | RFF+ON:{OrderNo}' |
Order number (not transmitted for return/confiscation messages) |
| Conditional/Optional | DTM+171:{YYYYMMDD}:102' |
Order date (not transmitted for return/confiscation messages) |
| Mandatory | NAD+SU+{GLN_Supplier}::9++{Name}+{Street}+{Town}++{PostalCode}+{Country}' |
Supplier: GLN, Name, Street and number, Town, Postal Code, Country Code |
| Mandatory | RFF+YC1:{SupplierNo}' |
Supplier number |
| Mandatory | NAD+BY+{GLN_Buyer}::9++{Name}+{Address}+{Town}++{PostalCode}+{Country}' |
Buyer with name and address (incl. street and number) |
| Mandatory | NAD+DP+{GLN_Store}::9++{StoreName}+{Address}+{Town}++{PostalCode}+{Country}' |
Location where goods were delivered (from where the receiving advice was issued) |
| Mandatory | CPS+1' |
Package calculation mode — content |
| Mandatory | LIN+{LineNo}++{EAN}:SRV' |
Main line position — product EAN code |
| Conditional/Optional | PIA+1+{InternalCode}:IN' |
Internal product code assigned by buyer |
| Conditional/Optional | PIA+1+{AdditionalCode}:BP' |
Additional internal product code assigned by buyer |
| Conditional/Optional | PIA+1+{SupplierCode}:SA' |
Internal product code assigned by supplier |
| Conditional/Optional | IMD+A++:::{ArticleDesc}' |
Product name — maximum 256 characters |
| Conditional/Optional | IMD+C++RC' |
Article type — RC=returnable packaging. Marks the transmitted article as returnable packaging |
| Mandatory/Conditional | QTY+194:{Qty}:PCE' |
194=received quantity |
| Optional | QTY+21:{Qty}:PCE' |
21=ordered quantity |
| Conditional/Optional | QTY+59:{ConsumerUnits}:PCE' |
59=number of consumer units in the traded unit (packing) |
| Conditional/Optional | PRI+AAA:{UnitPrice}:::1:PCE' |
Net unit reception price for the product |
| Conditional/Optional | FTX+ZZZ+1++COTA TVA %?:{VATRate}' |
VAT rate applicable to the article in the information system |
| Conditional/Optional | RFF+ALO:{NIRNo}' |
NIR number |
| Conditional/Optional | MOA+203:{LineNetValue}' |
Total net value received at line level |
| Mandatory | CNT+2:{LineCount}' |
Number of lines in the advice |
| Mandatory | UNT+{SegmentCount}+{MessageRef}' |
Advice terminator — message ID is repeated |
| Mandatory | UNZ+{MessageCount}+{InterchangeRef}' |
Physical file terminator — file ID is repeated |
EDIfact Example
UNA:+.? '
UNB+UNOD:3+5940000000020:14+5940000000010:14+240320:0900+000099++++++1'
UNH+00001+RECADV:D:01B:UN:EAN010'
BGM+632+0777111+9'
DTM+137:20240320:102'
DTM+50:20240320:102'
RFF+ON:45147813'
DTM+171:20240315:102'
NAD+SU+5940000000010::9++Furnizor SRL+Str. Exemplu 1+Bucuresti++010000+RO'
RFF+YC1:12345'
NAD+BY+5940000000020::9++Retailer SRL+Bd. Unirii 10+Bucuresti++030000+RO'
NAD+DP+5940000000030::9++Depozit Central+Str. Logistica 5+Ilfov++077000+RO'
CPS+1'
LIN+1++4304984471105:SRV'
PIA+1+8622:IN'
PIA+1+42759:BP'
PIA+1+3342:SA'
IMD+A++:::Produs Demo 500ml'
QTY+194:18:PCE'
QTY+21:18:PCE'
PRI+AAA:5.00:::1:PCE'
FTX+ZZZ+1++COTA TVA %?:19'
RFF+ALO:0777111'
MOA+203:90.00'
CNT+2:1'
UNT+24+00001'
UNZ+1+000099'
XML v2.0
Message structure: <Message> → <Version> → <Documents> → <Recadv> → <Header> + <Lines> + <Summary>
Header
| XML Element | Example | Format | M | Description |
|---|---|---|---|---|
Version |
2.0 |
Number (max 2 decimals) | File version | |
ReceptionNumber |
100107306 |
Number (16,0) | Yes | Receiving advice number |
ReceptionDate |
2012-07-28 |
YYYY-MM-DD | Yes | Receiving advice date |
DeliveryNumber |
65282 |
Text | No | Despatch advice number (DESADV) |
DeliveryDate |
2012-07-25 |
YYYY-MM-DD | No | Despatch advice date |
OrderNumber |
45051454 |
Number | No | Order number |
OrderDate |
2012-07-27 |
YYYY-MM-DD | No | Order date |
TransportDocNo |
45051454 |
Text | No | Transport document number |
DocumentType |
O |
Char (1-2 Char) | Yes | O=original, C=cancellation, R=return advice, RC=return advice cancellation, RP=replacement |
| Buyer | <Buyer> |
XML Tag | Buyer section | |
Buyer/GLN |
5948909999665 |
Number (max 14 digits) | Yes | Buyer GLN |
Buyer/BuyerName |
Text | No | Buyer name | |
Buyer/BuyerAddress |
Text | No | Address | |
Buyer/BuyerPostalCode |
Text | No | Postal code | |
Buyer/BuyerTown |
Text | No | Town | |
Buyer/BuyerCountry |
Text | No | Country | |
Buyer/BuyerInternalCode |
Text | No | Buyer internal code | |
Buyer/SAPCode |
Text | No | Buyer SAP code | |
| Supplier | <Supplier> |
XML Tag | Supplier section | |
Supplier/GLN |
5948909999665 |
Number (max 14 digits) | Yes | Supplier GLN |
Supplier/BuyerDepartment |
A15 |
Text | No | Buyer's internal department code |
Supplier/SupplierName |
Text | No | Supplier name | |
Supplier/SupplierAddress |
Text | No | Address | |
Supplier/SupplierPostalCode |
Text | No | Postal code | |
Supplier/SupplierTown |
Text | No | Town | |
Supplier/SupplierCountry |
Text | No | Country | |
Supplier/SupplierInternalCode |
103288774 |
Text | No | Supplier internal code |
Supplier/SAPCode |
103288774 |
Text | No | Supplier SAP code |
| Delivery | <Delivery> |
XML Tag | Delivery location section | |
Delivery/GLN |
5948909999665 |
Number (max 14 digits) | Yes | Delivery location GLN |
Delivery/DeliveryName |
Text | No | Location name | |
Delivery/DeliveryAddress |
Text | No | Address | |
Delivery/DeliveryPostalCode |
Text | No | Postal code | |
Delivery/DeliveryTown |
Text | No | Town | |
Delivery/DeliveryCountry |
Text | No | Country | |
Delivery/DeliveryInternalCode |
103288774 |
Text | No | Delivery location internal code |
Delivery/SAPCode |
103288774 |
Text | No | Location SAP code |
| LSP | <LSP> |
XML Tag | Logistics service provider section | |
LSP/GLN |
5948909999665 |
Number (max 14 digits) | Yes | Logistics service provider GLN |
LSP/LSPInternalCode |
103288774 |
Text | No | Logistics service provider internal code |
LSP/SAPCode |
103288774 |
Text | No | Logistics service provider SAP code |
| Invoicee | <Invoicee> |
XML Tag | Invoiced party section | |
Invoicee/GLN |
5948909999665 |
Number (max 14 digits) | No | Invoiced party GLN |
ContactDepartment |
Receptie Marfa |
Text | No | Contact department at delivery location |
ContactPhone |
0214023120 |
Text | No | Contact phone at delivery location |
ContactEmail |
sefrm.militari@METRO.ro |
Text | No | Contact email at delivery location |
Lines
1 line per received product with unique batch number, best before date, package type, SSCC and position on DESADV.
| XML Element | Example | Format | M | Description |
|---|---|---|---|---|
| Line | <Line> |
XML Tag | 1 line per received product with unique batch number, best before date, package type, SSCC and position on DESADV | |
LineNumber |
1 |
Number | Yes | Line number in the receiving advice |
EAN |
5941234567899 |
Number (max 14 digits) | Yes | Item EAN |
ArticleName |
Coca cola 2L |
Text | No | Article name |
BuyerItemCode |
123456001001 |
Number | No | Internal article code assigned by buyer |
BuyerAdditionalItemCode |
254635 |
Number | No | Buyer's additional internal code |
SupplierItemCode |
ABC1234 |
Text (max 35 char) | No | Internal article code assigned by supplier |
QuantityOrder |
37.000 |
Number (max 3 decimals) | No | Quantity on the original order |
QuantityDelivery |
37.000 |
Number (max 3 decimals) | No | Quantity on the despatch advice (DESADV) |
QuantityReception |
37.000 |
Number (max 3 decimals) | Yes | Received quantity |
QuantityVariance |
37.000 |
Number (max 3 decimals) | No | Difference between delivered quantity and received quantity |
A difference between QuantityDelivery and QuantityReception automatically triggers a credit note suggestion in CRMconnect. Verify that the values are correct before sending.
| XML Element | Example | Format | M | Description |
|---|---|---|---|---|
QuantityVarianceReason |
124 |
Text (3) | No | Reason code for the quantity difference |
UnitOfMeasure |
PCE |
3 Letter Standard | Yes | Standard EDIFACT coding (PCE, KGM, CS for cases) |
PackSize |
1.000 |
Decimal (max 3 decimals) | Yes | Number of pieces per case (delivered by supplier) |
Price |
10.3740 |
Number (max 4 decimals) | No | Price per traded unit (QuantityReception) |
UnitPrice |
0.8645 |
Number (max 4 decimals) | No | Price per consumer unit (Price / PackSize) |
VatRate |
9 |
Number | No | VAT rate % expressed as a number, valid at the date of reception |
ArticleType |
CU |
2 letter coding | No | CU=consumer unit, TU=traded unit, MX=mixed assortment |
FreeGood |
0 |
0 or 1 | No | 0=No or absent; 1=free goods |
DespatchPosNo |
900003 |
Text (6) | No | Article position in the received DESADV |
BatchNo |
2988 |
Text (10) | No | Batch number |
BatchCodeOrigin |
QA |
Text (15) | No | Batch code at origin |
BatchCodeDestination |
SA |
Text (15) | No | Batch code at destination |
BestBeforeDate |
2017-05-01 |
Date (YYYY-MM-DD) | No | Best before date |
| PackageDetails | <PackageDetails> |
XML Tag | No | Package details |
PackageDetails/PackageType |
CT |
Text (3) | No | Package type (CT=carton, 201=pallet) |
PackageDetails/PackageTypeIdentCode |
50 |
Text (3) | No | 50=EAN-13/EAN-8 barcode, 52=UCC/EAN-128 barcode |
PackageDetails/NumberOfPackages |
108 |
Number (11,3) | No | Number of packages on the same pallet (marked with the SSCC below) |
PackageDetails/SSCC |
340017244206795132 |
Text (18) | No | SSCC — unique pallet code |
Summary
| XML Element | Example | Format | M | Description |
|---|---|---|---|---|
Lines |
1 |
Number | Yes | Total number of lines in RECADV |
TotalReceiptAmount |
1234.56 |
Number (17,4) | No | Total net amount of the reception |
TotalReceiptQuantity |
1234.56 |
Number (17,4) | No | Total received quantity (arithmetic sum regardless of UOM) |
TotalPallets |
12 |
Number (17,4) | No | Total number of pallets received |
XSD Schema
File: `Azuvio-CRMconnect-EDIconnect-RECADV-v2.0.xsd`
xmllint --schema Azuvio-CRMconnect-EDIconnect-RECADV-v2.0.xsd aviz-receptie.xml --noout
CRMconnect Field Mapping
| EDI Field | EDIfact Segment / XML Element | CRMconnect Field |
|---|---|---|
| NIR number | BGM+632 / ReceptionNumber |
Warehouse → Reception → Number |
| NIR date | DTM+137 / ReceptionDate |
Warehouse → Reception → Date |
| DESADV reference | RFF+DQ / DeliveryNumber |
Issue → Document (search) |
| Order reference | RFF+ON / OrderNumber |
Sales → Orders → Reference |
| Received quantity | QTY+194 / QuantityReception |
Reconciliation → Accepted |
| Quantity difference | QuantityVariance |
Reconciliation → Difference |
| Unit price | PRI+AAA / UnitPrice |
Reception Line → Price |
| VAT rate | FTX+ZZZ / VatRate |
Product → VAT Class |
| NIR number (reference) | RFF+ALO |
Reception → Internal NIR Number |
| Line net value | MOA+203 |
Reception → Line Total |
Effects in CRMconnect
| Scenario | CRMconnect Action |
|---|---|
QuantityReception = QuantityDelivery |
Invoice confirmed, no further action |
QuantityReception < QuantityDelivery |
Credit note suggestion is generated |
DocumentType = R (return) |
Return order is created in Warehouse |
BGM_1001 = 70E (confiscation) |
Confiscation workflow is triggered |