Documentation

Standard workflow of a message

All the supplier's messages are arriving via AS2.

On steps 1 & 2, the notifications are manual and requires an action from B2Boost Support Team. After step 3, the email notifications in case of issue are sent automatically by our robot. There is no notification about correct reception, processing and transmission to Eurelec of a message.

This documentation page will describe in details all the types of errors that can occur during Step 4 and how to resolve them.

IMPORTANT NOTE

Any message rejected by B2Boost is not transmitted to Eurelec. It is the Supplier's responsibility to correct the message and to resend it again.

It is not advised to emit and transmit a credit note for a rejected message. Indeed, if we receive a credit note correctly formatted, it will be sent automatically to Eurelec. Eurelec will therefore receive a credit note for an invoice they never received in first place.

B2Boost AS2

Specifications: EURELEC - 181001_B2Boost_Eurelec_AS2Specification.docx

Certificate: EURELEC - B2BOOST_AS2_Certificate.zip

Logilec

Website: LECLERC - index - Google Docs This Google site is maintained by Logilec and contains useful documentation.

EDIFACT Specifications: Cahier des charges EDI - INVOIC.pdf In the rest of the document, when we refer to a page in the "Related EDIFACT Specifications", this is a page from this PDF.

The following two links are constantly maintained by Logilec: Liste des magasins.pdf - Google Drive Liste des entrepôts.pdf - Google Drive

UN/EDIFACT Syntax rule

Source: https://unece.org/fileadmin/DAM/trade/edifact/untdid/d422_s.htm

Component data element ("CE")

A simple data element which is a subordinate portion of a composite data element and in interchange identified by its position within the composite data element

Component data element separator

A character used to separate the component data elements in a composite data element In general: : (colon)

Composite data element

A data element containing two or more component data elements

Data Element ("DE")

A unit of data which in a certain context is considered indivisible (ISO 2382/4) UN/EDIFACT: A unit of data for which the identification, description and value representation have been specified

Data element separator

A character used to separate data elements in a segment In general: + (plus sign)

Data element value

The specific entry of an identified data element represented as specified in a data elements directory

Data value representation

a	alphabetic characters
n	numeric characters
an	alpha-numeric characters
a3	3 alphabetic characters, fixed length
n3	3 numeric characters, fixed length
an3	3 alpha-numeric characters, fixed length
a..3	up to 3 alphabetic characters
n..3	up to 3 numeric characters
an..3	up to 3 alpha-numeric characters

Qualifier

A data element whose value shall be expressed as a code that gives specific meaning to the function of another data element or a segment E.g. in the segment BGM+380: "380" is the segment qualifier

Release character

A character used to restore to its original meaning any character used as a syntactical separator In general: ? (question mark) Immediately preceding one of the characters ' (apostrophe), + (plus sign), : (colon), ? (interrogation mark), it restores their normal meaning. E.g. 10?+10=20 means 10+10=20. The character question mark itself is represented by ??

Segment

A predefined and identified set of functionally related data elements values which are identified by their sequential positions within the set. A segment starts with a segment tag and ends with a segment terminator.

Segment code

A code which uniquely identifies each segment as specified in a segment directory

Segment tag

A composite data element, in which the first component data element contains a code which uniquely identifies a segment as specified in the relevant segment directory. Additional component data elements can be conditionally used to indicate the hierarchical level and nesting relation in a message and the incidence of repetition of the segment

Segment terminator

A syntax character indicating the end of a segment In general: ' (apostrophe)

Representation


-----------------------------------------
|UNH |'|Data    |DATA    |Data    |UNT|'|  A SEGMENT contains:
|    | |segment |SEGMENT |segment |   | |  - A Segment TAG
-------------------|---------------------  - Simple data elements or
                   |                       - Composite data elements
+------------------+-------------------+     or both as applicable
|                                      |
----------------------------------------
|TAG |+|SIMPLE       |+|COMPOSITE    |'|   A SEGMENT TAG contains:
|    | |DATA ELEMENT | |DATA ELEMENT | |   - A segment code and,
---|--------------|----------|-----|----     if explicit indication,
   |              |          |     |         repeating and nesting
   |              |          |     |         value(s). See 8.1 and 9.
   |              |          |     |
   |              |          |     |       A SIMPLE DATA ELEMENT contains
--------------   -------   -------------   - A single data element
|Code|:|Value|   |Value|   |COMP|:|COMP|     value
--------------   -------   |D/E | |D/E |   A COMPOSITE DATA ELEMENT
                           |    | |    |     contains:
                           --|------|---   - Component data elements
                             |      |
                         ------- -------   A COMPONENT DATA ELEMENT
                         |     | |     |     contains:
                         |Value| |Value|   - A single data element
                         ------- -------     value

Sample EDIFACT


xxxxxxxxxx
1   :   UNA:+.? '
2   :   UNB+UNOA:3+SENDER_GLN:14+RECEIVER_GLN:14+211127:2025+INTERCHANGE_NUMBER'
3   :   UNH+MSG_REF_NUM+INVOIC:D:96A:UN:EAN008'
4   :   BGM+380+INVOICE_REF+9'
5   :   DTM+137:20211127:102'
6   :   DTM+11:20211127:102'
7   :   PAI+::70'
8   :   FTX+PMD+++1,70:71,70:141,70:211,70:281,70'
9   :   FTX+PMT+++1,70:71,70:141,70:211,70:281,70'
10  :   FTX+REG+++SELLER TRADING NAME:COMPANY_TYPE:SHARE_AMOUNT CURRENCY'
11  :   FTX+AAB+++1,70:71,70:141,70:211,70:281,70'
12  :   FTX+SIN+++1,70:71,70:141,70:211,70:281,70'
13  :   FTX+SUR+++1,70:71,70:141,70:211,70:281,70'
14  :   FTX+AAI+++1,70:71,70:141,70:211,70:281,70'
15  :   FTX+GEN+++1,70:71,70:141,70:211,70:281,70'
16  :   RFF+DQ:DELIVERY_NOTE_NUMBER'
17  :   DTM+171:20211127:102'
18  :   RFF+CT:CONTRACT_REF_1'
19  :   RFF+CT:CONTRACT_REF_2'
20  :   RFF+ON:PURCHASE_ORDER_REF'
21  :   DTM+171:20211125:102'
22  :   NAD+BY+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'
23  :   NAD+IV+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'
24  :   RFF+VA:FR17824374516'
25  :   RFF+GN:824374516'
26  :   NAD+RE+PAYEE_GLN::9'
27  :   NAD+DP+DELIVERY_GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME:+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE
        +COUNTRY_CODE'
28  :   NAD+SE+SELLER_GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME:+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE
        +COUNTRY_CODE'
29  :   RFF+VA:VAT_REGISTRATION_NUMBER'
30  :   RFF+XA:COMPANY_REGISTRATION_NUMBER'
31  :   RFF+GN:GOVERNMENT_REFERENCE_NUMBER'
32  :   CUX+2:EUR:4'
33  :   PAT+3'
34  :   DTM+13:20211230:102'
35  :   PAT+22'
36  :   PCD+12:0:13'
37  :   PAT+20'
38  :   LIN+10++EAN_CODE_10:EN'
39  :   PIA+1+00:PV'
40  :   IMD+E+ANM+:::ITEM_DESCRIPTION_10'
41  :   QTY+47:60:PCE'
42  :   QTY+52:4:PCE'
43  :   MOA+203:150.84'
44  :   PRI+AAA:2.514:::1:PCE'
45  :   PRI+AAB:4.477:::1:PCE'
46  :   TAX+7+VAT+++:::21'
47  :   ALC+A++2+1+TD:::ALLOWANCE_DESCRIPTION_10'
48  :   PCD+1:43.84'                                        
49  :   LIN+20++EAN_CODE_20:EN' 
50  :   PIA+1+00:PV'
51  :   IMD+E+ANM+:::ITEM_DESCRIPTION_20'
52  :   QTY+47:10:PCE'
53  :   QTY+52:10:PCE'
54  :   MOA+203:10.26'
55  :   PRI+AAA:1.026:::1:PCE'
56  :   PRI+AAB:1.827:::1:PCE'
57  :   TAX+7+VAT+++:::5.50'
58  :   ALC+A++2+1+TD:::ALLOWANCE_DESCRIPTION_20'
59  :   PCD+1:43.84'
60  :   LIN+30++EAN_CODE_30:EN'
61  :   PIA+1+00:PV'
62  :   IMD+E+ANM+:::ITEM_DESCRIPTION_30'
63  :   QTY+47:270:PCE'
64  :   QTY+52:10:PCE'
65  :   MOA+203:239.76'
66  :   PRI+AAA:0.888:::1:PCE'
67  :   PRI+AAB:1.581:::1:PCE'
68  :   TAX+7+VAT+++:::21'
69  :   ALC+A++2+1+TD:::ALLOWANCE_DESCRIPTION_30'
70  :   PCD+1:43.84'
71  :   LIN+40++EAN_CODE_40:EN'
72  :   PIA+1+00:PV'
73  :   IMD+E+ANM+:::ITEM_DESCRIPTION_40'
74  :   QTY+47:200:PCE'
75  :   QTY+52:8:PCE'
76  :   MOA+203:311'
77  :   PRI+AAA:1.555:::1:PCE'
78  :   PRI+AAB:2.769:::1:PCE'
79  :   TAX+7+VAT+++:::5.50'
80  :   ALC+A++2+1+TD:::ALLOWANCE_DESCRIPTION_40'
81  :   PCD+1:43.84'
82  :   LIN+50++EAN_CODE_50:EN'
83  :   PIA+1+00:PV'
84  :   IMD+E+ANM+:::ITEM_DESCRIPTION_50'
85  :   QTY+47:10:PCE'
86  :   QTY+52:10:PCE'
87  :   MOA+203:10.26'
88  :   PRI+AAA:1.026:::1:PCE'
89  :   PRI+AAB:1.827:::1:PCE'
90  :   TAX+7+VAT+++:::5.50'
91  :   ALC+A++2+1+TD:::ALLOWANCE_DESCRIPTION_50'
92  :   PCD+1:43.84'
93  :   UNS+S'
94  :   CNT+2:5'
95  :   MOA+124:100.26'
96  :   MOA+125:722.12'
97  :   MOA+128:822.38'
98  :   TAX+7+VAT++331.52+:::5.50'
99  :   MOA+124:18.23'
100 :   TAX+7+VAT++390.6+:::21'
101 :   MOA+124:82.03'
102 :   UNT+100+MSG_REF_NUM'
103 :   UNZ+1+INTERCHANGE_NUMBER'

Notes

BGM Segment in the header that we accept (only)

Code 380 = Invoice Code 381 = Credit note Code 383 = Correcting invoice

FTX Segments in the header: meaning and number of accepted occurence(s)

[0,1] FTX+PMD - Payment detail/remittance information [0,2] FTX+PMT - Payment information [1,1] FTX+REG - Regulatory information [0,1] FTX+AAB - Terms of payments [0,n] FTX+SIN - Special instructions [0,n] FTX+SUR - Supplier remarks [0,n] FTX+AAI - General information [0,1] FTX+GEN - Entire transaction set

Expected values for segment NAD


x
TEST :
~~~~~~
+---------+----------+---------------+---------------+---------------+
| Company |   Type   |   Value FR    |   Value PT    |   Value PL    |
+=========+==========+===============+===============+===============+
| Eurelec | TEST GLN | 5430001208023 | 5430001208078 | 5430001208085 |
|         | TEST VAT | FR17824374516 | PT980596637   | PL5263390202  |
|         | Siren    | 824374516     | 824374516     | 824374516     |
+---------+----------+---------------+---------------+---------------+

PROD :                                                
~~~~~~
+---------+----------+---------------+---------------+---------------+
| Company |   Type   |   Value FR    |   Value PT    |   Value PL    |
+=========+==========+===============+===============+===============+
| Eurelec | PROD GLN | 4260493952002 | 4260493953009 | 4260493955003 |
|         | PROD VAT | FR17824374516 | PT980596637   | PL5263390202  |
|         | Siren    | 824374516     | 824374516     | 824374516     |
+---------+----------+---------------+---------------+---------------+

Examples NAD

France


xxxxxxxxxx
TEST:
NAD+BY+5430001208023::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+5430001208023::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:FR17824374516'
RFF+GN:824374516'

PROD:
NAD+BY+4260493952002::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+4260493952002::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:FR17824374516'
RFF+GN:824374516'

Poland


xxxxxxxxxx
TEST:
NAD+BY+5430001208085::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+5430001208085::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:PL5263390202'
RFF+GN:824374516'

PROD:
NAD+BY+4260493955003::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+4260493955003::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:PL5263390202'
RFF+GN:824374516'

Portugal


xxxxxxxxxx
TEST:
NAD+BY+5430001208078::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+5430001208078::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:PT980596637'
RFF+GN:824374516'

PROD:
NAD+BY+4260493953009::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
NAD+IV+4260493953009::9++EURELEC Trading SCRL+Floor 6 - Rue Guimard 10+Bruxelles++1040+BE'
RFF+VA:PT980596637'
RFF+GN:824374516'

Header issues

[H01]

Currency is not accepted

The presence of the currency in the message is mandatory. We are looking at the segment CUX for a currency code in format ISO 4217 in first occurrence of data element 6345.

Definition

Currency (CUX):

C504	CURRENCY DETAILS
6347	Currency details qualifier	an1..3
6345	Currency, coded	an1..3
6343	Currency qualifier	an1..3
6348	Currency rate base	n1..4
C504	CURRENCY DETAILS
6347	Currency details qualifier	an1..3
6345	Currency, coded	an1..3
6343	Currency qualifier	an1..3
6348	Currency rate base	n1..4
5402	RATE OF EXCHANGE	n1..12
6341	CURRENCY MARKET EXCHANGE, CODED	an1..3

Example

CUX+2:EUR:4'
CUX+2:PLN:4'

[H02]

"Dispatch advice number" or "Delivery note number" NOT found in message

At least one of the two references must be found in the invoice. Even if this will not raise an error when absent, please try to include the date relative to the reference.

Segment	Meaning
RFF+AAK	Dispatch Advice Number
RFF+DQ	Delivery note number

Definition

Reference (RFF)

C506	REFERENCE
1153	Reference qualifier	an1..3
1154	Reference number	an1..35
1156	Line number	an1..6
4000	Reference version number	n1..35

Example

RFF+AAK:20BA829528'
RFF+DQ:987654321'

[H03]

"Shipping date", "Delivery date" or "Picking date" NOT found in message

At least one of the three dates must be found in the invoice.

DTM+11: Shipping date
DTM+35: Delivery date
DTM+200: Picking date

Definition

DATE/TIME/PERIOD (DTM):

C507	DATE/TIME/PERIOD
2005	Date or time or period function code qualifier	an1..3
2380	Date or time or period value	an1..35
4441	Date or time or period format code	an1..3

Example

DTM+11:20210828:102'
DTM+35:20210828:102'
DTM+200:20210828:102'

[H04]

VAT amount = 0.00 Mandatory segment FTX+SIN missing in EDIFACT

Invoice has a 'Total Amount Taxes' equal to 0 but there is no mention to explain why it's exempt of VAT, the segment FTX+SIN (Special instructions) is missing.

Definition

Free Text (FTX):

4451	TEXT SUBJECT CODE QUALIFIER	an1..3
4451	FREE TEXT FUNCTION CODE	an1..3
C107	TEXT REFERENCE
4441	Free text value code	an1..17
1131	Code list identification code	an1..3
3055	Code list responsible agency code	n1..3
C108	TEXT LITERAL
4440	Free text value	an1..512
4440	Free text value	an1..512
4440	Free text value	an1..512
4440	Free text value	an1..512
4440	Free text value	an1..512
3453	LANGUAGE NAME CODE	n1..3
4447	FREE TEXT FORMAT CODE	an1..3

Example

FTX+SIN+++1'

[H05]

Missing Seller party name

The field "Party name" is empty in segment NAD+SE.

[H06]

Missing Seller address part

One or more field are missing or empty for address part in segment NAD+SE.

Street
City
Zip
Country-code

[H07]

Missing Seller GLN identifier

The field "Party identifier"(GLN) is empty in segment NAD+SE.

Definition

Name and address (NAD):

3035	PARTY FUNCTION CODE QUALIFIER	an1..3
C082	PARTY IDENTIFICATION DETAILS
3039	Party identifier	an1..35
1131	Code list identification code	an1..17
3055	Code list responsible agency code	an1..3
C058	NAME AND ADDRESS
3124	Name and address description	an1..35
3124	Name and address description	an1..35
3124	Name and address description	an1..35
3124	Name and address description	an1..35
3124	Name and address description	an1..35
C080	PARTY NAME
3036	Party name	an1..35
3036	Party name	an1..35
3036	Party name	an1..35
3036	Party name	an1..35
3036	Party name	an1..35
3045	Party name format code	an1..3
C059	STREET
3042	Street and number or post office box identifier	an1..35
3042	Street and number or post office box identifier	an1..35
3042	Street and number or post office box identifier	an1..35
3042	Street and number or post office box identifier	an1..35
3164	CITY NAME	an1..35
C819	COUNTRY SUB-ENTITY DETAILS
3229	Country sub-entity name code	an1..9
1131	Code list identification code	an1..17
3055	Code list responsible agency code	an1..3
3228	Country sub-entity name	an1..70
3251	POSTAL IDENTIFICATION CODE	an1..17
3207	COUNTRY NAME CODE	an1..3

Example

NAD+SE+SELLER_GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME:+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE+COUNTRY_CODE'

[H08]

Missing Seller VAT registration number

Definition

Reference (RFF+VA):

Example

NAD+SE+SELLER_GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME:+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE+COUNTRY_CODE'
RFF+VA:VAT_REGISTRATION_NUMBER'

[H09]

Missing Seller amount of share capital

The amount of share capital is missing in the segment FTX+REG.

[H10]

Missing Seller legal structure

The legal structure is missing in the segment FTX+REG.

[H11]

Missing Seller trading name

The trading name is missing in the segment FTX+REG.

Definition

Free Text (FTX):

Missing or the duplicate of segment FTX+REG will lead to an error.

Example

FTX+**REG**+++Seller trading name+Seller legal structure+Seller amount of share capital'

[H12]

"Eurelec" not found in the invoicee party name

"Eurelec" was not found in the segment NAD_IV party name.

[H13]

Missing Invoicee address part

One or more field are missing or empty for address part in segment NAD+IV.

Street
City
Zip
Country-code

[H14]

Invoicee GLN is not identical to Buyer GLN

Invocee GLN is different to buyer GLN.

Definition

Name and address (NAD):

Example

NAD+IV+SELLER_GLN::9++Eurelec+STREET_&_NUMBER:STREET_&_NUMBER+CITY_NAME++ZIP_CODE+COUNTRY_CODE' NAD+BY+SELLER_GLN::9++Eurelec+STREET_&_NUMBER:STREET_&_NUMBER+CITY_NAME++ZIP_CODE+COUNTRY_CODE'

[H15]

Incorrect delivery store

The GLN of the delivery store was empty or not found in our data base, if you can find the delivery GLN in the following documents:

If you have this error but the GLN exist in the document above, please inform us at support@helpdesk.com .

Example

NAD+DP+GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE+COUNTRY_CODE'

[H16]

Incorrect delivery store received. The delivery associated to the purchase order

The delivery store GLN associated with the purchase order is different and it doesn't correspond the central GLN associated with the purchase order that you can find in the followings documents.

NAD+DP+GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE+COUNTRY_CODE'

[H17]

Currency used must be PLN

If the document type is a correcting invoice, the currency use must be PLN.

Definition

Currency (CUX):

Example

CUX+2:**PLN**:4'

[H18]

Bio certificate has not been found in any of the FTX (Free Text)

The Bio certificate has not been found in the FTX+SUR segment (Supplier remarks).

Definition

Free Text (FTX):

Example

FTX+SUR+++?*?*?* Produit issu de l'agriculture Biologique - distribution certifiee:par ####'

[H19]

Eurelec VAT incorrect.

The Eurelec VAT is incorrect in the segment RFF+VA of NAD+IV.

Definition

Reference (RFF+VA):

Example

NAD+IV+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'
RFF+VA:FR17824374516'

[H20]

Missing mandatory field value: Eurelec VAT

The Eurelec VAT is missing in the segment RFF+VA of NAD+IV.

Definition

Reference (RFF+VA):

Example

NAD+IV+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'
RFF+VA:FR17824374516'

[H21] to [H33]

The Following date is invalid

The format of the date received is not "yyyy-MM-dd" or the date received is just not valid.

[H21]

PenaltyDate

[H22]

RetailerOrderDate

[H23]

SupplierOrderDate

[H24]

DespatchDate

[H25]

InvoiceDate

[H26]

CreditedInvoiceDate

[H27]

TermNetDueDate

[H28]

PickingDate

[H29]

ShippingDate

[H30]

DeliveryDate

[H31]

DeliveryNoteDate

[H32]

ActualSaleDate

[H33]

ReturnsNoticeDate

[H34]

Missing Delivery address part

One or more field are missing or empty for address part in segment NAD+DP.

Street
City
Zip
Country-code

Definition

Name and address (NAD)

Example

NAD+DP+DELIVERY_GLN::9++PARTY_NAME:PARTY_NAME:PARTY_NAME:+STREET_&_NUMBER:STREET_&_NUMBER:+CITY_NAME++ZIP_CODE+COUNTRY_CODE'

[H35]

Missing Despatch Date and/or Reference

[H36]

The receiveid invoiceDate can't be bigger than Eurelec reception date

The reference of the order is missing

[H37]

Missing Buyer order reference

The reference of the order is missing

Example

RFF+ON:PURCHASE_ORDER_REF'

[H38]

Duplicate reference

An invoice/credit note with this reference has already been treated with success.

Example

BGM+380+INVOICE_REF+9'

[H39]

Wrong country code for Eurelec buyer/payer

The invoice/credit note Eurelec "payer" and/or "buyer" address country-code value should be "BE"

Example 1 (buyer)

NAD+BY+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'

Example 2 (payer)

NAD+IV+EURELEC_GLN::9++EURELEC TRADING SCRL+FLOOR 6 - RUE GUIMARD 10+BRUXELLES++1040+BE'

[H40]

Referenced order number does not have the correct number of digits

The Order Reference has a number of digits that does not fit with the account configuration.

Example

If supplier's config is meant to prevent order number length other than 10digits:

RFF+ON:0604500911'

NOTE: The order ref has 10 digits so it should be ok.

[H41]

Duplicate found for this supplier older GLN

An invoice/credit note with this reference has already been treated with success for this supplier with it's older gln (if configured).

Example

BGM+380+INVOICE_REF+9'

Line issues

[L01]

No line amount found for tax rate in the message

There is no line amount in the message for the tax rate

Definition

Monetary amount (MOA)

C516	MONETARY AMOUNT
5025	Monetary amount type code qualifier	an1..3
5004	Monetary amount	n..35
6345	Currency identification code	an1..3
6343	Currency type code qualifier	an1..3
4405	Status description code	an1..3

Example

MOA+55:150.84'

[L02]

No line amount found in any line

There is no amount found in any line in the edifact.

Definition

Monetary amount (MOA)

Example

MOA+203:150.84'

[L03]

Invalid ean found on line number

The EAN found in LIN segment is invalid.

Definition

Line Item (LIN)

1082	LINE ITEM IDENTIFIER	an1..6
1229	ACTION REQUEST/NOTIFICATION DESCRIPTION CODE	an1..3
C212	ITEM NUMBER IDENTIFICATION
7140	Item identifier	an1..35
7143	Item type identification code	an1..3
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
C829	SUB-LINE INFORMATION
5495	Sub-line indicator code	an1..3
1082	Line item identifier	an1..6
1222	CONFIGURATION LEVEL NUMBER	an1..2
7083	CONFIGURATION OPERATION CODE	an1..3

Example

LIN+10++EAN_CODE_10:EN'

[L04]

Mandatory gross price is missing on line number, having allowance(s)-charge(s)

Gross price (PRI+AAB) is mandatory if there are any allowance/charge on lines.

Definition

Price details (PRI):

C516	PRICE INFORMATION
5125	Price code qualifier	an1..3
5118	Price amount	an1..15
5375	Price type code	an1..3
5387	Price specification code	an1..3
5284	Unit price basis value	n1..9
6411	Measurement unit code	an1..3
5213	SUB-LINE ITEM PRICE CHANGE OPERATION CODE	an1..3

Example

PRI+AAB:4.477:::1:PCE

[L05]

Mandatory net price is missing on line number

Net price (PRI+AAA) is mandatory.

Definition

Price details (PRI)

Example

PRI+AAA:2.514:::1:PCE'

[L06]

At least one of the 3 Quantities is missing at line

If the document is a correcting invoice, the 3 QTY+2 must be in the message.

Definition

Quantity(QTY):

C516	QUANTITY DETAILS
6063	Quantity type code qualifier	an1..3
6060	Quantity	an1..35
6411	Measurement unit code	an1..3

Example

QTY+2X:828:PCE'
QTY+2Y:228:PCE'
QTY+2:-600:PCE'

[L07]

Quantity mismatch at lin

If the document is a correcting invoice, the equation below must be respected.

QTY+2Y - QTY+2X = QTY+2

Definition

Quantity (QTY)

Example

QTY+2X:828:PCE'
QTY+2Y:228:PCE'
QTY+2:-600:PCE'

[L08]

At least one of the 3 Total Line Gross Amount is missing at line

If the document is a correcting invoice, the 3 MOA+66 must be in the message.

Definition

Monetary amount (MOA)

Example

MOA+66X:8404.20:PLN'
MOA+66Y:2314.20:PLN'
MOA+66:-6090.00:PLN'

[L09]

Total Line Gross Amount mismatch at line

If the document is a correcting invoice, the equation below must be respected.

MOA+66Y - MOA+66X = MOA+66

Definition

Monetary amount (MOA)

Example

MOA+66X:8404.20:PLN'
MOA+66Y:2314.20:PLN'
MOA+66:-6090.00:PLN'

[L10]

At least one of the 3 Unit Selling Price is missing at line

If the document is a correcting invoice, the 3 PRI+AA must be in the message.

Definition

Price details (PRI)

Example

PRI+AAX:10.15'
PRI+AAY:10.15'
PRI+AAA:0.00'

[L11]

Unit Selling Price mismatch at line

If the document is a correcting invoice, the equation below must be respected.

PRI+AAY - PRI+AAX = PRI+AAA

Definition

Price details (PRI)

Example

PRI+AAX:10.15'
PRI+AAY:10.15'
PRI+AAA:0.00'

[L14]

Tax Amount 'Should Be' is missing at line

If the document is a correcting invoice, Tax Amount 'Should Be' (TAX+7+VAT+++Y) must be in the message.

Definition

Duty/Tax/Fee (TAX):

5283	PARTY FUNCTION CODE QUALIFIER	an1..3
C241	DUTY/TAX/FEE TYPE
5153	Duty or tax or fee type name code	an1..3
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
5152	Duty or tax or fee type name	an1..35
C058	DUTY/TAX/FEE ACCOUNT DETAIL
5289	Duty or tax or fee account code	an1..6
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
5286	DUTY OR TAX OR FEE ASSESSMENT BASIS VALUE	an1..15
C243	DUTY/TAX/FEE DETAIL
5279	Duty or tax or fee rate description code	an1..7
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
5278	Duty or tax or fee rate description	an1..17
5273	Duty or tax or fee rate basis code	an1..12
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
5305	DUTY OR TAX OR FEE CATEGORY CODE	an1..3
3466	PARTY TAX IDENTIFIER	an1..20
1227	CALCULATION SEQUENCE CODE	an1..3

Example

TAX+7+VAT+++Y:::23+S'

[L15]

Total Tax Amount mismatch at line

The equation below must be respected.

MOA+55Y - MOA+55X = MOA+55

Definition

Monetary amount (MOA)

Example

MOA+55X:1932.97'
MOA+55Y:532.27'
MOA+55:-1400.70'

[L16]

Missing tax rate at line

Tax rate (TAX+7) is mandatory in the message.

Definition

Duty/Tax/Fee (TAX)

Example

TAX+7+VAT+++Y:::23+S'

[L17]

No line found in the message

Line segment (LIN) is mandatory in the message.

Definition

Line Item (LIN):

Example

LIN+20++EAN_CODE_20:EN'

[L18]

Cannot deal with a mix of VAT rate change and a price/quantity change at line

Various VAT rates and different price and/or quantities of the same line are forbidden.

Definition

Line Item (LIN), Duty/Tax/Fee (TAX), Price details (PRI) and Quantity (QTY)

Example

LIN+10++EAN_CODE_10:EN'
PIA+1+00:PV'
IMD+E+ANM+:::ITEM_DESCRIPTION_10'
QTY+47:60:PCE'
QTY+52:4:PCE'
MOA+203:150.84'
PRI+AAB:4.477:::1:PCE'
TAX+7+VAT+++:::21'

[L19]

The net unit price decimal amount differ from contract on the following line(s)

The decimal amount of the net price unit (PRI+AAA) differs from the contract you have with Eurelec. If there is no contract, then the decimal amount of the net price unit can be up to 4.

Definition

Price details (PRI)

Example

PRI+AAA:2.514:::1:PCE'

[L20]

The recalculated unit price (tot/qty) is bigger than the transmitted unit price on line(s)

The recalculated unit price is bigger than the unit price (PRI+AAA).

=> PRI+AAA <= MOA+203 / QTY+47

Definition

Price details (PRI), Monetary amount (MOA) and Quantity (QTY)

Example

QTY+47:60:PCE'
QTY+52:4:PCE'
MOA+203:150.84'
PRI+AAA:2.514:::1:PCE'
PRI+AAB:4.477:::1:PCE'

2.514 = 150.84 / 60

[L21]

The lineAmount > calculatedLineAmount (with reCalculatedUnitPrice) on line(s)

In an invoice, the line amount (MOA+203) can't be bigger than the calculatedLineAmount.

r e C a l c u l a t e d U n i t P r i c e = P R I + A A A

r e C a l c u l a t e d U n i t P r i c e = M O A + 203 / Q T Y + 47

M O A + 203 = r e C a l c u l a t e d U n i t P r i c e * Q T Y + 47

M O A + 203 = c a l c u l a t e d L i n e A m o u n t

Definition

Price details (PRI), Monetary amount (MOA) and Quantity (QTY)

Example

QTY+47:60:PCE'
QTY+52:4:PCE'
MOA+203:150.84'
PRI+AAA:2.514:::1:PCE'
PRI+AAB:4.477:::1:PCE'

2.514 = 150.84 / 60

[L22]

The lineAmount < calculatedLineAmount (with reCalculatedUnitPrice) on line(s)

In a credit note, the line amount (MOA+203) can't be smaller than the calculatedLineAmount.

r e C a l c u l a t e d U n i t P r i c e = M O A + 203 / Q T Y + 47

c a l c u l a t e d L i n e A m o u n t = r e C a l c u l a t e d U n i t P r i c e * Q T Y + 47

M O A + 203 = c a l c u l a t e d L i n e A m o u n t

Definition

Price details (PRI), Monetary amount (MOA) and Quantity (QTY)

Example

QTY+47:60:PCE'
QTY+52:4:PCE'
MOA+203:150.84'
PRI+AAA:2.514:::1:PCE'
PRI+AAB:4.477:::1:PCE'

2.514 = 150.84 / 60

[L23]

The lineAmount is bigger/smaller than calculatedLineAmount on line

The line amount (MOA+203) can't be bigger than the calculatedLineAmount for an invoice and can't be smaller than the calculatedLineAmount for a credit note.

=> MOA+203 = calculatedLineAmount

=> calculatedLineAmount = reCalculatedUnitPrice * QTY+47

=> reCalculatedUnitPrice = MOA+203 / QTY+47

Definition

Price details (PRI), Monetary amount (MOA) and Quantity (QTY)

Example

QTY+47:60:PCE'
QTY+52:4:PCE'
MOA+203:150.84'
PRI+AAA:2.514:::1:PCE'
PRI+AAB:4.477:::1:PCE'

2. .514 = 150.84 / 60

[L24]

Quantity is equal to zero on line(s)

The invoiced quantities (QTY+47) can't be equal to 0.

Definition

Quantity (QTY)

Example

QTY+47:60:PCE'

[L25]

Total invoice line must be 0 when Unit Price equals 0 on line(s)

If the unit price (PRI+AAA) equals 0, then the total invoice line (MOA+203) must be 0.

Definition

Price details (PRI) and Monetary amount (MOA)

Example

MOA+203:0.00'
PRI+AAA:0.00:::1:PCE'
PRI+AAB:00.0:::1:PCE'

[L26]

There is a mix between negativ and positiv lines

A mix between total amount negative lines and total amount positive lines are forbidden.

Definition

Price details (PRI)

Example

MOA+203:150.84'

[L27]

NVALID.INVOICE.LINE.REF

The EAN code is mandatory in lines.

Definition

Line Item (LIN)

Example

LIN+10++EAN_CODE_10:EN'

[L28]

Total line gross amount not found for line(s)

Total line gross amount ( MOA+203) is mandatory for all lines.

Definition

Monetary amount (MOA)

Example

MOA+203:150.84'

[L30]

Bio product is not labelled as bio by the supplier for line(s)

The Bio product is not labelled as bio in the IMD segment. The default pattern is:

Definition

Item Description (IMD)

7077	DESCRIPTION FORMAT CODE	an1..3
C272	ITEM CHARACTERISTIC
7081	Item characteristic code	an1..3
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
C273	ITEM DESCRIPTION
7009	Item description code	an1..17
1131	Code list identification code	an1..3
3055	Code list responsible agency code	an1..3
7008	Item description	an1..256
7008	Item description	an1..256
3453	Language name code	an..3
7383	SURFACE OR LAYER CODE	an1..3

Example

LIN+10++8715700407760:EN'
PIA+1+76009084:SA'
PIA+1+00:PV'
IMD+E+ANM+:::ITEM_DESCRIPTION_10 BIO '

[L31]

The recalculated line amount differs from transmited line amount on line(s)

In an invoice, the line amount (MOA+203) can't differ from the calculatedLineAmount.

c a l c u l a t e d L i n e A m o u n t = ((P R I + A A A) * (Q T Y + 47)) => r o u n d e d T o 2 d i g i t s

The calculation for this check is the following :


xxxxxxxxxx
- if: (unitPrice * quantity).round(2) differs from totalLineGrossAmount
- then: we throw an error [L31] for the line.

NOTE: You have to comply with this check depending on your region. This is now the case for Portugal.

[L32]

Total line amount must contain stricly 2 decimals. This is not the case on line(s)

In an invoice, the line amount (MOA+203) has to contain striclty 2 decimals.

Summary issues

[S01]

Missing tax amount for one tax rate in summary (tax rate declared in at least one line but not found in the summary)

There is at least one missing tax amount for a tax rate found in lines.

Definition

Monetary amount (MOA)

Example

TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S02]

Tax rate is declared in the message summary but we found no line with this tax rate in the message

There is at least one tax rate mentioned in summary but not in lines.

Definition

Duty/Tax/Fee (TAX)

Example

TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S03]

Total Taxable Amount for the tax rate is not equal to the sum of all the line(s) amount for this tax rate. The difference exceeds the tolerance

The Total Taxable Amount for the tax rate is not equal to the sum of all the line(s) amount for this tax rate.

=> TAX+7+VAT++331.52+:::5.50' = Σ MOA+203 (for TAX+7+VAT+++:::5.50')

Definition

Monetary amount (MOA)

Example

TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S04]

Total Taxable Amount in the message summary is not equal to the sum of all the line(s) amount . The difference exceeds the tolerance

The Total Taxable Amount for the tax rate is not equal to the sum of all the line(s) amount for this tax rate.

=> MOA+124 = Σ MOA+203 ( lines )

Definition

Monetary amount (MOA)

Example

CNT+2:5'
MOA+124:100.26'

[S05]

Difference between the Total Taxable Amount in the message summary and the sum of all the summary Taxable Amount (per rate) exceeds the tolerance

The Total Taxable Amount for the tax rate is not equal to the sum of all the summary taxable amount.

=> MOA+125 = TAX+7+VAT++Σ (Taxable Amount) +::: ( per rate )

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

MOA+125:722.12'
MOA+128:822.38'
TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S06]

Difference between the 'Total Amount Taxes' in the message summary and the sum of all the lines Taxable Amount exceeds the tolerance

The Total Taxable Amount for the tax rate is not equal to the sum of all the summary taxable amount.

=> MOA+124 = Σ ((TAX+7+VAT+++::: tax rate * MOA+203) / 100)

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

MOA+203:150.84'
PRI+AAA:2.514:::1:PCE'
PRI+AAB:4.477:::1:PCE'
TAX+7+VAT+++:::21'
...
Summary
...
MOA+124:100.26'

[S07]

Total Taxable Amount + Total Amount Taxes - Total Amount Due when it should be 0, so it exceeds the tolerance

The total amount due must be equal to the sum of the total taxable amount and total amount taxes.

=> MOA+125 + MOA+124 = MOA+128

Definition

Monetary amount (MOA)

Example

MOA+124:100.26'
MOA+125:722.12'
MOA+128:822.38'

[S08]

"DocumentType" with a Total Amount Due of 0 is not allowed.

A total amount due ( MOA+128 ) can't be equal 0.

Definition

Monetary amount (MOA)

Example

MOA+128:822.38'

[S09]

Difference between the declared VAT amount and what we automatically calculated for the tax rate exceeds the tolerance

The difference between total taxable amount (for the tax rate) * tax rate must be equal to the total amount taxes for the tax rate.

M O A + 124 = Σ (T A X + 7 + V A T + + T o t a l T a x a b l e A m o u n t (f o r t h i s t a x r a t e) + ::: t a x r a t e)

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

MOA+124:100.26'
MOA+125:722.12'
MOA+128:822.38'
TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S10]

VAT rate used not allowed

The tax rate use for VAT is not allowed or is missing (mandatory field).

Definition

Duty/Tax/Fee (TAX)

Example

TAX+7+VAT++331.52+:::5.50'
MOA+124:18.23'
TAX+7+VAT++390.6+:::21'
MOA+124:82.03'

[S11]

At least one of the 3 Total Taxable Amount is missing

If the document is a correcting invoice, the 2 MOA+56 (or MOA+79X/Y) (Total Taxable Amount Was and Should Be) and MOA+125 (MOA+79) (Total Taxable Amount) must be in the message.

Definition

Monetary amount (MOA)

Example

MOA+56X:33748.20'
MOA+56Y:2314.20'
MOA+125:-31434.00'

MOA+79X:33748.20'
MOA+79Y:2314.20'
MOA+79:-31434.00'

[S12]

At least one of the 3 Total Amount Taxes is missing

If the document is a correcting invoice, the 2 MOA+55 (Total Amount Taxes Was and Should Be) and MOA+124 (Total Amount Taxes) must be in the message.

Definition

Monetary amount (MOA)

Example

MOA+55X:7762.09'
MOA+55Y:532.27'
MOA+124:-7229.82'

[S13]

At least one of the 3 Total Amount Due is missing

If the document is a correcting invoice, the 3 MOA+77 (Total Amount Due) must be in the message.

Definition

Monetary amount (MOA)

Example

MOA+77X:41510.29'
MOA+77Y:2846.47'
MOA+77:-38663.82'

[S15]

Total Taxable Amount mismatch (Y - X <> Z )

The equation below must be respected.

MOA+56Y - MOA+56X = MOA+125
MOA+79Y - MOA+79X = MOA+79

Definition

Monetary amount (MOA)

Example

MOA+56X:33748.20'
MOA+56Y:2314.20'
MOA+125:-31434.00'

MOA+79X:33748.20'
MOA+79Y:2314.20'
MOA+79:-31434.00'

[S16]

Total Amount Taxes mismatch (Y - X <> Z )

The equation below must be respected.

MOA+77Y - MOA+77X = MOA+77

Definition

Monetary amount (MOA)

Example

MOA+77X:41510.29'
MOA+77Y:2846.47'
MOA+77:-38663.82'

[S17]

Total Amount Due mismatch (Y - X <> Z )

The equation below must be respected.

MOA+55Y - MOA+55X = MOA+124

Definition

Monetary amount (MOA)

Example

MOA+55X:7762.09'
MOA+55Y:532.27'
MOA+124:-7229.82'

[S19]

Total Taxable Amount mismatch (Y - X <> Z ) for tax rate

The equation below must be respected.

MOA+55Y - MOA+55X = MOA+124

Definition

Monetary amount (MOA)

Example

MOA+55X:7762.09'
MOA+55Y:532.27'
MOA+124:-7229.82'

[S20]

Total Tax Amount mismatch (Y - X <> Z ) for tax rate

The equation below must be respected.

MOA+55Y - MOA+55X = MOA+124

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

TAX+7+VAT+++X:::23+S'
MOA+79X:33748.20'
MOA+55X:7762.09'
TAX+7+VAT+++Y:::23+S'
MOA+79Y:2314.20'
MOA+55Y:532.27'
TAX+7+VAT+++:::23+S'
MOA+79:-31434.00'
MOA+124:-7229.82'

[S21]

At least one of the 3 Tax Total Taxable Amount is missing for tax rate

If the document is a correcting invoice, the 3 MOA+79 (Total Taxable Amount ) must be in the message.

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

TAX+7+VAT+++X:::23+S'
MOA+79X:33748.20'
MOA+55X:7762.09'
TAX+7+VAT+++Y:::23+S'
MOA+79Y:2314.20'
MOA+55Y:532.27'
TAX+7+VAT+++:::23+S'
MOA+79:-31434.00'
MOA+124:-7229.82'

[S22]

At least one of the 3 Tax Total Tax Amount is missing for tax rate

If the document is a correcting invoice, the 2 MOA+55 (Total Amount Taxes Was and Should Be) and MOA+124 (Total Amount Taxes) must be in the message.

Definition

Monetary amount (MOA) and Duty/Tax/Fee (TAX)

Example

TAX+7+VAT+++X:::23+S'
MOA+79X:33748.20'
MOA+55X:7762.09'
TAX+7+VAT+++Y:::23+S'
MOA+79Y:2314.20'
MOA+55Y:532.27'
TAX+7+VAT+++:::23+S'
MOA+79:-31434.00'
MOA+124:-7229.82'