Polia GS1 (GLN, GTIN)
Ako preniesť údaje GS1 EDI, na ktorých závisia partneri v maloobchode a FMCG (GLN, GTIN, odkazy na dodací list a príjemku, šarža a dátum spotreby), do faktúry Peppol BIS Billing 3.0 odoslanej cez Unimaze.
English version: GS1 fields (GLN, GTIN)
Od 1. januára 2027 musia byť faktúry medzi slovenskými firmami vo formáte Peppol BIS Billing 3.0. Nahrádzajú tak EDIFACT INVOIC, ktorý si dnes mnohé firmy z oblasti rýchloobrátkového tovaru (FMCG), maloobchodu a farmácie vymieňajú cez GS1 EDI. Tieto faktúry obsahujú údaje, od ktorých závisia procesy odberateľa, napríklad GLN predajní, GTIN, čísla príjemiek a čísla šarží.
GS1 Slovakia a GS1 Czech Republic zverejnili odporúčanie, kam tieto údaje vo faktúre BIS 3.0 patria. Finančná správa SR na neho upozornila poskytovateľov Peppol. Táto stránka ukazuje, ako tieto polia odoslať a prečítať cez Unimaze.
Čo odporúčanie je a čo nie je
- Je dobrovoľné. Nemení požiadavky zákona ani slovenskej špecifikácie a faktúra musí naďalej spĺňať slovenské požiadavky.
- Používa len polia, ktoré v BIS 3.0 už existujú, a prejde validáciou Peppol. Nemá nový identifikátor customization ani profilu, takže faktúru posielate ako zvyčajne.
- Dohodnite sa s obchodným partnerom, ktoré polia budete vypĺňať. Odberateľ využije len to, čo očakáva.
- Zdrojom je tabuľka GS1 PEPPOL-BIS3.0_SK_FMCG.xlsx, zverejnená na gs1sk.org/e-faktura. Táto stránka vychádza z verzie 1.11. Ak GS1 zverejní novšiu verziu, platí tabuľka.
Odosielanie a prijímanie
Tieto faktúry odosielate rovnako ako ostatné faktúry na Slovensku (pozri Sending an invoice):
- Transaction Services (JSON):
POST /api/v1/transactions/submit-invoice. Použite polia z tabuliek nižšie a Unimaze za Vás vytvorí prvky BIS 3.0. - Messaging Services (UBL XML):
POST /api/v1/messages/create-business-transaction. Prvky zo stĺpca XPath vypĺňate sami. - EDI (EDIFACT INVOIC):
POST /api/v1/messages/create-edi-message. Váš ERP naďalej posiela EDIFACT a Unimaze ho namapuje na faktúru Peppol BIS Billing 3.0. Mapovanie pre Vaše faktúry nastavíte po dohode s Unimaze.
Transaction Services pokrýva všetky polia na tejto stránke okrem čísla objednávky u dodávateľa (BT-14). Ak ho potrebujete posielať, kontaktujte podporu Unimaze. Dovtedy ho môžete poslať na každej položke vo vlastnosti supplier_order_number (pozri Ďalšie vlastnosti položky nižšie).
Prijímanie týchto faktúr
Ak Vám obchodní partneri tieto polia posielajú, čítajte prijatú faktúru ako UBL XML cez
GET /api/v1/messages/{messageId}/documents/core. XML obsahuje všetky polia, ktoré odosielateľ vyplnil, vrátane všetkých prvkovcac:AdditionalItemProperty.
Odkazy na doklady
| Pole GS1 | Obchodný pojem | XPath v BIS 3.0 (pod Invoice/) | Pole v Transaction Services |
|---|---|---|---|
| Číslo objednávky zákazníka | BT-13 | cac:OrderReference/cbc:ID | orderReference.documentNo |
| Číslo objednávky u dodávateľa | BT-14 | cac:OrderReference/cbc:SalesOrderID | Zatiaľ žiadne. Kontaktujte podporu Unimaze |
| Číslo dodacieho listu | BT-16 | cac:DespatchDocumentReference/cbc:ID | documentReferences.despatch.documentNo |
| Číslo príjemky (RECADV) | BT-15 | cac:ReceiptDocumentReference/cbc:ID | documentReferences.receipt.documentNo |
| Číslo zmluvy | BT-12 | cac:ContractDocumentReference/cbc:ID | documentReferences.contract.documentNo |
| Číslo a dátum predchádzajúcej faktúry | BT-25, BT-26 | cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID a cbc:IssueDate | billingReferences.invoices[0].documentNo a .issueDate |
| Obdobie sumárnej faktúry | BT-73, BT-74 | cac:InvoicePeriod/cbc:StartDate a cbc:EndDate | billingPeriod.startDate a .endDate |
| Variabilný symbol | BT-83 | cac:PaymentMeans/cbc:PaymentID | paymentIdentifier platobného prostriedku, napríklad paymentMeans[].sepaCreditTransfer.paymentIdentifier |
- Ak faktúra pokrýva jednu objednávku, uveďte jej číslo v
BT-13. Ak pokrýva viac objednávok, GS1 odporúča vBT-13textConsolidated Invoicea číslo objednávky každej položky vo vlastnostibuyer_order_number. - BIS 3.0 má na faktúre jeden dodací list a jednu príjemku, a to bez dátumu. Pre viac dokladov alebo pre dátumy použite na každej položke vlastnosti
delivery_note_number,delivery_note_date,receiving_advice_numberareceiving_advice_date. - GS1 odporúča variabilný symbol s najviac 10 znakmi.
Strany a miesta
Partneri v maloobchode identifikujú centrály, predajne a sklady globálnym lokalizačným číslom (GLN). V BIS 3.0 má GLN schému 0088. Ide o doplnkové identifikátory: adresou v Peppol zostáva DIČ (0245), ako opisuje Specific use for Slovakia. Schémy identifikátorov všeobecne opisuje Business participant identifiers.
| Pole GS1 | Obchodný pojem | XPath v BIS 3.0 (pod Invoice/) | Pole v Transaction Services |
|---|---|---|---|
| GLN dodávateľa | BT-29 | cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088'] | supplier.locationIdentifier, napríklad 0088:8589000100023 |
| GLN odberateľa | BT-46 | cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088'] | customer.locationIdentifier |
| GLN miesta dodania | BT-71 | cac:Delivery/cac:DeliveryLocation/cbc:ID[@schemeID='0088'] | delivery.locationIdentifier |
| Názov miesta dodania | BT-70 | cac:Delivery/cac:DeliveryParty/cac:PartyName/cbc:Name | delivery.partyName |
| Adresa miesta dodania | BT-75 až BT-80 | cac:Delivery/cac:DeliveryLocation/cac:Address | delivery.address |
| IČO dodávateľa a odberateľa | BT-30, BT-47 | cac:PartyLegalEntity/cbc:CompanyID[@schemeID='0158'] | supplier.legalIdentifier, customer.legalIdentifier |
locationIdentifier píšte vo formáte {schéma}:{identifikátor}, rovnako ako identifikátor účastníka. Unimaze potom nastaví atribút schemeID.
BIS 3.0 nemá miesto pre objednávateľa, konečné miesto dodania (predajňu) ani koncového spotrebiteľa. GS1 ich uvádza na každej položke ako vlastnosti ordered_by_gln, store_number_gln, ultimate_customer_gln a ultimate_customer_name.
Položky
| Pole GS1 | Obchodný pojem | XPath v BIS 3.0 (pod cac:InvoiceLine/) | Pole v Transaction Services (v invoiceLines[]) |
|---|---|---|---|
| GTIN (čiarový kód EAN) | BT-157 | cac:Item/cac:StandardItemIdentification/cbc:ID[@schemeID='0160'] | standardItemNo |
| Číslo tovaru dodávateľa | BT-155 | cac:Item/cac:SellersItemIdentification/cbc:ID | itemNo |
| Číslo tovaru odberateľa | BT-156 | cac:Item/cac:BuyersItemIdentification/cbc:ID | buyersItemNo |
| Krajina pôvodu | BT-159 | cac:Item/cac:OriginCountry/cbc:IdentificationCode | originCountryCode |
| Číslo riadku objednávky | BT-132 | cac:OrderLineReference/cbc:LineID | orderLineReference |
| Fakturované množstvo a merná jednotka | BT-129, BT-130 | cbc:InvoicedQuantity a @unitCode | quantity a unitOfMeasure.code |
| Jednotková cena po zľave (netto) | BT-146 | cac:Price/cbc:PriceAmount | unitPriceAmount |
| Ďalšie vlastnosti položky | BG-32 | cac:Item/cac:AdditionalItemProperty | additionalItemProperties[] s name a value |
Unimaze zapíše standardItemNo so schémou 0160 (GTIN). Peppol kontroluje kontrolnú číslicu GTIN, preto posielajte celé číslo s 8, 12, 13 alebo 14 číslicami.
Zľava na položke a zľava z ceny
GS1 rozlišuje dva druhy zľavy na položke. Použite jeden alebo druhý, nie oba.
| Druh | XPath v BIS 3.0 (pod cac:InvoiceLine/) | Význam | discounts[].discountType v Transaction Services |
|---|---|---|---|
| Zľava z ceny | cac:Price/cac:AllowanceCharge | Vysvetľuje, ako sa z katalógovej ceny (BaseAmount) dospelo k jednotkovej cene po zľave. Je už započítaná v cene. | LinePriceDiscount, s baseAmount a amount |
| Zľava na položke | cac:AllowanceCharge | Znižuje sumu riadku. | LineDiscount, s amount alebo percentage |
Ďalšie vlastnosti položky
Pre všetko, čo má EDIFACT INVOIC na položke a BIS 3.0 nie, používa GS1 vlastnosti položky (cac:Item/cac:AdditionalItemProperty) s pevnými názvami. Pravidlá:
- Názov píšte presne podľa zoznamu: malými písmenami, s podčiarkovníkmi.
- Každá vlastnosť musí mať názov aj hodnotu.
- Dátumy píšte ako
YYYY-MM-DDa čísla s desatinnou bodkou. - Vlastnosti sú informácie pre odberateľa. Peppol ich nekontroluje a nepočíta s nimi. Napríklad
vat_amountnenahrádza rozpis DPH.
| Názov | Typ | Význam |
|---|---|---|
| Položka | ||
item_type | text | Typ položky: Z tovar, O obaly, S služba |
units_per_carton | číslo | Počet spotrebiteľských jednotiek vo fakturačnej jednotke |
delivery_date | dátum | Dátum dodania položky |
batch_number | text | Číslo šarže |
expiry_date | dátum | Použiteľnosť do (dátum exspirácie) |
serial_number | text | Sériové číslo |
article_number_manufacturer | text | Výrobné číslo |
consumer_unit_price | číslo | Predajná cena za jednotku |
vat_amount | číslo | Suma DPH na položke (informatívna) |
free_text_law | text | Text vyžadovaný legislatívou |
| Odkazy | ||
buyer_order_number | text | Číslo objednávky zákazníka |
buyer_order_date | dátum | Dátum vystavenia objednávky |
supplier_order_number | text | Číslo objednávky u dodávateľa |
supplier_order_date | dátum | Dátum prijatia objednávky u dodávateľa |
delivery_note_number | text | Číslo dodacieho listu |
delivery_note_date | dátum | Dátum vystavenia dodacieho listu |
receiving_advice_number | text | Číslo príjemky (RECADV) |
receiving_advice_date | dátum | Dátum vystavenia príjemky (RECADV) |
invoice_reference_type | text | Význam referenčného čísla faktúry: AAB zálohová (proforma) faktúra, IV faktúra |
invoice_reference_number | text | Referenčné číslo faktúry, napríklad zálohovej |
invoice_reference_date | dátum | Dátum referenčnej faktúry |
free_reference | text | Voľné referenčné číslo (dohodnuté medzi partnermi) |
free_reference_date | dátum | Dátum voľného referenčného čísla |
| Strany | ||
ordered_by_gln | text | GLN objednávateľa |
delivery_party_gln | text | GLN miesta dodania |
store_number_gln | text | GLN konečného miesta dodania (predajne) |
ultimate_customer_gln | text | GLN koncového spotrebiteľa |
ultimate_customer_name | text | Meno alebo názov koncového spotrebiteľa |
| Poplatky a spotrebná daň | ||
excise_duty_category_code | text | Kód skupiny spotrebnej dane |
excise_duty_basis | číslo | Základ spotrebnej dane (množstvo) |
excise_duty_amount | číslo | Suma spotrebnej dane |
recycling_fee_type | text | Typ recyklačného poplatku |
recycling_fee_amount | číslo | Recyklačný poplatok za položku celkom |
recycling_fee_per_unit | číslo | Recyklačný poplatok za jednotku |
recycling_fee_unit | text | Merná jednotka recyklačného poplatku |
copyright_fee_type | text | Typ autorského poplatku |
copyright_fee_amount | číslo | Autorský poplatok za položku celkom |
copyright_fee_per_unit | číslo | Autorský poplatok za jednotku |
copyright_fee_unit | text | Merná jednotka autorského poplatku |
| Lieky | ||
sukl_id | text | Kód tovaru ŠÚKL (Štátny ústav pre kontrolu liečiv) |
adc_code | text | Kód ADC (identifikačný kód lieku) |
purchase_price | číslo | Nákupná cena za jednotku (informatívna, napríklad pre distribútorov) |
Príklad
Položka faktúry na 10 kusov tovaru s GTIN, šaržou a dátumom spotreby, dodaná do predajne, s dodacím listom a príjemkou. Príklad ukazuje len polia z tejto stránky; zvyšok faktúry je ako zvyčajne.
{
"orderReference": { "documentNo": "ON-2026-1187" },
"documentReferences": {
"despatch": { "documentNo": "DL-55120" },
"receipt": { "documentNo": "RA-900341" }
},
"supplier": { "locationIdentifier": "0088:8589000100023" },
"customer": { "locationIdentifier": "0088:8589000100016" },
"delivery": {
"partyName": "Predajňa 112 Žilina",
"locationIdentifier": "0088:8589000200037",
"actualDeliveryDate": "2027-01-14"
},
"invoiceLines": [
{
"itemNo": "A-1001",
"buyersItemNo": "200345",
"standardItemNo": "8586000123458",
"name": "Minerálna voda 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" }
]
}
]
}<!-- Hlavička -->
<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>
<!-- V cac:AccountingSupplierParty/cac:Party, za cbc:EndpointID -->
<cac:PartyIdentification>
<cbc:ID schemeID="0088">8589000100023</cbc:ID>
</cac:PartyIdentification>
<!-- V cac:AccountingCustomerParty/cac:Party, za 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>Predajňa 112 Žilina</cbc:Name>
</cac:PartyName>
</cac:DeliveryParty>
</cac:Delivery>
<!-- Položka -->
<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>Minerálna voda 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>Kódy pri prevode z EDIFACT
Niektoré kódy EDIFACT sa líšia od číselníkov, ktoré BIS 3.0 povoľuje.
Spôsob úhrady (BT-81, číselník UNCL4461):
| EDIFACT INVOIC | BIS 3.0 |
|---|---|
42 Úhrada na bankový účet | 30 Credit transfer alebo 58 SEPA credit transfer |
10 V hotovosti | 10 Cash |
21 Banková zmenka | 21 Banker's draft |
23 Bankový šek | 23 Bank cheque |
Merné jednotky (BT-130, číselník UN/ECE Rec 20). Pozri aj Unit of measure.
| EDIFACT INVOIC | BIS 3.0 |
|---|---|
PCE kus | H87 |
CT kartón | XCT, alebo EA či C62, ak kartón fakturujete ako jednu jednotku |
KGM kilogram | KGM |
LTR liter | LTR |
Pre kategórie a sadzby DPH postupujte podľa Specific use for Slovakia. Každá sadzba DPH na faktúre má vlastný záznam v rozpise DPH, takže faktúra s tovarom s DPH 5 %, 19 % a 23 % má tri záznamy S s rôznymi percentami.
Updated 16 days ago
