Zahlungen

Alle Zah­lun­gen einer Rech­nung auflisten

GET /api/invoice-payments?invoice_id={invoice_id}

Zah­lun­gen kön­nen immer nur für eine bestimmte Rech­nung zurück­ge­ge­ben wer­den.
Des­halb ist invoice_id ein Pflichtparameter.

<?xml version="1.0" encoding="UTF-8"?>
<invoice-payments type="array">
    <invoice-payment>
        ...
    <invoice-payment>
    <invoice-payment>
        ...
    <invoice-payment>
</invoice-payments>

Ein­zelne Zah­lung aufrufen

GET /api/invoice-payments/{id}
<?xml version="1.0" encoding="UTF-8"?>
<invoice-payment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <invoice_id type="integer">1</invoice_id>
    <date type="date">2009-11-04</date>
    <amount type="float">12.34</amount>
    <comment>per Überweisung</comment>
    <type>BANK_TRANSFER</type>
</invoice-payment>

type kann fol­gende Werte haben

  • CREDIT_NOTE (Gut­schrift)
  • BANK_CARD (Bank­karte)
  • BANK_TRANSFER (Über­wei­sung)
  • DEBIT (Last­schrift)
  • CASH (Bar)
  • PAYPAL (Pay­pal)
  • CREDIT_CARD (Kre­dit­karte)
  • COUPON (Gut­schein)
  • MISC (Sons­ti­ges)

Zah­lung erstellen

POST /api/invoice-payments

Zah­lun­gen kön­nen nur für Rech­nun­gen im Sta­tus offen (OPEN) oder über­fäl­lig (OVERDUE) gebucht werden.

XML-Element Beschrei­bung Typ Default-Wert Pflicht­feld
invoice_id ID der Rech­nung INT ja
date Datum des Zahlungseingangs DATE heute
amount Betrag der Zahlung FLOAT ja
com­ment Kom­men­tar ALNUM
type Zahl­art ALNUM (“CREDIT_NOTE”, “BANK_CARD”, “BANK_TRANSFER”, “DEBIT”, “CASH”, “PAYPAL”, “CREDIT_CARD”, “COUPON”, “MISC”)
mark_invoice_as_paid Gibt an, ob die zuge­hö­rige Rech­nung als bezahlt mar­kiert wer­den soll (Sta­tus PAID). BOOL 0 (false)
<invoice-payment>
    <invoice_id>1</invoice_id>
    <date>2009-11-03</date>
    <amount>12.34</amount>
    <comment>per Überweisung</comment>
</invoice-payment>
<?xml version="1.0" encoding="UTF-8"?>
<invoice-payment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <invoice_id type="integer">1</invoice_id>
    <date type="date">2009-11-03</date>
    <amount type="float">12.34</amount>
    <comment>per Überweisung</comment>
</invoice-payment>

Zah­lung löschen

DELETE /api/invoice-payments/{id}

Das Löschen einer Zah­lung setzt den Sta­tus der Rech­nung auf offen (OPEN), bzw. über­fäl­lig (OVERDUE).