billomat[API]: Rechnungen – Kommentare und Historie

Alle Kommentare einer Rechnung auflisten

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

Kommentare können immer nur für eine bestimmte Rechnung zurückgegeben werden.

Deshalb ist invoice_id ein Pflichtparameter.

Response: 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<invoice-comments type="array">
    <invoice-comment>
        ...
    <invoice-comment>
    <invoice-comment>
        ...
    <invoice-comment>
</invoice-comments>

Einzelnen Kommentar aufrufen

GET /api/invoice-comments/{id}
Response: 200 OK
<?xml version="1.0" encoding="UTF-8"?>
<invoice-comment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <invoice_id type="integer">1</invoice_id>
    <user_id type="integer">1</user_id>
    <comment>Rechnung erstellt.</comment>
</invoice-comment>

Kommentar erstellen

POST /api/invoice-comments

Erstellt einen neuen Rechnungskommentar.

XML-Element

Beschreibung

Typ

Default-Wert

Pflichtfeld

invoice_id

ID der Rechnung

INT

ja

comment

Kommentar

ALNUM

ja

Request Body
<invoice-comment>
    <invoice_id>1</invoice_id>
    <comment>Kunde will nächste Woche bezahlen</comment>
</invoice-comment>
Response: 201 Created
<?xml version="1.0" encoding="UTF-8"?>
<invoice-comment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <invoice_id type="integer">1</invoice_id>
    <user_id type="integer">1</user_id>
    <comment>Kunde will nächste Woche bezahlen</comment>
</invoice-comment>

Kommentar löschen

DELETE /api/invoice-comments/{id}
Response: 200 OK
Du bist hier: Startseite » API » Rechnungen » Kommentare und Historie