Code lists — which values are permitted at all

Where the lists come from

The lists are not part of the norm; the norm references them. UNTDID 1001 for the invoice type, UNTDID 4461 for payment means, UNTDID 5305 for the tax category, ISO 4217 for currencies, ISO 3166-1 for countries, UN/ECE Recommendation 20 for units of measure.

Which also means a code list can change without the norm changing. Hard-code the values in a mapping and you find out about a new edition when an invoice is rejected.

The cause underneath

Nearly every BR-CL failure arises the same way: the source system keeps the value as a house abbreviation — “pcs” for pieces, “INV” for invoice, “transfer” for the payment route — and the mapping passes it through unchanged. Translating it into the code is a table somebody has to build.

Build those tables once, centrally, rather than scattered per field. The three that fail most often are unit of measure (BT-130), invoice type (BT-3) and payment means (BT-81).

All code-list rules

With the official rule text, which names the list prescribed in each case.

• BR-CL-01

  The document type code MUST be coded by the invoice and credit note related code lists of UNTDID 1001.

• BR-CL-03

  currencyID MUST be coded using ISO code list 4217 alpha-3

• BR-CL-04

  Invoice currency code MUST be coded using ISO code list 4217 alpha-3

• BR-CL-05

  Tax currency code MUST be coded using ISO code list 4217 alpha-3

• BR-CL-06

  Value added tax point date code MUST be coded using a restriction of UNTDID 2475.

• BR-CL-07

  Object identifier identification scheme identifier MUST be coded using a restriction of UNTDID 1153.

• BR-CL-08

  Subject Code MUST be coded using a restriction of UNTDID 4451.

• BR-CL-10

  Any identifier identification scheme identifier MUST be coded using one of the ISO 6523 ICD list.

• BR-CL-11

  Any registration identifier identification scheme identifier MUST be coded using one of the ISO 6523 ICD list.

• BR-CL-13

  Item classification identifier identification scheme identifier MUST be coded using one of the UNTDID 7143 list.

• BR-CL-14

  Country codes in an invoice MUST be coded using ISO code list 3166-1

• BR-CL-15

  Country codes in an invoice MUST be coded using ISO code list 3166-1

• BR-CL-16

  Payment means in an invoice MUST be coded using UNTDID 4461 code list

• BR-CL-17

  Invoice tax categories MUST be coded using UNCL 5305 code list

• BR-CL-18

  Invoice tax categories MUST be coded using UNCL 5305 code list

• BR-CL-19

  Coded allowance reasons MUST belong to the UNCL 5189 code list

• BR-CL-20

  Coded charge reasons MUST belong to the UNCL 7161 code list

• BR-CL-21

  Item standard identifier scheme identifier MUST belong to the ISO 6523 ICD code list

• BR-CL-22

  Tax exemption reason code identifier scheme identifier MUST belong to the CEF VATEX code list

• BR-CL-23

  Unit code MUST be coded according to the UN/ECE Recommendation 20 with Rec 21 extension

• BR-CL-24

  For Mime code in attribute use MIMEMediaType.

• BR-CL-25

  Endpoint identifier scheme identifier MUST belong to the CEF EAS code list

• BR-CL-26

  Delivery location identifier scheme identifier MUST belong to the ISO 6523 ICD code list