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 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 prvkov cac:AdditionalItemProperty.

Odkazy na doklady

Pole GS1Obchodný pojemXPath v BIS 3.0 (pod Invoice/)Pole v Transaction Services
Číslo objednávky zákazníkaBT-13cac:OrderReference/cbc:IDorderReference.documentNo
Číslo objednávky u dodávateľaBT-14cac:OrderReference/cbc:SalesOrderIDZatiaľ žiadne. Kontaktujte podporu Unimaze
Číslo dodacieho listuBT-16cac:DespatchDocumentReference/cbc:IDdocumentReferences.despatch.documentNo
Číslo príjemky (RECADV)BT-15cac:ReceiptDocumentReference/cbc:IDdocumentReferences.receipt.documentNo
Číslo zmluvyBT-12cac:ContractDocumentReference/cbc:IDdocumentReferences.contract.documentNo
Číslo a dátum predchádzajúcej faktúryBT-25, BT-26cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID a cbc:IssueDatebillingReferences.invoices[0].documentNo a .issueDate
Obdobie sumárnej faktúryBT-73, BT-74cac:InvoicePeriod/cbc:StartDate a cbc:EndDatebillingPeriod.startDate a .endDate
Variabilný symbolBT-83cac:PaymentMeans/cbc:PaymentIDpaymentIdentifier 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 v BT-13 text Consolidated Invoice a číslo objednávky každej položky vo vlastnosti buyer_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_number a receiving_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 GS1Obchodný pojemXPath v BIS 3.0 (pod Invoice/)Pole v Transaction Services
GLN dodávateľaBT-29cac:AccountingSupplierParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088']supplier.locationIdentifier, napríklad 0088:8589000100023
GLN odberateľaBT-46cac:AccountingCustomerParty/cac:Party/cac:PartyIdentification/cbc:ID[@schemeID='0088']customer.locationIdentifier
GLN miesta dodaniaBT-71cac:Delivery/cac:DeliveryLocation/cbc:ID[@schemeID='0088']delivery.locationIdentifier
Názov miesta dodaniaBT-70cac:Delivery/cac:DeliveryParty/cac:PartyName/cbc:Namedelivery.partyName
Adresa miesta dodaniaBT-75 až BT-80cac:Delivery/cac:DeliveryLocation/cac:Addressdelivery.address
IČO dodávateľa a odberateľaBT-30, BT-47cac: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 GS1Obchodný pojemXPath v BIS 3.0 (pod cac:InvoiceLine/)Pole v Transaction Services (v invoiceLines[])
GTIN (čiarový kód EAN)BT-157cac:Item/cac:StandardItemIdentification/cbc:ID[@schemeID='0160']standardItemNo
Číslo tovaru dodávateľaBT-155cac:Item/cac:SellersItemIdentification/cbc:IDitemNo
Číslo tovaru odberateľaBT-156cac:Item/cac:BuyersItemIdentification/cbc:IDbuyersItemNo
Krajina pôvoduBT-159cac:Item/cac:OriginCountry/cbc:IdentificationCodeoriginCountryCode
Číslo riadku objednávkyBT-132cac:OrderLineReference/cbc:LineIDorderLineReference
Fakturované množstvo a merná jednotkaBT-129, BT-130cbc:InvoicedQuantity a @unitCodequantity a unitOfMeasure.code
Jednotková cena po zľave (netto)BT-146cac:Price/cbc:PriceAmountunitPriceAmount
Ďalšie vlastnosti položkyBG-32cac:Item/cac:AdditionalItemPropertyadditionalItemProperties[] 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.

DruhXPath v BIS 3.0 (pod cac:InvoiceLine/)Významdiscounts[].discountType v Transaction Services
Zľava z cenycac:Price/cac:AllowanceChargeVysvetľ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žkecac:AllowanceChargeZniž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-DD a čísla s desatinnou bodkou.
  • Vlastnosti sú informácie pre odberateľa. Peppol ich nekontroluje a nepočíta s nimi. Napríklad vat_amount nenahrádza rozpis DPH.
NázovTypVýznam
Položka
item_typetextTyp položky: Z tovar, O obaly, S služba
units_per_cartončísloPočet spotrebiteľských jednotiek vo fakturačnej jednotke
delivery_datedátumDátum dodania položky
batch_numbertextČíslo šarže
expiry_datedátumPoužiteľnosť do (dátum exspirácie)
serial_numbertextSériové číslo
article_number_manufacturertextVýrobné číslo
consumer_unit_pricečísloPredajná cena za jednotku
vat_amountčísloSuma DPH na položke (informatívna)
free_text_lawtextText vyžadovaný legislatívou
Odkazy
buyer_order_numbertextČíslo objednávky zákazníka
buyer_order_datedátumDátum vystavenia objednávky
supplier_order_numbertextČíslo objednávky u dodávateľa
supplier_order_datedátumDátum prijatia objednávky u dodávateľa
delivery_note_numbertextČíslo dodacieho listu
delivery_note_datedátumDátum vystavenia dodacieho listu
receiving_advice_numbertextČíslo príjemky (RECADV)
receiving_advice_datedátumDátum vystavenia príjemky (RECADV)
invoice_reference_typetextVýznam referenčného čísla faktúry: AAB zálohová (proforma) faktúra, IV faktúra
invoice_reference_numbertextReferenčné číslo faktúry, napríklad zálohovej
invoice_reference_datedátumDátum referenčnej faktúry
free_referencetextVoľné referenčné číslo (dohodnuté medzi partnermi)
free_reference_datedátumDátum voľného referenčného čísla
Strany
ordered_by_glntextGLN objednávateľa
delivery_party_glntextGLN miesta dodania
store_number_glntextGLN konečného miesta dodania (predajne)
ultimate_customer_glntextGLN koncového spotrebiteľa
ultimate_customer_nametextMeno alebo názov koncového spotrebiteľa
Poplatky a spotrebná daň
excise_duty_category_codetextKód skupiny spotrebnej dane
excise_duty_basisčísloZáklad spotrebnej dane (množstvo)
excise_duty_amountčísloSuma spotrebnej dane
recycling_fee_typetextTyp recyklačného poplatku
recycling_fee_amountčísloRecyklačný poplatok za položku celkom
recycling_fee_per_unitčísloRecyklačný poplatok za jednotku
recycling_fee_unittextMerná jednotka recyklačného poplatku
copyright_fee_typetextTyp autorského poplatku
copyright_fee_amountčísloAutorský poplatok za položku celkom
copyright_fee_per_unitčísloAutorský poplatok za jednotku
copyright_fee_unittextMerná jednotka autorského poplatku
Lieky
sukl_idtextKód tovaru ŠÚKL (Štátny ústav pre kontrolu liečiv)
adc_codetextKód ADC (identifikačný kód lieku)
purchase_pricečísloNá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" }
      ]
    }
  ]
}

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 INVOICBIS 3.0
42 Úhrada na bankový účet30 Credit transfer alebo 58 SEPA credit transfer
10 V hotovosti10 Cash
21 Banková zmenka21 Banker's draft
23 Bankový šek23 Bank cheque

Merné jednotky (BT-130, číselník UN/ECE Rec 20). Pozri aj Unit of measure.

EDIFACT INVOICBIS 3.0
PCE kusH87
CT kartónXCT, alebo EA či C62, ak kartón fakturujete ako jednu jednotku
KGM kilogramKGM
LTR literLTR

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.


Did this page help you?