API Reference

For a complete and up-to-date API reference open the following link:

https://e-racuni.com/obracuni/ApiDocumentation

Check articles below for examples on how to use the API:

Invoicing API - SalesInvoice API [23]
SalesOrder API [24]
SalesQuote API [25]
AdvanceInvoice API [1]
DebitNote API [4]
CreditNote API [3]
DeliveryNote API [5]
Partner API [14]
Warehouse API [27]
Product API [16]
ProductGroup API [17]
GoodsReceipt API [12]
PurchaseOrder API [18]
GeneralLedger API [8]
GeneralLedgerJournalVoucher API [9]
BillOfMaterials API [2]
E-Banking API [7]
TABooking API [26]
IntraWarehouseTransfer API [13]
ReceivedInvoice API [21]
ReceivedAdvanceInvoice API [19]
ReceivedCreditNote API [20]
WorkOrder API [28]
Document Management API [6]
Reporting API [22]

1. AdvanceInvoice API

AdvanceInvoiceGet	Get advance invoice by document number, or by combination of document number and date.
AdvanceInvoiceGetPDF	Get PDF file for advance invoice by document number, or by combination of document number and date.
AdvanceInvoiceCreate	Create new advance invoice.
AdvanceInvoiceImport	Import advance invoice issued in other IS.
AdvanceInvoiceUpdate	Update existing advance invoice.
AdvanceInvoiceDelete	Delete advance invoice.
AdvanceInvoiceCancel	Cancel advance invoice.
AdvanceInvoiceList	Get list of advance invoices for specified criteria
AdvanceInvoiceSendByEmail	Sends document by email to the recipient(s).
AdvanceInvoiceAttachmentAdd	Add attachment to advance invoice.
AdvanceInvoiceAttachmentSetDefault	Add attachment to advance invoice and set is as default.
AdvanceInvoiceAttachmentGet	Get default attachment of advance invoice.
AdvanceInvoiceAttachmentList	Get all attachments of advance invoice.

1.1 AdvanceInvoiceGet

Get advance invoice by document number, or by combination of document number and date.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

(For internal "XML" format)

1.2 AdvanceInvoiceGetPDF

Get PDF for advance invoice 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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.
markDocumentAsSent	Marks document as sent.

Example request and response

1.3 AdvanceInvoiceCreate

Create new advance invoice.

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 domestic transactions of goods and services // Obdavčen promet blaga in storitev v Sloveniji
4 - Zero-rated transaction - supply of goods within the EU // Oproščen promet - dobava blaga znotraj EU
104 - Vat free transaction - supply of goods in EU by customs procedure 42 and 63 // Oproščen promet - dobava blaga znotraj EU po carinskih postopkih 42 in 63
6 - Zero-rated transaction - tripartite supplies of goods within the EU // Oproščen promet - tristranske dobave blaga znotraj EU
11 - Sales of services in the EU, VAT reverse charge // Oproščen promet - storitve v EU, od katerih plača DDV prejemnik
103 - Vat free transaction - supply of goods in EU by call-of-stock arrangement // Oproščen promet - dobava blaga znotraj EU po skladiščenju na odpoklic
1 - Zero-rated transaction - exports of commodity outside the EU // Oproščen promet - izvoz blaga izven EU
3 - Zero-rated transaction with the right to deduct input VAT // Oproščen promet - s pravico do odbitka vstopnega DDV
2 - Zero-rated transaction - without the right to deduct input VAT // Oproščen promet - brez pravice do odbitka vstopnega DDV
9 - Transactions exempt from VAT with the right of input VAT deduction (transactions outside SLO) // Neobdavčljiv promet s pravico do odbitka vstopnega DDV (prometi izven SLO)
7 - not subject to VAT // Neobdavčen promet - ne gre v DDV evidence
12 - Nontaxable suply - other taxes or duties other than VAT // Neobdavčen promet - ostali davki oziroma dajatve (razen DDV)
105 - Not subject to VAT – supply of goods outside EU // Neobdavčen promet - dobava blaga zunaj Unije (tretje države)
10 - Supply of goods and services in Slovenia, VAT reverse charged by the recipient // Dobava blaga in storitev v SLO, DDV obračuna prejemnik (76.a člen)
5 - Zero-rated transaction - assembly in the EU // Oproščen promet - montaža v EU (obračun tujega DDV)
8 - Distance selling in the EU surpassing annual sales threshold (foreign VAT) // Oproščen promet - prodaja blaga na daljavo (obračun tujega DDV)
101 - Special vat margin calculation for used goods // Posebna ureditev za rabljeno blago
102 - Special vat margin calculation for used goods - tax free // Posebna ureditev za rabljeno blago - oproščen promet
13 - Special vat margin calculation for travel agencies - price difference taxed // Obdavčen promet - posebni postopek obdavčitve razlike v ceni za potovalne agencije (98. člen)
14 - VAT exempt transactions for travel agencies // Oproščen promet za potovalne agencije (99. člen)
100 - Electronic services in other EU member countries (OSS) // Prodaja elektronskih storitev v drugih članicah EU (OSS)
106 - Distance sales of goods to EU consumers (OSS) // Prodaja blaga na daljavo končnim potrošnikom v EU (OSS)
107 - Supply of services to EU consumers (OSS) // Prodaja storitev končnim potrošnikom v EU (OSS)
108 - Distance sales of imported goods to EU consumers (IOSS) // Prodaja na daljavo iz tretjih držav uvoženega blaga končnim potrošnikom v EU (IOSS)
120 - Supply of services from EU to third country consumers (foreign VAT) // Izvoz storitev iz EU končnim potrošnikom v državi izven EU (obračun tujega DDV)
121 - Distance sales of goods to consumers outside EU (foreign VAT) // Prodaja blaga na daljavo končnim potrošnikom v državi izven EU (obračun tujega DDV)

Before using vat transaction types for OSS and IOSS, you must set up registration for OSS and IOSS in company settings under foreign VAT registrations.

Parameters

AdvanceInvoice

Complex parameter with data tags

Example request and response

1.4 AdvanceInvoiceImport

Import advance invoice 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 advance invoices with this api call, advance invoices's data must contain code as unique identifier.

Parameters

importType	Flag for the type of import
AdvanceInvoice	Advance invoice data in xml substructure.
dataFormat	In case some other data format is used for import, this parameter should be used. Possible values are defaul data format "eracuniXML" and "ESLOG". If this parameter is not included in XML, import from default data format is used.
base64data	This parameter is mandatory in case using dataFormat "ESLOG". Content of this parameter should be eSlog XML encoded into base64 string.

Example request and response

1.5 AdvanceInvoiceUpdate

Update existing advance invoice.Data must contain advance invoice number to be able to identify document which is to be updated.

Parameters

AdvanceInvoice

Complex parameter with data tags

Example request and response

1.6 AdvanceInvoiceDelete

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book

Example request and response

1.7 AdvanceInvoiceCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.
cancellationDocNumber	Number of cancellation document (mandatory and works only for imported documents).

Example request and response

1.8 AdvanceInvoiceList

Get list of advance invoices 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, prepaymentDateFrom/prepaymentDateTo or dateOfSupplyFrom/dateOfSupplyUntil.

Parameters

number	Document number
dateFrom	The date which is used to select advance invoices whose date is following it
dateTo	The date which is used to select advance invoices whose date is preceding it
prepaymentDateFrom	The date which is used to select advance invoices whose date of prepayment is following it
prepaymentDateTo	The date which is used to select advance invoices whose date of prepayment is preceding it
dateOfSupplyFrom	The date which is used to select advance invoices whose date of supply/performance is following it
dateOfSupplyUntil	The date which is used to select advance invoices whose date of supply/performance is preceding it
deliveryAddress	Delivery address of the buyer
buyer	Buyer code, or buyer name
costPosition	Cost position code
totalAmount	Total amount of the advance invoices
totalCurrency	Currency used in advance invoice
article	Product code, or product name
status	Possible values: Draft, IssuedInvoice, NotBooked, Booked, CanceledCreditInvoice, OpenedClaim, ClosedClaim, OpenedDueClaim, DocumentSentAlready, DocumentNotYetSent, DocumentSentByEMail, DocumentNotSentByEMail, CancellationDocument, CancelledDocument, HasOpenAmountForSalesInvoice, HasNoOpenAmountForSalesInvoice, AccountingEntryOrImportedInvoice, DocumentNotSentOrPrinted, NotCancellationOrCancelledDocument, VatReportDone, VatReportOpen.
issuer	Issuer of document, search is done by username

Example request and response

1.9 AdvanceInvoiceSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

1.10 AdvanceInvoiceAttachmentAdd

Add image/attachment to advance invoice.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

1.11 AdvanceInvoiceAttachmentSetDefault

Add attachment to advance invoice and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

1.12 AdvanceInvoiceAttachmentGet

Get default attachment of advance invoice.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

1.13 AdvanceInvoiceAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

2. BillOfMaterials API

BillOfMaterialsGet	Get bill of materials by number.
BillOfMaterialsCreate	Create new bill of materials.
BillOfMaterialsUpdate	Update existing bill of materials.
BillOfMaterialsDelete	Delete bill of materials.
BillOfMaterialsList	Get list of bills of materials for specified criteria.

2.1 BillOfMaterialsGet

Get bill of materials by number.

Parameters

number	Number of bill of materials.
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

2.2 BillOfMaterialsCreate

Create new bill of materials.

Parameters

BillOfMaterials

Bill of materials's data in xml substructure.

Example request and response

2.3 BillOfMaterialsUpdate

Update existing bill of materials.

Parameters

BillOfMaterials

Product's data in xml substructure

Example request and response

2.4 BillOfMaterialsDelete

Delete bill of materials.

Parameters

number

Unique identifier for bill of materials.

Example request and response

2.5 BillOfMaterialsList

Get list of bills of materials for specified criteria.

Parameters

number	BillOfMaterials number.
dateFrom	Search by bill of materials date range.
dateTo	Search by bill of materials date range.
article	Search by material.
status	Usage status (Active, Inactive, Draft)

Example request and response

3. CreditNote API

CreditNoteGet	Get credit note by document number, or by combination of document number and date.
CreditNoteGetPDF	Get PDF file for credit note by document number, or by combination of document number and date.
CreditNoteCreate	Create new credit note.
CreditNoteImport	Import credit note issued in other IS.
CreditNoteUpdate	Update existing credit note.
CreditNoteDelete	Delete credit note.
CreditNoteCancel	Cancel credit note.
CreditNoteList	Get list of credit notes for specified criteria
CreditNoteSendByEmail	Sends document by email to the recipient(s).
CreditNoteAttachmentAdd	Add attachment to credit note.
CreditNoteAttachmentSetDefault	Add attachment to credit note and set is as default.
CreditNoteAttachmentGet	Get default attachment of credit note.
CreditNoteAttachmentList	Get all attachments of credit note.

3.1 CreditNoteGet

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

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

(For internal "XML" format)

3.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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.
markDocumentAsSent	Marks document as sent.

Example request and response

3.3 CreditNoteCreate

Create new credit note.

Before using vat transaction types for OSS and IOSS, you must set up registration for OSS and IOSS in company settings under foreign VAT registrations.

Parameters

CreditNote

Complex parameter with data tags

Example request and response

3.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

importType	Flag for the type of import
CreditNote	Sales invoice data in xml substructure.
dataFormat	In case some other data format is used for import, this parameter should be used. Possible values are defaul data format "eracuniXML" and "ESLOG". If this parameter is not included in XML, import from default data format is used.
base64data	This parameter is mandatory in case using dataFormat "ESLOG". Content of this parameter should be eSlog XML encoded into base64 string.

Example request and response

3.5 CreditNoteUpdate

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

Parameters

CreditNote

Complex parameter with data tags

Example request and response

3.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

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book

Example request and response

3.7 CreditNoteCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.
cancellationDocNumber	Number of cancellation document (mandatory and works only for imported documents).

Example request and response

3.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

number	Document number
dateFrom	The date which is used to select credit notes whose date is following it
dateTo	The date which is used to select credit notes whose date is preceding it
paymentDueDateFrom	The date which is used to select credit notes whose payment due date is following it
paymentDueDateTo	The date which is used to select credit notes whose payment due date is preceding it
dateOfSupplyFrom	The date which is used to select credit notes whose date of supply/performance is following it
dateOfSupplyUntil	The date which is used to select credit notes whose date of supply/performance is preceding it
deliveryAddress	Delivery address of the buyer
buyer	Buyer code, or buyer name
costPosition	Cost position code
totalAmount	Total amount of the credit notes
totalCurrency	Currency used in credit note
article	Product code, or product name
status	Possible values: Draft, IssuedInvoice, NotBooked, Booked, CanceledCreditInvoice, OpenedClaim, ClosedClaim, OpenedDueClaim, DocumentSentAlready, DocumentNotYetSent, DocumentSentByEMail, DocumentNotSentByEMail, WithInvoiceReference, WithoutInvoiceReference, CancellationDocument, CancelledDocument, AccountingEntryOrImportedInvoice, DocumentNotSentOrPrinted, NotCancellationOrCancelledDocument, VatReportDone, VatReportOpen
issuer	Issuer of document, search is done by username

Example request and response

3.9 CreditNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

3.10 CreditNoteAttachmentAdd

Add image/attachment to credit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

3.11 CreditNoteAttachmentSetDefault

Add attachment to credit note and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

3.12 CreditNoteAttachmentGet

Get default attachment of credit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

3.13 CreditNoteAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

4. DebitNote API

DebitNoteGet	Get debit note by document number, or by combination of document number and date.
DebitNoteGetPDF	Get PDF file for debit note by document number, or by combination of document number and date.
DebitNoteCreate	Create new debit note.
DebitNoteImport	Import debit note issued in other IS.
DebitNoteUpdate	Update existing debit note.
DebitNoteDelete	Delete debit note.
DebitNoteCancel	Cancel debit note.
DebitNoteList	Get list of debit notes for specified criteria
DebitNoteSendByEmail	Sends document by email to the recipient(s).
DebitNoteAttachmentAdd	Add attachment to debit note.
DebitNoteAttachmentSetDefault	Add attachment to debit note and set is as default.
DebitNoteAttachmentGet	Get default attachment of debit note.
DebitNoteAttachmentList	Get all attachments of debit note.

4.1 DebitNoteGet

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

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

(For internal "XML" format)

4.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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.
markDocumentAsSent	Marks document as sent.

Example request and response

4.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 Slovenia //Obdavčen promet blaga in storitev v Sloveniji
1 - Zero-rated transaction - exports of goods outside the EU //Oproščen promet - izvoz blaga izven EU
2 - Zero-rated transaction - without the right to deduct input VAT //Oproščen promet - brez pravice do odbitka vstopnega DDV
3 - Zero-rated transaction - with the right to deduct input VAT //Oproščen promet - s pravico do odbitka vstopnega DDV
4 - Zero-rated transaction - supply of goods within the EU //Oproščen promet - dobava blaga znotraj EU
5 - Zero-rated transaction - assembly in the EU //Oproščen promet - montaža v EU (obračun tujega DDV)
6 - Zero-rated transaction - tripartite supplies of goods within the EU //Oproščen promet - tristranske dobave blaga znotraj EU
7 - Transactions exempt from VAT - not for VAT records //Neobdavčen promet - ne gre v DDV evidence
8 - Zero-rated transaction - remote sales of goods //Oproščen promet - prodaja blaga na daljavo (obračun tujega DDV)
9 - Transactions exempt from VAT with the right of input VAT deduction (transactions outside SLO) //Neobdavčljiv promet s pravico do odbitka vstopnega DDV (prometi izven SLO)
10- Supply of goods and services in SLO, VAT charged by the recipient //Dobava blaga in storitev v SLO, DDV obračuna prejemnik (76.a člen)
11- Sales of services in the EU, VAT paid by the recipient //Oproščen promet - storitve v EU, od katerih plača DDV prejemnik
100- Sales of electronic services taxed in other EU country //
101- Special vat margin calculation for used goods//Posebna ureditev za rabljeno blago
102- Special vat margin calculation for used goods - tax free //Posebna ureditev za rabljeno blago - oproščen promet
103- Vat free transaction - supply of goods in EU by call-of-stock arrangement //Oproščen promet - dobava blaga znotraj EU po skladiščenju na odpoklic
104- Vat free transaction - supply of goods in EU by customs procedure 42 and 63 //Oproščen promet - dobava blaga znotraj EU po carinskih postopkih 42 in 63
105- Not subject to VAT – supply of goods outside EU //Neobdavčen promet - dobava blaga zunaj Unije (tretje države)
106- Distance sales of goods to EU consumers (OSS) //Prodaja blaga na daljavo končnim potrošnikom v EU (OSS)
107- Supply of services to EU consumers (OSS) //Prodaja storitev končnim potrošnikom v EU (OSS)
109- Distance sales of goods to domestic consumers (OSS) //Prodaja blaga na daljavo končnim potrošnikom v SLO (OSS)
108- Distance sales of imported goods to EU consumers (IOSS) //Prodaja na daljavo iz tretjih držav uvoženega blaga končnim potrošnikom v EU (IOSS)
110- Distance sales of imported goods to domestic consumers (IOSS)//Prodaja na daljavo iz tretjih držav uvoženega blaga končnim potrošnikom v SLO (IOSS)
120- Supply of services from EU to third country consumers (foreign VAT) //Izvoz storitev iz EU končnim potrošnikom v državi izven EU (obračun tujega DDV)
Number of debit note which is created from this web service is automatically set if parameter status is set to "issuedInvoice".

Before using vat transaction types for OSS and IOSS, you must set up registration for OSS and IOSS in company settings under foreign VAT registrations.

Parameters

DebitNote

Complex parameter with data tags

Example request and response

4.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

importType	Flag for the type of import
DebitNote	Sales invoice data in xml substructure.

Example request and response

4.5 DebitNoteUpdate

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

Parameters

DebitNote

Complex parameter with data tags

Example request and response

4.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

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book

Example request and response

4.7 DebitNoteCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
businessUnit	Business unit
vatBook	Vat book
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.
cancellationDocNumber	Number of cancellation document (mandatory and works only for imported documents).

Example request and response

4.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

number	Document number
dateFrom	The date which is used to select debit notes whose date is following it
dateTo	The date which is used to select debit notes whose date is preceding it
paymentDueDateFrom	The date which is used to select debit notes whose payment due date is following it
paymentDueDateTo	The date which is used to select debit notes whose payment due date is preceding it
dateOfSupplyFrom	The date which is used to select debit notes whose date of supply/performance is following it
dateOfSupplyUntil	The date which is used to select debit notes whose date of supply/performance is preceding it
deliveryAddress	Delivery address of the buyer
buyer	Buyer code, or buyer name
costPosition	Cost position code
totalAmount	Total amount of the debit notes
totalCurrency	Currency used in debit note
article	Product code, or product name
status	Possible values: Draft, IssuedInvoice, NotBooked, Booked, CanceledCreditInvoice, OpenedClaim, ClosedClaim, OpenedDueClaim, DocumentSentAlready, DocumentNotYetSent, DocumentSentByEMail, DocumentNotSentByEMail, CancellationDocument, CancelledDocument, AccountingEntryOrImportedInvoice, DocumentNotSentOrPrinted, NotCancellationOrCancelledDocument, VatReportDone, VatReportOpen
issuer	Issuer of document, search is done by username

Example request and response

4.9 DebitNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

4.10 DebitNoteAttachmentAdd

Add image/attachment to debit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

4.11 DebitNoteAttachmentSetDefault

Add attachment to debit note and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

4.12 DebitNoteAttachmentGet

Get default attachment of debit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

4.13 DebitNoteAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

5. DeliveryNote API

DeliveryNoteGet	Get delivery notes by document number, or by combination of document number and date.
DeliveryNoteGetPDF	Get PDF for delivery note by document number, or by combination of document number and date.
DeliveryNoteCreate	Create new delivery note.
DeliveryNoteUpdate	Update existing delivery note.
DeliveryNoteDelete	Delete delivery note.
DeliveryNoteCancel	Cancel delivery note.
DeliveryNoteList	Get list of delivery notes for specified criteria
DeliveryNoteSendByEmail	Sends document by email to the recipient(s).
DeliveryNoteAttachmentAdd	Add attachment to delivery note.
DeliveryNoteAttachmentSetDefault	Add attachment to delivery note and set is as default.
DeliveryNoteAttachmentGet	Get default attachment of delivery note.
DeliveryNoteAttachmentList	Get all attachments of delivery note.

5.1 DeliveryNoteGet

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

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
warehouse	Warehouse code
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

5.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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2014-00001)
date	Document date
costPosition	Cost position
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.
markDocumentAsSent	Marks document as sent.

Example request and response

5.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 calculationQuantity is 1, default date is day of execution.
Additional optional item fields are: calculationQuantity, associatedSerialNumbers, lotNumber (optionali expirationDate can be defined for given LOT number), discountPercentage, salesPrice (retail price including VAT for retail document) or grossPrice (gross price without VAT for gross document), position, productName, description, remarks and vatTransactionType. Supported values for vatTransactionType are:
0 - Taxable transactions of goods and services in Slovenia,
1 - Zero-rated transaction - exports of goods outside the EU,
2 - Zero-rated transaction - without the right to deduct input VAT,
3 - Zero-rated transaction - with the right to deduct input VAT,
4 - Zero-rated transaction - supply of goods within the EU,
5 - Zero-rated transaction - assembly in the EU,
6 - Zero-rated transaction - tripartite supplies of goods within the EU,
7 - Transactions exempt from VAT - not for VAT records,
8 - Zero-rated transaction - remote sales of goods,
9 - Transactions exempt from VAT with the right of input VAT deduction (transactions outside SLO),
10- Supply of goods and services in SLO, VAT charged by the recipient,
11- Sales of services in the EU, VAT paid by the recipient.
100- Sales of electronic services taxed in other EU country.

Parameters

DeliveryNote

Complex parameter with data tags like:

Example request and response

5.4 DeliveryNoteUpdate

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

Parameters

DeliveryNote

Complex parameter with data tags

Example request and response

5.5 DeliveryNoteDelete

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

Parameters

number	Document number
date	Document date
costPosition	Cost position

Example request and response

5.6 DeliveryNoteCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.

Example request and response

5.7 DeliveryNoteList

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

Parameters

number	Document number
dateFrom	The date which is used to select delivery notes whose date is following it
dateTo	The date which is used to select delivery notes whose date is preceding it
warehouse	Warehouse code
dateOfSupply	The date of receival
orderReference	Purchase order number
serialNumber	Product serial number
supplier	Buyer code, or buyer name
costPosition	Cost position code
product	Product code, or product name
status	Possible values: Draft, IssuedInvoice, NotBooked, Booked, WithSalesInvoiceReference, WithoutSalesInvoiceReference, Opened, Closed, DocumentSentAlready, DocumentNotYetSent, DocumentSentByEMail, DocumentNotSentByEMail, WithWorkOrderReference, WithoutWorkOrderReference, CancellationDocument, CancelledDocument, DocumentNotSentOrPrinted, NotCancellationOrCancelledDocument

Example request and response

5.8 DeliveryNoteSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

5.9 DeliveryNoteAttachmentAdd

Add image/attachment to delivery note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

5.10 DeliveryNoteAttachmentSetDefault

Add attachment to delivery note and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

5.11 DeliveryNoteAttachmentGet

Get default attachment of delivery note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

5.12 DeliveryNoteAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

6. Document Management API

DocumentInboxImport	Import electronic document to document management inbox
DocumentInboxAddEntry	Add an entry to document management inbox (document capture inbox)
DocumentInboxList	List entries in the document management inbox

6.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 (eSLOG, UBL), etc.

Parameters

checkExisting	Boolean parameter. If true, importing an already existing document will fail. The document is equal to an already existing document if document number or filename match existing/already imported document.
allOrganizations	Boolean parameter. If true, the organization lookup will be performed before actual import is done. The document will be imported into the organization for which the document is destined according to the data it contains (VAT ID, TaxID, IBAN, etc.).
electronicDocument	Electronic document file. This can be either ISO SEPA XML or eSLOG XML
documentVisualization	PDF visualization of electronic document (optional parameter)
automaticallyImportDocument	Optional parameter, that determines, that document (for now only received invoices and bank statements) will be automatically imported after successfully imported into inbox.

Example request and response

6.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

checkExisting	Boolean parameter. If true, importing an already existing document will fail. The document is equal to an already existing document if document date, partner and document number all match.
automaticallyImportDocument	Optional parameter, that determines, that document (for now only received invoices and bank statements) will be automatically imported after successfully imported into inbox.

Example request and response

6.3 DocumentInboxList

List entries in the document management inbox.

Parameters

documentNumber	Document number received by mail.
dateFrom	Document date from received by mail.
dateTo	Document date to received by mail.
receivalDateFrom	Mail receival from.
receivalDateTo	Mail receival to.
status	Status of mail.
sequentialNumber	Sequential number of mail.
senderName	Sender name.
type	Type of mail.
deliveryMethod	Delivery method of mail.
description	Search by word or sentence from mail description.
fileName	Search mail by their attachemnt filenames.

Example request and response

7. E-Banking API

BankStatementImport

Import bank statement file.

7.1 BankStatementImport

Import bank statement file.

Parameters

IBAN	Bank account number (used when importing bank statements of type "IsoSepaXml", "ZbsXml")
payPalAccount	PayPal account name (used when importing bank statements of type "PayPalCsv")
importTransactionFeeAsOutflow	Can be used only with type "PayPalCsv". This parameter is optional, default this parameter is true.
stripeAccount	Stripe account name (used when importing bank statements of type "StripeCsv")
glsAccount	GLS account name (used when importing bank statements of type "GLSSpreadsheet")
statementNumber	Bank statement number (optional, because it can be in the statement)
type	Type of bank statement ("IsoSepaXml", "ZbsXml", "PayPalCsv", "StripeCsv", "GLSSpreadsheet", "PostaSlovenijeXml", "eracuniSpreadsheet")
account	This parameter is mandatory in case of using type "eracuniSpreadsheet", to select for which account statement is beeing imported. It can contain IBAN or payment account name.
statementData	Bank statement coded with base64 coder
pdfStatementData	Bank statement pdf coded with base64 coder (optional)
pdfStatementFileName	File name of bank statement pdf (optional)
dateFormat	Can be used only for types "PayPalCsv" and "eracuniSpreadsheet". This parameter is optional, default format in case of "PayPalCsv" is "MM/DD/YYYY", all possible formats are: "MM/DD/YYYY" and "DD/MM/YYYY". Default format in case of "eracuniSpreadsheet" is "DD.MM.YYYY", all possible formats are: "DD.MM.YYYY", "DD.MM.YYYY.", "DD/MM/YYYY", "MM/DD/YYYY", "YYYY-MM-DD", "YYYY.MM.DD" and "YYYY.MM.DD.".

Example request and response

8. General Ledger API

8.1 GeneralLedgerGetAccountBalance

Get account balance from the general ledger.

Parameters

fiscalYear	Select fiscal year (business year). Fiscal year which is set as default will be used if absent from the request.
accountNumber	General ledger account number
partnerCode	If partner code is specified the balance will be calculated for that partner with only.
voucherStatus	General ledger journal voucher status of entries used in balance calculation. Possible values are: all Include open and posted vouchers/entries when calculating the balance. This is the default parameter value. open Include only open vouchers. posted Include only posted vouchers.
balanceDate	The date of the balance returned.
costPosition	Cost center code.

Example request and response

8.2 GeneralLedgerAccountStatementGetEntries

Get general ledger account statement entries.

Parameters

businessYear	Select business year. Business year which is set as default will be used if not specified.
accountNumber	General ledger account number.
partnerCode	If partner code is specified, only entries assigned to the given partner will be returned.
document	If document ID is specified, the statement will include only entries assigned to the given document. Document string can containt the * (star) character to match entries where document Id matches the search string.
transactionDateFrom	Entries for transactions from the given date
transactionDateTo	Entries for transactions up to the given date
documentDateFrom	Entries for document from date
documentDateTo	Entries for documents up to given date
dueDateFrom	Entry due date from
dueDateTo	Entry due date to
postingDateFrom	Entry posting date from
postingDateTo	Entry posting date to
transactionAmount	Filter out entries matching approximate transaction amount. If currency parameter is also specified, then the amount will be matched with the entry amount in the foreign currency.
transactionCurrency	Use this criteria when you need to filter out transaction originating in a foreign currency
costCentre	Filter out entries on the given cost centre. Character * (star) can be used for matching multiple cost center codes
description	Filter out entries matching description (* character can be used)
creditOrDebit	Optional to filter out only debit or credit transactions. Possible values are: debit Only debit transactions credit Only credit transaction
voucherStatus	Optional to limit list to entries depending on the GL journal voucher status. Possible values are: all Include open and posted vouchers/entries when calculating the balance. This is the default parameter value. open Include only open vouchers. posted Include only posted vouchers.
entryStatus	Optional to specify entry status regarding document payment status. Possible values are: open list open items only cleared list cleared entries only

Example request and response

9. GeneralLedgerJournalVoucher API

GeneralLedgerJournalVoucherGet	Get general ledger journal voucher by document number, or by combination of document number and business year.
GeneralLedgerJournalVoucherGetPDF	Get PDF for general ledger journal voucher by document number, or by combination of document number and business year.
GeneralLedgerJournalVoucherCreate	Create new general ledger journal voucher.
GeneralLedgerJournalVoucherUpdate	Update existing general ledger journal voucher.
GeneralLedgerJournalVoucherDelete	Delete general ledger journal voucher.
GeneralLedgerJournalVoucherList	Get list of general ledger journal vouchers for specified criteria.
GeneralLedgerJournalVoucherCancel	Cancel general ledger journal voucher.

10. GeneralLedgerJournalVoucherGet

Get general ledger journal voucher by document number, or by combination of document number and business year.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (00002)
businessYear	Business year.

Example request and response

11. GeneralLedgerJournalVoucherGetPDF

Get PDF for general ledger journal voucher by document number, or by combination of document number and business year.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (00002)
businessYear	Business year.

Example request and response

11.1 GeneralLedgerJournalVoucherCreate

Create new general ledger journal voucher. In tag "Items" you specifie general ledger journal entries.

Parameters

GeneralLedgerJournalVoucher

Complex parameter with data tags

Example request and response

11.2 GeneralLedgerJournalVoucherUpdate

Update existing general ledger journal voucher.Data must contain general ledger journal voucher number and business year to be able to identify document which is to be updated.

Parameters

GeneralLedgerJournalVoucher

Complex parameter with data tags

Example request and response

11.3 GeneralLedgerJournalVoucherDelete

Delete general ledger journal voucher. Must specify parameter/s (number and business year) to identify document for deleting.

Parameters

number	General ledger journal voucher number
businessYear	General ledger journal voucher date

Example request and response

11.4 GeneralLedgerJournalVoucherCancel

Cancel general ledger journal voucher. Must specify parameter/s (number and business year) to identify document for canceling.

Parameters

number	General ledger journal voucher number
businessYear	General ledger journal voucher date

Example request and response

11.5 GeneralLedgerJournalVoucherList

Get list of general ledger journal vouchers for criteria which is specified by API parameters.

Parameters

number	General ledger journal voucher number
dateFrom	The date which is used to select general ledger journal vouchers whose period date is following it
dateTo	The date which is used to select general ledger journal vouchers whose period date is preceding it
status	Status of general ledger journal vouchers. Possible values: Opened, Closed, Unbalanced and NotTransferred.
remarks	Search from remarks on general ledger journal voucher
businessYear	Search by business year
businessEventType	Search by business event type
profitAndLossAccountType	Search by user defined type.

Example request and response

12. GoodsReceipt API

GoodsReceiptGet	Get goods receipts by document number, or by combination of document number and date.
GoodsReceiptGetPDF	Get PDF file for goods receipt by document number, or by combination of document number and date.
GoodsReceiptCreate	Create new goods receipt.
GoodsReceiptUpdate	Update existing goods receipt.
GoodsReceiptDelete	Delete goods receipt.
GoodsReceiptCancel	Cancel goods receipt.
GoodsReceiptList	Get list of goods receipts for specified criteria
GoodsReceiptSendByEmail	Sends document by email to the recipient(s).
GoodsReceiptAttachmentAdd	Add attachment to goods receipt.
GoodsReceiptAttachmentSetDefault	Add attachment to goods receipt and set is as default.
GoodsReceiptAttachmentGet	Get default attachment of goods receipt.
GoodsReceiptAttachmentList	Get all attachments of goods receipt.

12.1 GoodsReceiptGet

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

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position

Example request and response

12.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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2014-00001)
date	Document date
costPosition	Cost position

Example request and response

12.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

GoodsReceipt	Complex parameter with data tags like:
status	Possible values: Draft, Issued

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.

If price calculation is not specified at all in XML (all calues are missing), default price calculation from article is taken or new calculation is created based on inventory, gross and sales price from article.

Example request and response

12.4 GoodsReceiptUpdate

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

Parameters

GoodsReceipt

Complex parameter with data tags

Example request and response

12.5 GoodsReceiptDelete

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

Parameters

number	Document number
date	Document date

Example request and response

12.6 GoodsReceiptCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.

Example request and response

12.7 GoodsReceiptList

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

Parameters

number	Document number
dateFrom	The date which is used to select goods receipts whose date is following it
dateTo	The date which is used to select goods receipts whose date is preceding it
warehouse	Warehouse code
dateOfReceival	The date of receival
supplierDeliveryNote	Delivery Note number
purchaseOrder	Purchase number
serialNumber	Product serial number
supplier	Supplier name
costPosition	Cost position code
product	Product code, or product name
remarks	Document remarks
status	Possible values: Draft, Issued, Booked, NotBooked, CancellationDocument, CancelledDocument, WithReceivedInvoiceReference, WithoutReceivedInvoiceReference

Example request and response

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

12.8 GoodsReceiptSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

12.9 GoodsReceiptAttachmentAdd

Add image/attachment to goods receipt.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

12.10 GoodsReceiptAttachmentSetDefault

Add attachment to goods receipt and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

12.11 GoodsReceiptAttachmentGet

Get default attachment of goods receipt.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

12.12 GoodsReceiptAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

13. InternalMovement API

InternalMovementGet	Get internal movement by document number, or by combination of document number and date.
InternalMovementGetPDF	Get PDF file for internal movement by document number, or by combination of document number and date.
InternalMovementCreate	Create new internal movement.
InternalMovementUpdate	Update existing internal movement.
InternalMovementDelete	Delete internal movement.

13.1 InternalMovementGet

Get internal movements by number.

Parameters

number	Number of internal movement.
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

13.2 InternalMovementCreate

Create new internal movement.

Parameters

InternalMovement

Internal movement's data in xml substructure.

Example request and response

13.3 InternalMovementUpdate

Update existing internal movement.

Parameters

InternalMovement

Product's data in xml substructure

Example request and response

13.4 InternalMovementDelete

Delete internal movement.

Parameters

number

Unique identifier for internal movement.

Example request and response

14. Partner API

Please check the API reference documentation for PartnerAPI here https://e-racuni.com/obracuni/ApiDocumentation.

PartnerAPI exposes the functionality of the partner list GUI to developer. Most of partner editing features are available via API methods in this category. The API user account needs to own the same privileges as the regular GUI to get access to features via the API.

Below you will find examples on how to use the partner API. Some examples are written using JSON request notation, some examples are written in XML and some examples use curl command line tool to illustrate multiple way on how you can use the API.

Please use the API developer panel to generate API request source in a language of your preference. JSON, XML, Linux command line and PHP request source can be automatically generated by the API developer panel tool.

API developer panel is available at:

https://e-racuni.com/obracuni/developer

14.1 Creating B2B customer

Here is a simple example on how to create a B2B customerusing JSON API request.

14.2 Creating B2C customer

Here is a simple example on how to create a B2C customerusing JSON API request.

15. Partner API methods

PartnerGetByID	Get partner by partner ID.
PartnerGetByCode	Get partner by partner's code.
PartnerGetByDocumentID	Get partner by partner's documentID (internal identificator from program).
PartnerCreate	Create new partner.
PartnerUpdate	Update existing partner.
PartnerImport	Import partner by creating new and/or updating existing ones.
PartnerDelete	Delete partner.
PartnerList	Get list of partners for specified criteria.
PartnerListBuyers	Get list of buyers for specified criteria.
PartnerListSuppliers	Get list of suppliers for specified criteria.
PartnerListEmployees	Get list of employees for specified criteria.
PartnerBuyerCreditLimitGet	Get partner buyer credit limit with unpaid amount by invoices and posted debt.
PartnerAttachmentAdd	Add attachment to partner.
PartnerAttachmentSetDefault	Add attachment to partner and set is as default.
PartnerAttachmentGet	Get default attachment of partner.
PartnerAttachmentList	Get all attachments of partner.
PartnerAvatarAdd	Add partner's avatar.
PartnerAvatarGet	Get partner's avatar.
PartnerAvatarRemove	Remove partner's avatar.

15.1 PartnerGetByID

Get partner by partner ID.

Parameters

ID	Partner ID (partner taxNumber accepted too). Partner ID is external number (matična številka) in case of legal person and in case of natural person it is registration number (EMŠO)

Example request and response

15.2 PartnerGetByCode

Get partner by partner code.

Parameters

partnerCode

Partner code.

Example request and response

15.3 PartnerGetByDocumentID

Get partner by partner documentID.

Parameters

documentID

Partner documentID (internal id from program).

Example request and response

15.4 PartnerCreate

Create new partner. (for more detailed partner's data structure look in API for PartnerGetByID)

Parameters

partner

Partner's data in xml substructure.

Example request and response

15.5 PartnerUpdate

Update existing partner.

Parameters

partner

Partner's data in xml substructure.

Example request and response

15.6 PartnerDelete

Delete partner.

Parameters

ID	Partner's ID.
taxNumber	Partner's tax number.
partnerCode	Partner's code.

Example request and response

15.7 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

importType	Flag for the type of import createOrUpdate Import all - create new and update existing partners createOnly Skip import for existing partners updateOnly Skip import of new partners
partner	Partner's data in xml substructure.

Example request and response

15.8 PartnerList

Get list of partners for specified criteria.

Parameters

partnerType	Type of partners to be answered. If this parameter is missing, answer all types of partners. Possible types are: buyer supplier user
searchKey	Search key. The value from this field is used for searching for: ( company name for partners as legal person, given name and name for partners as physical person)
partnerCode	Partner's code
taxNumber	Tax number
street	Street
postalCodeOrCity	Postal code or City
eMail	Email
mobileOrPhoneNumber	Mobile or phone number
companyType	Company type where parameter value is the same as possible values of tag companyType described abowe

Example request and response

15.9 PartnerListBuyers

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

Parameters

searchKey	Search key. The value from this field is used for searching for: (company name for partners as legal person, given name and name for partners as physical person)
partnerCode	Partner's code
buyerCode	Buyer's code
taxNumber	Tax number
street	Street
postalCodeOrCity	Postal code or City
eMail	Email
mobileOrPhoneNumber	Mobile or phone number
buyerCountry	Buyer country iso code
status	Status of the buyers to be answered. It is optional and possible types are: defaultBuyer buyerOnBlackList trustworthyBuyer buyerDoesNotExistAnymore

Example request and response

15.10 PartnerListSuppliers

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

Parameters

searchKey	Search key. The value from this field is used for searching for: (company name for partners as legal person, given name and name for partners as physical person)
partnerCode	Partner's code
supplierCode	Supplier's code
taxNumber	Tax number
street	Street
postalCodeOrCity	Postal code or City
eMail	Email
mobileOrPhoneNumber	Mobile or phone number
status	Status of the suppliers to be answered. It is optional and possible types are: defaultSupplier supplierOnBlackList trustworthySupplier supplierDoesNotExistAnymore

Example request and response

15.11 PartnerListEmployees

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

Parameters

searchKey	Search key. The value from this field is used for searching for: (company name for partners as legal person, given name and name for partners as physical person)
partnerCode	Partner's code
taxNumber	Tax number
status	Status of the employees. Possible types are: active inactive

Example request and response

15.12 PartnerBuyerCreditLimitGet

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

Parameters

ID	Partner's ID.
taxNumber	Partner's tax number.
partnerCode	Partner's code.
creditLimitDate	Date on which credit limit is calculated, if parameter is empty or not present, todays date is taken.
currency	Curreny of results, if not specified default currency is taken

Example request and response

15.13 PartnerAttachmentAdd

Add image/attachment to partner.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.14 PartnerAttachmentSetDefault

Add attachment to partner and set it as default.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.15 PartnerAttachmentGet

Get default attachment of partner.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.16 PartnerAttachmentList

Get all images/attachments of article.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.17 PartnerAvatarAdd

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

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.18 PartnerAvatarGet

Get partner's avatar.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

15.19 PartnerAvatarRemove

Remove partner's avatar.

Parameters

partnerCode	Partner code.
documentID	Partner's document ID.

Example request and response

16. Product API

ProductGetByCode	Get product by product's code.
ProductCreate	Create new product
ProductUpdate	Update existing product
ProductPriceCalculationUpdate	Update product price calculation.
ProductMassPriceCalculationUpdate	Update up to 5000 price calculations with setting only 3 basic prices (supplier price, gross price and sales price)
ProductImport	Import product by creating new and/or updating existing one.
ProductMassImport	Import up to 5000 products with basic data.
ProductDelete	Delete product.
ProductList	Get list of products for specified criteria
ProductPriceListGet	Get price list for product if used for specified product
ProductPriceDiscountActionList	Get price discount action list for given article.
ProductPriceDiscountActionAdd	Add price discount action list for given articles.
ProductImageAdd	Add image/attachment to product.
ProductImageSetDefault	Add image/attachment to product and set is as default.
ProductImageGet	Get default image/attachment of product.
ProductImageList	Get all images/attachments of product.

16.1 ProductGetByCode

Get product by productCode.

Parameters

productCode

Product code.

Example request and response

16.2 ProductCreate

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

Parameters

product

Product's data in xml substructure.

Example request and response

16.3 ProductUpdate

Update existing product.

Parameters

product

Product's data in xml substructure

Example request and response

16.4 ProductPriceCalculationUpdate

Update product's price calculation.

Parameters

productCode	Unique identifier for product.
applyPricesToArticle	Decide if inventory, gross and sales prices are applied also to article.
priceCalculation	Price calculation

Example request and response

16.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

applyPricesToArticle	Decide if inventory, gross and sales prices are applied also to article.
priceCalculations	Price calculations

Example request and response

16.6 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

importType	Flag for the type of import createOrUpdate Import all - create new and update existing partners createOnly Skip import for existing partners updateOnly Skip import of new partners
product	Product's data in xml substructure.

Example request and response

16.7 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

importType	Flag for the type of import createOrUpdate Import all - create new and update existing products createOnly Skip import for existing products updateOnly Skip import of new products
products	Products basic data in xml substructure. Below is and example of all basic basic data that can be set.

Example request and response

16.8 ProductDelete

Delete product.

Parameters

productCode

Unique identifier for product.

Example request and response

16.9 ProductList

Get list of products for specified criteria.

Parameters

productCode	Product's code.
productCodeFrom	Search by product code range.
productCodeTo	Search by product code range.
searchKey	Search key. The value from this property is used for searching for values in fields: "name", "description" and "brand"
supplierCode	Supplier code
barCode	Bar code
brand	Name of the product's brand
productGroup	Code of product group (primary or secondary)
status	Usage status (active, inactive)
type	Type of article, possible types: services, goodsWithStockManagement, goodsWithoutStockManagement, rawMaterial, intermediateProduct, product, license
catalogueCode	Catalogue code.

Example request and response

16.10 ProductPriceListGet

Get price list for product if used for specified product.

Parameters

productCode	Product's code.
priceListCurrency	Price list currency
priceListDate	Price list date

Example request and response

16.11 ProductPriceDiscountActionList

Get price discount action list for given article.

Parameters

productCode	Product's code.
productGroupCode	Product group's code.
buyerGroupCode	Buyer group's code.
warehouseCode	Warehouse code.
validFrom	Validity date from.
validTo	Validity date to.
discountPercentage	Disctount percentage.

Example request and response

16.12 ProductPriceDiscountActionAdd

Add price discount action list for given article.

Parameters

priceDiscountAction

Discount action data.

Example request and response

16.13 ProductImageAdd

Add image/attachment to product.

Parameters

productCode

Product code.

Example request and response

16.14 ProductImageSetDefault

Add image/attachment to product and set is as default.

Parameters

productCode

Product code.

Example request and response

16.15 ProductImageGet

Get default image/attachment of product.

Parameters

productCode

Product code.

Example request and response

16.16 ProductImageList

Get all images/attachments of product.

Parameters

productCode

Product code.

Example request and response

17. ProductGroup API

ProductGroupGetByCode	Get product group by product group's code.
ProductGroupCreate	Create new product group
ProductGroupUpdate	Update existing product group
ProductGroupDelete	Delete product group.
ProductGroupList	Get list of product groups for specified criteria

17.1 ProductGroupGetByCode

Get product group by product group code.

Parameters

ProductGroupCode

Product group code.

Example request and response

17.2 ProductGroupCreate

Create new product group. (for product group's data structure look in API for ProductGroupGetByCode).

Parameters

ProductGroup

Product group's data in xml substructure.

Example request and response

17.3 ProductGroupUpdate

Update existing ProductGroup.

Parameters

ProductGroup

Product group's data in xml substructure

Example request and response

17.4 ProductGroupDelete

Delete ProductGroup.

Parameters

ProductGroupCode

Unique identifier for ProductGroup.

Example request and response

17.5 ProductGroupList

Get list of Product groups for specified criteria.

Parameters

ProductGroupCode	ProductGroup's code.
productGroupDescription	Search key. The value from this property is used for searching for values in fields: "name", "description" and "brand"
status	Usage status (active, inactive)

Example request and response

18. PurchaseOrder API

PurchaseOrderGet	Get purchase orders by document number, or by combination of document number and date.
PurchaseOrderGetPDF	Get PDF file for purchase orders by document number, or by combination of document number and date.
PurchaseOrderCreate	Create new purchase order.
PurchaseOrderUpdate	Update existing purchase order.
PurchaseOrderDelete	Delete purchase order.
PurchaseOrderCancel	Cancel purchase order.
PurchaseOrderList	Get list of purchase orders for specified criteria
PurchaseOrderSendByEmail	Sends document by email to the recipient(s).
PurchaseOrderAttachmentAdd	Add attachment to purchase order.
PurchaseOrderAttachmentSetDefault	Add attachment to purchase order and set is as default.
PurchaseOrderAttachmentGet	Get default attachment of purchase order.
PurchaseOrderAttachmentList	Get all attachments of purchase order.

18.1 PurchaseOrderGet

Get purchase orders by document number, or by combination of document number and date.

Parameters

number	Document number. Can use sequential document number (example: 8), or formatted number (example: 2011-00008)
date	Document date
costPosition	Cost position
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

18.2 PurchaseOrderGetPDF

Get PDF for purchase order 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

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2010-00002)
date	Document date
costPosition	Cost position
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

18.3 PurchaseOrderCreate

Create new purchase order.

Document item can be specified with: productCode, quantity, discountPercentage, or can be specified with: description, currency, quantity, netPrice.Additional optional item fields are: discountPercentage, unit, vatPercentage, vatTransactionType. date Date YYYY-MM-DDunit String OptionalvatTransactionType Enum 0-9 (0 is default) OptionalValues description for vatTransactionType:
0 - Taxable transactions of goods and services in Slovenia,
1 - Zero-rated transaction - exports of goods outside the EU,
2 - Zero-rated transaction - without the right to deduct input VAT,
3 - Zero-rated transaction - with the right to deduct input VAT,
4 - Zero-rated transaction - supply of goods within the EU,
5 - Zero-rated transaction - assembly in the EU,
6 - Zero-rated transaction - tripartite supplies of goods within the EU,
7 - Transactions exempt from VAT - not for VAT records,
8 - Zero-rated transaction - remote sales of goods,
9 - Transactions exempt from VAT with the right of input VAT deduction (transactions outside SLO),
10- Supply of goods and services in SLO, VAT charged by the recipient,
11- Sales of services in the EU, VAT paid by the recipient.

Parameters

PurchaseOrder

Complex parameter with data tags

Example request and response

18.4 PurchaseOrderUpdate

Update existing purchase order.Data must contain purchase order number to be able to identify document which is to be updated.

Parameters

PurchaseOrder

Complex parameter with data tags

Example request and response

18.5 PurchaseOrderDelete

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

Parameters

number	Document number
date	Document date
costPosition	Cost position

Example request and response

18.6 PurchaseOrderCancel

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

Parameters

number	Document number
date	Document date
costPosition	Cost position
status	Status of cancelation document (draft, issuedInvoice). By Default status is issuedInvoice.

Example request and response

18.7 PurchaseOrderList

Get list of purchase orders for criteria which is specified by API parameters.

Parameters

number	Document number
dateFrom	The date which is used to select purchase orders whose date is following it.
dateTo	The date which is used to select purchase orders whose date is preceding it
supplier	Supplier name
costPosition	Cost position code
totalAmount	Total amount of the sales order
totalCurrency	Currency used in sales order
status	Possible values: Draft Opened PartlyDelivered Completed Cancelled

Example request and response

18.8 PurchaseOrderSendByEmail

Sends document by email to the recipient(s).

Parameters

number	Document number
date	Document date (optional additional document identification)
sender	Email sender (Optional)
recipient	Comma delimited list of recipient(s) emails
cc	CC email (Optional)
bcc	BCC email (Optional)
subject	Mail subject (Optional)
message	Message text (Optional)
useHtmlMessage	Send message text as HTML (Optional)

Example request and response

18.9 PurchaseOrderAttachmentAdd

Add image/attachment to purchase order.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

18.10 PurchaseOrderAttachmentSetDefault

Add attachment to purchase order and set is as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

18.11 PurchaseOrderAttachmentGet

Get default attachment of purchase order.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

18.12 PurchaseOrderAttachmentList

Get all images/attachments of article.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

19. ReceivedAdvanceInvoice API

ReceivedAdvanceInvoiceGet	Get received advance invoice by number.
ReceivedAdvanceInvoiceCreate	Create new received advance invoice.
ReceivedAdvanceInvoiceUpdate	Update existing received advance invoice.
ReceivedAdvanceInvoiceDelete	Delete received advance invoice.
ReceivedAdvanceInvoiceList	Get list of received advance invoices for specified criteria.
ReceivedAdvanceInvoiceAttachmentAdd	Add attachment to received advance invoice.
ReceivedAdvanceInvoiceAttachmentSetDefault	Add attachment to received advance invoice and set is as default.
ReceivedAdvanceInvoiceAttachmentGet	Get default attachment of received advance invoice.
ReceivedAdvanceInvoiceAttachmentList	Get all attachments of received advance invoice.

19.1 ReceivedAdvanceInvoiceGet

Get received advance invoice by number.

Parameters

number	Supplier number of received advance invoice.
internalNumber	Internal number of received advance invoice.
date	Document date.
costPosition	Cost position.
supplier	Supplier name.
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

19.2 ReceivedAdvanceInvoiceCreate

Create new received advance invoice.

Parameters

ReceivedAdvanceInvoice

received advance invoice's data in xml substructure.

Supported values for items inputVatTransactionType are:
0 - Purchase of goods and services //promet blaga in storitev
1 - Purchase of real estate //nabava nepremičnin
2 - Other fixed assets purchase //nabava ostalih osnovnih sredstev
3 - Intra-Community goods acquisitions //pridobitve blaga znotraj Skupnosti
4 - Tripartite intra-Community goods acquisitions //tristranske pridobitve blaga znotraj Skupnosti
5 - Intra-Community fixed assets acquisitions //pridobitve osn. sredstev znotraj Skupnosti
6 - Goods import from non-EU member countries //Uvoz blaga iz držav izven EU
7 - Fixed assets import from non-EU member countries //Uvoz osnovnih sredstev iz držav izven EU
8 - Purchase of good and services in Slovenia, VAT reverse charge //Nabave blaga in storitev v SLO, od katerih plača DDV prejemnik (76.a člen)
9 - Purchase of real estate in Slovenia, VAT reverse charge //Nabave nepremičnin v SLO, od katerih plača DDV prejemnik (76.a člen)
10- Purchase of other fixed assests in Slovenia, VAT reverse charge //Nabave drugih OS v SLO, od katerih plača DDV prejemnik (76.a člen)
11- Acquisition of real estate within the community //pridobitve nepremičnin znotraj Skupnosti
12- Acquisition of electronic services (reverse charge) //Pridobitev elektronskih storitev (samoobdavčitev)

Example request and response

19.3 ReceivedAdvanceInvoiceUpdate

Update existing received advance invoice.

Parameters

ReceivedAdvanceInvoice

received advance invoice data in xml substructure

Example request and response

19.4 ReceivedAdvanceInvoiceDelete

Delete received advance invoice.

Parameters

number	Supplier number of received advance invoice.
internalNumber	Internal number of received advance invoice.
date	Document date.
costPosition	Cost position.
supplier	Supplier name.

Example request and response

19.5 ReceivedAdvanceInvoiceList

Get list of received advance invoices for specified criteria.

Parameters

number	Suppliers number
internalNumber	Internal number
dateFrom	The date which is used to select received advance invoices whose date is following it
dateTo	The date which is used to select received advance invoices whose date is preceding it
receivalDateFrom	The date which is used to select received advance invoices whose date of receival is following it
receivalDateTo	The date which is used to select received advance invoices whose date of receival is preceding it
prepaymentDateFrom	The date which is used to select received advance invoices whose date of prepayment is following it
prepaymentDateTo	The date which is used to select received advance invoices whose date of prepayment is preceding it
supplier	Supplier code or name
costPosition	Cost position code
article	Product code, or product name

Example request and response

19.6 ReceivedAdvanceInvoiceAttachmentAdd

Add image/attachment to received advance invoice.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

19.7 ReceivedAdvanceInvoiceAttachmentSetDefault

Add attachment to received advance invoice and set it as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

19.8 ReceivedAdvanceInvoiceAttachmentGet

Get default attachment of received advance invoice.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

19.9 ReceivedAdvanceInvoiceAttachmentList

Get all images/attachments of received advance invoice.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

20. ReceivedCreditNote API

ReceivedCreditNoteGet	Get received credit note by number.
ReceivedCreditNoteCreate	Create new received credit note.
ReceivedCreditNoteUpdate	Update existing received credit note.
ReceivedCreditNoteDelete	Delete received credit note.
ReceivedCreditNoteList	Get list of received credit notes for specified criteria.
ReceivedCreditNoteAttachmentAdd	Add attachment to received credit note.
ReceivedCreditNoteAttachmentSetDefault	Add attachment to received credit note and set is as default.
ReceivedCreditNoteAttachmentGet	Get default attachment of received credit note.
ReceivedCreditNoteAttachmentList	Get all attachments of received credit note.

20.1 ReceivedCreditNoteGet

Get received credit note by number.

Parameters

number	Supplier number of received credit note.
internalNumber	Internal number of received credit note.
date	Document date.
costPosition	Cost position.
supplier	Supplier name.
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

20.2 ReceivedCreditNoteCreate

Create new received credit note.

Parameters

ReceivedCreditNote

Received credit note's data in xml substructure.

Example request and response

20.3 ReceivedCreditNoteUpdate

Update existing received credit note.

Parameters

ReceivedCreditNote

Received credit note data in xml substructure

Example request and response

20.4 ReceivedCreditNoteDelete

Delete received credit note.

Parameters

number	Supplier number of received credit note.
internalNumber	Internal number of received credit note.
date	Document date.
costPosition	Cost position.
supplier	Supplier name.

Example request and response

20.5 ReceivedCreditNoteList

Get list of received credit notes for specified criteria.

Parameters

number	Suppliers number
internalNumber	Internal number
dateFrom	The date which is used to select received credit notes whose date is following it
dateTo	The date which is used to select received credit notes whose date is preceding it
supplier	Supplier code or name
costPosition	Cost position code
paymentAmount	Payment amount of the document
paymentCurrency	Payment currency of document
article	Product code, or product name

Example request and response

20.6 ReceivedCreditNoteAttachmentAdd

Add image/attachment to received credit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

20.7 ReceivedCreditNoteAttachmentSetDefault

Add attachment to received credit note and set it as default.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

20.8 ReceivedCreditNoteAttachmentGet

Get default attachment of received credit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

20.9 ReceivedCreditNoteAttachmentList

Get all images/attachments of received credit note.

Parameters

number	Document number. Can use sequential document number (example: 2), or formated number (example: 2016-00002)
date	Document date
costPosition	Cost position/cost center
businessUnit	Business unit

Example request and response

21. ReceivedInvoice API

ReceivedInvoiceGet	Get received invoice by number.
ReceivedInvoiceCreate	Create new received invoice.
ReceivedInvoiceUpdate	Update existing received invoice.
ReceivedInvoiceDelete	Delete received invoice.
ReceivedInvoiceList	Get list of received invoices for specified criteria.
ReceivedInvoicePaymentRecordAdd	Add payment record on received invoice.
ReceivedInvoiceAttachmentAdd	Add attachment to received invoice.
ReceivedInvoiceAttachmentSetDefault	Add attachment to received invoice and set is as default.
ReceivedInvoiceAttachmentGet	Get default attachment of received invoice.
ReceivedInvoiceAttachmentList	Get all attachments of received invoice.

21.1 ReceivedInvoiceGet

Get received invoice by number.

Parameters

number	Supplier number of received invoice.
internalNumber	Internal number of received invoice.
date	Document date.
costPosition	Cost position.
supplier	Supplier name.
documentID	Internal document identificator. In case of using this parameter, no other parameter listed abowe is needed for searching by document.

Example request and response

21.2 ReceivedInvoiceCreate

Create new received invoice.

Parameters

ReceivedInvoice

Received invoice's data in xml substructure.

Example request and response