API Reference

• SalesInvoice API [15]
• CreditNote API [2]
• SalesQuote API [17]
• DeliveryNote API [4]
• SalesOrder API [16]
• AdvanceInvoice API [20]
• Partner API [11]
• Product API [12]
• ProductGroup API [13]
• BillOfMaterials API [1]
• WorkOrderAPI [27]
• DebitNote API [3]
• Document Management API [5]
• GeneralLedger API [8]
• GeneralLedgerJournalVoucherAPI [21]
• GoodsReceipt API [9]
• PurchaseOrder API [14]
• Warehouse API [19]
• TABooking API [18]
• ReceivedInvoice API [24]
• ReceivedCreditNote API [25]
• ReceivedAdvanceInvoice API [26]
• Reporting API [28]

1. BillOfMaterials API

1.1 BillOfMaterialsGet

Get bill of materials by number.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsGet">
       <parameter name="number" value="055/11" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <BillOfMaterials>
               <date>2015-05-06</date>
               <number>055/11</number>
               <productCode>055</productCode>
               <productQuantity>10.000000</productQuantity>
               <status>Active</status>
               <MaterialItems>
                       <MaterialItem>
                               <itemProductCode>000011</itemProductCode>
                               <position>1</position>
                               <quantity>5.000000</quantity>
                       </MaterialItem>
                       <MaterialItem>
                               <itemProductCode>000001</itemProductCode>
                               <position>2</position>
                               <quantity>1.000000</quantity>
                       </MaterialItem>
               </MaterialItems>
               <WorkingHours>
                       <WorkingHour>
                               <description>consulting</description>
                               <hoursPlanned>6.0000</hoursPlanned>
                               <position>1</position>
                               <workTask>consulting</workTask>
                       </WorkingHour>
                       <WorkingHour>
                               <description>Programiranje</description>
                               <hoursPlanned>8.0000</hoursPlanned>
                               <position>2</position>
                               <workTask>consulting</workTask>
                       </WorkingHour>
                       <WorkingHour>
                               <description>Testiranje</description>
                               <hoursPlanned>2.0000</hoursPlanned>
                               <position>3</position>
                               <workTask>consulting</workTask>
                       </WorkingHour>
               </WorkingHours>
       </BillOfMaterials>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find bill of materials number: 055/11,  
</response>

1.2 BillOfMaterialsCreate

Create new bill of materials.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsCreate">
       <parameter name="BillOfMaterials">
               <date>2015-05-06</date>                          <!-- Mandatory
               <productCode>055</productCode>                   <!-- Mandatory
               <productQuantity>10.000000</productQuantity>     <!-- Mandatory
               <status>Active</status>                          <!-- Mandatory possible values: Draft, Active, Inactive
               <MaterialItems>
                       <MaterialItem>
                               <itemProductCode>000011</itemProductCode>    <!-- Mandatory
                               <position>1</position>                       <!-- Optional
                               <quantity>5.000000</quantity>                <!-- Mandatory
                       </MaterialItem>
               </MaterialItems>
               <WorkingHours>
                       <WorkingHour>
                               <description>test working hour</description> <!-- Mandatory
                               <hoursPlanned>6.0000</hoursPlanned>          <!-- Mandatory
                               <position>1</position>                       <!-- Optional
                               <workTask>consulting</workTask>              <!-- Mandatory
                       </WorkingHour>
               </WorkingHours>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>055/11</number>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Bill of materials for number: 055/11 already exists!><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" must be specified., missing mandatory attributes, invalid values, no privileges, Error creating bill of materials  
</response>

1.3 BillOfMaterialsUpdate

Update existing bill of materials.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsUpdate">
       <parameter name="BillOfMaterials">
               <date>2015-05-06</date>                          <!-- Mandatory
               <number>055/11</number>                          <!-- Mandatory
               <productCode>055</productCode>                   <!-- Mandatory
               <productQuantity>10.000000</productQuantity>     <!-- Mandatory
               <status>Active</status>                          <!-- Mandatory possible values: Draft, Active, Inactive
               <MaterialItems>
                       <MaterialItem>
                               <itemProductCode>000011</itemProductCode>    <!-- Mandatory
                               <position>1</position>                       <!-- Optional
                               <quantity>9.000000</quantity>                <!-- Mandatory
                       </MaterialItem>
               </MaterialItems>
               <WorkingHours>
                       <WorkingHour>
                               <description>test working hour</description> <!-- Mandatory
                               <hoursPlanned>7.0000</hoursPlanned>          <!-- Mandatory
                               <position>1</position>                       <!-- Optional
                               <workTask>consulting</workTask>              <!-- Mandatory
                       </WorkingHour>
               </WorkingHours>
       </parameter>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <productCode>PA2521U-2AC3</productCode>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find bill of materials for number: 055/11, missing mandatory attributes, invalid values, no privileges,  
</response>

1.4 BillOfMaterialsDelete

Delete bill of materials.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsDelete">
       <parameter name="number" value="055/11" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>   <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find bill of materials for number: 055/11, Can not delete. Found 3  bill of materials with number 055,
</response>

1.5 BillOfMaterialsList

Get list of bills of materials for specified criteria.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsList">
       <parameter name="number" value="123456" />
       <parameter name="status" value="active"/>
</method>
</request>

<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BillOfMaterialsList">
       <parameter name="dateFrom" value="2015-05-01" />
    <parameter name="dateTo" value="2015-05-26" />
</method>
</request>


Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <BillOfMaterials>
                <!-- structure of bill of materials data is the same as in BillOfMaterialsGet
       </BillOfMaterials>
       <BillOfMaterials>
                <!-- structure of bill of materials data is the same as in BillOfMaterialsGet
       </BillOfMaterials>
       ...
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,  
</response>

2. CreditNote API

2.1 CreditNoteGet

Get credit note by document number, or by combination of document number and date.

Parameters

Example request and response

(For internal "XML" format)

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteGet">
       <parameter name="number" value="1/2013" />
       <parameter name="date" type="Date" value="2013-02-15" />
</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">
       <CreditNote>
               <businessYear>2010</businessYear>
               <buyerCode>123456</buyerCode>   
               <buyerCity>Zagreb</buyerCity>
               <buyerCountry>HR</buyerCountry>
               <buyerName>5 FIVER d.o.o.</buyerName>
               <buyerPostalCode>4240</buyerPostalCode>
               <buyerStreet>ULICA 22</buyerStreet>
               <buyerTaxNumber>75882442</buyerTaxNumber>
               <buyerVatRegistration>None</buyerVatRegistration>
               <city>Zagreb</city>
               <costPosition>1</costPosition>
                <businessUnit>0001</businessUnit>
                <methodOfPayment>bankTransfer</methodOfPayment>
               <date>2010-02-19</date>
               <dateOfSupplyFrom>2010-02-19</dateOfSupplyFrom>
               <paymentDueDate>2010-03-06</paymentDueDate>
               <invoicePricingType>retail</invoicePricingType>
               <number>2010-00002</number>             
               <vatTransactionType>0</vatTransactionType>
                <vatOutgoingDocumentVatClause>Registered</vatOutgoingDocumentVatClause>
               <status>issuedInvoice</status>
               <totalAmount>90.000</totalAmount>
               <totalCurrency>EUR</totalCurrency>
               <totalDiscount>8.33</totalDiscount>
               <totalNetAmount>75.00</totalNetAmount>
               <totalVatAmountLowerRate2>0.00</totalVatAmountLowerRate2>
               <totalVatAmountNormalRate>0.00</totalVatAmountNormalRate>
               <totalVatAmountLowerRate>0.00</totalVatAmountLowerRate>
               <totalVatAmountZeroRate>0.0</totalVatAmountZeroRate>
               <totalVatBaseAmountLowerRate2>0.00</totalVatBaseAmountLowerRate2>
               <totalVatBaseAmountNormalRate>0.00</totalVatBaseAmountNormalRate>
               <totalVatBaseAmountLowerRate>0.00</totalVatBaseAmountLowerRate>
               <totalVatBaseAmountZeroRate>1.55</totalVatBaseAmountZeroRate>
               <reference>05 11290</reference>                         
                <cancelledDocumentRef>2012-00015</cancelledDocumentRef>
                <introductionText>introduction text</introductionText>  
                <vatCountryIsoCode>SI</vatCountryIsoCode>
               <Address>                                 
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                       <Item>
                               <position>1</position>
                               <amount>75.00</amount>
                              <amountWithoutDiscount>83.33</amountWithoutDiscount>
                               <currency>EUR</currency>
                               <description>Prevoz robe</description>
                               <discountAmount>8.33</discountAmount>
                               <discountPercentage>10.0000</discountPercentage>
                               <netPrice>83.33333</netPrice>
                               <netPriceInDocumentCurrency>83.33333</netPriceInDocumentCurrency>
                               <quantity>1.000</quantity>
                               <price>100.00000</price>
                               <priceInDocumentCurrency>100.00000</priceInDocumentCurrency>
                               <vatAmount>15.00</vatAmount>
                               <vatPercentage>20.0</vatPercentage>
                               <vatTransactionType>0</vatTransactionType>
                       </Item>
               </Items>
       </CreditNote>
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="document could not be found"><error/>
</response>

2.2 CreditNoteGetPDF

Get PDF for credit note by document number, or by combination of document number and date. Response (on OK) returns binary record for PDF file coded with Base64 coding.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteGetPDF">
       <parameter name="number" value="2" />
       <parameter name="date" type="Date" value="2010-02-22" />
          <parameter name="markDocumentAsSent" />
</method>
</request>


Response
<response status="ok">
       <number>2</number>
       <date>2010-02-22</date>
       <pdfFile>JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nJVYS4/bNh...</pdfFile>
</response>

Response (on error)
<response status="error">
       <error description="Can not find credit note for number: 2 and date: 2010-02-22">
       </error>
</response>

2.3 CreditNoteCreate

Create new credit note.

Document item can be specified with: productCode, quantity, discountPercentage, or can be specified with: description, currency, quantity, price (retail price including VAT for retail document) or netPrice (gross price without VAT for gross document). Default document type is gross.Additional optional item fields are: discountPercentage, unit, vatPercentage, vatTransactionType.

Supported values for vatTransactionType are:

0 - Taxable transactions of goods and services in Croatia,
1 - Zero-rated transaction - with the right to deduct input VAT,
2 - Zero-rated transaction - without the right to deduct input VAT (domestic),
3 - Transactions excluded from VAT - Other,
4 - Exempt supplies relating to international transport,
7 - Transactions exempt from VAT - not for VAT records,
10 - Transitory item - tourist residence tax,
11 - Transitory item - tourist travel insurance,
12 - Transitory item - other,
13 - Transitory item - return fee for packaging,
14 - Deliveries of goods and services in the Republic of Croatia for which VAT is charged to recipient,
15 - Transactions excluded from VAT - supplies of goods at distance,
16 - Transactions excluded from VAT - services performed in EU,
17 - Transactions excluded from VAT - services performed for tax payers without seat in RH,
18 - Transactions excluded from VAT - deliveries of new means of transport in EU,
19 - Transactions excluded from VAT - supplies of goods in EU,
20 - Transactions excluded from VAT - assembly and installation of goods in EU,
21 - Transactions excluded from VAT - trilateral delivery in EU,
22 - Transactions excluded from VAT - export of goods outside of EU,
23 - Transactions excluded from VAT - supplies of goods in EU customs procedures.
25 - Transactions excluded from VAT - sold goods to tax payers without seat in RH,

Number of credit note which is created from this web service is automatically set if parameter status is set to "issuedInvoice".

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteCreate">
<parameter name="CreditNote">           
               <date>2010-01-13</date>                         <!-- document date
               <dateOfSupplyFrom>2010-02-19</dateOfSupplyFrom>
               <paymentDueDate>2010-03-06</paymentDueDate>             
               <city>Zagreb</city>
               <customerContactPerson></customerContactPerson> <!-- (Optional)
               <type>retail</type>                                     <!-- (Optional) Type of pricing - default is "gross"
               <isReccurringInvoice>false</isReccurringInvoice>
               <vatTransactionType>0</vatTransactionType>              <!-- (Optional) default is 0
               <vatOutgoingDocumentVatClause>Registered</vatOutgoingDocumentVatClause> <!-- (Optional) Possible values: Registered, NotRegistered, RegisteredVATr2
               <costPosition>120</costPosition>                        <!-- (Optional)
               <deliveryMethod>Delivery method</deliveryMethod>        <!-- (Optional)
               <superDiscountPercentage>5</superDiscountPercentage> <!-- (Optional)
               <remarks>Remark on Sales invoice</remarks>              <!-- (Optional)
               <introductionText>introduction text</introductionText>   <!-- (Optional)
               <buyerCode>123456</buyerCode>                   <!-- (Optional). If it is specified buyer parameters bellow are not needed as the buyer data is taken from database. If any parameter bellow is sepcified it will override master buyer data in document
                <buyerDocumentID>60:123456</buyerCode>                  <!-- (Optional). If it is specified buyer parameters bellow are not needed as the buyer data is taken from database. If any parameter bellow is specified it will override master buyer data in document
               <buyerName>ivan novak</buyerName>               
               <buyerTaxNumber>02169711</buyerTaxNumber>       <!-- (Optional)
               <buyerVatRegistration>None</buyerVatRegistration>       <!-- (None, Unknown, RegisteredR1, RegisteredR2)
               <buyerEMail>ivan@novak.com</buyerEMail>                 <!-- (Optional)
               <buyerStreet>Iztokova 22</buyerStreet>                  <!-- (Optional)
               <buyerPostalCode>20000</buyerPostalCode>                <!-- (Optional)
               <buyerCity>Zagreb</buyerCity>                   <!-- (Optional)
               <buyerCountry>SI</buyerCountry>                         <!-- (Optional) ISO-2 country code
               <documentLanguage>Croatian</documentLanguage> <!-- (Optional) Possible document language: Slovene, English, German and Croatian
               <printingTemplate>template</printingTemplate> <!-- (Optional) Setting printing template for document, posible values is code of uploaded templates in web app
               <salesInvoiceRef>2014-00001</salesInvoiceRef> <!-- (Optional) Setting reference to sales invoice
               <advanceInvoiceRef>2014-00001</advanceInvoiceRef> <!-- (Optional) Setting reference to advance invoice
               <methodOfPayment>bankTransfer</methodOfPayment> <!-- Possible ways of payment: Unknown, BankTransfer, Cash, Cheques, EurocardMastercard, Visa, Amex, Diners, ConsumerLoanAneks, ConsumerLoanDiners, InGoods, CashOnDelivery, CashOnDeliveryCourierService, CreditCard, PayPal, Maestro, DirectDebit, Compensation, Other
               <vatCountryIsoCode>SI</vatCountryIsoCode> <!-- Mandatory if using vatTransactionTypes: 15 and it determines that VAT procentages for specified country has to be taken
               <Address>                        <!-- (Optional) Setting delivery address on document and partner buyer if it doesn't exists              
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                       <Item>                                          <!-- item specified with ref to product
                               <position>1</position>      <!-- position of item
                               <productCode>020</productCode>          <!-- product code
                               <quantity>100</quantity>
                               <discountPercentage>10</discountPercentage>
                               <vatTransactionType>0</vatTransactionType> <!-- (Optional) default is 0
                       </Item>
                       <Item>                                          <!-- Item specified for good or service
                               <position>2</position>      <!-- position of item
                               <description>Transport of goods</description>
                               <price>11.00</price>
                               <discountPercentage>2</discountPercentage>      <!-- (Optional)
                               <vatPercentage>10</vatPercentage>               <!-- (Optional)
                               <currency>EUR</currency>                        <!-- (Optional)
                               <quantity>10</quantity>                         <!-- (Optional) default 0
                               <unit>km</unit>                         <!-- (Optional)
                               <vatTransactionType>0</vatTransactionType>      <!-- (Optional) default is 0
                       </Item>
                       ...
               </Items>
       </parameter>
</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" >
       <number>2/2013</number>         <!-- created document ID or number
       <date>2013-01-13</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

2.4 CreditNoteImport

Import Credit note issued in other IS. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating Credit notes with this api call, Credit notes's data must contain code as unique identifier.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteImport">
               <parameter name="importType" value="createOrUpdate" />
               <parameter name="CreditNote">
                    <!-- structure of elements is the same as in CreditNoteCreate only tag <number> is mandatory here
                <parameter/>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>0001-1206-2014</number>
       <date>2013-06-12</date>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
        <error description="Property <number> is required."><error/>  <!-- missing number  
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
                <error description="Credit note for number: 0001-1206-2013 already exists!"></error>  <!-- Credit note for number already exists  
</response>

(Using UBL data format)

<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteImport">
               <parameter name="importType" value="createOrUpdate" />
               <parameter name="dataFormat" value="UBL" />
               <parameter name="base64data">JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+Cn...
                    <!-- UBL XML encoded into base64 string
                <parameter/>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>0001-1206-2014</number>
       <date>2021-06-12</date>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
                <error description="Parameter <base64data>: cannot parse contents"></error>  <!-- Error when decoding XML from base64 string  
</response>

<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
                <error description="Error parsing XML file due to invalid syntax"></error>  <!-- Error when parsing XML
</response>

<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
                <error description="Document can not be overwritten because it is already posted."></error>  <!-- There are several different error messages possible.
</response>

2.5 CreditNoteUpdate

Update existing credit note.Data must contain credit note number to be able to identify document which is to be updated.

Parameters

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="ivan" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" /><login username="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteUpdate">
<parameter name="CreditNote">
         <number>12</number>                                    <!-- document number is mandatory in UPDATE (Can use sequential document number (example: 12), or formatted number (example: 12/2011))
               <!--  Parameters are identical to the parameters in CreditNoteCreate api
       </parameter>
</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" >
       <number>2/2013</number>         <!-- updated document ID or number
       <date>2013-01-13</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

2.6 CreditNoteDelete

Delete credit note. Must specify parameter/s (number, number+date) to identify document for deleting. It is possible to delete only last credit note.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteDelete">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2016-01-13" />
</method>
</request>

Response
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 March 2016 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges,  
</response>

2.7 CreditNoteCancel

Cancel credit note. Must specify parameter/s (number, number+date) to identify document for cancelling.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteCancel">
       <parameter name="number" value="2013-00014" />
       <parameter name="cancellationDocNumber" value="2013-00014" />  <!-- Works only when canceling imported documents where this number is mandatory
       <parameter name="date" type="Date" value="2013-03-26" />
       <parameter name="status" value="draft" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Access denied. User account does not have sufficient privileges for the given request"><error/>     <!-- document could not be found, no privileges,  
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not cancel credit note for arguments number: 2013-00014 date: 2013-03-26"><error/>      <!-- document could not be canceled,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find credit note for number
Can not cancel. Found X credit notes
Found X credit notes X. You can only cancel one credit note at a time
Can not cancel credit note X

2.8 CreditNoteList

Get list of credit notes for criteria which is specified by API parameters. Mixing different types of dates in search criteria is not supported - date parameters can be combined only as follows: dateFrom/dateTo, paymentDueDateFrom/paymentDueDateTo or dateOfSupplyFrom/dateOfSupplyUntil.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteList">
               <parameter name="status" value="issuedInvoice" />
               <parameter name="dateFrom" type="Date" value="2010-02-19" />
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<CreditNotes>                   
       <CreditNote>
                <!-- structure of elements is the same as in CreditNoteGet
       </CreditNote>
       ...
</CreditNotes>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- no privileges,  
</response>

2.9 CreditNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteSendByEmail">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2010-01-13" />
       <parameter name="sender" value="ivan@novak.com"/>
       <parameter name="recipient" value="zoran@novak.com,zlatko@novak.com"/>
       <parameter name="cc" value=""/>
       <parameter name="bcc" value=""/>
       <parameter name="subject" value="TEST d.o.o.: Sales invoice nr. 0002/2010"/>
       <parameter name="message" value="Message text"/>
        <parameter name="useHtmlMessage" value="true"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges, mail sending failed
</response>

2.10 CreditNoteAttachmentAdd

Add image/attachment to credit note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteAttachmentAdd">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to credit note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find credit note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

2.11 CreditNoteAttachmentSetDefault

Add attachment to credit note and set is as default.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteAttachmentSetDefault">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to credit note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find credit note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

2.12 CreditNoteAttachmentGet

Get default attachment of credit note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteAttachmentGet">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <CreditNote>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </CreditNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find credit note for number: 2020-00001 Credit note does not have attachemnts.
</response>

2.13 CreditNoteAttachmentList

Get all images/attachments of article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="CreditNoteAttachmentList">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <CreditNote>
               <Attachments>
                       <Attachment>
                               <fileName>att1.jpg</fileName>
                               <contents encoding="BASE64">1BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att2.jpg</fileName>
                               <contents encoding="BASE64">2BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att3.jpg</fileName>
                               <contents encoding="BASE64">3BASE64</contents>
                       </Attachment>
               </Attachments>
       </CreditNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find credit note for number: 2020-00001 Credit note does not have attachemnts.
</response>

3. DebitNote API

3.1 DebitNoteGet

Get debit note by document number, or by combination of document number and date.

Parameters

Example request and response

(For internal "XML" format)

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteGet">
       <parameter name="number" value="1/2013" />
       <parameter name="date" type="Date" value="2013-02-15" />
</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">
       <DebitNote>
               <businessYear>2010</businessYear>
               <buyerCode>123456</buyerCode>                   
               <buyerCity>RADOVLJICA</buyerCity>
               <buyerCountry>SI</buyerCountry>
               <buyerName>5 FIVER d.o.o.</buyerName>
               <buyerPostalCode>4240</buyerPostalCode>
               <buyerStreet>ULICA 22</buyerStreet>
               <buyerTaxNumber>75882442</buyerTaxNumber>
               <buyerVatRegistration>None</buyerVatRegistration>
               <city>Zagreb</city>
               <costPosition>1</costPosition>
               <businessUnit>0001</businessUnit>
               <date>2010-02-19</date>
               <dateOfSupplyFrom>2010-02-19</dateOfSupplyFrom>
               <paymentDueDate>2010-03-06</paymentDueDate>
               <invoicePricingType>retail</invoicePricingType>
               <number>2010-00002</number>             
               <vatTransactionType>0</vatTransactionType>
               <vatOutgoingDocumentVatClause>Registered</vatOutgoingDocumentVatClause>
               <status>issuedInvoice</status>
               <totalAmount>90.000</totalAmount>
               <totalCurrency>EUR</totalCurrency>
               <totalDiscount>8.33</totalDiscount>
               <totalNetAmount>75.00</totalNetAmount>
               <totalVatAmountLowerRate2>0.00</totalVatAmountLowerRate2>
               <totalVatAmountNormalRate>0.00</totalVatAmountNormalRate>
               <totalVatAmountLowerRate>0.00</totalVatAmountLowerRate>
               <totalVatAmountZeroRate>0.0</totalVatAmountZeroRate>
               <totalVatBaseAmountLowerRate2>0.00</totalVatBaseAmountLowerRate2>
               <totalVatBaseAmountNormalRate>0.00</totalVatBaseAmountNormalRate>
               <totalVatBaseAmountLowerRate>0.00</totalVatBaseAmountLowerRate>
               <totalVatBaseAmountZeroRate>1.55</totalVatBaseAmountZeroRate>
               <reference>05 11290</reference>                         
               <cancelledDocumentRef>2012-00015</cancelledDocumentRef>
               <introductionText>introduction text</introductionText>   
               <vatCountryIsoCode>SI</vatCountryIsoCode>
               <Address>                                   
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                       <Item>
                               <position>1</position>
                               <amount>75.00</amount>
                              <amountWithoutDiscount>83.33</amountWithoutDiscount>
                               <currency>EUR</currency>
                               <description>Prevoz robe</description>
                               <discountAmount>8.33</discountAmount>
                               <discountPercentage>10.0000</discountPercentage>
                               <netPrice>83.33333</netPrice>
                               <netPriceInDocumentCurrency>83.33333</netPriceInDocumentCurrency>
                               <quantity>1.000</quantity>
                               <price>100.00000</price>
                               <priceInDocumentCurrency>100.00000</priceInDocumentCurrency>
                               <vatAmount>15.00</vatAmount>
                               <vatPercentage>20.0</vatPercentage>
                               <vatTransactionType>0</vatTransactionType>
                       </Item>
               </Items>
       </DebitNote>
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="document could not be found"><error/>
</response>

3.2 DebitNoteGetPDF

Get PDF for debit note by document number, or by combination of document number and date. Response (on OK) returns binary record for PDF file coded with Base64 coding.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteGetPDF">
       <parameter name="number" value="2" />
       <parameter name="date" type="Date" value="2010-02-22" />
          <parameter name="markDocumentAsSent" />
</method>
</request>


Response
<response status="ok">
       <number>2</number>
       <date>2010-02-22</date>
       <pdfFile>JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nJVYS4/bNh...</pdfFile>
</response>

Response (on error)
<response status="error">
       <error description="Can not find debit note for number: 2 and date: 2010-02-22">
       </error>
</response>

3.3 DebitNoteCreate

Create new debit note.

Document item can be specified with: productCode, quantity, discountPercentage, or can be specified with: description, currency, quantity, price (retail price including VAT for retail document) or netPrice (gross price without VAT for gross document). Default document type is gross.Additional optional item fields are: discountPercentage, unit, vatPercentage, vatTransactionType. Supported values for vatTransactionType are:

0 - Taxable transactions of goods and services in Croatia,
1 - Zero-rated transaction - with the right to deduct input VAT,
2 - Zero-rated transaction - without the right to deduct input VAT (domestic),
3 - Transactions excluded from VAT - Other,
4 - Exempt supplies relating to international transport,
7 - Transactions exempt from VAT - not for VAT records,
10 - Transitory item - tourist residence tax,
11 - Transitory item - tourist travel insurance,
12 - Transitory item - other,
13 - Transitory item - return fee for packaging,
14 - Deliveries of goods and services in the Republic of Croatia for which VAT is charged to recipient,
15 - Transactions excluded from VAT - supplies of goods at distance,
16 - Transactions excluded from VAT - services performed in EU,
17 - Transactions excluded from VAT - services performed for tax payers without seat in RH,
18 - Transactions excluded from VAT - deliveries of new means of transport in EU,
19 - Transactions excluded from VAT - supplies of goods in EU,
20 - Transactions excluded from VAT - assembly and installation of goods in EU,
21 - Transactions excluded from VAT - trilateral delivery in EU,
22 - Transactions excluded from VAT - export of goods outside of EU,
23 - Transactions excluded from VAT - supplies of goods in EU customs procedures.
25 - Transactions excluded from VAT - sold goods to tax payers without seat in RH,

Number of debit note which is created from this web service is automatically set if parameter status is set to "issuedInvoice".

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteCreate">
<parameter name="DebitNote">            
               <date>2010-01-13</date>                         <!-- document date
               <dateOfSupplyFrom>2010-02-19</dateOfSupplyFrom>
               <paymentDueDate>2010-03-06</paymentDueDate>             
               <city>Zagreb</city>
               <customerContactPerson></customerContactPerson> <!-- (Optional)
               <type>retail</type>                                     <!-- (Optional) Type of pricing - default is "gross"
               <isReccurringInvoice>false</isReccurringInvoice>
               <vatTransactionType>0</vatTransactionType>              <!-- (Optional) default is 0
               <vatOutgoingDocumentVatClause>Registered</vatOutgoingDocumentVatClause> <!-- (Optional) Possible values: Registered, NotRegistered, RegisteredVATr2
               <costPosition>120</costPosition>                        <!-- (Optional)
               <deliveryMethod>Delivery method</deliveryMethod>        <!-- (Optional)
               <superDiscountPercentage>5</superDiscountPercentage> <!-- (Optional)
               <remarks>Remark on Sales invoice</remarks>              <!-- (Optional)
               <introductionText>introduction text</introductionText>   <!-- (Optional)
               <buyerCode>123456</buyerCode>                   <!-- (Optional). If it is specified buyer parameters bellow are not needed as the buyer data is taken from database. If any parameter bellow is sepcified it will override master buyer data in document
                <buyerDocumentID>60:123456</buyerCode>                  <!-- (Optional). If it is specified buyer parameters bellow are not needed as the buyer data is taken from database. If any parameter bellow is specified it will override master buyer data in document
               <buyerName>ivan novak</buyerName>               
               <buyerTaxNumber>02169711</buyerTaxNumber>       <!-- (Optional)
               <buyerVatRegistration>None</buyerVatRegistration>       <!-- (None, Unknown, RegisteredR1, RegisteredR2)
               <buyerEMail>ivan@novak.com</buyerEMail>                 <!-- (Optional)
               <buyerStreet>Iztokova 22</buyerStreet>                  <!-- (Optional)
               <buyerPostalCode>20000</buyerPostalCode>                <!-- (Optional)
               <buyerCity>Zagreb</buyerCity>                   <!-- (Optional)
               <buyerCountry>HR</buyerCountry>                         <!-- (Optional) ISO-2 country code
               <documentLanguage>Croatian</documentLanguage> <!-- (Optional) Possible document language: Slovene, English, German and Croatian
               <printingTemplate>Predloga2</printingTemplate> <!-- (Optional) Setting printing template for document, posible values is code of uploaded templates in web app
               <salesInvoiceRef>2014-00001</salesInvoiceRef> <!-- (Optional) Setting reference to sales invoice
               <vatCountryIsoCode>SI</vatCountryIsoCode> <!-- Mandatory if using vatTransactionTypes: 100, 8 and 5 and it determines that VAT procentages for specified country has to be taken
               <Address>                        <!-- (Optional) Setting delivery address on document and partner buyer if it doesn't exists             
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                       <Item>                                          <!-- item specified with ref to product
                               <position>1</position>      <!-- position of item
                               <productCode>020</productCode>          <!-- product code
                               <quantity>100</quantity>
                               <discountPercentage>10</discountPercentage>
                               <vatTransactionType>0</vatTransactionType> <!-- (Optional) default is 0
                       </Item>
                       <Item>                                          <!-- Item specified for good or service
                               <position>2</position>      <!-- position of item
                               <description>Transport of goods</description>
                               <price>11.00</price>
                               <discountPercentage>2</discountPercentage>      <!-- (Optional)
                               <vatPercentage>10</vatPercentage>               <!-- (Optional)
                               <currency>EUR</currency>                        <!-- (Optional)
                               <quantity>10</quantity>                         <!-- (Optional) default 0
                               <unit>km</unit>                         <!-- (Optional)
                               <vatTransactionType>0</vatTransactionType>      <!-- (Optional) default is 0
                       </Item>
                       ...
               </Items>
       </parameter>
</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" >
       <number>2/2013</number>         <!-- created document ID or number
       <date>2013-01-13</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

3.4 DebitNoteImport

Import Debit note issued in other IS. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating Debit notes with this api call, Debit notes's data must contain code as unique identifier.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteImport">
               <parameter name="importType" value="createOrUpdate" />
               <parameter name="DebitNote">
                    <!-- structure of elements is the same as in DebitNoteCreate only tag <number> is mandatory here
                <parameter/>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>0001-1206-2014</number>
       <date>2013-06-12</date>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
        <error description="Property <number> is required."><error/>  <!-- missing number  
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
                <error description="Debit note for number: 0001-1206-2013 already exists!"></error>  <!-- Debit note for number already exists  
</response>

3.5 DebitNoteUpdate

Update existing debit note.Data must contain debit note number to be able to identify document which is to be updated.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteUpdate">
<parameter name="DebitNote">
         <number>12</number>                                    <!-- document number is mandatory in UPDATE (Can use sequential document number (example: 12), or formatted number (example: 12/2011))
               <!--  Parameters are identical to the parameters in DebitNoteCreate api
       </parameter>
</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" >
       <number>2/2013</number>         <!-- updated document ID or number
       <date>2013-01-13</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

3.6 DebitNoteDelete

Delete debit note. Must specify parameter/s (number, number+date) to identify document for deleting. It is possible to delete only last debit note.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteDelete">
<parameter name="DebitNote">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2016-01-13" />
</parameter>
</method>
</request>

Response
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 March 2016 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges,  
</response>

3.7 DebitNoteCancel

Cancel debit note. Must specify parameter/s (number, number+date) to identify document for cancelling.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteCancel">
       <parameter name="number" value="2013-00014" />
       <parameter name="cancellationDocNumber" value="2013-00014" />  <!-- Works only when canceling imported documents where this number is mandatory
       <parameter name="date" type="Date" value="2013-03-26" />
       <parameter name="status" value="draft" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Access denied. User account does not have sufficient privileges for the given request"><error/>     <!-- document could not be found, no privileges,  
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not cancel debit note for arguments number: 2013-00014 date: 2013-03-26"><error/>       <!-- document could not be canceled,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find debit note for number
Can not cancel. Found X debit notes
Found X debit notes X. You can only cancel one debit note at a time
Can not cancel debit note X

3.8 DebitNoteList

Get list of debit notes for criteria which is specified by API parameters. Mixing different types of dates in search criteria is not supported - date parameters can be combined only as follows: dateFrom/dateTo, paymentDueDateFrom/paymentDueDateTo or dateOfSupplyFrom/dateOfSupplyUntil.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteList">
               <parameter name="status" value="issuedInvoice" />
               <parameter name="dateFrom" type="Date" value="2010-02-19" />
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<DebitNotes>                    
       <DebitNote>
                <!-- structure of elements is the same as in DebitNoteGet
       </DebitNote>
       ...
</DebitNotes>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- no privileges,  
</response>

3.9 DebitNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteSendByEmail">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2010-01-13" />
       <parameter name="sender" value="ivan@novak.com"/>
       <parameter name="recipient" value="zoran@novak.com,zlatko@novak.com"/>
       <parameter name="cc" value=""/>
       <parameter name="bcc" value=""/>
       <parameter name="subject" value="TEST d.o.o.: Sales invoice nr. 0002/2010"/>
       <parameter name="message" value="Message text"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges, mail sending failed
</response>

3.10 DebitNoteAttachmentAdd

Add image/attachment to debit note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteAttachmentAdd">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to debit note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find debit note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

3.11 DebitNoteAttachmentSetDefault

Add attachment to debit note and set is as default.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteAttachmentSetDefault">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to debit note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find debit note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

3.12 DebitNoteAttachmentGet

Get default attachment of debit note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteAttachmentGet">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <DebitNote>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </DebitNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find debit note for number: 2020-00001 Debit note does not have attachemnts.
</response>

3.13 DebitNoteAttachmentList

Get all images/attachments of article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DebitNoteAttachmentList">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <DebitNote>
               <Attachments>
                       <Attachment>
                               <fileName>att1.jpg</fileName>
                               <contents encoding="BASE64">1BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att2.jpg</fileName>
                               <contents encoding="BASE64">2BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att3.jpg</fileName>
                               <contents encoding="BASE64">3BASE64</contents>
                       </Attachment>
               </Attachments>
       </DebitNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find debit note for number: 2020-00001 Debit note does not have attachemnts.
</response>

4. DeliveryNote API

4.1 DeliveryNoteGet

Get delivery note by document number, or by combination of document number and date.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteGet">
       <parameter name="number" value="2012-00014" />
       <parameter name="date" type="Date" value="2012-09-26" />
</method>
</request>

Response
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 November 2012 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
               <DeliveryNote>
               <businessUnit>0001</businessUnit>
               <businessYear>2014</businessYear>
               <buyerCity>Zagreb</buyerCity>
               <buyerCode>123456</buyerCode>    
               <buyerCountry>HR</buyerCountry>
               <buyerEMail>test@hotmail.com</buyerEMail>
               <buyerName>Company, d.o.o.</buyerName>
               <buyerPostalCode>6257</buyerPostalCode>
               <buyerStreet>Precna ulica 1</buyerStreet>
               <buyerVatRegistration>None</buyerVatRegistration>
               <cancelledDocumentRef>2012-00015</cancelledDocumentRef>
               <city>Zagreb</city>
               <costPosition>0001</costPosition>
               <date>2014-03-18</date>
               <dateOfSupply>2014-03-18</dateOfSupply>
               <number>0019/2014</number>
               <salesInvoiceRef>2014-00005</salesInvoiceRef>
               <status>IssuedInvoice</status>
               <totalCurrency>EUR</totalCurrency>
               <totalDiscount>0.0</totalDiscount>
               <totalNetAmount>78.62</totalNetAmount>
               <totalVatAmountFlatRate>0.00</totalVatAmountFlatRate>
               <totalVatAmountNormalRate>7.49</totalVatAmountNormalRate>
               <totalVatAmountLowerRate>4.23</totalVatAmountLowerRate>
               <totalVatAmountZeroRate>0.0</totalVatAmountZeroRate>
               <totalVatBaseAmountFlatRate>0.00</totalVatBaseAmountFlatRate>
               <totalVatBaseAmountNormalRate>34.05</totalVatBaseAmountNormalRate>
               <totalVatBaseAmountLowerRate>44.57</totalVatBaseAmountLowerRate>
               <totalVatBaseAmountZeroRate>0.00</totalVatBaseAmountZeroRate>
               <vatTransactionType>0</vatTransactionType>
               <warehouseCode>8956</warehouseCode>
               <Address>                                  
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                       <Item>
                               <calculationCurrency>EUR</calculationCurrency>
                               <calculationQuantity>-1.000000</calculationQuantity>
                               <costsDirectAmount>0.00000</costsDirectAmount>
                               <costsDirectPercentage>0.00</costsDirectPercentage>
                               <costsOfCustomsAmount>0.00000</costsOfCustomsAmount>
                               <costsOfCustomsPercentage>0.00</costsOfCustomsPercentage>
                               <costsOfTransportAmount>0.00000</costsOfTransportAmount>
                               <costsOfTransportPercentage>0.00</costsOfTransportPercentage>
                               <discountPercentage>0.0000</discountPercentage>
                               <grossMarginAmount>6.69000</grossMarginAmount>
                               <grossMarginPercentage>17.66</grossMarginPercentage>
                               <grossPrice>44.57000</grossPrice>
                               <inboundVatAmount>-3.60000</inboundVatAmount>
                               <inboundVatPercentage>9.50</inboundVatPercentage>
                               <inventoryAmount>-37.88000</inventoryAmount>
                               <inventoryPrice>37.88000</inventoryPrice>
                               <outgoingVatAmount>4.64000</outgoingVatAmount>
                               <outgoingVatPercentage>9.50</outgoingVatPercentage>
                               <position>2</position>
                               <productCode>000013</productCode>
                               <retailMarginAmount>10.96000</retailMarginAmount>
                               <retailMarginPercentage>28.93</retailMarginPercentage>
                               <retailPrice>48.84000</retailPrice>
                               <salesPrice>48.80415</salesPrice>
                               <salesPriceAmount>-48.80415</salesPriceAmount>
                               <supplierAmountInCalculationCurrency>-37.88000</supplierAmountInCalculationCurrency>
                               <supplierDiscountAmount>0.00000</supplierDiscountAmount>
                               <supplierDiscountPercentage>0.00</supplierDiscountPercentage>
                               <supplierPrice>37.88000</supplierPrice>
                               <supplierPriceAmount>-37.88000</supplierPriceAmount>
                               <supplierPriceCurrency>EUR</supplierPriceCurrency>
                               <supplierPriceInCalculationCurrency>37.88000</supplierPriceInCalculationCurrency>
                       </Item>
                       <Item>
                               <calculationCurrency>EUR</calculationCurrency>
                               <calculationQuantity>-2.000000</calculationQuantity>
                               <costsDirectAmount>0.00000</costsDirectAmount>
                               <costsDirectPercentage>0.00</costsDirectPercentage>
                               <costsOfCustomsAmount>0.00000</costsOfCustomsAmount>
                               <costsOfCustomsPercentage>0.00</costsOfCustomsPercentage>
                               <costsOfTransportAmount>0.00000</costsOfTransportAmount>
                               <costsOfTransportPercentage>0.00</costsOfTransportPercentage>
                               <discountPercentage>0.0000</discountPercentage>
                               <grossMarginAmount>17.02459</grossMarginAmount>
                               <grossMarginPercentage>0.00</grossMarginPercentage>
                               <grossPrice>17.02459</grossPrice>
                               <inboundVatAmount>0.00000</inboundVatAmount>
                               <inboundVatPercentage>22.00</inboundVatPercentage>
                               <inventoryAmount>0.00000</inventoryAmount>
                               <inventoryPrice>0.00000</inventoryPrice>
                               <outgoingVatAmount>3.75000</outgoingVatAmount>
                               <outgoingVatPercentage>22.00</outgoingVatPercentage>
                               <position>1</position>
                               <productCode>320003</productCode>
                               <retailMarginAmount>17.02000</retailMarginAmount>
                               <retailMarginPercentage>0.00</retailMarginPercentage>
                               <retailPrice>17.02000</retailPrice>
                               <salesPrice>20.77000</salesPrice>
                               <salesPriceAmount>-41.54000</salesPriceAmount>
                               <supplierAmountInCalculationCurrency>0.00000</supplierAmountInCalculationCurrency>
                               <supplierDiscountAmount>0.00000</supplierDiscountAmount>
                               <supplierDiscountPercentage>0.00</supplierDiscountPercentage>
                               <supplierPrice>0.00000</supplierPrice>
                               <supplierPriceAmount>0.00000</supplierPriceAmount>
                               <supplierPriceCurrency>EUR</supplierPriceCurrency>
                               <supplierPriceInCalculationCurrency>0.00000</supplierPriceInCalculationCurrency>
                       </Item>
               </Items>
       </DeliveryNote>
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not find delivery note for number: XXX and date: XXX"><error/>
</response>

Error messages:
Parameter named "number" is required.
Can not find delivery note for number: XXX and date: XXX

4.2 DeliveryNoteGetPDF

Get PDF for delivery note by document number, or by combination of document number and date. User can also mark document as sent if the correct parameter is used. Response (on OK) returns binary record for PDF file coded with Base64 coding.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteGetPDF">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2009-12-15" />
        <parameter name="markDocumentAsSent" />
</method>
</request>


Response
<response status="ok">
       <number>2012-01293</number>
       <date>2013-01-02</date>
       <pdfFile>JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nJVYS4/bNh...</pdfFile>
</response>

Response (on error)
<response status="error">
       <error description="Can not find delivery note for number: 2013-01293 and date: 2013-01-02">
       </error>
</response>

4.3 DeliveryNoteCreate

Create new delivery note.

Mandatory document attributes are: warehouseCode, dateOfSupply.Mandatory document item attribute is productCode. Other attributes are optional and web service will use default values and those from specified product. Default amount is 1, default date is day of execution. Amounts in item calculations can be specified by prices, amounts or percantages, where related values will be automaticly recalculated.
Additional optional item fields are: calculationQuantity, associatedSerialNumbers, supplierPrice, supplierPriceAmount, supplierPriceCurrency, supplierPriceInCalculationCurrency, supplierAmountInCalculationCurrency, supplierDiscountPercentage, supplierDiscountAmount, costsOfTransportPercentage, costsOfTransportAmount, costsOfCustomsPercentage, costsOfCustomsAmount, inboundVatPercentage, inboundVatAmount, costsDirectPercentage, costsDirectAmount, inventoryPrice, inventoryAmount, grossMarginPercentage, grossMarginAmount, grossPrice, outgoingVatPercentage, outgoingVatAmount, retailMarginAmount, retailMarginPercentage, retailPrice, salesPrice, salesPriceAmount.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteCreate">
<parameter name="DeliveryNote">
               <date>2014-03-26</date>                                 <!-- document date
               <dateOfSupply>2014-03-26</dateOfSupply>                 <!-- date of receival
               <city>Ljubljana</city>                                          <!-- (Optional)
               <businessYear>2012</businessYear>                               <!-- (Optional)
               <purchaseOrder>13</purchaseOrder>                       <!-- (Optional)
               <warehouseCode>8956</warehouseCode>                     <!-- (Mandatory)
               <status>Issued</status>                                 <!-- (Optional)
               <costPosition>120</costPosition>                                <!-- (Optional)
               <deliveryMethod>Delivery method</deliveryMethod>        <!-- (Optional)
               <buyerCode>123456</buyerCode>                   <!-- (Optional). If buyer code is specified, other buyer parameters bellow are not needed as the buyer data is taken from database. If any additional parameter is specified, it will override master buyer data in document
                <buyerDocumentID>60:123456</buyerCode>                  <!-- (Optional). If it is specified buyer parameters bellow are not needed as the buyer data is taken from database. If any parameter bellow is specified it will override master buyer data in document
               <buyerCity>RADOVLJICA</buyerCity>
               <buyerCountry>SI</buyerCountry>
               <buyerName>5 FIVER d.o.o.</buyerName>
               <buyerPostalCode>4240</buyerPostalCode>
               <buyerStreet>ULICA 22</buyerStreet>
               <buyerTaxNumber>75882442</buyerTaxNumber>
               <buyerVatRegistration>None</buyerVatRegistration>
               <vatOutgoingDocumentVatClause>Registered</vatOutgoingDocumentVatClause> <!-- (Optional) Possible values: Registered, NotRegistered, RegisteredVATr2
               <remarks>Remark on delivery note</remarks>              <!-- (Optional)
               <salesInvoiceRef>2014-00001</salesInvoiceRef> <!-- (Optional) Setting reference to sales invoice
               <advanceInvoiceRef>2014-00001</advanceInvoiceRef> <!-- (Optional) Setting reference to advanceinvoice
               <salesQuoteRef>2014-00001</salesQuoteRef> <!-- (Optional) Setting reference to sales quote
               <Address>                        <!-- (Optional) Setting delivery address on document and partner buyer if it doesn't exists             
                       <city>Zagreb</city>
                       <country>HR</country>
                       <postalCode>10000</postalCode>
                       <street>Ilica 10</street>
                       <type>Delivery</type>
               </Address>
               <Items>
                        <Item>                                                          <!-- item specified with ref to product
                               <position>1</position>      <!-- position of item                                
                               <productCode>666666</productCode>                                <!-- product code
                               <calculationQuantity>2</calculationQuantity>                    <!-- quantity (default is 1)
                               <discountPercentage>10</discountPercentage>                     <!-- discount percentage
                               <productName>Product name</productName>                          <!-- change product name if this is enabled on article
                               <description>this is product with code 666666</description>      <!-- change product description if this is enabled on article
                               <remarks>test 1. 2.</remarks>                                    <!-- remarks on delivery note item
                               <associatedSerialNumbers>111, 222</associatedSerialNumbers>      <!-- serial numbers
                               <grossPrice>145,66</grossPrice>                                  <!-- set gross price when document type is "gross" or use <salesPrice> for setting price when document type is "retail"
                              <vatTransactionType>0</vatTransactionType>       <!-- (Optional) default is 0. Foreign VAT transaction types (100, 8 and 5) can only be set on document level.
                       </Item>
                       <Item>
                <position>2</position>      
                               <calculationQuantity>2.000</calculationQuantity>
                               <productCode>666666</productCode>
                       </Item>
                       <Item>
                <position>3</position>     
                               <productCode>666666</productCode>
                               <calculationQuantity>2.000</calculationQuantity>
                       </Item>
                       <Item>   <!-- (default quantity is 1)
                <position>4</position>    
                               <productCode>666666</productCode>
                       </Item>
                        ...
               </Items>
       </parameter>
</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" >
       <number>2014-00014</number>             <!-- created document ID or number
       <date>2014-03-26</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          
</response>

Generic error messages (not related to concrete property):
Access denied. User account does not have sufficient privileges for the given request
Parameter named DeliveryNote needed.
Error creating delivery note (descrition)

Error messages which are related to properties are formated in a a way: "Error nr: N #propertyName - error description"
warehouseCode - Missing warehouse code
warehouseCode - Warehouse does not exist
date - Entry is mandatory
date - Document cannot be issued retroactively because document with later date was already issued.
dateOfSupply - Entry is mandatory

Errors for document items data are formated like shown bellow (X is item sequence number)
ItemX_productCode - Entry is mandatory
ItemX_productCode - Can not find product for code:
ItemX_inboundVatPercentage - Entry is mandatory

4.4 DeliveryNoteUpdate

Update existing delivery note.Data must contain delivery note number to be able to identify document which is to be updated.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteUpdate">
<parameter name="DeliveryNote">
               <!--  Parameters are identical to the parameters in DeliveryNoteCreate api
       </parameter>
</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" >
       <number>2012-00014</number>             <!-- updated document ID or number
       <date>2012-09-26</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- Error messages are returned in format as described in DeliveryNoteCreate api
</response>

4.5 DeliveryNoteDelete

Delete delivery note. Must specify parameter/s (number, number+date) to identify document for deleting.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteDelete">
       <parameter name="number" value="2013-00014" />
       <parameter name="date" type="Date" value="2013-03-26" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find delivery note for number
Can not delete. Found X delivery notes
Data cannot be deleted because they are needed or referenced by other documents or data.

4.6 DeliveryNoteCancel

Cancel delivery note. Must specify parameter/s (number, number+date) to identify document for cancelling.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteCancel">
       <parameter name="number" value="2013-00014" />
       <parameter name="date" type="Date" value="2013-03-26" />
       <parameter name="status" value="draft" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Access denied. User account does not have sufficient privileges for the given request"><error/>     <!-- document could not be found, no privileges,  
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not cancel delivery note for arguments number: 2013-00014 date: 2013-03-26"><error/>    <!-- document could not be canceled,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find delivery note for number
Can not cancel. Found X delivery notes
Found X delivery notes X. You can only cancel one delivery note at a time
Can not cancel credit note X

4.7 DeliveryNoteList

Get list of delivery notes for criteria which is specified by API parameters.

Parameters

status Possible values: Draft, IssuedInvoice, NotBooked, Booked, WithSalesInvoiceReference, WithoutSalesInvoiceReference, Opened, Closed, DocumentSentAlready, DocumentNotYetSent, DocumentSentByEMail, DocumentNotSentByEMail, WithWorkOrderReference, WithoutWorkOrderReference, CancellationDocument, CancelledDocument, DocumentNotSentOrPrinted, NotCancellationOrCancelledDocument, MarkedAsVerified, UnmarkedAsVerified

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteList">
               <parameter name="status" value="Issued" />
               <parameter name="dateFrom" type="Date" value="2012-09-26" />
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<DeliveryNotes>                 
       <DeliveryNote>
                <!-- structure of elements is the same as in DeliveryNoteGet
       </DeliveryNote>
       ...
</DeliveryNotes>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- no privileges,  
</response>

Possible error messages:Access denied. User account does not have sufficient privileges for the given request.Invalid search key!Invalid search value: X

4.8 DeliveryNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteSendByEmail">
       <parameter name="number" value="2012-00014" />
       <parameter name="date" type="Date" value="2012-09-26" />
       <parameter name="sender" value="ivan@novak.com"/>
       <parameter name="recipient" value="zoran@novak.com,zlatko@novak.com"/>
       <parameter name="cc" value=""/>
       <parameter name="bcc" value=""/>
       <parameter name="subject" value="TEST d.o.o.: delivery notes nr. 0002/2010"/>
       <parameter name="message" value="Message text"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges, mail sending failed
</response>

Error messages
Access denied. User account does not have sufficient privileges for the given request.
number   asp.error.MandatoryEntry
stDok - Document does not exist
stDok - More then one document matches criteria !

4.9 DeliveryNoteAttachmentAdd

Add image/attachment to delivery note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteAttachmentAdd">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to delivery note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find delivery note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

4.10 DeliveryNoteAttachmentSetDefault

Add attachment to delivery note and set is as default.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteAttachmentSetDefault">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to delivery note 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find delivery note for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

4.11 DeliveryNoteAttachmentGet

Get default attachment of delivery note.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteAttachmentGet">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <DeliveryNote>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </DeliveryNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find delivery note for number: 2020-00001 Delivery note does not have attachemnts.
</response>

4.12 DeliveryNoteAttachmentList

Get all images/attachments of article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DeliveryNoteAttachmentList">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <DeliveryNote>
               <Attachments>
                       <Attachment>
                               <fileName>att1.jpg</fileName>
                               <contents encoding="BASE64">1BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att2.jpg</fileName>
                               <contents encoding="BASE64">2BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att3.jpg</fileName>
                               <contents encoding="BASE64">3BASE64</contents>
                       </Attachment>
               </Attachments>
       </DeliveryNote>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find delivery note for number: 2020-00001 Delivery note does not have attachemnts.
</response>

5. Document Management API

5.1 DocumentInboxImport

Import electronic document to document inbox. This can be only a document which is unique to a specific organization and which contains all data needed to identify its type and receiver. Examples of such documents include ISO SEPA bank statements in XML, electronic invoices in XML (UBL), etc.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DocumentInboxImport">
       <parameter name="checkExisting" value="true" />
       <parameter name="allOrganizations" value="true" />
       <parameter name="automaticallyImportDocument" value="true" />
       <parameter name="electronicDocument">
                       <documentDate>2012-11-15 12:00:00<documentDate>
                       <fileName>ISO_sepa.xml<fileName>
                       <contents encoding="BASE64">ASDASDASDASD</contents>
        </parameter>
       <parameter name="documentVisualization">
                       <documentDate>2012-11-15 12:00:00<documentDate>
                       <fileName>ISO_sepa.pdf<fileName>
                       <contents encoding="BASE64">ASDASDASDASD</contents>
        </parameter>
</method>
</request>

5.2 DocumentInboxAddEntry

Add new entry to document inbox. This can be either a PDF document, scanned image, XML electronic invoice or even multiple files each of its own type.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DocumentInboxAddEntry">
       <parameter name="checkExisting" value="true" />
       <parameter name="automaticallyImportDocument" value="true" />
       <parameter name="document">
                       <documentDate>2012-11-15 12:00:00</documentDate>
                       <documentNumber>22309-001-003</documentNumber>
                       <documentType>PurchaseInvoice</documentType>    <!-- Document type (Unknown, PurchaseInvoice, ReceivedSalesQuote, BankStatement, Contract, Advertising, ReceivedSalesOrder, ReceivedCreditNote, ReceivedAdvanceInvoice, GoodsReceipt, CashbookDailyTurnoverSummary, SalesInvoice, Compensation, PayrollDocuments, Other, SingleAdministrativeDocument)
                       <senderPartnerIdentifier>88888888</senderPartnerIdentifier>
                       <senderPartnerCode>00001</senderPartnerCode>
                       <senderPartnerName>Test Sender d.o.o.</senderPartnerName>
                       <emailSubject>Incoming mail subject</emailSubject>
                       <mailDescription>Description in incoming mail</mailDescription>
                       <receivedDate>2020-01-01</receivedDate>
                       <Attachments>
                               <Attachment>
                                       <fileName>Invoice.pdf</fileName>
                                       <fileType>PDF</fileType>
                                       <contents encoding="BASE64">ASDASDASDASD</contents>
                               </Attachment>
                               <Attachment>
                                       <fileName>Invoice.xml</fileName>
                                       <fileType>XML</fileType>
                                       <contents encoding="BASE64">ASDASDASDASD</contents>
                               </Attachment>
                       </Attachments>
        </parameter>
</method>
</request>

5.3 DocumentInboxList

List entries in the document management inbox.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="DocumentInboxList">
               <parameter name="status" value="Open" />
               <parameter name="receivalDateFrom" type="Date" value="2017-01-01" />
              <parameter name="receivalDateTo" type="Date" value="2021-01-01" />
       </method>
</request>
</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">
       <Document>
               <businessYear>2021</businessYear>
               <deliveryMethod>ElectronicViaWebServicesAPI</deliveryMethod>
               <description>Incoming mail subject
------------------------------

Description in incoming mail</description>
               <documentDate>2012-11-15</documentDate>
               <documentNumber>22309-001-003</documentNumber>
               <enteredTS>2021-03-18 08:14:01</enteredTS>
               <receivedDate>2020-01-01</receivedDate>
               <senderName>WorldStream B.V.</senderName>
               <sequentialNumber>5</sequentialNumber>
               <status>Open</status>
               <type>PurchaseInvoice</type>
       </Document>
       <Document>
               <businessYear>2021</businessYear>
               <deliveryMethod>ElectronicViaWebServicesAPI</deliveryMethod>
               <description>Incoming mail subject
------------------------------

Description in incoming mail</description>
               <documentDate>2012-11-15</documentDate>
               <documentNumber>22309-001-003</documentNumber>
               <enteredTS>2021-03-18 08:13:10</enteredTS>
               <receivedDate>2020-01-01</receivedDate>
               <senderName>Tastno 2x</senderName>
               <sequentialNumber>4</sequentialNumber>
               <status>Open</status>
               <type>PurchaseInvoice</type>
       </Document>
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Access denied. User account does not have sufficient privileges for the given request"><error/>   <!-- There are several different error messages possible.
</response>

6. E-Banking API

6.1 BankStatementImport

Import bank statement file.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BankStatementImport">
       <parameter name="IBAN" value="HR56 0443 0000 0256 970" />
       <parameter name="type" value="IsoSepaXml" />
       <parametername="statementData" value="D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyIgPz4NCjxEb2N1bWV..."/>
       <parameter name="pdfStatementData" value="JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+Cn..."/>
       <parameter name="pdfStatementFileName" value="test.pdf"/>
</method>
</request>

<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="BankStatementImport">
       <parameter name="payPalAccount" value="payPalAccount@payPal.com" />
       <parameter name="type" value="PayPalCsv" />
       <parametername="statementData" value="D94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9InllcyIgPz4NCjxEb2N1bWV..."/>
       <parameter name="pdfStatementData" value="JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+Cn..."/>
       <parameter name="pdfStatementFileName" value="test.pdf"/>
</method>
</request>

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

Bank statement with attachement.
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
        <statementNumber>Bank statement number 31 was imported</statementNumber>
        <pdfStatementFileName>PDF attachment added</pdfStatementFileName>
</response>

Bank statement without attachement.
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
        <statementNumber>Bank statement number 31 was imported</statementNumber>
        <pdfStatementFileName>No PDF attachment added</pdfStatementFileName>
</response>

Response on error if one of required parameters is missing
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Parameter named <IBAN> is required."><error/>       
</response>

Response on error if iban is not one of your
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Parameter named <IBAN> is not one of your bank accounts"><error/>   
</response>

Response on error if xml data is missing or it is not correct
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Error importing data!"><error/>     
</response>

Response on error if pdf attachement file is corrupted.
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="PDF file is corrupted!"><error/>    
</response>

7. FINA EInvoice API

API for sending document in public procurement to FINA.

7.1 GetFinaReceiverList

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

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>

7.2 SendDocumentToFina

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

Parameter document holds mandatory data:

Response values

StatusCode values are:

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>

7.3 GetDocumentStatusFromFina

Retrieves the status of an already sent document.

Request Parameters

Parameter document holds mandatory data:

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>

8. General Ledger API

8.1 GeneralLedgerGetAccountBalance

Get account balance from the general ledger.

Parameters

Example request and response

Example 1.

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GeneralLedgerGetAccountBalance">
  <parameter name="fiscalYear" value="2014" />
  <parameter name="balanceDate" type="Date" value="2004-01-31" />
  <parameter name="accountNumber" type="String" value="1200" />
  <parameter name="partnerCode" type="String" value="003" />
  <parameter name="voucherStatus" type="String" value="all" />
</method>
</request>

HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 Apr 2009 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <AccountBalance accountNumber="1200" partnerCode="003" balanceCredit="11.00" balanceDebit="12.00" balance="-1.0" currency="EUR">
</response>

8.2 GeneralLedgerAccountStatementGetEntries

Get general ledger account statement entries.

Parameters

Example request and response

Example 1.
POST /WebServicesSI/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="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="GeneralLedgerAccountStatementGetEntries">
  <parameter name="businessYear" value="2018" />
  <parameter name="documentDateFrom" type="Date" value="2018-01-31" />
  <parameter name="documentDateTo" type="Date" value="2018-02-28" />
  <parameter name="accountNumber" type="String" value="1200" />
  <parameter name="partnerCode" type="String" value="003" />
  <parameter name="transactionAmount" type="Decimal" value="50.00" />
</method>
</request>

HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 Apr 2009 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
<AccountStatement>
<businessYear>
<account>
               <Entry>
               <amountDebit>200000.000</amountDebit>
               <costPosition></costPosition>
               <description>KBM-Infond, družba za upravljanje d.o.o.</description>
               <document></document>
               <documentDate>2011-12-31</documentDate>
               <dueDate>2011-12-31</dueDate>
               <generalLedgerAccountNumber>12000</generalLedgerAccountNumber>
               <partner>KBM-Infond, družba za upravljanje d.o.o.</partner>
               <partnerCode>1142</partnerCode>
               <referencedDocument></referencedDocument>
               <sequenceNumber>89</sequenceNumber>
               <status>0</status>
               <transactionDate>2011-12-31</transactionDate>
               <vatDate>2011-12-31</vatDate>
       </Entry>
       <Entry>
               <amountDebit>200000.000</amountDebit>
               <costPosition></costPosition>
               <description>KBM-Infond, družba za upravljanje d.o.o.</description>
               <document></document>
               <documentDate>2011-12-31</documentDate>
               <dueDate>2011-12-31</dueDate>
               <generalLedgerAccountNumber>12000</generalLedgerAccountNumber>
               <partner>KBM-Infond, družba za upravljanje d.o.o.</partner>
               <partnerCode>1142</partnerCode>
               <referencedDocument></referencedDocument>
               <sequenceNumber>268</sequenceNumber>
               <status>0</status>
               <transactionDate>2011-12-31</transactionDate>
               <vatDate>2011-12-31</vatDate>
       </Entry>
       <Entry>
               <amountDebit>200000.000</amountDebit>
               <costPosition></costPosition>
               <description>KBM-Infond, družba za upravljanje d.o.o.</description>
               <document></document>
               <documentDate>2011-12-31</documentDate>
               <dueDate>2011-12-31</dueDate>
               <generalLedgerAccountNumber>12000</generalLedgerAccountNumber>
               <partner>KBM-Infond, družba za upravljanje d.o.o.</partner>
               <partnerCode>1142</partnerCode>
               <referencedDocument></referencedDocument>
               <sequenceNumber>447</sequenceNumber>
               <status>0</status>
               <transactionDate>2011-12-31</transactionDate>
               <vatDate>2011-12-31</vatDate>
       </Entry>
       .....
<AccountStatement>
</response>

9. GoodsReceipt API

9.1 GoodsReceiptGet

Get goods receipt by document number, or by combination of document number and date.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptGet">
       <parameter name="number" value="2012-00014" />
       <parameter name="date" type="Date" value="2012-09-26" />
</method>
</request>

Response
HTTP/1.1 200 OK
Server: e-racuni.com web server
Date: Tue, 1 November 2012 11:00:05 GMT
Content-Type: text/xml
Content-Length: 328

<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <GoodsReceipt>
               <number>2012-00014</number>
               <date>2012-09-26</date>
               <dateOfReceival>2012-09-26</dateOfReceival>
               <businessYear>2012</businessYear>
               <city>Zagreb</city>
               <costPosition>12</costPosition>
               <purchaseOrder>13</purchaseOrder>
               <warehouseCode>8956</warehouseCode>
               <status>Issued</status>
               <remarks>my remarks on: #(10. oktobar 2012 15:26:28)</remarks>
               <supplierCity>Oslo</supplierCity>
               <supplierCode>666000</supplierCode>
               <supplierDeliveryNote>11</supplierDeliveryNote>
               <supplierDeliveryNoteDate>2012-09-26</supplierDeliveryNoteDate>
               <supplierName>6 Partner Buyer Supplier</supplierName>
               <supplierPostalCode>0182</supplierPostalCode>
               <supplierStreet>Brennerivn.11</supplierStreet>
               <supplierTaxNumber>89133749</supplierTaxNumber>
        <cancelledDocumentRef>2012-00015</cancelledDocumentRef> <-- Reference to cancelled document
               <Items>
                       <Item>
                <position>1</position>
                               <productCode>666666</productCode>
                               <calculationQuantity>2.000</calculationQuantity>
                               <associatedSerialNumbers> 222, 111</associatedSerialNumbers>
                               <supplierPrice>10.00000</supplierPrice>
                               <supplierPriceAmount>20.00000</supplierPriceAmount>
                               <supplierPriceCurrency>HRK</supplierPriceCurrency>
                               <supplierPriceInCalculationCurrency>10.00000</supplierPriceInCalculationCurrency>
                               <supplierAmountInCalculationCurrency>20.00000</supplierAmountInCalculationCurrency>
                               <supplierDiscountPercentage>10.00</supplierDiscountPercentage>
                               <supplierDiscountAmount>2.00000</supplierDiscountAmount>
                               <costsOfTransportPercentage>5.00</costsOfTransportPercentage>
                               <costsOfTransportAmount>0.90000</costsOfTransportAmount>
                               <costsOfCustomsPercentage>2.00</costsOfCustomsPercentage>
                               <costsOfCustomsAmount>0.36000</costsOfCustomsAmount>
                               <inboundVatPercentage>20.00</inboundVatPercentage>
                               <inboundVatAmount>3.60000</inboundVatAmount>
                               <costsDirectPercentage>1.00</costsDirectPercentage>
                               <costsDirectAmount>0.18000</costsDirectAmount>
                               <inventoryPrice>9.72000</inventoryPrice>
                               <inventoryAmount>19.44000</inventoryAmount>
                               <grossMarginPercentage>10.00</grossMarginPercentage>
                               <grossMarginAmount>0.97200</grossMarginAmount>
                               <grossPrice>10.69200</grossPrice>
                               <outgoingVatPercentage>20.00</outgoingVatPercentage>
                               <outgoingVatAmount>2.33280</outgoingVatAmount>
                               <retailMarginAmount>1.94400</retailMarginAmount>
                               <retailMarginPercentage>20.00</retailMarginPercentage>
                               <retailPrice>11.66400</retailPrice>
                               <salesPrice>13.99680</salesPrice>
                               <salesPriceAmount>27.99360</salesPriceAmount>
                               <calculationCurrency>HRK</calculationCurrency>  
                       </Item>
               </Items>
       </GoodsReceipt>
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not find goods receipt for number: XXX and date: XXX"><error/>
</response>

Error messages:
Parameter named "number" is required.
Can not find goods receipt for number: XXX and date: XXX

9.2 GoodsReceiptGetPDF

Get PDF for goods receipt by document number, or by combination of document number and date. Response (on OK) returns binary record for PDF file coded with Base64 coding.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptGetPDF">
       <parameter name="number" value="12/2009" />
       <parameter name="date" type="Date" value="2009-12-15" />
</method>
</request>


Response
<response status="ok">
       <number>2012-01293</number>
       <date>2013-01-02</date>
       <pdfFile>JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlci9GbGF0ZURlY29kZT4+CnN0cmVhbQp4nJVYS4/bNh...</pdfFile>
</response>

Response (on error)
<response status="error">
       <error description="Can not find goods receipt for number: 2013-01293 and date: 2013-01-02">
       </error>
</response>

9.3 GoodsReceiptCreate

Create new goods receipt.

Mandatory document attributes are: supplierCode, warehouseCode.Mandatory document item attribute is productCode. Other attributes are optional and web service will use default values and those from specified product. Default amount is 1, default date is day of execution. Amounts in item calculations can be specified by prices, amounts or percantages, where related values will be automaticly recalculated.
Additional optional item fields are: calculationQuantity, associatedSerialNumbers, supplierPrice, supplierPriceAmount, supplierPriceCurrency, supplierPriceInCalculationCurrency, supplierAmountInCalculationCurrency, supplierDiscountPercentage, supplierDiscountAmount, costsOfTransportPercentage, costsOfTransportAmount, costsOfCustomsPercentage, costsOfCustomsAmount, inboundVatPercentage, inboundVatAmount, costsDirectPercentage, costsDirectAmount, inventoryPrice, inventoryAmount, grossMarginPercentage, grossMarginAmount, grossPrice, outgoingVatPercentage, outgoingVatAmount, retailMarginAmount, retailMarginPercentage, retailPrice, salesPrice, salesPriceAmount.

Attribute associatedSerialNumbers is mandatory for products which are declared to use serial numbers (numbers delimited by comma).
Status of document is automatically set to "issued" if parameter number is specified in parameter list, or if it's status is explicitelly set to issued.

Parameters

Special purpose documen item attributes are: inventoryPriceChangeApplyToArticle, grossPriceChangeApplyToArticle, salesPriceChangeApplyToArticle. If some is set to true, related price in product will be modified acording to the price in good receipt item.

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="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="GoodsReceiptCreate">
<parameter name="GoodsReceipt">
               <date>2012-09-26</date>                                 <!-- document date
               <dateOfReceival>2012-09-26</dateOfReceival>             <!-- date of receival
               <city>Zagreb</city>                                             <!-- (Optional)
               <businessYear>2012</businessYear>                               <!-- (Optional)
               <purchaseOrder>13</purchaseOrder>                       <!-- (Optional)
               <warehouseCode>8956</warehouseCode>                     <!-- (Mandatory)
               <status>Issued</status>                                 <!-- (Optional)
               <costPosition>120</costPosition>                                <!-- (Optional)
               <deliveryMethod>Delivery method</deliveryMethod>        <!-- (Optional)
               <superDiscountPercentage>5</superDiscountPercentage>    <!-- (Optional)
               <supplierCode>123456</supplierCode>                     <!-- (Mandatory)
               <supplierDeliveryNote>11</supplierDeliveryNote>         <!-- (Optional)
               <supplierDeliveryNoteDate>2012-09-26</supplierDeliveryNoteDate>
               <remarks>Remark on goods receipt</remarks>              <!-- (Optional)
               <Items>
                       <Item>                                                          <!-- item specified with ref to product
                <position>1</position>      <!-- position of item
                   <productCode>666666</productCode>                           <!-- product code
                               <calculationQuantity>2</calculationQuantity>                    <!-- quantity (default is 1)
                               <associatedSerialNumbers> 222, 111</associatedSerialNumbers>    <!-- serial numbers (a number per calculationQuantity of products)
                               <discountPercentage>10</discountPercentage>                     <!-- discount percentage
                       </Item>
                       <Item>
                <position>2</position>      <!-- position of item
                               <calculationQuantity>2.000</calculationQuantity>
                               <productCode>666666</productCode>
                               <salesPriceAmount>30</salesPriceAmount>                         <!-- sales amount (sales price * calculationQuantity)
                               <associatedSerialNumbers>111, 222</associatedSerialNumbers>
                       </Item>
                       <Item>
                <position>3</position>
                               <productCode>666666</productCode>
                               <calculationQuantity>2.000</calculationQuantity>
                               <supplierPriceAmount>60</supplierPriceAmount>                   <!-- sales amount (sales amount / calculationQuantity)
                               <associatedSerialNumbers>111, 222</associatedSerialNumbers>
                       </Item>
                       <Item>   <!-- (default quantity is 1)
                <position>4</position>
                               <productCode>666666</productCode>
                               <associatedSerialNumbers>123</associatedSerialNumbers>
                               <supplierPrice>30.00</supplierPrice>
                       </Item>
                       <Item>
                <position>5</position>
                               <productCode>666666</productCode>
                               <calculationQuantity>2.000</calculationQuantity>
                               <supplierPrice>10</supplierPrice>
                               <costsOfCustomsPercentage>5.00</costsOfCustomsPercentage>               <!-- customs cost percantage
                               <salesPrice>30</salesPrice>                                                     <!-- sales price
                               <associatedSerialNumbers>111, 222</associatedSerialNumbers>
                               <inventoryPriceChangeApplyToArticle>true</inventoryPriceChangeApplyToArticle>   <!-- special atribute for create and update function
                               <grossPriceChangeApplyToArticle>true</grossPriceChangeApplyToArticle>           <!-- special atribute for create and update function
                               <salesPriceChangeApplyToArticle>true</salesPriceChangeApplyToArticle>           <!-- special atribute for create and update function
                       </Item>
                       ...
               </Items>
       </parameter>
</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" >
       <number>2012-00014</number>             <!-- created document ID or number
       <date>2012-09-26</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          
</response>

Generic error messages (not related to concrete property):
Access denied. User account does not have sufficient privileges for the given request
Parameter named GoodsReceipt needed.
Error creating Goods receipt (descrition)
Goods receipt for number: X already exists!

Error messages which are related to properties are formated in a a way: "Error nr: N #propertyName - error description"
supplierCode - Missing supplier code
supplierCode - Can not find supplier for code:
warehouseCode - Missing warehouse code
warehouseCode - Warehouse does not exist
supplierTaxNumber - Tax number invalid
supplierTaxNumber - ID nr. for VAT invalid
supplierName - Entry is mandatory
city - Entry is mandatory
date - Entry is mandatory
date - Document cannot be issued retroactively because document with later date was already issued.
dateOfReceival - Entry is mandatory

Errors for document items data are formated like shown bellow (X is item sequence number)
ItemX_associatedSerialNumbers - Serial number entry is required for each piece of product.
ItemX_productCode - Entry is mandatory
ItemX_productCode - Can not find product for code:
ItemX_inboundVatPercentage - Entry is mandatory

9.4 GoodsReceiptUpdate

Update existing goods receipt.Data must contain goods receipt number to be able to identify document which is to be updated.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptUpdate">
<parameter name="GoodsReceipt">
               <!--  Parameters are identical to the parameters in GoodsReceiptCreate api
       </parameter>
</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" >
       <number>2012-00014</number>             <!-- updated document ID or number
       <date>2012-09-26</date>                 <!-- date of document
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- Error messages are returned in format as described in GoodsReceiptCreate api
</response>

9.5 GoodsReceiptDelete

Delete sales order. Must specify parameter/s (number, number+date) to identify document for deleting.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptDelete">
       <parameter name="number" value="2012-00014" />
       <parameter name="date" type="Date" value="2012-09-26" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find goods receipt for number
Can not delete. Found X goods receipts
Data cannot be deleted because they are needed or referenced by other documents or data.

9.6 GoodsReceiptCancel

Cancel goods receipt. Must specify parameter/s (number, number+date) to identify document for canceling.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptCancel">
       <parameter name="number" value="2013-00014" />
       <parameter name="date" type="Date" value="2013-03-26" />
       <parameter name="status" value="draft" />
</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">
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Access denied. User account does not have sufficient privileges for the given request"><error/>     <!-- document could not be found, no privileges,  
</response>

Response (on error)
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Can not cancel goods receipt for arguments number: 2013-00014 date: 2013-03-26"><error/>    <!-- document could not be canceled,  
</response>

Possible error messages:
Access denied. User account does not have sufficient privileges for the given request
Parameter named "number" is required
Can not find goods receipt for number
Can not cancel. Found X goods receipts
Found X goods receipts X. You can only cancel one goods receipt at a time
Can not cancel goods receipt X

9.7 GoodsReceiptList

Get list of goods receipts for criteria which is specified by API parameters.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptList">
               <parameter name="status" value="Issued" />
               <parameter name="dateFrom" type="Date" value="2012-09-26" />
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<GoodsReceipts>                 
       <GoodsReceipt>
                <!-- structure of elements is the same as in GoodsReceiptGet
       </GoodsReceipt>
       ...
</GoodsReceipts>
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- no privileges,  
</response>

Possible error messages:Access denied. User account does not have sufficient privileges for the given request.Invalid search key!Invalid search value: X

9.8 GoodsReceiptSendByEmail

Sends document by email to the recipient(s).

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptSendByEmail">
       <parameter name="number" value="2012-00014" />
       <parameter name="date" type="Date" value="2012-09-26" />
       <parameter name="sender" value="ivan@novak.com"/>
       <parameter name="recipient" value="zoran@novak.com,zlatko@novak.com"/>
       <parameter name="cc" value=""/>
       <parameter name="bcc" value=""/>
       <parameter name="subject" value="TEST d.o.o.: Goods receipts nr. 0002/2010"/>
       <parameter name="message" value="Message text"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>


Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="no privileges"><error/>     <!-- document could not be found, no privileges, mail sending failed
</response>

Error messages
Access denied. User account does not have sufficient privileges for the given request.
number   asp.error.MandatoryEntry
stDok - Document does not exist
stDok - More then one document matches criteria !

9.9 GoodsReceiptAttachmentAdd

Add image/attachment to goods receipt.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptAttachmentAdd">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to goods receipt 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find goods receipt for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

9.10 GoodsReceiptAttachmentSetDefault

Add attachment to goods receipt and set is as default.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptAttachmentSetDefault">
       <parameter name="number" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to goods receipt 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find goods receipt for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

9.11 GoodsReceiptAttachmentGet

Get default attachment of goods receipt.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptAttachmentGet">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <GoodsReceipt>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </GoodsReceipt>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find goods receipt for number: 2020-00001 Goods receipt does not have attachemnts.
</response>

9.12 GoodsReceiptAttachmentList

Get all images/attachments of article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="GoodsReceiptAttachmentList">
       <parameter name="number" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <GoodsReceipt>
               <Attachments>
                       <Attachment>
                               <fileName>att1.jpg</fileName>
                               <contents encoding="BASE64">1BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att2.jpg</fileName>
                               <contents encoding="BASE64">2BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att3.jpg</fileName>
                               <contents encoding="BASE64">3BASE64</contents>
                       </Attachment>
               </Attachments>
       </GoodsReceipt>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <number> is required, Can not find goods receipt for number: 2020-00001 Goods receipt does not have attachemnts.
</response>

10. Internalmovement API

10.1 InternalMovementGet

Get internal movements by number.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="InternalMovementGet">
       <parameter name="number" value="055/11" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <InternalMovement>

       </InternalMovement>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find internal movement number: 055/11,  
</response>

10.2 InternalMovementCreate

Create new internal movement.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
       <method name="InternalMovementCreate">
               <parameter name="InternalInventoryChangeDoc">
                       <date>2014-12-13</date>  <!-- Mandatory
                       <status>Issued</status>
                       <remarks>adicijski text</remarks>
                       <warehouseFromCode>MP</warehouseFromCode>  <!-- Mandatory
                       <warehouseCode>8956</warehouseCode>      <!-- Mandatory
                       <Items>
                               <Item>
                                       <calculationQuantity>2</calculationQuantity>   <!-- Mandatory
                    <productCode>666666</productCode>  <!-- Mandatory         
                </Item>
                               <Item>
                                       <calculationQuantity>8</calculationQuantity>   <!-- Mandatory
                    <productCode>666555</productCode>  <!-- Mandatory         
                </Item>
                       </Items>
               </parameter>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>055/11</number>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="internal movement for number: 055/11 already exists!><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" must be specified., missing mandatory attributes, invalid values, no privileges, Error creating internal movement  
</response>

10.3 InternalMovementUpdate

Update existing internal movement.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="InternalMovementUpdate">
       <parameter name="InternalMovement">
                       <date>2014-12-13</date>  <!-- Mandatory
                       <status>Issued</status>
                       <remarks>adicijski text</remarks>
                       <warehouseFromCode>MP</warehouseFromCode>  <!-- Mandatory
                       <warehouseCode>8956</warehouseCode>      <!-- Mandatory
                       <Items>
                               <Item>
                                       <calculationQuantity>2</calculationQuantity>   <!-- Mandatory
                    <productCode>666666</productCode>  <!-- Mandatory         
                </Item>
                               <Item>
                                       <calculationQuantity>8</calculationQuantity>   <!-- Mandatory
                    <productCode>666555</productCode>  <!-- Mandatory         
                </Item>
                       </Items>
       </parameter>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <number>055/11</number>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find internal movement for number: 055/11, missing mandatory attributes, invalid values, no privileges,  
</response>

10.4 InternalMovementDelete

Delete internal movement.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="InternalMovementDelete">
       <parameter name="number" value="055/11" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>   <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "number" is required, Can not find internal movement for number: 055/11, Can not delete. Found 3  internal movement with number 055,
</response>

11. Partner API

11.1 PartnerGetByID

Get partner by partner ID.

Parameters

Example request and response for a natural person

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerGetByID">
       <parameter name="ID" value="59318506371" />
</method>
</request>

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">
       <Partner>
               <personalID>12710048305</personalID>    <!-- Partner OIB
               <ID>0108988710054</ID>                                  <!-- Partner ID
               <partnerCode>666009</partnerCode>               <!-- Partner code.
               <companyType></companyType>             <!-- Type of company. (Contractor, Ltd, Plc, Co, Organization, Subsidiary, Association, Direction, Unit, Division, Edu, Gov, Charity, Cooperative)
               <vatRegistration>None</vatRegistration>         <!-- VAT reg type (Unknown, None, RegisteredR1, RegisteredR2)
               <dateOfRegistration></ dateOfRegistration>              <!-- Company establishment date
               <branchClassification></branchClassification>           <!-- For legal person - Branch classification
               <municipalityCode>037</municipalityCode>
               <municipalityName>BRINJE</municipalityName>
               <firstName>Tester</firstName>                           <!-- For legal person this is the first name of contact person
               <lastName>7 PartnerEmployee</lastName>                          <!-- For legal person is the last name of contact person
               <gender>male</gender>                                           <!-- Type of person sex. (male, female, unknown)
               <maritalStatus>concubinance</maritalStatus>                     <!-- For natural person   (single, married, widowed, concubinance)
               <mobilePhone>555-454123</mobilePhone>
               <fax></fax>
               <dateOfBirth>1945-08-07</dateOfBirth>                           <!-- For natural person only   birth date
               <eMail>milan@kovac.com,zlatko@kovac.com</eMail>         <!-- comma delimited list of emails
               <Addresses>
                       <Address>                               
                               <type>Primary</type>                            <!--Primary address (possible address types are: Invoicing, Primary, Delivery)
                               <street>Iztokova 22</street>
                               <city>Maribor</city>
                               <postalCode>2000</postalCode>
                               <country>SI</country>
                               <telephone>05/625 94 39</telephone>
                               <fax>05/625 94 39</fax>
                               <eMail>test@gmail.com<eMail>
                       </Address>
                       <Address >
                               <type>Invoicing</type>                          <!--Invoicing address, can include tags "firstAddressLine" and "additionalLine" for additional data for invoicing
                               <additionalLine>Test Company</additionalLine>
                               <firstAddressLine>Iztok Kladnik</firstAddressLine>
                               <street>Iztokova 22</street>
                               <city>Maribor</city>
                               <postalCode>2000</postalCode>
                               <country>SI</country>
                               <telephone>05/625 94 39</telephone>
                       </Address>
                       <Address >
                               <type>Delivery</type>                           <!--Delivery address, can include tag "additionalLine" for name of recipient
                               <addressCode>PE0001</addressCode>
                               <additionalLine>Test Company</additionalLine>
                               <street>Iztokova 22</street>
                               <city>Maribor</city>
                               <postalCode>2000</postalCode>
                               <country>SI</country>
                               <telephone>05/625 94 39</telephone>
                       </Address>
               </Addresses>
               <EmployeeData>
                       <amountOfBusTicket>20.00</amountOfBusTicket>
                       <costPosition></costPosition>
                       <distanceFromHomeKm>12.00</distanceFromHomeKm>
                       <ownVehicleModel>audi</ownVehicleModel>
                       <ownVehicleRegNr>mb es-123</ownVehicleRegNr>
                       <status>active</status>
                       <transportRelationToWork>mb-sb</transportRelationToWork>
                       <Employments>
                               <Employment>
                                       <beginDate>2000-02-01</beginDate>
                                       <employmentContractEndDate>2024-02-01</employmentContractEndDate>
                                       <employmentType>craftsman</employmentType>
                                       <grossSalary>8123.0000</grossSalary>
                                       <grossSalaryCalculationFactor>1.020000</grossSalaryCalculationFactor>
                                       <grossSalaryCurrency>HRK</grossSalaryCurrency>
                                       <isHandicappedPerson>0</isHandicappedPerson>
                                       <jobTitle>delavec</jobTitle>
                                       <previousWorkExperienceDays>1</previousWorkExperienceDays>
                                       <previousWorkExperienceMonths>2</previousWorkExperienceMonths>
                                       <previousWorkExperienceYears>3</previousWorkExperienceYears>
                                       <primaryEmployment>0</primaryEmployment>
                                       <sickLeaveOver42hourPrice>2.0000</sickLeaveOver42hourPrice>
                                       <sickLeaveOver42hourPriceCurrency>EUR</sickLeaveOver42hourPriceCurrency>
                                       <workingHoursPerWeek>40.00</workingHoursPerWeek>
                               </Employment>
                       </Employments>
               </EmployeeData>
               <BankAccounts>
                       <BankAccount>
                               <accountNumber>2340009-1110423406</accountNumber>
                               <accountReference>99</accountReference>
                               <bank>NLB</bank>
                               <currency>HRK</currency>
                               <description>Testni racun za partner create 2</description>
                               <IBAN>HR56340001001808119</IBAN>
                               <status>Active</status>
                               <SWIFT>LJBASI2X</SWIFT>
                       </BankAccount>
               </BankAccounts>
                <ContactPersons>
                       <ContactPerson>
                               <contactPersonFullName>Contact person 1</contactPersonFullName>
                               <contactPersonFunction>Programmer</contactPersonFunction>
                               <email>test@gmail.com</eMail>
                               <mobilePhoneNumber>030 999 666</mobilePhoneNumber>
                       </ContactPerson>
                       <ContactPerson>
                               <contactPersonFullName>Contact person 1</contactPersonFullName>
                               <contactPersonFunction>Support</contactPersonFunction>
                               <email>test@gmail.com</eMail>
                               <phone>03 746 4362</phone>
                               <remarks>Leed programmer</remarks>
                       </ContactPerson>
               </ContactPersons>
       </Partner>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Partner not found,  "><error/>      
</response>

11.2 PartnerGetByCode

Get partner by partner code.

Parameters

Example request and response for a legal person

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerGetByCode">
       <parameter name="partnerCode" value="666000" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <Partner>
               <personalID>12710048305</personalID>
               <partnerCode>666000</partnerCode>
               <vatRegistration>RegisteredR1</vatRegistration>
               <branchClassification>G47.762</branchClassification>
               <companyName>6 Partner Buyer Supplier</companyName>
               <companyType>Organization</companyType>
               <eMail>info@neupra.de,micka@kovac.com,zlatko@kovac.com</eMail>
               <firstName>Micka</firstName>
               <lastName>Kovac</lastName>
               <mobilePhone>0511 3423-0</mobilePhone>
               <Addresses>
                       <Address>
                               <city>Oslo</city>
                               <country>NO</country>
                               <postalCode>0182</postalCode>
                               <street>Brennerivn.11</street>
                               <type>Invoicing</type>
                       </Address>
                       <Address>
                               <city>Hannover</city>
                               <country>DE</country>
                               <fax>0511 3423-200</fax>
                               <postalCode>30169</postalCode>
                               <street>Bleichstra e 12</street>
                               <telephone>0511 3423-0</telephone>
                               <type>Delivery</type>
                       </Address>
                       <Address>
                               <city>Oslo</city>
                               <country>NO</country>
                               <fax>(47) 22 11 30 33</fax>
                               <postalCode>0182</postalCode>
                               <street>Brennerivn.11</street>
                               <telephone>(47) 22 11 30 30</telephone>
                               <type>Primary</type>
                       </Address>
               </Addresses>
               <BuyerData>
                       <buyerCode>444000</buyerCode>
                       <costPosition></costPosition>
                       <discountPercentage>5.000</discountPercentage>
                       <numberOfDaysForPayment>20</numberOfDaysForPayment>
                       <numberOfDaysForPaymentBaseDate>fromDocumentDate</numberOfDaysForPaymentBaseDate>
                       <status>trustworthyBuyer</status>
               </BuyerData>
               <SupplierData>
                       <acceptsOrdersReceivedAtLeastDaysInAdvance>30</acceptsOrdersReceivedAtLeastDaysInAdvance>
                       <costPosition></costPosition>
                       <numberOfDaysForPayment>20</numberOfDaysForPayment>
                       <numberOfDaysForPaymentBaseDate>fromDocumentDate</numberOfDaysForPaymentBaseDate>
                       <status>supplierOnBlackList</status>
                       <supplierCode>555000</supplierCode>
               </SupplierData>
               <BankAccounts>
                       <BankAccount>
                               <accountNumber>2340009-1110423406</accountNumber>
                               <accountReference>99</accountReference>
                               <bank>NLB</bank>
                               <currency>HRK</currency>
                               <description>Testni racun za partner create 2</description>
                               <IBAN>HR56340001001808119</IBAN>
                               <status>Active</status>
                               <SWIFT>253</SWIFT>
                       </BankAccount>
               </BankAccounts>
       </Partner>

</response>

11.3 PartnerCreate

Create a new partner (for details about partner data structure see API for PartnerGetByID)

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerCreate">
       <parameter name="Partner">
        <companyName>Tvrtka d.o.o </companyName>
               <personalID>59318506371</personalID>
               <mobilePhone>064/123456</mobilePhone>
               <fax>05/625 94 40</fax>
               <eMail>micka@kovac.com,zlatko@kovac.com</eMail>
               ...
               <!--  optional data in sub elements (see properties in PartnerGetByID)
               <Addresses>
                       <Address>
                               <type></type>   <!--(possible address types are: Invoicing, Primary, Delivery)
                               ...
                       </Address>
               </Addresses>
               <BuyerData></BuyerData>
               <SupplierData></SupplierData>
               <EmployeeData></EmployeeData>
               <BankAccounts>
                       <BankAccount></BankAccount>
               </BankAccounts>
                <ContactPersons>     <!-- Contact persons where structure is the same as displayed in abowe example on Get by ID API call
                       <ContactPerson></ContactPerson>
                </ContactPersons>
        </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

11.4 PartnerUpdate

Update existing partner.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerUpdate">
       <parameter partner>
                <partnerCode>666009</partnerCode>
               <!--other params as in PartnerCreate
        </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

11.5 PartnerDelete

Delete partner.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerDelete">
        <parameter name="ID" value="7369" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>
</response>

11.6 PartnerImport

Import partner by creating new and/or updating existing ones. Parameter importType can be used to specify type of import. If parameter is not specified, createOrUpdate is used as default. For updating partner with this api call, partner's data must contain code as unique identifier.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerImport">
       <parameter name="importType" value="createOrUpdate" />
       <parameter name="partner">              <!-- parameter here is the same as for PartnerUpdate or PartnerCreate depending on importType
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <ID></ID>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>          <!-- missing mandatory attributes, invalid values, no privileges,  
</response>

11.7 PartnerList

Get list of partners for specified criteria.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerList">
       <parameter name="searchKey" type="String" value="Tvrtka D O O" />
       <parameter name="postalCodeOrCity" type="String" value="Zagreb" />
        <parameter name="street" type="String" value="Vladanova" />
       <parameter name="partnerCode" type="String" value="666009" />
       <parameter name="partnerType" value="buyer"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
                <!-- structure of each partner is the same as in PartnerGetByID
       </Partner>
       <Partner>
       </Partner>
       ...
</response>

11.8 PartnerListBuyers

Get list of buyers for specified criteria. Response structure is identical to API "PartnerList"

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerListBuyer">
       <parameter name="buyerCode" type="String" value="111" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
                <!-- structure of each partner is the same as in PartnerGetByID
       </Partner>
       <Partner>
       </Partner>
       ...
</response>

11.9 PartnerListSuppliers

Get list of suppliers for specified criteria. Response structure is identical to API "PartnerList"

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerListSupplier">
       <parameter name="supplierCode" type="String" value="111" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
                <!-- structure of each partner is the same as in PartnerGetByCode
       </Partner>
       <Partner>
       </Partner>
       ...
</response>

11.10 PartnerListEmployees

Get list of employees for specified criteria. Response structure is identical to API "PartnerList"

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerListEmployees">
       <parameter name="partnerCode" type="String" value="666009" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
                <!-- structure of each partner is the same as in PartnerGetByCode
       </Partner>
       <Partner>
       </Partner>
       ...
</response>

11.11 PartnerBuyerCreditLimitGet

Get partner buyer credit limit with unpaid amount by invoices and posted debt.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerBuyerCreditLimitGet">
       <parameter name="partnerCode" value="100011" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <buyerCreditLimit>EUR 20,00</buyerCreditLimit>
       <unpaidInvoicesAmount>EUR 16.278,76</unpaidInvoicesAmount>
       <postedDebt>EUR 5.167,96</postedDebt>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Partner not found, Partner xyz is not defined as buyer!, Buyer kyz does not have defined credit limit or it is below minimum required amount! "><error/>    
</response>

11.12 PartnerGetByDocumentID

Get partner by partner documentID.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerGetByDocumentID">
       <parameter name="documentID" value="34:1234" />
</method>
</request>

11.13 PartnerAttachmentAdd

Add image/attachment to partner.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAttachmentAdd">
       <parameter name="partnerCode" type="String" value="00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to partner 00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required, Can not find partner for code: 00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

11.14 PartnerAttachmentSetDefault

Add attachment to partner and set it as default.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAttachmentSetDefault">
       <parameter name="partnerCode" type="String" value="2020-00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added attachment att.jpg to partner 2020-00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required., Can not find partner for code: 00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

11.15 PartnerAttachmentGet

Get default attachment of partner.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAttachmentGet">
       <parameter name="partnerCode" type="String" value="00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </Partner>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required., Can not find partner for code: 00001, partner does not have attachemnts.
</response>

11.16 PartnerAttachmentList

Get all images/attachments of article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAttachmentList">
       <parameter name="partnerCode" type="String" value="2020-00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
               <Attachments>
                       <Attachment>
                               <fileName>att1.jpg</fileName>
                               <contents encoding="BASE64">1BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att2.jpg</fileName>
                               <contents encoding="BASE64">2BASE64</contents>
                       </Attachment>
                       <Attachment>
                               <fileName>att3.jpg</fileName>
                               <contents encoding="BASE64">3BASE64</contents>
                       </Attachment>
               </Attachments>
       </Partner>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required., Can not find partner for code: 00001, partner does not have attachemnts.
</response>

11.17 PartnerAvatarAdd

Add avatar to partner. If partner already has avatar, old one is removed and new one set.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAvatarAdd">
       <parameter name="partnerCode" type="String" value="00001" />
       <parameter name="attachment">
               <contents encoding="BASE64">BASE64...</contents>
               <fileName>att.jpg</fileName>
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully added avatar att.jpg to partner 00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required, Can not find partner for code: 00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>

11.18 PartnerAvatarGet

Get partner's avatar.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAvatarGet">
       <parameter name="partnerCode" type="String" value="00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Partner>
               <Attachments>
                       <Attachment>
                               <fileName>att.jpg</fileName>
                               <contents encoding="BASE64">BASE64</contents>
                       </Attachment>
               </Attachments>
       </Partner>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required., Can not find partner for code: 00001, partner does not have avatar.
</response>

11.19 PartnerAvatarRemove

Remove partner's avatar.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="PartnerAvatarRemove">
       <parameter name="partnerCode" type="String" value="00001" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <message>Successfully removed avatar att.jpg to partner 00001.</message>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named "partnerCode" or "documentID" is required., Can not find partner for code: 00001, partner does not have avatar.
</response>

12. Product API

12.1 ProductGetByCode

Get product by productCode.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductGetByCode">
       <parameter name="productCode" value="PA2521U-2AC3" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Product>
               <productCode>PA2521U-2AC3</productCode>                 <!-- (Mandatory and Unique)
               <barCode></barCode>                                     <!-- (Optional but must be unique)
               <catalogueCode>V000061280</catalogueCode>               <!-- (Optional)
               <status>active</status>                                 <!-- (Optional   if not specified default is used   true=active, false=inactive = product can not be put on the document
               <type>goodsWithoutStockManagement</type>                <!-- (Optional   if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
               <trackItemsBySerialNumbers>true</trackItemsBySerialNumbers>             <!-- (Optional   default false)
               <name>TOSHIBA charger 15V/ 6A 90 W</name>                               <!-- (one of properties: "name" or "description" is mandatory)
               <description>Toshiba charger for 15V, 6A, 90W, 3-pin</description>                                      <!-- (one of properties: "name" or "description" is mandatory)
               <nameEnglish></nameEnglish>                             <!-- (Optional)
               <descriptionEnglish></descriptionEnglish>               <!-- (Optional)
               <nameGerman></nameGerman>                               <!-- (Optional)
               <descriptionGerman></descriptionGerman>                 <!-- (Optional)
               <productGroupPrimary>01125</productGroupPrimary>        <!-- (Optional)
               <productGroupSecondary>00106</productGroupSecondary>    <!-- (Optional)
               <customProperty1>true</customProperty1>                 <!-- (Optional)
               <customProperty2>leather</customProperty2>              <!-- (Optional)
               <customProperty3>shine</customProperty3>                <!-- (Optional)
               <customProperty4>XL</customProperty4>                   <!-- (Optional)
               <brand>Minoti</brand>                                   <!-- (Optional)
               <costPosition>0001</costPosition>                       <!-- (Optional). This property can be used as product selection criteria for several reports.
               <unit>piece</unit>                                      <!-- (Optional)
               <packingQuantity>5.000</packingQuantity>                <!-- (Optional)
               <minimalStockQuantity>100.0000</minimalStockQuantity>   <!-- (Optional)
               <warrantyPeriod>24</warrantyPeriod>                     <!-- (Optional)
               <weight>0.500000</weight>                               <!-- (Optional)
               <useOfPriceList>false</useOfPriceList>  <!-- (Optional   default false) true=use price list for the product, false=do not use price list for product.
               <vatPercentage>20.0</vatPercentage>     <!-- (Mandatory. Values: 0, 8.5, 20)
               <currency>EUR</currency>                <!-- (Optional)
               <exchangeRate>SlovenianBankMiddleRate</exchangeRate>    <!-- (Optional. Values: SlovenianBankMiddleRate , NLBSellingRate. Default: SlovenianBankMiddleRate)
               <purchasePrice>20.49</purchasePrice>    <!-- (Optional)
               <retailPrice>30.00</retailPrice>        <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
               <grossPrice>25.00</grossPrice>          <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
               <procurementTransactionAccount>760200</procurementTransactionAccount>                           <!-- (Optional)
               <domesticSalesTransactionAccount>760100</domesticSalesTransactionAccount>                       <!-- (Optional)
               <foreignSalesTransactionAccount>760100</foreignSalesTransactionAccount>                         <!-- (Optional)
               <allowChangeOfProductDescriptionOnTheInvoice>false</allowChangeOfProductDescriptionOnTheInvoice> <!-- (Optional   default false)
               <allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice>                          <!-- (Optional   default false)
               <allowChangeOfVatRateOnTheInvoice>false</allowChangeOfVatRateOnTheInvoice>                      <!-- (Optional   default false)
               <invoicingRemarks>Technical documentation for the bottom of the document</invoicingRemarks>     <!-- (Optional)
       </Product>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for code: PA2521U-2AC3,  
</response>

12.2 ProductCreate

Create new product. (for product's data structure look in API for ProductGetByCode). Parameter productCode is optional (if not specified, it will be automatically generated), but if product with such code already exists, error response will be returned.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductCreate">
       <parameter name="product">
               <productCode>PA2521U-2AC3</productCode>                         <!-- (Mandatory and Unique)
               <catalogueCode>V000061280</catalogueCode>                       <!-- (Optional)
               <status>active</status>                                         <!-- (Optional   if not specified default is used   true=active, false=inactive = product can not be put on the document
               <type>goodsWithStockManagement</type>                           <!-- (Optional   if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
               <trackItemsBySerialNumbers>true</trackItemsBySerialNumbers>     <!-- (Optional   default false)
               <name>TOSHIBA charger 15V/ 6A 90 W</name>                       <!-- (one of properties: "name" or "description" is mandatory)
               <description>Toshiba charger for 15V, 6A, 90W, 3-pin</description>      <!-- (one of properties: "name" or "description" is mandatory)
               <productGroupPrimary>01125</productGroupPrimary>                <!-- (Optional)
               <brand>TOSHIBA</brand>                                          <!-- (Optional)
               <unit>piece</unit>                                              <!-- (Optional)
               <packingQuantity>1.000</packingQuantity>                        <!-- (Optional)
               <minimalStockQuantity>10</minimalStockQuantity>                 <!-- (Optional)
               <warrantyPeriod>24</warrantyPeriod>     <!-- (Optional)
               <useOfPriceList>false</useOfPriceList>  <!-- (Optional   default false) true=use price list for the product, false=do not use price list for product.
               <vatPercentage>20.0</vatPercentage>     <!-- (Mandatory. Values: 0, 8.5, 20)
               <currency>EUR</currency>                <!-- (Optional)
               <exchangeRate>SlovenianBankMiddleRate</exchangeRate>            <!-- (Optional. Values: SlovenianBankMiddleRate , NLBSellingRate. Default: SlovenianBankMiddleRate)
               <purchasePrice>20.49</purchasePrice>    <!-- (Optional)
               <retailPrice>30.00</retailPrice>        <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
               <grossPrice>25.00</grossPrice>          <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
               <procurementTransactionAccount>760200</procurementTransactionAccount>                   <!-- (Optional)
               <domesticSalesTransactionAccount>760100</domesticSalesTransactionAccount>               <!-- (Optional)
               <foreignSalesTransactionAccount>760100</foreignSalesTransactionAccount>                 <!-- (Optional)
               <allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice>         <!-- (Optional   default false)
               <allowChangeOfPriceOnTheInvoice>true</allowChangeOfPriceOnTheInvoice>                   <!-- (Optional   default false)
               <allowChangeOfVatRateOnTheInvoice>false</allowChangeOfVatRateOnTheInvoice>              <!-- (Optional   default false)
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <productCode>PA2521U-2AC3</productCode>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Product for productCode: PA2521U-2AC3 already exists!><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <product> must be specified., missing mandatory attributes, invalid values, no privileges, Error creating product  
</response>

12.3 ProductUpdate

Update existing product.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductUpdate">
       <parameter name="product">
               <productCode>PA2521U-2AC3</productCode>                         <!-- (Mandatory and Unique)
               <catalogueCode>V000061280</catalogueCode>                       <!-- (Optional)
               <status>active</status>                                         <!-- (Optional   if not specified default is used   true=active, false=inactive = product can not be put on the document
               <type>product</type>                                            <!-- (Optional   if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
               <trackItemsBySerialNumbers>true</trackItemsBySerialNumbers>     <!-- (Optional   default false)
               <name>TOSHIBA charger 15V/ 6A 90 W </name>                      <!-- (one of properties: "name" or "description" is mandatory)
               <description>Toshiba charger for 15V, 6A, 90W, 3-pin</description>                                      <!-- (one of properties: "name" or "description" is mandatory)
               <unit>piece</unit>                                                      <!-- (Optional)
               <packingQuantity>1.000</packingQuantity>                                <!-- (Optional)
               <minimalStockQuantity>20</minimalStockQuantity>                         <!-- (Optional)
               <warrantyPeriod>36</warrantyPeriod>     <!-- (Optional)
               <vatPercentage>20.0</vatPercentage>     <!-- (Mandatory. Values: 0, 8.5, 20)
               <currency>EUR</currency>                        <!-- (Mandatory)
               <purchasePrice>20.49</purchasePrice>    <!-- (Optional)
               <retailPrice>30.00</retailPrice>                <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
               <grossPrice>25.00</grossPrice>          <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
               <allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice>                 <!-- (Optional   default false)
               <allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice>          <!-- (Optional   default false)
               <allowChangeOfVatRateOnTheInvoice>true</allowChangeOfVatRateOnTheInvoice>       <!-- (Optional   default false)
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <productCode>PA2521U-2AC3</productCode>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/> <!-- Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <product> needed, Product's property <productCode> is required, Can not find product for productCode: PA2521U-2AC3, missing mandatory attributes, invalid values, no privileges,  
</response>

12.4 ProductPriceCalculationUpdate

Update product's price calculation.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
       <method name="ProductPriceCalculationUpdate">
                  <parameter name="productCode" value="000001" />
                  <parameter name="applyPricesToArticle" type="Boolean" value="true" />
                  <parameter name="priceCalculation">
                               <calculationCurrency>EUR</calculationCurrency>
                               <costsDirectAmount>0.00000</costsDirectAmount>
                               <costsDirectPercentage>0.00</costsDirectPercentage>
                               <costsOfCustomsAmount>0.00000</costsOfCustomsAmount>
                               <costsOfCustomsPercentage>0.00</costsOfCustomsPercentage>
                               <costsOfTransportAmount>0.00000</costsOfTransportAmount>
                               <costsOfTransportPercentage>0.00</costsOfTransportPercentage>
                               <grossMarginAmount>7.00000</grossMarginAmount>
                               <grossMarginPercentage>38.89</grossMarginPercentage>
                               <grossPrice>25.00000</grossPrice>
                               <inboundVatAmount>0.00000</inboundVatAmount>
                               <inboundVatPercentage>0.00</inboundVatPercentage>
                               <inventoryPrice>18.00000</inventoryPrice>
                               <outgoingVatAmount>5.94000</outgoingVatAmount>
                               <outgoingVatPercentage>22.00</outgoingVatPercentage>
                               <retailMarginAmount>9.00000</retailMarginAmount>
                               <retailMarginPercentage>50</retailMarginPercentage>
                               <retailPrice>27.00000</retailPrice>
                               <salesPrice>32.94000</salesPrice>
                               <supplierDiscountAmount>0.00000</supplierDiscountAmount>
                               <supplierDiscountPercentage>0.00</supplierDiscountPercentage>
                               <supplierPrice>18.00000</supplierPrice>
                               <supplierPriceCurrency>EUR</supplierPriceCurrency>
                               <supplierPriceInCalculationCurrency>18.00000</supplierPriceInCalculationCurrency>
                  </parameter>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
    <message>Successfully updated price calculation for product with code 00001</message>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>   <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for productCode: PA2521U-2AC3
</response>

12.5 ProductMassPriceCalculationUpdate

Update up to 5000 product's price calculations. In this case only 3 basic prices can be updated which are supplier price, gross price and sales price.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductMassPriceCalculationUpdate">
               <parameter name="applyPricesToArticle"  type="Boolean" value="true"/>
          <parameter name="priceCalculations">
                  <PriceCalculations>
                               <PriceCalculation>
                                       <productCode>36457558</productCode>
                                       <supplierPrice>10.50</supplierPrice>
                                       <grossPrice>30.44</grossPrice>
                                       <salesPrice>40.99</salesPrice>
                               </PriceCalculation>
                               <PriceCalculation>
                                       <productCode>000009</productCode>
                                       <supplierPrice>11.50</supplierPrice>
                                       <grossPrice>32.44</grossPrice>
                                       <salesPrice>42.99</salesPrice>
                               </PriceCalculation>
                               <PriceCalculation>
                                       <productCode>000010</productCode>
                                       <supplierPrice>13.50</supplierPrice>
                                       <grossPrice>36.44</grossPrice>
                                       <salesPrice>47.99</salesPrice>
                               </PriceCalculation>
                       </PriceCalculations>
               </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <36457559>Product for code 36457559 successfully imported.</36457559>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!--Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Maximum number of  price calculations for update exceeded, Product for code 0099 not foud.
</response>

12.6 ProductDelete

Delete product.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductDelete">
       <parameter name="productCode" value="PA2521U-2AC3" />
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>   <! Possible errors: Access denied. User account does not have sufficient privileges for the given request, Parameter named <productCode> is required, Can not find product for productCode: PA2521U-2AC3, Can not delete. Found 3  product with productCode: PA2521U-2AC3,
</response>

12.7 ProductImport

Import product by creating new and/or updating existing ones. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating product with this api call, product's data must contain code as unique identifier.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductImport">
       <parameter name="importType" value="createOrUpdate" />
       <parameter name="product">              <!-- parameter here is the same as for ProductUpdate or ProductCreate depending on importType
               <productCode>PA2521U-2AC3</productCode>                         <!-- (Mandatory and Unique)
               <catalogueCode>V000061280</catalogueCode>                       <!-- (Optional)
               <status>active</status>                                         <!-- (Optional   if not specified default is used   true=active, false=inactive = product can not be put on the document
               <type>product</type>                                            <!-- (Optional   if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
               <trackItemsBySerialNumbers>true</trackItemsBySerialNumbers>     <!-- (Optional   default false)
               <name>TOSHIBA charger 15V/ 6A 90 W </name>                      <!-- (one of properties: "name" or "description" is mandatory)
               <description>Toshiba charger for 15V, 6A, 90W, 3-pin</description>                                      <!-- (one of properties: "name" or "description" is mandatory)
               <unit>piece</unit>                                                      <!-- (Optional)
               <packingQuantity>1.000</packingQuantity>                                <!-- (Optional)
               <minimalStockQuantity>20</minimalStockQuantity>                         <!-- (Optional)
               <warrantyPeriod>36</warrantyPeriod>     <!-- (Optional)
               <vatPercentage>20.0</vatPercentage>     <!-- (Mandatory. Values: 0, 8.5, 20)
               <currency>EUR</currency>                        <!-- (Optional)
               <purchasePrice>20.49</purchasePrice>    <!-- (Optional)
               <retailPrice>30.00</retailPrice>                <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
               <grossPrice>25.00</grossPrice>          <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
               <allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice>                 <!-- (Optional   default false)
               <allowChangeOfPriceOnTheInvoice>false</allowChangeOfPriceOnTheInvoice>          <!-- (Optional   default false)
               <allowChangeOfVatRateOnTheInvoice>true</allowChangeOfVatRateOnTheInvoice>       <!-- (Optional   default false)
       </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <parameter name="productCode" value="PA2521U-2AC3" />
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!--Possible errors:  Access denied. User account does not have sufficient privileges for the given request, missing mandatory attributes, invalid
</response>

12.8 ProductMassImport

Import up to 5000 products with basic data, by creating new and/or updating existing ones. Parameter 'importType' can be used to specify type of import. If parameter is not specified, "createOrUpdate" is used as default. For updating product with this api call, product's data must contain code as unique identifier.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductMassImport">
       <parameter name="importType" value="createOrUpdate" />
          <parameter name="products">
                  <Products>
                               <Product>
                                       <productCode>36457558</productCode>     <!-- (Mandatory and Unique)
                                       <name>Mass import product 1</name>      <!-- (one of properties: "name" or "description" is mandatory)
                                       <description>Mass import product 1 description</description>        <!-- (one of properties: "name" or "description" is mandatory)
                                       <vatPercentage>22</vatPercentage>         <!-- (Mandatory. Values: 0, 9.5, 22)
                                       <currency>EUR</currency>         <!-- (Optional)
                                       <unit>pc</unit>         <!-- (Optional)
                                       <allowChangeOfProductDescriptionOnTheInvoice>true</allowChangeOfProductDescriptionOnTheInvoice>
                                       <status>active</status>                                         <!-- (Optional   if not specified default is used   true=active, false=inactive = product can not be put on the document
                                       <type>product</type>                                            <!-- (Optional   if not specified default is used - goodsWithoutStockManagement). Possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license.
                                       <purchasePrice>20.49</purchasePrice>    <!-- (Optional)
                                       <retailPrice>30.00</retailPrice>                <!-- for types of products other then: "rawMaterial" and "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified.
                                       <grossPrice>25.00</grossPrice>          <!-- for types of product: "rawMaterial" or "intermediateProduct", one of product properties: retailPrice or grossPrice must be specified
                               </Product>
                               ....
                       </Products>
               </parameter>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <36457559>Product for code 36457559 successfully imported.</36457559>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!--Possible errors:  Access denied. User account does not have sufficient privileges for the given request, missing mandatory attributes, Product for code 0099 not foud.,  Product for code 8847 already exists.
</response>

12.9 ProductList

Get list of products for specified criteria.

Parameters

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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductList">
       <parameter name="searchKey" type="String" value="" />
       <parameter name="productCode" value="123456" />
       <parameter name="barCode" value="" />
       <parameter name="brand" type="String" value="Samsung" />
       <parameter name="status" value="active"/>
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <Product>
                <!-- structure of product data is the same as in ProductGetByCode
       </Product>
       <Product>
                <!-- structure of product data is the same as in ProductGetByCode
       </Product>
       ...
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,  
</response>

12.10 ProductPriceListGet

Get price list for product if used for specified product.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductPriceListGet">
       <parameter name="productCode" value="123456" />
       <parameter name="priceListCurrency" value="EUR" />
       <parameter name="priceListDate" value="2014-11-13" />
</method>
</request>


Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
       <PriceListItem>
               <grossPrice>160.00000</grossPrice>
               <productPriceListCurrency>EUR</productPriceListCurrency>
               <purchasePrice>101.00000</purchasePrice>
               <retailPrice>300.00000</retailPrice>
               <validFrom>2014-11-11</validFrom>
               <validTo>2014-11-13</validTo>
       </PriceListItem>
               <PriceListItem>
               <grossPrice>170.00000</grossPrice>
               <productPriceListCurrency>EUR</productPriceListCurrency>
               <purchasePrice>106.00000</purchasePrice>
               <retailPrice>366.00000</retailPrice>
               <validFrom>2014-12-11</validFrom>
               <validTo>2015-01-13</validTo>
       </PriceListItem>
       ...
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Access denied. User account does not have sufficient privileges for the given request, Invalid search keys, invalid values, no privileges,  
</response>

<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description="Use of price list for this product is disabled."><error/>
</response>

12.11 ProductPriceDiscountActionList

Get price discount action list for given article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
<method name="ProductPriceDiscountActionList">
       <parameter name="productCode" type="String" value="000001" />
       <parameter name="productGroupCode" type="String" value="ABC" />
       <parameter name="buyerGroupCode" type="String" value="101" />
       <parameter name="warehouseCode" type="String" value="WH01" />
       <parameter name="validFrom" type="Date" value="2021-05-01" />
       <parameter name="validTo" type="Date" value="2021-05-31" />      
</method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <ProductPriceDiscountAction>
               <discountPercentage>50.0000</discountPercentage>
               <productCode>000001</productCode>
               <validFrom>2021-05-10</validFrom>
               <validTo>2021-05-14</validTo>
       </ProductPriceDiscountAction>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, No price discount actions were found matching search criteria!
</response>

12.12 ProductPriceDiscountActionAdd

Add price discount action list for given article.

Parameters

Example request and response

POST /WebServicesSI/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="ivan" md5pass="8b29582ce0a1c85dc0c574d218acb900" token="649026C063054A139549200F3C9D01C6" />
       <method name="ProductPriceDiscountActionAdd">
                  <parameter name="priceDiscountAction">
                               <productCode>00001</productCode>
                               <articleGroupCode>AR01</articleGroupCode>
                               <buyerGroupCode>BY01</buyerGroupCode>
                               <warehouseCode>00001</warehouseCode>
                               <discountPercentage>34.00</discountPercentage>
                               <validFrom>2022-01-01</validFrom>
                               <validTo>2022-04-01</validTo>
                  </parameter>
       </method>
</request>

Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok">
       <message>Successfully added price discount action for product with code 00001.</message>
</response>

Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
       <error description=""><error/>  <!-- Possible errors:  Access denied. User account does not have sufficient privileges for the given request, Can not find product for code: 9999.
</response>