Abo-Rechnungen

Alle Abo-Rechnungen auflisten

GET /api/recurrings

<?xml version="1.0" encoding="UTF-8"?>
<recurrings type="array" page="1" per_page="100" total="2">
    <recurring>
        ...
    </recurring>
    <recurring>
        ...
    </recurring>
</recurrings>

Über Parameter kann gefiltert werden:

GET /api/recurrings?label=foo

Listet alle Abo-Rechnungen auf, die „foo“ in der Bezeichnung haben. Groß- und Kleinschreibung wird ignoriert.
Folgende Filter-Parameter stehen zur Verfügung:

Einzelne Abo-Rechnung aufrufen

GET /api/recurrings/{id}

<?xml version="1.0" encoding="UTF-8"?>
<recurring>
    <id type="integer">2</id>
    <created type="datetime">2012-03-02T16:17:41+01:00</created>
    <client_id type="integer">33234</client_id>
    <contact_id type="integer" />
    <template_id type="integer" />
	<email_template_id type="integer" />
    <currency_code>EUR</currency_code>
    <name>Monatsmiete</name>
    <title>Rechnung</title>
    <cycle_number>1</cycle_number>
    <cycle>MONTHLY</cycle>
    <action>EMAIL</action>
    <hour type="integer">16</hour>
    <start_date type="date">2012-03-03</start_date>
    <end_date type="date">2012-10-11</end_date>
    <last_creation_date type="date">2012-05-25</last_creation_date>
    <next_creation_date type="date">2012-06-01</next_creation_date>
    <iterations type="integer">0</iterations>
    <counter type="integer">9</counter>
    <address />
    <due_days type="integer">0</due_days>
    <discount_rate type="float">1.1</discount_rate>
    <discount_days type="integer">7</discount_days>
    <intro>Hiermit berechnen wir für...</intro>
    <note>Vielen Dank für Ihren Auftrag</note>
    <total_gross type="float">107.1</total_gross>
    <total_net type="float">90.0</total_net>
    <net_gross>NET</net_gross>
    <reduction>10</reduction>
    <total_gross_unreduced type="float">119.0</total_gross_unreduced>
    <total_net_unreduced type="float">100.0</total_net_unreduced>
    <quote type="float">1.0000</quote>
    <ultimo type="integer">1</ultimo>
    <label />
    <supply_date_type>SUPPLY_TEXT</supply_date_type>
    <supply_date>[Dates.month]</supply_date>
    <email_sender />
    <email_subject />
    <email_message />
    <email_filename />
	<email_bcc />
    <letter_color>0</letter_color>
    <letter_duplex>1</letter_duplex>
    <letter_paper_weight>90</letter_paper_weight>
    <payment_types />
    <offer_id>777</offer_id>
    <confirmation_id />
</recurring>

cycle kann folgende Werte haben:
– DAILY
– WEEKLY
– MONTHLY
– YEARLY
action kann folgende Werte haben:
– CREATE (erstellen)
– COMPLETE (abschließen)
– EMAIL (Versand per E-Mail)
– MAIL (Versand per Post)
supply_date_type kann folgende Werte haben:
– SUPPLY_DATE (Leistungsdatum als Datum)
– DELIVERY_DATE (Lieferdatum als Datum)
– SUPPLY_TEXT (Leistungsdatum als Freitext)
– DELIVERY_TEXT (Lieferdatum als Freitext)
net_gross kann folgende Werte haben:
– NET (Netto-Preise)
– GROSS (Brutto-Preise)
Bei den Zahlarten handelt es sich um eine durch Komma getrennte Liste. Die Namen der Zahlarten werden bei den Zahlungen aufgelistet.
Die Abo-Rechnungspositionen können gesondert abgerufen werden.

Abo-Rechnung erstellen

POST /api/recurrings

Erstellt eine neue Abo-Rechnung.

Die übrigen Eigenschaften der Abo-Rechnung werden automatisch berechnet.
Abo-Rechnungspositionen (recurring-items) können bei der Erstellung direkt mit angegeben werden. Es gelten die gleichen XML-Elemente wie unter Abo-Rechnungsposition erstellen. Nur das XML-Element recurring_id muss nicht mit angegeben werden.

<recurring>
    <client_id>1</client_id>
    <start_date>2011-11-18</start_date>
    <note>Vielen Dank für Ihren Auftrag</note>
    <recurring-items>
        <recurring-item>
            <unit>Stück</unit>
            <unit_price>1.23</unit_price>
            <quantity>1.5</quantity>
            <title>Muster</title>
        </recurring-item>
        <recurring-item>
            <unit>Stunde</unit>
            <unit_price>90</unit_price>
            <quantity>8</quantity>
            <title>Arbeiten</title>
        </recurring-item>
    </recurring-items>
</recurring>

<?xml version="1.0" encoding="UTF-8"?>
<recurring>
    <id type="integer">1234</id>
    <client_id type="integer">1</client_id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <start_date type="date">2011-11-18</start_date>
    ...
</recurring>

Abo-Rechnung bearbeiten

PUT /api/recurrings/{id}

Abo-Rechnungspositionen können nicht direkt über die Abo-Rechnung bearbeitet werden. Bitte dafür über die entsprechende Ressource gehen.

<recurring>
    <name>Monatsmiete</name>
</recurring>

Abo-Rechnung löschen

DELETE /api/recurrings/{id}

Löscht eine Abo-Rechnung inkl. aller dazugehöriger Abo-Rechnungspositionen.

Abo-Rechnung stoppen

PUT /api/recurrings/{id}/stop

Setzt das Feld „next_creation_date“ auf null und stoppt somit die Erzeugung weiterer Rechnungen.