Zuletzt geändert am 5. Oktober 2018 um 12:38

System-API: Rechnungen

Version vom 5. Oktober 2018, 12:38 Uhr von Richard Reiber (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „Der nachfolgend beschriebene API-Endpoint hat die URL <code>/invoice</code>. Zur Verwendung der System-API konsultieren Sie bitte die Grundsätze der System-…“)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

Der nachfolgend beschriebene API-Endpoint hat die URL /invoice. Zur Verwendung der System-API konsultieren Sie bitte die Grundsätze der System-API.

GET (alle Rechnungen)

Erwartete Parameter

Keine

Rückgabe

JSON-Array mit allen Rechnungen und jeweils den folgenden Elementen:

  • ID
  • client
  • date
  • duedate
  • customno
  • status

GET (eine Rechnung)

URL

/invoice/INVOICE_ID

Erwartete Parameter

Keine

Rückgabe

JSON-Array mit allen Daten der Rechnung und den Rechnungspositionen

POST (Rechnung anlegen)

Erwartete Parameter

  • client
  • date (optional, ansonsten aktuelles Datum)
  • duedate (optional, ansonsten Standard)
  • items[]
    • description
    • amount
    • tax = 0|1

Rückgabe

JSON-Array mit Element "id", der ID der neuen Rechnung

PUT (Rechnung bearbeiten)

URL

/invoice/INVOICE_ID

Erwartete Parameter

Es können alle Spalten aus der Tabelle invoices als Key verwendet werden. Als Value ist der gewünschte neue Wert zu übergeben.

Zusätzlich können Rechnungspositionen angelegt/bearbeitet werden:

  • items[]
    • id (nur für Bearbeitung, ID der Rechnungsposition)
    • description
    • amount
    • tax = 0|1

Rückgabe

JSON-Array mit "status" = "ok"