Alle Positionen einer Abo-Rechnung auflisten
GET /api/recurring-items?recurring_id={recurring_id}
Abo-Rechnungspositionen können immer nur für eine bestimmte Abo-Rechnung zurückgegeben werden.
Deshalb ist recurring_id ein Pflichtparameter.
<?xml version="1.0" encoding="UTF-8"?>
<recurring-items type="array" page="1" per_page="100" total="2">
<recurring-item>
...
<recurring-item>
<recurring-item>
...
<recurring-item>
</recurring-items>
Einzelne Position aufrufen
GET /api/recurring-items/{id}
<?xml version="1.0" encoding="UTF-8"?>
<recurring-item>
<id type="integer">1</id>
<article_id type="integer">123</article_id>
<recurring_id type="integer">1</recurring_id>
<position type="integer">1</position>
<unit>Stück</unit>
<quantity type="float">5.2</quantity>
<unit_price type="float">10.0</unit_price>
<tax_name>MwSt</tax_name>
<tax_rate type="float">19.0</tax_rate>
<title>Visitenkarten</title>
<description>Wunderschöne 4c Visitenkarten</description>
<total_gross type="float">49.98</total_gross>
<total_net type="float">42.0</total_net>
<reduction>10</reduction>
<total_gross_unreduced type="float">61.88</total_gross_unreduced>
<total_net_unreduced type="float">52.0</total_net_unreduced>
</recurring-item>
Position erstellen
POST /api/recurring-items
XML-Element |
Beschreibung |
Typ |
Default-Wert |
Pflichtfeld |
recurring_id |
ID der Abo-Rechnung |
INT |
|
ja (nicht aber bei der Abo-Rechnungserstellung) |
article_id |
ID des Artikels, setzt bei Neuanlage zusätzlich die Werte aus Artikel |
INT |
|
|
unit |
Einheit |
ALNUM |
|
|
quantity |
Menge |
FLOAT |
0.0 |
|
unit_price |
Preis pro Einheit |
FLOAT |
0.0 |
|
tax_name |
Steuerbezeichnung |
ALNUM |
Standard-Steuersatz |
|
tax_rate |
Steuerrate in Prozent |
FLOAT |
Standard-Steuersatz |
|
title |
Titel |
ALNUM |
|
|
description |
Beschreibung |
ALNUM |
|
|
reduction |
Rabatt (Absolut oder als Prozentwert: 10/10%) |
ALNUM |
|
|
Die Abo-Rechnungsposition wird nach evenutell bereits bestehenden Positionen angefügt.
<recurring-item>
<recurring_id>1</recurring_id>
<unit>Stück</unit>
<quantity>5.2</quantity>
<unit_price>10.0</unit_price>
<tax_name>MwSt</tax_name>
<tax_rate>19.0</tax_rate>
<title>Visitenkarten</title>
<description>Wunderschöne 4c Visitenkarten</description>
</recurring-item>
<?xml version="1.0" encoding="UTF-8"?>
<recurring-item>
<id type="integer">1</id>
<article_id />
<recurring_id type="integer">1</recurring_id>
<created>2007-12-13T12:12:00+01:00</created>
<position type="integer">1</position>
<unit>Stück</unit>
<quantity type="float">5.2</quantity>
<unit_price type="float">10.0</unit_price>
<tax_name>MwSt</tax_name>
<tax_rate type="float">19.0</tax_rate>
<title>Visitenkarten</title>
<description>Wunderschöne 4c Visitenkarten</description>
<total_gross type="float">61.88</total_gross>
<total_net type="float">52.0</total_net>
</recurring-item>
Position bearbeiten
PUT /api/recurring-items/{id}
Hier gelten die selben Parameter wie beim Anlegen, allerdings kann die verknüpfte Abo-Rechnung (recurring_id) nicht mehr geändert werden.
<recurring-item>
<unit>Stunde</unit>
<quantity>8.5</quantity>
</recurring-item>
Position löschen
DELETE /api/recurring-items/{id}
Beim Löschen von Abo-Rechnungspositionen wird position für alle verbleibenden Positionen neu vergeben (ohne die Sortierung zu ändern), um die evtl. entstandene Lücke wieder zu füllen.