API for sending document in public procurement to FINA.
GetFinaReceiverList | Get possible receivers from FINA for e-invoice in public procurement. This data is needed to send a document to a desired receiver. |
SendDocumentToFina | Send an existing invoice in public procurement to FINA. You will need companyID and partyIdentificationID from the receiver registry in order to send the invoice. |
GetDocumentStatusFromFina | Retrieve the status of an already sent document to FINA. |
Get possible receivers from FINA for invoice in public procurement. You can filter all by not sending any parameters or single out a desired receiver. Invoices can be sent only to buyers that exist in this registry.
Request parameters
status | Filter ACTIVE or INACTIVE receivers. Parameter is optional. |
companyID | companyID of the receiver (OIB in HR). Parameter is optional. |
partyIdentificationID | Receiver unique identifier which includes also the business unit code. This is like an electronic receiver address that will be needed for sending a document to FINA. For filtering receivers this parameter is optional. |
registrationName | Registration name of the company. Parameter is optional. |
Example request and response
POST /WebServicesHR/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="admin" md5pass="d2cc342653e944df15923698c6bdd1ac" token="A73A6E565E0842B8AE67B6D52BE8F2A0" />
<method name="GetFinaReceiverList">
<parameter name="status" value="ACTIVE"/> <!-- Optional -->
<parameter name="companyID" value="28921383001"/> <!-- Optional -->
<!-- <parameter name="partyIdentificationID" value="9934:28921383001::HR99:06"/> --> <!-- Optional -->
<!-- <parameter name="registrationName" value="HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA"/> --> <!-- Optional -->
</method>
</request>
____________________________________________________________________________
Response
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 March 2010 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<GetFinaReceiverListMsg>
<Receiver>
<addressLine>MEĐIMURSKA ULICA 26B, 42000, VARAŽDIN</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA MURU I GOPRNJU DRAVU</businessBranchName>
<cityName>VARAŽDIN</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:06</partyIdentificationID>
<postalCode>42000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>MEĐIMURSKA ULICA 26B</streetName>
</Receiver>
<Receiver>
<addressLine>VUKOVARSKA 35, 21000, SPLIT</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA SLIVOVE JUŽNOG JADRANA</businessBranchName>
<cityName>SPLIT</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:04</partyIdentificationID>
<postalCode>21000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>VUKOVARSKA 35</streetName>
</Receiver>
<Receiver>
<addressLine>ĐURE ŠPORERA 3, 51000, RIJEKA</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA SLIVOVE SJEVERNOG JADRANA</businessBranchName>
<cityName>RIJEKA</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:03</partyIdentificationID>
<postalCode>51000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>ĐURE ŠPORERA 3</streetName>
</Receiver>
<Receiver>
<addressLine>SPLAVARSKA 2A, 31000, OSIJEK</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA DUNAV I DONJU DRAVU</businessBranchName>
<cityName>OSIJEK</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:02</partyIdentificationID>
<postalCode>31000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>SPLAVARSKA 2A</streetName>
</Receiver>
<Receiver>
<addressLine>ŠETALIŠTE BRAĆE RADIĆA 22, 35000, SLAVONSKI BROD</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA SREDNJU I DONJU SAVU</businessBranchName>
<cityName>SLAVONSKI BROD</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:01</partyIdentificationID>
<postalCode>35000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>ŠETALIŠTE BRAĆE RADIĆA 22</streetName>
</Receiver>
<Receiver>
<addressLine>ULICA GRADA VUKOVARA 220, 10000, ZAGREB</addressLine>
<businessBranchName>DIREKCIJA</businessBranchName>
<cityName>ZAGREB</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:00</partyIdentificationID>
<postalCode>10000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>ULICA GRADA VUKOVARA 220</streetName>
</Receiver>
<Receiver>
<addressLine>ULICA GRADA VUKOVARA 271, 10000, ZAGREB</addressLine>
<businessBranchName>VODNOGOSPODARSKI ODJEL ZA GORNJU SAVU</businessBranchName>
<cityName>ZAGREB</cityName>
<companyID>28921383001</companyID>
<country>REPUBLIKA HRVATSKA</country>
<endpointID>28921383001</endpointID>
<endpointIDSchemeID>9934</endpointIDSchemeID>
<isoCode>HR</isoCode>
<partyIdentificationID>9934:28921383001::HR99:05</partyIdentificationID>
<postalCode>10000</postalCode>
<registrationName>HRVATSKE VODE, PRAVNA OSOBA ZA UPRAVLJANJE VODAMA</registrationName>
<status>active</status>
<streetName>ULICA GRADA VUKOVARA 271</streetName>
</Receiver>
</GetFinaReceiverListMsg>
</response>
Send an existing invoice in public procurement to FINA.
To be able to send a document, you will need receiver data that you can retrieve by using GetFinaReceiverList method.
Request Parameters
document | Parameter that holds document data. Mandatory data. |
sendWithAttachments | Possible values are "true" or "false". If set to true all user added attachments will be sent with the document. Optional data. |
companyID | companyID of the receiver. Mandatory data. |
partyIdentificationID | partyIdentificationID of the receiver. Mandatory data. |
Parameter document holds mandatory data:
type | Document type. Supported values are SalesInvoice, AdvanceInvoice, CreditNote. |
number | Full number of the document. |
year | Year of the document. |
Response values
StatusCode values are:
documentSent | Document was sent to FINA. |
documentDeliveryFailed | Document was not sent due to problems. |
documentDeliveryConfirmed | Document delivery was confirmed. |
documentReceivalConfirmed | Document receival was confirmed. |
documentRejectedByReceiver | Document was rejected by receiver. |
documentRejectedByGateway | Document was rejected by gateway. |
SendingTransactionID > is a unique identifier of the sent document that was assigned and returned by FINA upon receival.
SendingResultMessage > is an additional message that holds an description. For instance if an error occurs its description will be added to this message.
Example request and response
POST /WebServicesHR/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="admin" md5pass="d2cc342653e944df15923698c6bdd1ac" token="A73A6E565E0842B8AE67B6D52BE8F2A0" />
<method name="SendDocumentToFina">
<parameter name="document"> <!-- Mandatory -->
<type>SalesInvoice</type> <!-- Mandatory -->
<number>141/0001/191</number> <!-- Mandatory -->
<year>2019</year> <!-- Mandatory -->
</parameter>
<parameter name="sendWithAttachments" value="true"/> <!-- Optional -->
<parameter name="companyID" value="87311810356"/> <!-- Mandatory -->
<parameter name="partyIdentificationID" value="9934:87311810356"/> <!-- Mandatory -->
</method>
</request>
____________________________________________________________________________
Response
<response status="ok">
<SendDocumentToFinaMsg>
<MsgTimestamp>2019-08-28T10:10:40</MsgTimestamp>
<MsgText>Document was sent.</MsgText>
<DocumentSendingLog>
<StatusCode>documentSent</StatusCode>
<SentTS>2019-08-27T13:27:44</SentTS>
<DeliveryConfirmedTS>2019-08-27T13:27:47</DeliveryConfirmedTS>
<SendingTransactionID>68991</SendingTransactionID>
</DocumentSendingLog>
</SendDocumentToFinaMsg>
</response>
In case the document was already sent to FINA:
<response status="ok">
<SendDocumentToFinaMsg>
<MsgTimestamp>2019-08-28T12:14:46</MsgTimestamp>
<MsgText>Document was already sent to FINA.</MsgText>
<DocumentSendingLog>
<StatusCode>documentDeliveryConfirmed</StatusCode>
<SentTS>2019-08-28T12:11:43</SentTS>
<DeliveryConfirmedTS>2019-08-27T13:27:50</DeliveryConfirmedTS>
<SendingTransactionID>68991</SendingTransactionID>
<SendingResultMessage>Zaprimljen</SendingResultMessage>
</DocumentSendingLog>
</SendDocumentToFinaMsg>
</response>
In case of an error:
<response status="ok">
<SendDocumentToFinaMsg>
<MsgTimestamp>2019-08-28T12:02:26</MsgTimestamp>
<MsgText>Document delivery failed.</MsgText>
<DocumentSendingLog>
<StatusCode>documentDeliveryFailed</StatusCode>
<SentTS>2019-07-29T08:58:47</SentTS>
<SendingResultMessage>eFINA - Sistemska greška na strani web servisa!</SendingResultMessage>
</DocumentSendingLog>
</SendDocumentToFinaMsg>
</response>
<response status="error">
<error description="Document with requested parameters does not exist."></error>
</response>
Retrieves the status of an already sent document.
Request Parameters
document | Parameter that holds document data. Mandatory data. |
Parameter document holds mandatory data:
type | Document type. Supported values are SalesInvoice, AdvanceInvoice, CreditNote. |
number | Full number of the document. |
year | Year of the document. |
Example request and response
POST /WebServicesHR/API HTTP/1.1
Host: eurofaktura.com
User-Agent: Mozilla/4.0
Content-Length: 410
Content-Type: application/octet-stream
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="admin" md5pass="d2cc342653e944df15923698c6bdd1ac" token="A73A6E565E0842B8AE67B6D52BE8F2A0" />
<method name="GetDocumentStatusFromFina">
<parameter name="document"> <!-- Mandatory -->
<type>SalesInvoice</type> <!-- Mandatory -->
<number>141/0001/191</number> <!-- Mandatory -->
<year>2019</year> <!-- Mandatory -->
</parameter>
</method>
</request>
____________________________________________________________________________
Response
<response status="ok">
<GetDocumentStatusFromFinaMsg>
<MsgTimestamp>2019-08-28T10:10:40</MsgTimestamp>
<MsgText>Document was sent.</MsgText>
<DocumentSendingLog>
<StatusCode>documentSent</StatusCode>
<SentTS>2019-08-27T13:27:44</SentTS>
<DeliveryConfirmedTS>2019-08-27T13:27:47</DeliveryConfirmedTS>
<SendingTransactionID>68991</SendingTransactionID>
</DocumentSendingLog>
</GetDocumentStatusFromFinaMsg>
</response>