XML komunikácia a Peppol

XML komunikácia - nastavenie stavu pre odoslanie do siete Peppol na doklade

Od verzie rel. 14400 podporuje program POHODA pri XML komunikácii prenos údajov o stave pre odoslanie do siete Peppol na doklade. XML komunikácia v programe POHODA bola rozšírená o blok peppol, v ktorom je možné definovať stav dokladu v systéme Peppol pomocou elementu statePeppol.

Vzorový príklad XML

inv:peppol
   typ:statePeppoldelivered/typ:statePeppol
/inv:peppol

Stav dokladu v systéme Peppol - element <statePeppol>

Pre XML import dát do programu POHODA môže doklad nadobúdať nasledujúce stavy Peppol:

  • Odoslané do Peppol mimo programu POHODA (Externe), hodnota "externally"

Ak nebude vo vstupnom XML doklade uvedený blok peppol s elementom pre stav dokladu statePeppol, tak bude na vytvorenom doklade v programe POHODA nastavený stav Peppol:

  • Nevstupuje - ak doklad nemá vyplnenú hodnotu v poli Peppol ID
  • Na odoslanie - ak doklad má vyplnenú hodnotu v poli Peppol ID

Peppol ID na doklade je možné vyplniť:

  • V bloku typ:address na importovanom doklade použitím elementu typ:peppolID.

    Vzorový príklad XML

    typ:address
      typ:companyNový s.r.o./typ:company
      typ:cityBratislava/typ:city
      typ:streetTajovského 14/typ:street
      typ:zip811 04/typ:zip
      typ:ico36255789/typ:ico
      typ:dic2021746617/typ:dic
      typ:icDphSK2020765512/typ:icDph
      typ:peppolID0245:2021746617/typ:peppolID
    /typ:address
  • Vytvorením väzby na adresár cez atribút linkToAddress. Ak záznam v agende Adresár obsahuje vyplnenú hodnotu Peppol ID, táto hodnota sa prenesie aj do importovaného dokladu.

    Vzorový príklad XML

    typ:address linkToAddress="true"
      typ:ico36255789/typ:ico
    /typ:address

Poznámka: Pri importe údajov do agendy adresár je pre vyplnenie hodnoty Peppol ID rovnako možné použiť blok typ:address s elementom typ:peppolID.

Pri XML exporte dát z programu POHODA môže doklad nadobúdať nasledujúce stavy Peppol:

  • Nevstupuje do Peppol, hodnota "notEnter"
  • Na odoslanie do Peppol, hodnota "forSending"
  • Prebieha spracovanie dokladu v sieti Peppol (Spracováva sa), hodnota "processing"
  • Úspešne doručené príjemcovi, hodnota "delivered"
  • Doklad bol pri odosielaní do siete Peppol odmietnutý (Odmietnuté), hodnota "rejected"
  • Odoslané do Peppol mimo programu POHODA (Externe), hodnota "externally"

Odoslanie dokladov do siete Peppol

Od verzie rel. 14405 podporuje program POHODA pri XML komunikácii odoslanie vybraných dokladov do siete Peppol.

XML komunikácia v programe POHODA bola rozšírená o schému sendPeppol.xsd, pomocou ktorej je možné vykonať výber dokladov a ich následné odoslanie do siete Peppol.

Popis
Schéma
XSD schéma pre výber a odoslanie dokladov do siete Peppol

Pre výber dokladov na odoslanie je možné použiť:

  • ID
  • Číslo dokladu
  • Dátum od / do
  • Názov firmy
  • IČO
  • SQL filter
  • Užívateľský filter

XML komunikácia - vzorové príklady požiadaviek


Príklad č.1)

  • Odoslanie dokladu so zadaným databázovým ID do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:filter
    ftr:id111/ftr:id
   /ftr:filter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.2)

  • Odoslanie dokladu so zadaným číslom do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:filter
    ftr:numbers
     typ:numberRequested260100001/typ:numberRequested
    /ftr:numbers
   /ftr:filter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.3)

  • Odoslanie dokladov v dátumovom rozsahu do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:filter
    ftr:dateFrom2026-11-06/ftr:dateFrom
    ftr:dateTill2026-11-06/ftr:dateTill
   /ftr:filter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.4)

  • Odoslanie dokladov určených vybraným odberateľom podľa názvu firmy do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:filter
    ftr:companyABC, s.r.o./ftr:company
    ftr:companyAgroZet a.s./ftr:company
   /ftr:filter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.5)

  • Odoslanie dokladov určených vybraným odberateľom podľa IČO do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:filter
    ftr:selectedIco
     ftr:ico36255789/ftr:ico
    /ftr:selectedIco
   /ftr:filter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.6)

  • Odoslanie dokladov so stavom „Na odoslanie“ do siete Peppol pomocou SQL filtra

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:queryFilter
    ftr:filter(FA.RelDlvState=2)/ftr:filter
   /ftr:queryFilter
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

Príklad č.7)

  • Odoslanie dokladov vybraných na základe užívateľského filtra do siete Peppol.

Vzorový príklad XML

sPep:sendPeppol version="2.0"
  sPep:record agenda="issuedInvoice"
   ftr:userFilterNameOznačené/ftr:userFilterName
  /sPep:record
/sPep:sendPeppol

STIAHNUŤ

XML komunikácia - vzorové príklady odpovedí


Príklad č.8)

  • Odpoveď pri úspešnom odoslaní dokladu do siete Peppol.

Vzorový príklad XML

sPep:sendPeppolResponse version="2.0" state="ok"
  rdc:producedDetails
   rdc:id111/rdc:id
   rdc:actionTypesendPeppol/rdc:actionType
  /rdc:producedDetails
  sPep:sendDocuments
   sPep:sendDocument
    sPep:id111/sPep:id
    sPep:number260100061/sPep:number
    sPep:stateok/sPep:state
    sPep:detailDoklad č. 260100061 bol úspešne odoslaný do siete Peppol./sPep:detail
   /sPep:sendDocument
  /sPep:sendDocuments
/sPep:sendPeppolResponse

STIAHNUŤ

Príklad č.9)

  • Odpoveď pri pokuse o odoslanie dokladu bez vyplnenej hodnoty Peppol ID.

Vzorový príklad XML

sPep:sendPeppolResponse version="2.0" state="ok"
  rdc:producedDetails
   rdc:id37/rdc:id
   rdc:actionTypesendPeppol/rdc:actionType
  /rdc:producedDetails
  sPep:sendDocuments
   sPep:sendDocument
    sPep:id37/sPep:id
    sPep:number260100017/sPep:number
    sPep:statewarning/sPep:state
    sPep:detailDoklad č. 260100017 nevstupuje do siete Peppol./sPep:detail
   /sPep:sendDocument
  /sPep:sendDocuments
/sPep:sendPeppolResponse

STIAHNUŤ

Príklad č.10)

  • Odpoveď pri pokuse o odoslanie nevalidného dokladu do siete Peppol.

Vzorový príklad XML

sPep:sendPeppolResponse version="2.0" state="error"
  rdc:importDetails
   rdc:detail
    rdc:stateerror/rdc:state
    rdc:errno140/rdc:errno
    rdc:notePri odoslaní dokladov do siete Peppol nastala chyba./rdc:note
   /rdc:detail
  /rdc:importDetails
  rdc:producedDetails
   rdc:id38/rdc:id
   rdc:actionTypesendPeppol/rdc:actionType
  /rdc:producedDetails
  sPep:sendDocuments
   sPep:sendDocument
    sPep:id38/sPep:id
    sPep:number260100018/sPep:number
    sPep:stateerror/sPep:state
    sPep:detailDoklad č. 260100018 nebol exportovaný do BIS.
Export sa nepodaril.
Štruktúra dokladu zodpovedá špecifikácii UBL 2.1.
Doklad nespĺňa všetky pravidlá pre BIS:
[BR-CL-23] Kód mernej jednotky musí byť zo zoznamu UN/ECE Rec 20 a 21./sPep:detail
   /sPep:sendDocument
  /sPep:sendDocuments
/sPep:sendPeppolResponse

STIAHNUŤ