Posts

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 ServiceOnly 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