List all incoming posts

GET /api/incoming-items
<?xml version="1.0" encoding="UTF-8"?>
<incoming-items type="array" page="1" per_page="100" total="4">
  <incoming-item>
  ...
  </incoming-item>
 <incoming-item>
 ...
 </incoming-item>
</incoming-items>

You can filter the result by parameters:

GET /api/incoming-items?incoming_id=1234

Lists all posts of the incoming invoice with the ID “1234”. Upper and lower case are ignored.

The following filter parameters are available:

Parameter Beschreibung
incoming_id ID of the incoming invoice
customfield Custom field

Get a single item

GET /api/incoming-items/{id}
<?xml version="1.0" encoding="UTF-8"?>
<incoming-item>
  <id type="integer">1</id>
  <incoming_id type="integer">1</incoming_id>
  <position type="integer">1</position>
  <description><description/>
  <total type="float">75</total>
  <tax_name>Ust</tax_name>
  <tax_rate type="float">0</tax_rate>
  <tax_rate_reverse_charge type="float"/>
  <tax_included type="bool">1</tax_included>
  <category>external_services</category>
  <type>SERVICE</type>
  <cost_center><cost_center/>
  <expense_account_number type="integer"><expense_account_number/>
  <customfield><customfield/>
</incoming-item>

Create item

POST /api/incoming-items
XML-Element Beschreibung Typ Default-Wert Pflichtfeld
incoming_id ID of the incoming invoice INT ja
position Position INT
description Description ALNUM
total Amount of the post INT
tax_name Name of the tax ALNUM
tax_rate Rate of taxation FLOAT
tax_rate_reverse_charge Tax rate for reverse charge FLOAT
tax_included Tax included BOOL
category Titel of the category ALNUM
type Product or Service
Only for invoice to foreign countries, dependent on company location.
ENUM
[PRODUCT,
SERVICE]
cost_center Cost center INT
expense_account_number Number of the exepense account INT
customfield Custom field ALNUM

The line item is added to eventual already existing positions.

<?xml version="1.0" encoding="UTF-8"?>
<incoming-item>
  <incoming_id type="integer">1</incoming_id>
  <position type="integer">1</position>
  <description>Example description</description>
  <total type="float">25</total>
  <tax_name>Ust</tax_name>
  <tax_rate type="float">19</tax_rate>
  <tax_rate_reverse_charge type="float"/>
  <tax_included type="bool">1</tax_included>
  <category>training_costs</category>
  <type>SERVICE<type/>
  <cost_center>1234<cost_center/>
  <expense_account_number type="integer">5678<expense_account_number/>
</incoming-item>
<?xml version="1.0" encoding="UTF-8"?>
<incoming-item>
  <id type="integer">1</id>
  <incoming_id type="integer">1</incoming_id>
  <position type="integer">1</position>
  <description>Example description</description>
  <total type="float">25</total>
  <tax_name>Ust</tax_name>
  <tax_rate type="float">19</tax_rate>
  <tax_rate_reverse_charge type="float"/>
  <tax_included type="bool">1</tax_included>
  <category>training_costs</category>
  <type>SERVICE<type/>
  <cost_center>1234<cost_center/>
  <expense_account_number type="integer">5678<expense_account_number/>
</incoming-item>

Edit item

PUT /api/incoming-items/{id}

Here the same parameters apply as for creating, however, the associated incoming invoice (incoming_id) can not be changed.

<incoming-item>
    <total>18</total>
</incoming-item>

Delete item

DELETE /api/incoming-items/{id}

Deletes an item