GS1 fields (GLN, GTIN)
How to carry the GS1 EDI data that retail and FMCG partners rely on (GLN, GTIN, delivery and receiving advice references, batch and expiry) in a Peppol BIS Billing 3.0 invoice sent through Unimaze.
Slovenská verzia: Polia GS1 (GLN, GTIN)
From 1 January 2027, invoices between Slovak companies must be Peppol BIS Billing 3.0 invoices. That replaces EDIFACT INVOIC, which many companies in fast-moving consumer goods (FMCG), retail and pharma exchange today through GS1 EDI. Those invoices carry data that the buyer's processes depend on, such as store GLNs, GTINs, receiving advice numbers and batch numbers.
GS1 Slovakia and GS1 Czech Republic have published a recommendation for where that data goes in a BIS 3.0 invoice. The Slovak Financial Administration has made Peppol providers aware of it. This page shows how to send and read those fields with Unimaze.
What the recommendation is, and isn't
- It is voluntary. It does not change what the law or the Slovak specification requires, and the invoice must still meet the Slovak requirements.
- It uses only fields that already exist in BIS 3.0 and passes Peppol validation. There is no new customization or profile ID, so you send the invoice as usual.
- Agree with your trading partner which fields you'll fill in. A buyer can only use what it expects.
- The source is GS1's spreadsheet PEPPOL-BIS3.0_SK_FMCG.xlsx, published on gs1sk.org/e-faktura. This page follows version 1.11. If GS1 publishes a newer version, the spreadsheet takes precedence.
Sending and receiving
You send these invoices the same way as any other invoice in Slovakia (see Sending an invoice):
- Transaction Services (JSON):
POST /api/v1/transactions/submit-invoice. Use the properties in the tables below, and Unimaze writes the BIS 3.0 elements for you. - Messaging Services (UBL XML):
POST /api/v1/messages/create-business-transaction. Write the elements in the XPath column yourself. - EDI (EDIFACT INVOIC):
POST /api/v1/messages/create-edi-message. Your ERP keeps sending EDIFACT, and Unimaze maps it to a Peppol BIS Billing 3.0 invoice. Contact Unimaze to set up the mapping for your invoices.
Transaction Services covers every field on this page except the supplier's order number (BT-14). If you need to send it, contact Unimaze support. Meanwhile, you can send it on each line in the supplier_order_number item property.
Receiving these invoices
If your trading partners send you these fields, read the received invoice as UBL XML with
GET /api/v1/messages/{messageId}/documents/core. The XML contains every field the sender filled in, including allcac:AdditionalItemPropertyelements.
Document references
| GS1 field | Business term | BIS 3.0 XPath (under Invoice/) | Transaction Services property |
|---|---|---|---|
| Customer's order number | BT-13 | cac:OrderReference/cbc:ID | orderReference.documentNo |
| Supplier's order number | BT-14 | cac:OrderReference/cbc:SalesOrderID | None yet. Contact Unimaze support |
| Delivery note number | BT-16 | cac:DespatchDocumentReference/cbc:ID | documentReferences.despatch.documentNo |
| Receiving advice number (RECADV) | BT-15 | cac:ReceiptDocumentReference/cbc:ID | documentReferences.receipt.documentNo |
| Contract number | BT-12 | cac:ContractDocumentReference/cbc:ID | documentReferences.contract.documentNo |
| Preceding invoice number and date | BT-25, BT-26 | cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID and cbc:IssueDate | billingReferences.invoices[0].documentNo and .issueDate |
| Invoicing period of a consolidated invoice | BT-73, BT-74 | cac:InvoicePeriod/cbc:StartDate and cbc:EndDate | billingPeriod.startDate and .endDate |
| Variable symbol | BT-83 | cac:PaymentMeans/cbc:PaymentID | paymentIdentifier of the payment means, for example paymentMeans[].sepaCreditTransfer.paymentIdentifier |
- If the invoice covers one order, put its number in
BT-13. If it covers several orders, GS1 recommends the textConsolidated InvoiceinBT-13, and the order number of each line in thebuyer_order_numberitem property. - BIS 3.0 has one delivery note and one receiving advice per invoice, and no dates for them. For more than one, or for the dates, use the item properties
delivery_note_number,delivery_note_date,receiving_advice_numberandreceiving_advice_dateon each line. - GS1 recommends at most 10 characters for the variable symbol.
Parties and locations
Retail partners identify head offices, stores and warehouses by Global Location Number (GLN). In BIS 3.0 a GLN uses the scheme 0088. These are additional identifiers: the Peppol address is still the DIČ (0245), as described in Specific use for Slovakia. For the identifier schemes in general, see Business participant identifiers.
| GS1 field | Business term | BIS 3.0 XPath (under Invoice/) | Transaction Services property |
|---|---|---|---|
| Supplier GLN | BT-29 | cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088'] | supplier.locationIdentifier, for example 0088:8589000100023 |
| Buyer GLN | BT-46 | cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088'] | customer.locationIdentifier |
| Delivery place GLN | BT-71 | cac:Delivery/cac:DeliveryLocation/cbc:ID[@schemeID='0088'] | delivery.locationIdentifier |
| Delivery place name | BT-70 | cac:Delivery/cac:DeliveryParty/cac:PartyName/cbc:Name | delivery.partyName |
| Delivery place address | BT-75 to BT-80 | cac:Delivery/cac:DeliveryLocation/cac:Address | delivery.address |
| Supplier and buyer IČO | BT-30, BT-47 | cac:PartyLegalEntity/cbc:CompanyID[@schemeID='0158'] | supplier.legalIdentifier, customer.legalIdentifier |
Write locationIdentifier in the {scheme}:{identifier} format, as for the participant identifier. Unimaze then sets the schemeID attribute.
BIS 3.0 has no place for the ordering party, the final delivery place (store) or the ultimate customer. GS1 puts them on each line as the item properties ordered_by_gln, store_number_gln, ultimate_customer_gln and ultimate_customer_name.
Line items
| GS1 field | Business term | BIS 3.0 XPath (under cac:InvoiceLine/) | Transaction Services property (in invoiceLines[]) |
|---|---|---|---|
| GTIN (EAN barcode) | BT-157 | cac:Item/cac:StandardItemIdentification/cbc:ID[@schemeID='0160'] | standardItemNo |
| Supplier's article number | BT-155 | cac:Item/cac:SellersItemIdentification/cbc:ID | itemNo |
| Buyer's article number | BT-156 | cac:Item/cac:BuyersItemIdentification/cbc:ID | buyersItemNo |
| Country of origin | BT-159 | cac:Item/cac:OriginCountry/cbc:IdentificationCode | originCountryCode |
| Order line number | BT-132 | cac:OrderLineReference/cbc:LineID | orderLineReference |
| Invoiced quantity and unit | BT-129, BT-130 | cbc:InvoicedQuantity and @unitCode | quantity and unitOfMeasure.code |
| Net unit price | BT-146 | cac:Price/cbc:PriceAmount | unitPriceAmount |
| Additional item properties | BG-32 | cac:Item/cac:AdditionalItemProperty | additionalItemProperties[] with name and value |
Unimaze writes standardItemNo with the scheme 0160 (GTIN). Peppol validates the GTIN check digit, so send the full 8, 12, 13 or 14 digits.
Line discounts and price discounts
GS1 separates two kinds of discount on a line. Use one or the other, not both.
| Kind | BIS 3.0 XPath (under cac:InvoiceLine/) | Effect | Transaction Services discounts[].discountType |
|---|---|---|---|
| Price discount | cac:Price/cac:AllowanceCharge | Explains how the net unit price was reached from the list price (BaseAmount). It is already included in the price. | LinePriceDiscount, with baseAmount and amount |
| Line discount | cac:AllowanceCharge | Reduces the line amount. | LineDiscount, with amount or percentage |
Additional item properties
For everything EDIFACT INVOIC has on a line and BIS 3.0 does not, GS1 uses item properties (cac:Item/cac:AdditionalItemProperty) with fixed names. Rules:
- Write the name exactly as listed: lower case, with underscores.
- Every property needs both a name and a value.
- Write dates as
YYYY-MM-DDand numbers with a decimal point. - The properties are information for the buyer. Peppol does not validate or calculate with them. For example,
vat_amountdoes not replace the VAT breakdown.
| Name | Type | Meaning |
|---|---|---|
| Item | ||
item_type | text | Item type: Z goods, O packaging, S service |
units_per_carton | number | Number of consumer units in the invoiced unit |
delivery_date | date | Delivery date of the line |
batch_number | text | Batch (lot) number |
expiry_date | date | Expiry (best before) date |
serial_number | text | Serial number |
article_number_manufacturer | text | Manufacturer's article number |
consumer_unit_price | number | Retail selling price per unit |
vat_amount | number | VAT amount of the line (informative) |
free_text_law | text | Text required by law |
| References | ||
buyer_order_number | text | Customer's order number |
buyer_order_date | date | Order date |
supplier_order_number | text | Supplier's order number |
supplier_order_date | date | Date the supplier received the order |
delivery_note_number | text | Delivery note number |
delivery_note_date | date | Delivery note date |
receiving_advice_number | text | Receiving advice (RECADV) number |
receiving_advice_date | date | Receiving advice (RECADV) date |
invoice_reference_type | text | What the invoice reference is: AAB proforma invoice, IV invoice |
invoice_reference_number | text | Referenced invoice number, for example an advance invoice |
invoice_reference_date | date | Date of the referenced invoice |
free_reference | text | Reference agreed between the partners |
free_reference_date | date | Date of that reference |
| Parties | ||
ordered_by_gln | text | GLN of the ordering party |
delivery_party_gln | text | GLN of the delivery place |
store_number_gln | text | GLN of the final delivery place (store) |
ultimate_customer_gln | text | GLN of the ultimate customer |
ultimate_customer_name | text | Name of the ultimate customer |
| Fees and excise duty | ||
excise_duty_category_code | text | Excise duty category code |
excise_duty_basis | number | Excise duty basis (quantity) |
excise_duty_amount | number | Excise duty amount |
recycling_fee_type | text | Recycling fee type |
recycling_fee_amount | number | Recycling fee for the line |
recycling_fee_per_unit | number | Recycling fee per unit |
recycling_fee_unit | text | Unit of measure of the recycling fee |
copyright_fee_type | text | Copyright fee type |
copyright_fee_amount | number | Copyright fee for the line |
copyright_fee_per_unit | number | Copyright fee per unit |
copyright_fee_unit | text | Unit of measure of the copyright fee |
| Pharmaceuticals | ||
sukl_id | text | Product code of the State Institute for Drug Control (ŠÚKL) |
adc_code | text | ADC code (medicinal product identification code) |
purchase_price | number | Purchase price per unit (informative, for distributors) |
Example
An invoice line for 10 pieces of a product with a GTIN, a batch and expiry date, delivered to a store, with a delivery note and a receiving advice. The example shows only the fields on this page; the rest of the invoice is as usual.
{
"orderReference": { "documentNo": "ON-2026-1187" },
"documentReferences": {
"despatch": { "documentNo": "DL-55120" },
"receipt": { "documentNo": "RA-900341" }
},
"supplier": { "locationIdentifier": "0088:8589000100023" },
"customer": { "locationIdentifier": "0088:8589000100016" },
"delivery": {
"partyName": "Store 112 Žilina",
"locationIdentifier": "0088:8589000200037",
"actualDeliveryDate": "2027-01-14"
},
"invoiceLines": [
{
"itemNo": "A-1001",
"buyersItemNo": "200345",
"standardItemNo": "8586000123458",
"name": "Mineral water 1.5 l",
"quantity": 10,
"unitOfMeasure": { "code": "H87" },
"unitPriceAmount": 2.40,
"taxableAmount": 24.00,
"taxAmount": 5.52,
"taxCategoryType": "StandardRated",
"taxPercentage": 23,
"originCountryCode": "SK",
"orderLineReference": "1",
"additionalItemProperties": [
{ "name": "item_type", "value": "Z" },
{ "name": "batch_number", "value": "L2701-07" },
{ "name": "expiry_date", "value": "2027-07-31" },
{ "name": "store_number_gln", "value": "8589000200037" }
]
}
]
}<!-- Header -->
<cac:OrderReference>
<cbc:ID>ON-2026-1187</cbc:ID>
</cac:OrderReference>
<cac:DespatchDocumentReference>
<cbc:ID>DL-55120</cbc:ID>
</cac:DespatchDocumentReference>
<cac:ReceiptDocumentReference>
<cbc:ID>RA-900341</cbc:ID>
</cac:ReceiptDocumentReference>
<!-- In cac:AccountingSupplierParty/cac:Party, after cbc:EndpointID -->
<cac:PartyIdentification>
<cbc:ID schemeID="0088">8589000100023</cbc:ID>
</cac:PartyIdentification>
<!-- In cac:AccountingCustomerParty/cac:Party, after cbc:EndpointID -->
<cac:PartyIdentification>
<cbc:ID schemeID="0088">8589000100016</cbc:ID>
</cac:PartyIdentification>
<cac:Delivery>
<cbc:ActualDeliveryDate>2027-01-14</cbc:ActualDeliveryDate>
<cac:DeliveryLocation>
<cbc:ID schemeID="0088">8589000200037</cbc:ID>
</cac:DeliveryLocation>
<cac:DeliveryParty>
<cac:PartyName>
<cbc:Name>Store 112 Žilina</cbc:Name>
</cac:PartyName>
</cac:DeliveryParty>
</cac:Delivery>
<!-- Line -->
<cac:InvoiceLine>
<cbc:ID>1</cbc:ID>
<cbc:InvoicedQuantity unitCode="H87">10</cbc:InvoicedQuantity>
<cbc:LineExtensionAmount currencyID="EUR">24.00</cbc:LineExtensionAmount>
<cac:OrderLineReference>
<cbc:LineID>1</cbc:LineID>
</cac:OrderLineReference>
<cac:Item>
<cbc:Name>Mineral water 1.5 l</cbc:Name>
<cac:BuyersItemIdentification>
<cbc:ID>200345</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
<cbc:ID>A-1001</cbc:ID>
</cac:SellersItemIdentification>
<cac:StandardItemIdentification>
<cbc:ID schemeID="0160">8586000123458</cbc:ID>
</cac:StandardItemIdentification>
<cac:OriginCountry>
<cbc:IdentificationCode>SK</cbc:IdentificationCode>
</cac:OriginCountry>
<cac:ClassifiedTaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>23</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:ClassifiedTaxCategory>
<cac:AdditionalItemProperty>
<cbc:Name>item_type</cbc:Name>
<cbc:Value>Z</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name>batch_number</cbc:Name>
<cbc:Value>L2701-07</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name>expiry_date</cbc:Name>
<cbc:Value>2027-07-31</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name>store_number_gln</cbc:Name>
<cbc:Value>8589000200037</cbc:Value>
</cac:AdditionalItemProperty>
</cac:Item>
<cac:Price>
<cbc:PriceAmount currencyID="EUR">2.40</cbc:PriceAmount>
</cac:Price>
</cac:InvoiceLine>Codes when converting from EDIFACT
Some EDIFACT codes differ from the code lists that BIS 3.0 allows.
Payment means (BT-81, code list UNCL4461):
| EDIFACT INVOIC | BIS 3.0 |
|---|---|
42 Payment to bank account | 30 Credit transfer, or 58 SEPA credit transfer |
10 Cash | 10 Cash |
21 Banker's draft | 21 Banker's draft |
23 Bank cheque | 23 Bank cheque |
Units of measure (BT-130, code list UN/ECE Rec 20). See also Unit of measure.
| EDIFACT INVOIC | BIS 3.0 |
|---|---|
PCE piece | H87 |
CT carton | XCT, or EA or C62 if you invoice the carton as one unit |
KGM kilogram | KGM |
LTR litre | LTR |
For VAT categories and rates, follow Specific use for Slovakia. Each VAT rate on the invoice gets its own entry in the VAT breakdown, so an invoice with goods at 5 %, 19 % and 23 % has three S entries with different percentages.
Updated 16 days ago
