Invoice, UBL - Integrators Manual
Your main goals are to enable users following operations via your ERP system:
- Send documents, properly formatted and wrapped in XML with enabled attachments
- Receive documents (importing data from XML document)
- Monitor statuses of sent invoices
- Enable resend and cancel actions with outgoing and reject action on incoming invoices
Moj-eRačun functionalities presume that user is registered, so if he hasn't passed the registration process, it is necessary for an application to redirect him to our page https://www.moj-eracun.hr/hr/Account/Register where he can go through the process using web browser and familiarize himself with details and further steps. After he successfully passes the registration process, he should be able to input his credentials into your application. User identity is defined through 4 fields:
Pass - User credential password
Oib - Sender CompanyID
PJ – Sender Company Business Unit
Password - Login password
CompanyId - Sender Business Number, aka Oib or VatId
CompanyBu – Sender Business Unit
All of these four data are interpreted as textual data. User may run multiple companies under the same account and vice-versa so "many-to-many" relationship should be considered. Business unit field should remain empty if user doesn't require one or he doesn't know what that is. Business unit can be described as a store, or dislocated area which one company owns or where it conducts some business activities.
Invoice is XML representation of invoice data.
Invoice xsd schemes and namespaces
Invoice implements UBL-2.1 schemes and namespaces.
Invoice parsed nodes
Parsed nodes are mandatory nodes, that moj-eracun.hr service will extract from posted document and use to properly address document
Supplier CompanyID (Oib, VatId or similar): Invoice/AccountingSupplierParty/Party/PartyLegalEntity/CompanyID
Supplier Company BusinessUnit: Invoice/AccountingSupplierParty/Party/PartyIdentification/ID
Customer CompanyID (Oib, VatId or similar): Invoice/AccountingCustomerParty/Party/PartyLegalEntity/CompanyID
Customer Company BusinessUnit: Invoice/AccountingCustomerParty/Party/PartyIdentification/ID
Customer Business Contact Email: Invoice/AccountingCustomerParty/AccountingContact/ElectronicMail
Attached document: AttachedDocument/Attachment/EmbeddedDocumentBinaryObject
Invoice parsed nodes example
15-01-91 69715301002 Business unit 1 01234554321 podružnica Ilok firstname.lastname@example.org;email@example.com;firstname.lastname@example.org 15-01-91 JVBER...==
Guidelines for implementation
These guidelines contain some of the most common questions which could appear during the integration proccess.
- Make sure to fill as many data as possible in the XML document
- Make sure that you validate your XML document before testing
- Make sure that you enable sending eDocuments to multiple e-mail addresses (see XML node strucutre lower)
- Make sure that you enable sending multiple attachments
Multiple e-mails - XML node structure
Multiple e-mail addressess should be put in the customers Accounting Contact data:
Accounting Contact Name email@example.com;firstname.lastname@example.org
European Norm (EN) compliance
In March 2017, CEN issued the EU norm for electronic invoices which are exchanged with public entities. This norm implemented some differences in comparison to the current data
model used by Moj-eRačun and other service providers in Croatia.
Therefore we have begun to implement these changes to our system to enable our users to exchange eInvoices with public entities. Our service will be fully compliant with the EU norm, and the Croatian legislation in time.
To implement these differences, we had to do some modifications to our system. These modifications are described in the following guidelines:
These Guidelines contain XSD schemes for EN compliant eInovices, an XML example and PDF file with textual guidelines. In order to ensure that all of our partners will be able to exchange EN compliant eInvoices, we have decided to develop a converter which will convert the current standard which our user use to the EN compliant format. Therefore, the proccess of exchange of eInvoices will look like this:
We hope that this picture, together with the Guidelines will give you all the necessary information on implementation of EN compliant eInvoices. If you have any questions, feel free to contact us.
This document defines the Moj-eRačun extension of EU norm HRN EN 16931-1:2017 and its UBL 2.1 mapping EN 16931-3.2:2017. The goal of defining an extension of EN 16931-1:2017 is to define additional business terms required to adequately support electronic invoicing legal requirements in Croatia (from other laws besiedes VAT), further automate electronic invoice processing and payment and better integration with other business documents exchanged in the supply and financial value chains. The document contains definition of business terms that consist the extensions, extensions of business terms and required controlled vocabularies (code lists) The definition of business terms follows the structure defied by the semantic model of EN 16931-1:2017 in which every business term is described by an ID, term name, description, content model and cardinality.
Documents compliant to this extension maintain full compliance to both the semantic model and business rules defined by EN 16931-1:2017, as well as with the Croatian Core Invoice Usage Specification version 1.2 from 03.01.2020 published at link
You can validate Your XML document on the this: link
Moj-eRačun service provides a demo environment to its partners for testing purposes. Demo environment can be accessed via this: link.
If a partner wants to use our demo environment, he should be registered so make sure you have your username and password before you begin testing.
If you have any questions, feel free to contact us: