Rechnungen

Attribute

Die Repräsentation der Rechnung enthält neben den wichtigsten Eigenschaften ausserdem:
  • Positionen (Items)
  • Positionstypen (titledescriptionitemsubtotalpage-break oder separator)
  • Zahlungen (Payments)
  • Mahnungen (Reminders)

{
    "id": 80547,
    "customer_id": 760269602,
    "project_id": 944514545,
    "identifier": "R1704-013",
    "date": "2017-04-05",
    "due_date": "2017-04-25",
    "status": "paid",
    "reversal": false,
    "title": "Rechnung",
    "recipient_address": "Beispiel AG\r\nBeispielstrasse 123\r\n8000 Zürich",
    "currency": "CHF",
    "net_total": 35612.5,
    "tax": 8,
    "gross_total": 38461.5,
    "created_on": "2017-04-04",
    "updated_on": "2017-07-10",
    "salutation": "<div>Wir erlauben uns, Ihnen Folgendes in Rechnung zu stellen:</div>",
    "footer": "<div>Zahlbar ohne Abzug innert 20 Tagen.<br><br>Kontoverbindung...<br><br><br>Herzlichen Dank für Ihren Auftrag.</div>",
    "items": [
        {
            "id": 387469,
            "type": "title",
            "title": "März 2017",
            "description": null,
            "quantity": 0,
            "unit": null,
            "unit_price": 0,
            "net_total": 0
        },
        {
            "id": 387470,
            "type": "item",
            "title": "Allgemeine Arbeiten",
            "description": null,
            "quantity": 15.5,
            "unit": "h",
            "unit_price": 185,
            "net_total": 2867.5
        },
        {
            "id": 387471,
            "type": "item",
            "title": "Umsetzung Backend",
            "description": null,
            "quantity": 4.25,
            "unit": "h",
            "unit_price": 185,
            "net_total": 786.25
        },
        {
            "id": 387472,
            "type": "item",
            "title": "Umsetzung Frontend",
            "description": null,
            "quantity": 110.25,
            "unit": "h",
            "unit_price": 185,
            "net_total": 20396.25
        },
        {
            "id": 387473,
            "type": "item",
            "title": "Hosting Dienstleistungen",
            "description": null,
            "quantity": 45.5,
            "unit": "h",
            "unit_price": 185,
            "net_total": 8417.5
        },
        {
            "id": 387474,
            "type": "item",
            "title": "Support",
            "description": null,
            "quantity": 11.75,
            "unit": "h",
            "unit_price": 185,
            "net_total": 2173.75
        },
        {
            "id": 387475,
            "type": "item",
            "title": "Projektleitung / Kommunikation",
            "description": null,
            "quantity": 5.25,
            "unit": "h",
            "unit_price": 185,
            "net_total": 971.25
        }
    ],
    "payments": [
        {
            "id": 65938,
            "date": "2017-05-30",
            "paid_total": 10000,
            "currency": "CHF",
            "created_on": "2017-06-05",
            "updated_on": "2017-06-05"
        },
        {
            "id": 65939,
            "date": "2017-07-06",
            "paid_total": 28461.5,
            "currency": "CHF",
            "created_on": "2017-07-10",
            "updated_on": "2017-07-10"
        }
    ],
    "reminders": [
        {
            "id": 2291,
            "date": "2017-05-18",
            "due_date": "2017-05-28",
            "fee": 0,
            "salutation": "<div>Sehr geehrte Damen und Herren<br><br>Bei der Kontrolle unserer Buchhaltung ist uns aufgefallen, dass wir für folgende Rechnung noch keinen Zahlungseingang verbuchen konnten:</div>",
            "footer": "<div>Sicherlich handelt es sich hierbei um ein Versehen. Wir bitten Sie höflich, uns den Betrag in den nächsten Tagen auf unser Bankkonto zu überweisen. Sollte sich Ihre Zahlung mit diesem Schreiben gekreuzt haben, betrachten Sie diese Erinnerung als gegenstandslos.<br><br>Kontoverbindung:&nbsp;<br>Zürcher Kantonalbank<br>IBAN: CH31 0070 0110 0064 2620 6.<br><br>Herzlichen Dank.</div>",
            "created_on": "2017-05-18",
            "updated_on": "2017-05-18"
        }
    ]
}


GET invoices

Abruf aller Rechnungen:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/invoices \
  -H 'authorization: Token token={api-key}'

Zusätzlich sind folgende Parameter möglich:
  • status – ("created", "sent", "partially_paid", "paid", "overdue", "ignored")
Die Antwort liefert ein Array mit vollständigen Rechnungsinformationen (siehe Attribute) ausser salutationfooteritems, payments und reminders.


GET invoices/{id}

Abruf einer einzelnen Rechnung:

curl -X GET \
  https://{domain}.mocoapp.com/api/v1/invoices/{123} \
  -H 'Authorization: Token token={api-key}'

Die Antwort ist die Repräsentation einer einzelnen Rechnung inkl. Positionen, Zahlungen und Mahnungen.


Mehr zu API (V1)...
30 Tage gratis

Account sofort startbereit. Voller Funktionsumfang. Ohne Zahlungsangaben.