Preskoči na glavni sadržaj

Tehnička specifikacija - za državu sa sinkronom obradom

U ovom tekstu opisuje se način povezivanja sustava Primatelja (obveznik javne nabave) sa sustavom Fine u svrhu komunikacije iz smjera Primatelja prema Fini. Isti je namijenjen svim zainteresiranim stranama koje će sudjelovati u implementaciji rješenja na strani Primatelja.

U ovom se tekstu opisuju sve poruke koje sustavi razmjenjuju, načini razmjene te razine sigurnosti, odnosno zaštite prijenosa.

Podaci će se razmjenjivati korištenjem XML poruka putem web servisa. Ovakvim načinom razmjene podataka nema ovisnosti o tehnologiji koja se koristi na strani Pošiljatelja, ni o tehnologiji na strani Fine kao informacijskog posrednika, a ni na strani proračunskog korisnika kao krajnjeg Primatelja.

Prije puštanja na produkcijski sustav nužna je verifikacija uspješne razmjene podataka na testnim okruženjima Fine i Primatelja.

 

Definicije i skraćenice

SSLSecure Sockets Layer – protokol koji omogućava zaštitu komunikacijskog kanala
PošiljateljPošiljatelj računa prema korisniku državnog proračuna
PrimateljObveznik javne nabave
ERPEnterprise Resource Planning – Poslovni sustav na strani Pošiljatelja
SOAPSimple Object Access Protocol – protokol koji se koristi za razmjenu podataka između dva sustava web servisima

 

Komunikacijski uvjeti

Razmjena podataka u sustavu e-Račun za državu između Primatelja i Fine vrši se putem internetske mreže. Zaštita prijenosnog kanala se radi korištenjem dvosmjernog kriptiranja kanala (2-way ssl) što znači da se pri uspostavljanju sigurne veze klijent predstavlja aplikacijskim certifikatom, a web server poslužiteljskim (SSL) certifikatom.

Da bi se Primatelj mogao uspješno povezati na web servis Fine, potrebno je zadovoljiti sljedeće preduvjete:

  • primatelj treba zatražiti od Fine certifikat za potrebe potpisivanja SOAP poruka i autentifikacije na sustav. U svrhu testiranja Primatelj treba koristiti demo certifikat, a za potrebe povezivanje na produkcijski sustav, treba koristiti produkcijski certifikat,
  • primatelj treba prilagoditi svoje ERP sustav za slanje SOAP poruka prema uputi iz ove tehničke specifikacije.

 

Zaštita integriteta

Zaštita integriteta ostvaruje se digitalnim potpisivanjem SOAP poruke Fininim certifikatom. Standard koji se koristi za izvedbu potpisa SOAP poruke je WS-Security (https://www.oasis-open.org/standards#wssv1.0).

Za potrebe testiranja, Primatelj dobavlja Finin DEMO certifikat, a za produkciju produkcijski certifikat. U testnoj okolini nije dozvoljeno slanje SOAP poruka potpisanih produkcijskim certifikatom, ni obrnuto.

 

Koncept razmjene podataka

Sustav Primatelja ovisno o operaciji koju želi izvršiti prema web servisu Fine šalje poruku po standardiziranoj XML shemi. U odgovoru web servisa Finin sustav sinkrono šalje rezultat obrade ili grešku ukoliko bilo što nije u redu.

Odgovorne poruke sadrže "MessageAck" element gdje se nalaze osnovni podaci o odgovoru web servisa. Ukoliko je SOAP poruka u skladu s definicijom web servisa (WSDL), tada se u elementu AckStatus pojavljuje odgovor ACCEPTED. Ukoliko SOAP poruka nije u skladu s definicijom, tada se u odgovoru pojavljuje MSG_NOT_VALID. Vrijednost SYSTEM_ERROR pokazuje da je došlo do većih problema u sustavu Fine (npr. runtime exception). U slučaju "SYSTEM_ERROR" tada je defaultna vrijednost AckStatusCode "99".

Primatelj ima na raspolaganju sljedeće metode:

  • EchoBuyer
    • EchoBuyerMsg
EchoBuyer.jpg
  • getB2GIncomingInvoiceList
    • GetB2GIncomingInvoiceListMsg
getB2GIncomingInvoiceList.jpg
  • getB2GIncomingInvoice
    • GetB2GIncomingInvoiceMsg
getB2GIncomingInvoice.jpg
  • GetB2GOutgoingInvoiceList
    • GetB2GOutgoingInvoiceListMsg
GetB2GOutgoingInvoiceList.jpg
  • GetB2GOutgoingInvoice
    • GetB2GOutgoingInvoiceMsg
GetB2GOutgoingInvoice.jpg
  • ChangeB2GIncomingInvoiceStatus
    • poruka ChangeB2GIncomingInvoiceStatusMsg
ChangeB2GIncomingInvoiceStatus.jpg
  • GetReceiverList
    • poruka GetReceiverListMsg
GetReciverList.jpg

 

Metoda za provjeru rada web servisa (Echo metoda)

Kako bi se provjerila dostupnost web servisa, na raspolaganju je Echo metoda.

Elementi EchoBuyerMsg poruke

  • HeaderBuyer
    • MessageID - Jedinstveni broj poruke
    • BuyerID - Identifikator kupca (OIB) – (9934:12345678909)
    • AdditionalBuyerID - Dodatni identifikator kupca (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru primatelja)
    • MessageType - Tip poruke: 9999 – echo poruka
    • MessageAttributes – Atribut poruke
  • Data
    • EchoData
      • Echo - Sadržaj teksta

Elementi EchoBuyerAckMsg poruke

  • MessageAck
    • MessageID - Jedinstveni broj poruke
    • MessageAckID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageType – 10000 - Odgovor na echo poruku
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • EchoData
    • Echo - Sadržaj teksta

 

Metoda za dohvat liste ulaznih računa

Ova se metoda koristi za dohvaćanje liste ulaznih računa. Primatelj za dohvaćanje liste računa koristi filter kojim određuje kriterije po kojima želi dohvatiti račune. Omogućeno je sljedeće filtriranje:

  • po statusu računa,
  • po datumu,
  • po iznosu,
  • po registriranom nazivu pošiljatelja.

Lista računa koja se želi dohvatiti može se filtrirati i upisivanjem ID-eva računa od kojeg i do kojeg se želi napraviti dohvat.

Elementi GetB2GIncomingInvoiceListMsg poruke

  • HeaderBuyer
    • MessageID - Jedinstveni broj poruke
    • BuyerID - OIB kupca (npr. 9934:12345678901)
    • AdditionalBuyerID - Dodatni identifikator kupca (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru primatelja)
    • MessageType - Tip poruke 9101 – promjena statusa ulaznog e-računa
    • MessageAttributes – Atribut poruke
  • Data
    • B2GIncomingInvoiceList
      • DocumentCurrencyCode – true/false ispis valute iznosa računa u odgovornoj poruci (neobavezan element)
      • Filter - Filter za dohvat
        • InvoiceStatus
          • StatusCode - Status u sustavu e-Račun (prema tablici u poglavlju 8)
        • DateRange
          • From - Datum od
          • To - Datum do
        • AmountRange
          • From - Iznos od
          • To - Iznos do
        • TextSearch
          • SearchField - Polje za pretragu (default ALL)
          • SearchValue - Tekst za pretragu (ragistrirani naziv pošiljatelja)
        • InvoiceIDRange - Raspon za dohvat računa preko Fina InvoiceID
          • From - Invoice ID od (ne uključujući taj ID, veće od)
          • To - Invoice ID do (uključujući taj ID, manje ili jednako do)

Elementi GetB2GIncomingInvoiceListAckMsg poruke

Sinkroni odgovor na poruku za dohvat liste ulaznih račun.

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 9102 – sinkroni odgovor na GetB2GIncomingInvoiceListMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • B2GIncomingInvoiceList
    • B2GIncomingInvoice - Omotač ulaznog računa
      • DocumentType - Tip dokumenta
        • XMLStandard - Standard XML dokumenta (UBL ili CII)
        • SpecificationIdentifier - Prilagodba XML dokumenta (urn:cen.eu:en16931:2017) - fiksno
        • DocumentTypeCode - Tip dokumenta
        • DocumentTypeText - Opis tipa dokumenta
      • InvoiceStatus - Status dokumenta
        • StatusCode - Status u sustavu e-Račun
        • Note - Napomena statusa (npr. razlog odbijanja računa ili djelomičnog plaćanja)
        • PartialAmount - Iznos za djelomično plaćanje
        • DocumentCurrencyCode – Valuta iznosa djelomičnog plaćanja (neobavezan element)
      • SupplierID - Identifikator dobavljača (OIB, npr. 9934:12345678901)
      • AdditionalSupplierID - Dodatni identifikator izdavatelja (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru izdavatelja)
      • SupplierRegistrationName - Naziv pošiljatelja računa u sustavu
      • SupplierCompanyID - MB pošiljatelja računa u sustavu
      • InvoiceID - Identifikator računa u sustavu e-RačunB2G
      • SupplierInvoiceID - Identifikator računa pošiljatelja
      • DataInterchangeMethod - Metoda slanja računa (PKI, EDI, OTHER)
      • InvoiceIssueDate - Datum izdavanja
      • InvoiceTimestamp - Timestamp računa u sustavu e-RačunB2G
      • InvoicePayableAmount - Iznos računa
      • DocumentCurrencyCode – Valuta računa (neobavezan element)
  • Error
    • ErrorCode - Šifre grešaka odvojene delimiterom
    • ErrorMessage - Opisi grešaka odvojeni delimiterom
    • ErrorText - Dodatni tekst greške

 

Metoda za dohvat ulaznog računa

Ova se metoda koristi za dohvaćanje određenog ulaznog računa. Za dohvat računa, primatelj treba navesti ID računa kojeg želi dohvatiti.

Elementi GetB2GIncomingInvoiceMsg poruke

  • HeaderBuyer - Zaglavlje poruke
    • MessageID - Jedinstveni broj poruke
    • BuyerID - OIB kupca (npr. 9934:12345678901)
    • AdditionalBuyerID - Dodatni identifikator kupca (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru primatelja)
    • MessageType - Tip poruke: 9103 – dohvat ulaznog računa
    • MessageAttributes - Atributi poruke
  • Data - XML s podacima
    • B2GIncomingInvoice - Omotač upita za dohvat ulaznog računa
      • InvoiceID - Identifikator računa u sustavu e-RačunB2G
      • DocumentCurrencyCode – true/false ispis valute iznosa računa u odgovornoj poruci (neobavezan element)

Elementi GetB2GIncomingInvoiceAckMsg poruke

Sinkroni odgovor na poruku za dohvat ulaznog računa.

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 9104 – sinkroni odgovor na GetB2GIncomingInvoiceMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • B2GIncomingInvoice
    • InvoiceID - Identifikator računa u sustavu e-RačunB2G
    • InvoiceTimestamp - Timestamp računa u sustavu e-RačunB2G
    • DocumentType - Tip dokumenta za dohvat
      • XMLStandard - Standard XML dokumenta (UBL ili CII)
      • SpecificationIdentifier - Prilagodba XML dokumenta (urn:cen.eu:en16931:2017) - fiksno
      • DocumentTypeCode - Tip dokumenta
      • DocumentTypeText - Opis tipa dokumenta
    • InvoiceStatus - Status dokumenta za dohvat
      • StatusCode - Status u sustavu e-Račun
      • Note - Napomena statusa (npr. razlog odbijanja računa ili djelomičnog plaćanja)
      • PartialAmount - Iznos za djelomično plaćanje
      • DocumentCurrencyCode – Valuta iznosa djelomičnog plaćanja (neobavezan element)
    • DataInterchangeMethod - Metoda slanja računa (PKI, EDI, OTHER)
    • IncomingInvoiceEnvelope - Omotnica ulaznog dokumenta
      • InvoiceEnvelope - Omotač e-računa po UBL shemi
      • CreditNoteEnvelope - Omotač e-odobrenja po UBL shemi
      • PdfDocument - PDF dokumenta (e-računa ili e-odobrenja)
  • Error
    • ErrorCode - Šifre grešaka odvojene delimiterom
    • ErrorMessage - Opisi grešaka odvojeni delimiterom
    • ErrorText - Dodatni tekst greške

 

Metoda za promjenu statusa ulaznog računa

Ova se poruka koristi za promjenu statusa pojedinog ulaznog računa. Za promjenu statusa, Primatelj mora navesti ID računa i podatke o statusu koji želi postaviti.

Nakon ulaska računa u sustav "e-Račun za državu", automatski se postavlja početni status "RECEIVED". Primatelj nakon ulaska računa u sustav mora preuzeti račun i potvrditi zaprimanje računa slanjem statusa "RECEIVING_CONFIRMED". Tek nakon postavljanja navedenog statusa, moguće je slanje ostalih dostupnih statusa nevednih u tablici u 12. poglavlju ovog dokumenta.

Ukoliko primatelj želi odbiti račun zbog toga što je račun poslan na pogrešnu poslovnu jedinicu, kao "StatusCode" postavlja "REJECTED", a kao "CodeReason" postavlja šifru "190".

Elementi ChangeB2GIncomingInvoiceStatusMsg poruke

  • HeaderBuyer - Zaglavlje poruke
    • MessageID - Jedinstveni broj poruke
    • BuyerID - OIB kupca (npr. 9934:12345678901)
    • AdditionalBuyerID - Dodatni identifikator kupca (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru primatelja)
    • MessageType - Tip poruke: 107 – promjena statusa ulaznog računa
    • MessageAttributes - Atributi poruke
  • Data - XML s podacima
    • B2GIncomingInvoiceStatus
      • InvoiceID - Identifikator računa u sustavu e-Račun B2G
      • InvoiceStatus - Status u koji se želi napraviti promjena u sustavu e-Račun
        • StatusCode - Status u sustavu e-Račun (prema tablici u poglavlju 12)
        • CodeReason - Šifra razloga („190“ za Pogrešna poslovna jedinica) - opcionalno
        • Note - Napomena statusa (npr. razlog odbijanja računa ili djelomičnog plaćanja)
        • PartialAmount - Iznos za djelomično plaćanje
        • DocumentCurrencyCode – Valuta iznosa djelomičnog plaćanja (neobavezan element) – valuta mora biti ista kao i kod izvornog računa

Elementi ChangeB2GIncomingInvoiceStatusAckMsg poruke

Sinkroni odgovor na poruku za promjenu statusa ulaznog računa.

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 108 – sinkroni odgovor na ChangeB2GIncomingInvoiceStatusMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • Error
    • ErrorCode - Šifra greške odvojene delimiterom
    • ErrorMessage - Opis greške odvojene delimiterom
    • ErrorText - Dodatni tekst greške

 

Metoda za dohvat liste izlaznih računa

Ova se metoda koristi za dohvat liste izlaznih računa. Pošiljatelj za dohvaćanje liste računa koristi filter kojim određuje kriterije po kojima želi dohvatiti račune. Omogućeno je sljedeće filtriranje:

  • po statusu računa,
  • po datumu,
  • po iznosu.

Lista računa koja se želi dohvatiti može se filtrirati i upisivanjem ID-eva računa od kojeg i do kojeg se želi napraviti dohvat.

Elementi GetB2GOutgoingInvoiceListMsg poruke

  • HeaderSupplier
    • MessageID - Jedinstveni broj poruke
    • SupplierID - OIB dobavljača (npr. 9934:12345678901)
    • AdditionalSupplierID - Dodatni identifikator izdavatelja (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru izdavatelja)
    • MessageType - Tip poruke 9105 – promjena statusa ulaznog e-računa
    • MessageAttributes – Atribut poruke
  • Data
    • B2GOutgoingInvoiceList
      • DocumentCurrencyCode – true/false ispis valute iznosa računa u odgovornoj poruci (neobavezan element)
      • Filter - Filter za dohvat
        • InvoiceStatus
          • StatusCode - Status u sustavu e-Račun (prema tablici u poglavlju 8)
        • DateRange
          • From - Datum od
          • To - Datum do
        • AmountRange
          • From - Iznos od
          • To - Iznos do
        • InvoiceIDRange - Raspon za dohvat računa preko Fina InvoiceID
          • From - Invoice ID od (ne uključujući taj ID, veće od)
          • To - Invoice ID do (uključujući taj ID, manje ili jednako do)

Elementi GetB2GOutgoingInvoiceListAckMsg poruke

Sinkroni odgovor na poruku za dohvat liste izlaznih računa.

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 9106 – sinkroni odgovor na GetB2GOutgoingInvoiceListMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • B2GOutgoingInvoiceList
    • B2GOutgoingInvoice - Omotač ulaznog računa
      • DocumentType - Tip dokumenta
        • XMLStandard - Standard XML dokumenta (UBL ili CII)
        • SpecificationIdentifier - Prilagodba XML dokumenta (urn:cen.eu:en16931:2017) - fiksno
        • DocumentTypeCode - Tip dokumenta
        • DocumentTypeText - Opis tipa dokumenta
      • InvoiceStatus - Status dokumenta
        • StatusCode - Status u sustavu e-Račun
        • Note - Napomena statusa (npr. razlog odbijanja računa ili djelomičnog plaćanja)
        • PartialAmount - Iznos za djelomično plaćanje
        • DocumentCurrencyCode – Valuta iznosa djelomičnog plaćanja (neobavezan element)
      • BuyerID - Identifikator kupca (OIB, npr. 9934:12345678901)
      • AdditionalBuyerID - Dodatni identifikator kupca (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru primatelja)
      • BuyerRegistrationName - Naziv kupca računa u sustavu
      • BuyerCompanyID - MB kupca računa u sustavu
      • InvoiceID - Identifikator računa u sustavu e-RačunB2G
      • SupplierInvoiceID - Identifikator računa pošiljatelja
      • DataInterchangeMethod - Metoda slanja računa (PKI, EDI, OTHER)
      • InvoiceIssueDate - Datum izdavanja
      • InvoiceTimestamp - Timestamp računa u sustavu e-Račun B2G
      • InvoicePayableAmount - Iznos računa
      • DocumentCurrencyCode – Valuta računa (neobavezan element)
  • Error
    • ErrorCode - Šifre grešaka odvojene delimiterom
    • ErrorMessage - Opisi grešaka odvojeni delimiterom
    • ErrorText - Dodatni tekst greške

 

Metoda za dohvat izlaznog računa

Ova se metoda koristi za dohvaćanje određenog izlaznog računa. Za dohvat računa, pošiljatelj treba navesti ID računa kojeg želi dohvatiti.

Elementi GetB2GOutgoingInvoiceMsg poruke

  • HeaderSupplier - Zaglavlje poruke
    • MessageID - Jedinstveni broj poruke
    • SupplierID - OIB izdavatelja (npr. 9934:12345678901)
    • AdditionalSupplierID - Dodatni identifikator izdavatelja (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru izdavatelja)
    • MessageType - Tip poruke: 9107 – dohvat ulaznog računa
    • MessageAttributes - Atribut poruke
  • Data - XML s podacima
    • B2GOutgoingInvoice - Omotač upita za dohvat ulaznog računa
      • InvoiceID - Identifikator računa u sustavu e-RačunB2G
      • DocumentCurrencyCode – true/false ispis valute iznosa računa u odgovornoj poruci (neobavezan element)

Elementi GetB2GOutgoingInvoiceAckMsg poruke

Sinkroni odgovor na poruku za dohvat izlaznog računa

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 9108 – sinkroni odgovor na GetB2GIncomingInvoiceMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • B2GOutgoingInvoice
    • InvoiceID - Identifikator računa u sustavu e-RačunB2G
    • InvoiceTimestamp - Timestamp računa u sustavu e-RačunB2G
    • DocumentType - Tip dokumenta za dohvat
      • XMLStandard - Standard XML dokumenta (UBL ili CII)
      • SpecificationIdentifier - Prilagodba XML dokumenta (urn:cen.eu:en16931:2017) - fiksno
      • DocumentTypeCode - Tip dokumenta
      • DocumentTypeText - Opis tipa dokumenta
    • InvoiceStatus - Status dokumenta za dohvat
      • StatusCode - Status u sustavu e-Račun
      • Note - Napomena statusa (npr. razlog odbijanja računa ili djelomičnog plaćanja)
      • PartialAmount - Iznos za djelomično plaćanje
      • DocumentCurrencyCode – Valuta iznosa djelomičnog plaćanja (neobavezan element)
    • DataInterchangeMethod - Metoda slanja računa (PKI, EDI, OTHER)
    • OutgoingInvoiceEnvelope - Omotnica ulaznog dokumenta
      • InvoiceEnvelope - Omotač e-računa po UBL shemi
      • CreditNoteEnvelope - Omotač e-odobrenja po UBL shemi
      • PdfDocument - PDF dokumenta (e-računa ili e-odobrenja)
  • Error
    • ErrorCode - Šifre grešaka odvojene delimiterom
    • ErrorMessage - Opisi grešaka odvojeni delimiterom
    • ErrorText - Dodatni tekst greške

 

Poruka za dohvat registra Primatelja servisa e-Račun

Ova se poruka koristi za dohvat liste Primatelja iz registra sustava "e-Račun za državu".

Filtriranje je moguće prema OIB broju, nazivu poslovnog subjekta ili datumu. Ukoliko se želi dohvatiti kompletni registar, kao vrijednosti polja "SearchField" i "SearchValue" se upisuje "ALL". Ukoliko se pretraživanje radi prema OIB broju, kao vrijednosti polja "SearchField" se upisuje "OIB", a u polje "SearchValue" se upisuje OIB broj s "HR" prefiksom, npr. "HR01234567890".Ukoliko se pretraživanje radi prema nazivu poslovnog subjekta, kao vrijednosti polja "SearchField" se upisuje "NAZIV", a u polje "SearchValue" se upisuje dio i kompletan naziv poslovnog subjekta. Kod pretraživanja prema datumu upisuju se datumi u formatu GGGG-MM-DD.

Kod dohvata kompletnog registra i kod filtriranja prema nazivu i OIB broju, u odgovoru se šalju samo aktivni korisnici. U slučaju filtriranja prema datumu, u odgovoru se šalju aktivni i neaktivni korisnici za navedeno razdoblje.

Elementi GetReceiverListMsg poruke

  • HeaderSupplier - Zaglavlje poruke
    • MessageID - Jedinstveni broj poruke
    • SupplierID - OIB izdavatelja (npr. 9934:12345678901)
    • AdditionalSupplierID - Dodatni identifikator izdavatelja (poslovne jedinice, npr. HR99:12345 gdje je 12345 šifra poslovne jedinice koja je navedena u registru izdavatelja)
    • MessageType – Tip poruke: 50041 – dohvat registra primatelja
    • MessageAttributes - Atribut poruke
  • Data
    • ReceiverList - Dohvat liste primatelja iz registra
      • Filter - Filter za dohvat
        • DateRange
          • From - Datum od
          • To - Datum do
        • TextSearch
          • SearchField - Polje za pretragu ("ALL", "OIB" ili "NAZIV")
          • SearchValue – Vrijednost polja ("ALL" OIB broj ili naziv)

Elementi GetReceiverListAckMsg poruke

  • MessageAck
    • MessageID - Jedinstveni broj poruke na koju se odnosi odgovor
    • MessageAckID - Jedinstveni broj poruke odgovora
    • MessageType - Tip poruke: 50042– sinkroni odgovor na GetReceiverListMsg
    • AckStatus - Status odgovora
    • AckStatusCode - Šifra statusa iz sustava
    • AckStatusText - Opis statusa iz sustava
  • BusinessBranch – podaci o poslovnom subjektu
    • BuyerID - Identifikator organizacijske jedinice (BuyerID)
    • SchemeName - Vrsta sheme organizacijske jedinice (GLN, JUS, RKP,...)
    • BusinessBranchCode - Šifra organizacijske jedinice
    • BusinessBranchName - Naziv organizacijske jedinice
    • PostalAddress – Adresa poslovnog subjekta
      • StreetName - Ulica
      • BuildingNumber - Kućni broj
      • PostalCode - Poštanski broj
      • CityName – Grad
      • Country – Država
      • AddressLine – Adresa u jednoj liniji
    • Activity – Aktivnost
    • Receiver – primatelj
      • RegistrationName - Naziv primatelja računa
      • ISOCode - ISO kod države (HR)
      • CompanyID – OIB
      • PostalAddress – Adresa organizacijaske jedinice
        • StreetName - Ulica
        • BuildingNumber - Kućni broj
        • PostalCode - Poštanski broj
        • CityName – Grad
        • Country – Država
        • AddressLine – Adresa u jednoj liniji

 

Šifre statusa računa u razmjeni

Ulazni računi mogu imati sljedeće vrijednosti statusa:

StatusOpis
RECEIVEDZaprimljen. Početni status računa nakon zaprimanja u sustav
RECEIVING_CONFIRMEDPotvrda zaprimanja
APPROVEDOdobren (prihvaćen)
REJECTEDOdbijen
PAYMENT_FULFILLEDPlaćen u potpunosti
PAYMENT_PARTIALLY_FULFILLEDPlaćen djelomično

 

U slučaju odbijanja ili djelomičnog plaćanja nužno je upisivanje razloga odbijanja odnosno djelomičnog plaćanja u element "Note". Također, u slučaju djelomičnog plaćanja nužno je upisivanje iznosa djelomičnog plaćanja u element "PartialAmount".
 

Tipovi poruka u razmjeni

Slijedi tablica s opisima tipova poruka i odgovornih poruka:

Tip porukeOpisPoruka/metoda
9999Echo porukaEchoBuyerMsg
10000Odgovor na echo porukuEchoBuyerAckMsg
9101Dohvat liste ulaznih računaGetB2GIncomingInvoiceListMsg
9102Odgovor na dohvat liste ulaznih računaGetB2GIncomingInvoiceListAckMsg
9103Dohvat ulaznog računaGetB2GIncomingInvoiceMsg
9104Odgovor na dohvat ulaznog računaGetB2GIncomingInvoiceAckMsg
107Promjena statusa ulaznog računaChangeB2GIncomingInvoiceStatusMsg
108Odgovor na promjenu statusa ulaznog računaChangeB2GIncomingInvoiceStatusAckMsg
9105Dohvat liste izlaznih računaGetB2GOutgoingInvoiceListMsg
9106Odgovor na dohvat liste izlaznih računaGetB2GOutgoingInvoiceListAckMsg
9107Dohvat izlaznog računaGetB2GOutgoingInvoiceMsg
9108Odgovor na dohvat izlaznog računaGetB2GOutgoingInvoiceAckMsg
50041Dohvat registra primateljaGetReceiverListMsg
50042Odgovor na dohvat registra primateljaGetReceiverListAckMsg

 

Šifarnik mogućih grešaka kod slanja poruka

Šifra greškeOpis greškePoruka
E000100Nepostojeći korisnikNepostojeći korisnik ''{DN korisnika}''
E000101Korisnik nema pravaKorisnik ''{ID korisnika}'' nema prava ''{naziv prava}''
E000200Nepostojeći dokumentNe postoji dokument ID={ID dokumenta} primatelja ID={ID narucitelja}
E000201Nije moguća promjena statusa jer se dokument nalazi u nedozvoljenom statusuDokument ID={ID dokumenta} se nalazi u nedozvoljenom statusu ''{opis statusa}''. Nije moguća promjena statusa
E000202Nije moguća promjena statusa za dokumentDokument ID={ID dokumenta} tipa={tip dokumenta (380 račun...)} se ne može mijenjati status.
E000999Ostale greškeGreška: {0}

 

Sheme poruka i definicija web servisa

Sheme poruka i definicija web servisa nalazi se ovdje.

  • Nužni kolačići omogućuju osnovne funkcionalnosti. Bez ovih kolačića, web-stranica ne može pravilno funkcionirati, a isključiti ih možete mijenjanjem postavki u svome web-pregledniku.