Tehnička specifikacija - razmjena podataka web servisima sinkronom obradom
Brzi linkovi
Tehnička specifikacija
Metoda za provjeru rada web servisa
Metoda za dohvat liste ulaznih računa
Metoda za dohvat ulaznog računa
Metoda za promjenu statusa ulaznog računa
Metoda za dohvat liste izlaznih računa
Metoda za dohvat izlaznog računa
Poruka za dohvat registra Primatelja servisa e-Račun
Šifre statusa računa u razmjeni
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
SSL | Secure Sockets Layer – protokol koji omogućava zaštitu komunikacijskog kanala |
Pošiljatelj | Pošiljatelj računa prema korisniku državnog proračuna |
Primatelj | Obveznik javne nabave |
ERP | Enterprise Resource Planning – Poslovni sustav na strani Pošiljatelja |
SOAP | Simple 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
- getB2GIncomingInvoiceList
- GetB2GIncomingInvoiceListMsg
- getB2GIncomingInvoice
- GetB2GIncomingInvoiceMsg
- GetB2GOutgoingInvoiceList
- GetB2GOutgoingInvoiceListMsg
- GetB2GOutgoingInvoice
- GetB2GOutgoingInvoiceMsg
- ChangeB2GIncomingInvoiceStatus
- poruka ChangeB2GIncomingInvoiceStatusMsg
- GetReceiverList
- poruka GetReceiverListMsg
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:
Status | Opis |
RECEIVED | Zaprimljen. Početni status računa nakon zaprimanja u sustav |
RECEIVING_CONFIRMED | Potvrda zaprimanja |
APPROVED | Odobren (prihvaćen) |
REJECTED | Odbijen |
PAYMENT_FULFILLED | Plaćen u potpunosti |
PAYMENT_PARTIALLY_FULFILLED | Plać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 poruke | Opis | Poruka/metoda |
9999 | Echo poruka | EchoBuyerMsg |
10000 | Odgovor na echo poruku | EchoBuyerAckMsg |
9101 | Dohvat liste ulaznih računa | GetB2GIncomingInvoiceListMsg |
9102 | Odgovor na dohvat liste ulaznih računa | GetB2GIncomingInvoiceListAckMsg |
9103 | Dohvat ulaznog računa | GetB2GIncomingInvoiceMsg |
9104 | Odgovor na dohvat ulaznog računa | GetB2GIncomingInvoiceAckMsg |
107 | Promjena statusa ulaznog računa | ChangeB2GIncomingInvoiceStatusMsg |
108 | Odgovor na promjenu statusa ulaznog računa | ChangeB2GIncomingInvoiceStatusAckMsg |
9105 | Dohvat liste izlaznih računa | GetB2GOutgoingInvoiceListMsg |
9106 | Odgovor na dohvat liste izlaznih računa | GetB2GOutgoingInvoiceListAckMsg |
9107 | Dohvat izlaznog računa | GetB2GOutgoingInvoiceMsg |
9108 | Odgovor na dohvat izlaznog računa | GetB2GOutgoingInvoiceAckMsg |
50041 | Dohvat registra primatelja | GetReceiverListMsg |
50042 | Odgovor na dohvat registra primatelja | GetReceiverListAckMsg |
Šifarnik mogućih grešaka kod slanja poruka
Šifra greške | Opis greške | Poruka |
E000100 | Nepostojeći korisnik | Nepostojeći korisnik ''{DN korisnika}'' |
E000101 | Korisnik nema prava | Korisnik ''{ID korisnika}'' nema prava ''{naziv prava}'' |
E000200 | Nepostojeći dokument | Ne postoji dokument ID={ID dokumenta} primatelja ID={ID narucitelja} |
E000201 | Nije moguća promjena statusa jer se dokument nalazi u nedozvoljenom statusu | Dokument ID={ID dokumenta} se nalazi u nedozvoljenom statusu ''{opis statusa}''. Nije moguća promjena statusa |
E000202 | Nije moguća promjena statusa za dokument | Dokument ID={ID dokumenta} tipa={tip dokumenta (380 račun...)} se ne može mijenjati status. |
E000999 | Ostale greške | Greška: {0} |
Sheme poruka i definicija web servisa
Sheme poruka i definicija web servisa nalazi se ovdje.