Welcome to API developer panel

Introduction

In order to use web services API you need to activate web services in the company settings of the organization. After enabling web services, you'll be given a unique company identification and authentication token.

For every API request you send, you'll need the following:

 • username for the API account that will be using web services
 • MD5 hash for the password for that account (see instructions below on how to generate MD5 password hash)
 • the web services API token for the organization

To generate the MD5 password hash you can use the md5sum command on Linux as shown down below. In the example MD5 password hash is generated for the user with username "john" and password "pass123". The username has to be in UPPERCASE while the password has to be exactly as it is set.

  
# echo -n "JOHNpass123" | md5sum

API request examples

API requests can be sent using HTTP. You can use either XML or JSON format as shown in the examples below. Please note that the URL of the API endpoint for your organization can be different than in the example below. Refer to live API test console to get the correct API endpoint URL for your organization.

XML request

  
POST /WebServices/API HTTP/1.1
Host: eurofaktura.com
Content-Type: application/octet-stream

<?xml version="1.0" encoding="utf-8"?>
<request>
        <login username="john" md5pass="8b29582ce0a1e85da0c574d218acb900" token="341026F063054A129569212F3C9D01C6" />
        <method name="SalesInvoiceGet">
                <parameter name="number" value="2022-00001" />
                <parameter name="date" type="Date" value="2022-12-03" />
        </method>
</request>

JSON request

  
POST /WebServices/API HTTP/1.1
Host: eurofaktura.com
Content-Type: application/json

{
        "username": "john",
        "md5pass": "8b29582ce0a1e85da0c574d218acb900",
        "token": "341026F063054A129569212F3C9D01C6",
        "method": "SalesInvoiceGet",
        "parameters": {
                "number": "2022-00001",
                "date": "2022-12-03"
        }
}

×  
API can be used by any user account owning privileges for using the API. API user is limited to the same functionality which is available in the normal GUI login mode.
×  
Default web services API is limited to a maximum of 1 request per second per IP. A burst of 4 consequtive requests is allowed followed by a pause until 4 seconds period expires. Concurrent API requests coming from a single API user account are not allowed. Before sending another request you have to wait until the previous API request is finished. If you need to send requests concurrently you will need to create additional API user accounts to allocate the needed request pool and implement request pooling with queue on the client side according to your needs.
Request:
Parameters
XML
JSON
CURL
PHP
Run   
Copy   
Response:
Download