 |
| |
| |
| |
| |
| |
| |
| |
| |
| | |||||||||||||||
|
| |
| |
| |
| |
| |
| |
| |
| |
| | |||||||||||||||
| 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. |
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
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="ReceivedInvoiceGet">
<parameter name="number" value="678/2021" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<ReceivedInvoice>
<amountWithVAT>689.000</amountWithVAT>
<businessYear>2021</businessYear>
<costPosition>001</costPosition>
<date>2021-01-29</date>
<dateOfSupplyFrom>2021-01-21</dateOfSupplyFrom>
<documentID>51:4488260</documentID>
<internalNumber>RP9-0003</internalNumber>
<isInsideTheScopeOfVat>true</isInsideTheScopeOfVat>
<isReverseChargeVatDocument>false</isReverseChargeVatDocument>
<methodOfPayment>CreditCard</methodOfPayment>
<number>678/2021</number>
<paymentBankAccountNumber></paymentBankAccountNumber>
<paymentDueDate>2021-02-05</paymentDueDate>
<paymentReference></paymentReference>
<receivalDate>2021-01-29</receivalDate>
<receivedAdvanceInvoiceRef></receivedAdvanceInvoiceRef>
<roundingDifference>0.00</roundingDifference>
<supplier>4 Partner Foreign Company</supplier>
<supplierCode>666000</supplierCode>
<paymentAmount>689.000</paymentAmount>
<paymentCurrency>EUR</paymentCurrency>
<Items>
<Item>
<chartAccountNumber>00000</chartAccountNumber>
<costPosition></costPosition>
<description>OSOS</description>
<inputVatTransactionType>2</inputVatTransactionType>
<isInputVatDeductible>true</isInputVatDeductible>
<isInsideTheScopeOfVat>true</isInsideTheScopeOfVat>
<netAmount>689.000</netAmount>
<netAmountInDocumentCurrency>689.000</netAmountInDocumentCurrency>
<position>1</position>
<vatDeductionPercentage>100,00</vatDeductionPercentage>
<vatPercentage>22.0</vatPercentage>
</Item>
</Items>
</ReceivedInvoice>
</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, Cannot find received invoice for number: 055/11,
</response>
Create new received invoice.
Parameters
| ReceivedInvoice | Received 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
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="ReceivedInvoiceCreate">
<parameter name="ReceivedInvoice">
<amountWithVAT>689.000</amountWithVAT> <!-- (Optional) amount with VAT in default currency
<paymentAmount>689.000</paymentAmount> <!-- (Mandatory) payment amount
<paymentCurrency>EUR</paymentCurrency> <!-- (Mandatory) payment currency
<businessYear>2021</businessYear> <!-- (Mandatory) business year of received invoice
<costPosition>001</costPosition> <!-- (Optional/Mandatory) cost center is optional in case mandatory entry is not set in company settings
<date>2021-01-29</date> <!-- (Mandatory) date of received invoice
<number>678/2021</number> <!-- (Mandatory) suppliers number of received invoice
<paymentDueDate>2021-02-05</paymentDueDate> <!-- (Mandatory) payment due date
<receivalDate>2021-01-29</receivalDate> <!-- (Mandatory) date of receival of document
<dateOfSupplyFrom>2021-01-21</dateOfSupplyFrom> <!-- (Mandatory) date of supplay from
<dateOfSupplyUntil>2021-02-21</dateOfSupplyUntil> <!-- (Optional)
<isInsideTheScopeOfVat>true</isInsideTheScopeOfVat> <!-- (Optional) settting if received document is inside scope of VAT
<isReverseChargeVatDocument>false</isReverseChargeVatDocument> <!-- (Optional) settting if received document is reverse charge. This and abowe option "isInsideTheScopeOfVat" exclude each other
<methodOfPayment>CreditCard</methodOfPayment> <!-- (Mandatory) possible values: BankTransfer, Cash, CreditCard, Other
<paymentBankAccountNumber>SI56 0000 1111 2222 333</paymentBankAccountNumber> <!-- Mandatory in case "methodOfPayment" value BankTransfer is used
<paymentReference>SI99</paymentReference> <!-- Mandatory in case "methodOfPayment" value BankTransfer is used
<supplierBookingAccountNumber>26000</supplierBookingAccountNumber> <!-- Mandatory in case "methodOfPayment" value Other is used
<receivedAdvanceInvoiceRef>9384-2021</receivedAdvanceInvoiceRef> <!-- (Optional) received advance invoice reference
<roundingDifference>0.00</roundingDifference> <!-- (Optional)
<supplierCode>666000</supplierCode> <!-- (Mandatory) If supplier documentID specified, use this supplier identificator for referencing supplier on received document
<supplierDocumentID>55:666</supplierDocumentID> <!-- (Mandatory) If supplier code not specified, use this supplier identificator for referencing supplier on received document
<Items>
<Item>
<position>1</position> <!-- (Optional) item position
<chartAccountNumber>00000</chartAccountNumber> <!-- (Mandatory) account number
<costPosition>009</costPosition> <!-- (Optional) cost center code for referencing cost center on item
<description>OSOS</description> <!-- (Mandatory) description
<inputVatTransactionType>2</inputVatTransactionType> <!-- (Mandatory) input VAT transaction type
<isInputVatDeductible>true</isInputVatDeductible> <!-- (Optional) settting if received document items VAT is deducated
<vatDeductionPercentage>100,00</vatDeductionPercentage> <!-- (Mandatory) if abowe option is used. Percentage of VAT that is being deducated must be entered
<isInsideTheScopeOfVat>true</isInsideTheScopeOfVat> <!-- (Optional) settting if received document item is inside scope of VAT. This and abowe option "isInputVatDeductible" exclude each other
<netAmount>689.000</netAmount> <!-- (Mandatory) net amount
<netAmountInDocumentCurrency>689.000</netAmountInDocumentCurrency> <!-- (Optional) net amount id document currency
<vatPercentage>22.0</vatPercentage> <!-- (Optional) if this property is not present, default normal VAT rate is set
</Item>
<Item>
<position>2</position> <!-- (Optional) item position
<productCode>000001</productCode> <!-- (Optional) if item with referenced product is added product code should be present in item definition
<chartAccountNumber>00000</chartAccountNumber> <!-- (Mandatory) account number
<costPosition>009</costPosition> <!-- (Optional) cost center code for referencing cost center on item
<description>OSOS</description> <!-- (Mandatory) description
<inputVatTransactionType>2</inputVatTransactionType> <!-- (Mandatory) input VAT transaction type
<isInputVatDeductible>true</isInputVatDeductible> <!-- (Optional) settting if received document items VAT is deducated
<vatDeductionPercentage>100,00</vatDeductionPercentage> <!-- (Mandatory) if abowe option is used. Percentage of VAT that is being deducated must be entered
<isInsideTheScopeOfVat>true</isInsideTheScopeOfVat> <!-- (Optional) settting if received document item is inside scope of VAT. This and abowe option "isInputVatDeductible" exclude each other
<quantity>1</quantity> <!-- (Mandatory) quantity
<price>100.00</price> <!-- (Optional) product price, if not present, default purchase price of product is taken
<vatPercentage>22.0</vatPercentage> <!-- (Optional) if this property is not present, default normal VAT rate is set
</Item>
</Items>
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<number>055/11</number>
<date>2021-01-29</date>
</response>
Response on error
<?xml version="1.0" encoding="utf-8"?>
<response status="error" >
<error description="Received invoice 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 received invoice
</response>
Update existing received invoice.
Parameters
| ReceivedInvoice | Received invoice data in xml substructure |
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="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ReceivedInvoiceUpdate">
<parameter name="ReceivedInvoice">
<!-- Parameters are identical to the parameters in ReceivedInvoiceCreate api
</parameter>
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<number>055/11</number>
<date>2021-01-29</date>
</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 received invoice for number: 055/11, missing mandatory attributes, invalid values, no privileges,
</response>
Delete received invoice.
Parameters
| number | Supplier number of received invoice. |
| internalNumber | Internal number of received invoice. |
| date | Document date. |
| costPosition | Cost position. |
| supplier | Supplier name. |
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="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ReceivedInvoiceDelete">
<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 received invoice for number: 055/11, Can not delete. Found 3 received invoice with number 055,
</response>
Get list of received invoices for specified criteria.
Parameters
| number | Suppliers number |
| internalNumber | Internal number |
| dateFrom | The date which is used to select received invoices whose date is following it |
| dateTo | The date which is used to select received invoices whose date is preceding it |
| receivalDateFrom | The date which is used to select received invoices whose date of receival is following it |
| receivalDateTo | The date which is used to select received invoices whose date of receival is preceding it |
| paymentDueDateFrom | The date which is used to select received invoices whose date of expiration is following it |
| paymentDueDateTo | The date which is used to select received invoices whose date of expiration is preceding it |
| dateOfSupplyFrom | The date which is used to select received invoices whose date of supply/performance is following it |
| dateOfSupplyUntil | The date which is used to select received invoices whose date of supply/performance is preceding it |
| dateOfFullPaymentFrom | The date which is used to select received invoices whose date of full payment is following it |
| dateOfFullPaymentTo | The date which is used to select received invoices whose date of full payment is preceding it |
| dateOfPaymentOrderFrom | The date which is used to select received invoices whose date of payment order is following it |
| dateOfPaymentOrderTo | The date which is used to select received invoices whose date of payment order 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
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="ReceivedInvoiceList">
<parameter name="number" value="123456" />
</method>
</request>
<?xml version="1.0" encoding="utf-8"?>
<request>
<login username="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ReceivedInvoiceList">
<parameter name="dateFrom" value="2021-05-01" />
<parameter name="dateTo" value="2021-05-26" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<ReceivedInvoice>
<!-- structure of received invoice data is the same as in ReceivedInvoiceGet
</ReceivedInvoice>
<ReceivedInvoice>
<!-- structure of received invoice data is the same as in ReceivedInvoiceGet
</ReceivedInvoice>
...
</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>
Add payment record on received invoice.
Parameters
| number | Document number |
| date | Document date (optional additional document identification) |
| costPosition | Cost position |
| businessUnit | Business unit |
| paymentDate | Payment date |
| paymentAmount | Payment amount |
| paymentMethodForInvoice | Payment method for Received invoice
|
| paymentRemark | Payment remark (optional) |
| paymentCurrency | Payment currency (optional) |
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="micka" md5pass="ddb43e9f119c6805f4770ecc4f6466ba" token="E7DF3E6E94FB4579BBA8F54979010B5C" />
<method name="ReceivedInvoicePaymentRecordAdd">
<parameter name="number" value="2014-00013"/>
<parameter name="date" type="Date" value="2014-05-15"/>
<parameter name="paymentDate" type="Date" value="2014-05-20"/>
<parameter name="paymentAmount" value="50"/>
<parameter name="paymentMethodForInvoice" value="Cash"/>
<parameter name="paymentRemark" value="Payment record on Received invoice 2014-05-15"/>
<parameter name="paymentCurrency" value="EUR"/>
</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="Payment method Test is not supported"><error/> <!-- wrong payment method chosen
</response>
Add image/attachment to received 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
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="ReceivedInvoiceAttachmentAdd">
<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 received invoice 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 received invoice for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>
Add attachment to received 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
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="ReceivedInvoiceAttachmentSetDefault">
<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 received invoice 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 received invoice for number: 2020-00001, Parameter <attachment> is missing, Parameter <attachment> cannot parse contents
</response>
Get default attachment of received 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
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="ReceivedInvoiceAttachmentGet">
<parameter name="number" type="String" value="2020-00001" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<ReceivedInvoice>
<Attachments>
<Attachment>
<fileName>att.jpg</fileName>
<contents encoding="BASE64">BASE64</contents>
</Attachment>
</Attachments>
</ReceivedInvoice>
</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 received invoice for number: 2020-00001 received invoice does not have attachemnts.
</response>
Get all images/attachments of received 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
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="ReceivedInvoiceAttachmentList">
<parameter name="number" type="String" value="2020-00001" />
</method>
</request>
Response
<?xml version="1.0" encoding="utf-8"?>
<response status="ok" >
<ReceivedInvoice>
<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>
</ReceivedInvoice>
</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 received invoice for number: 2020-00001 received invoice does not have attachemnts.
</response>
