Rechnungs Positionen

Diese Schnittstelle existiert für Kunden die eigene Rechnungen aus einem vorhandenen System genrieren wollen.
Es können zyklisch Rechnungspositionen die in TimberData erstellt wurden ausgelesen werden.

Artikelnummer Format

Für Preispositionen die aus Holzdaten entstehen werden Artikelnummern dynamisch generiert. Das Artikelnummer Format was über article_number_format angegeben wird kann folgender Platzhalter enthalten:

  • T - Kurzname einer Holzart
  • U - Kurzname einer Sorte
  • Q - Kurzname einer Qualität
  • S - Bezeichnung der Stärkeklassee

Beispiel:

Für das Format T-U würde für eine Position die aus Buchen Stammholz Abschnitte besteht folgende Artikelnummer generiert: BU-FL

Fehlwerte:

Wenn ein Verkauf ohne Berücksichtigung einer Polterinformation passsiert wird sie durch einen Fallback Wert ersetzt:

  • Qualität - ZZQ
  • Sorte - ZZU
  • Baumart - ZZT
  • Stärkeklassee - ZZS

Für das Format T-U-Q würde für eine Position die in mit der Gruppierungsebene “Gruppierung nach Holzart” erstellt wurde folgende Artikelnummer generiert: BU-ZZU-ZZQ

Rechnungs Position Entität

invoice_number string Rechnungsnummer
invoice_date string Rechnungsdatum
service_date string Liefer/Leistungsdatum von
due_date string Fälligkeit
invoice_type string Belegart
buyer object Käufer ( ID und Name )
position_text string Positionstext
position_identifier string Artikelnummer/Leistungsnummer
unit_price int Einheitspreis in EUR-Cent
amount float Mengen / Anzahl
net_price int Nettopreis in EUR-Cent
gross_price int Bruttopreis in EUR-Cent
unit string Einheit
tax_rate float Mehrwertsteuersatz
tree_type string Holzart oder leer wenn Artikel/Freitextposition
usage string Sorte oder leer wenn Artikel/Freitextposition
cashback_due_date string Skonto Zahlungszeitraum
cashback_percent float Skonto Rabatt
invoice_id int Rechnungs ID
invoice_creator object Referenz des Users der die Rechnung erstellt hat

Rechnungs Position Auflistung

Endpunkt /inventory/v4/sale/invoice/positions/export
Methode GET
Scope invoice
Query Parameter
article_number_format siehe Abschnitt “Artikelnummer Format” article_number_format=T-U-Q
created_start_time Zeige Positionen die an, oder nach diesem Datum erstellt wurden created_start_time=2024-05-02
created_end_time Zeige Positionen die an, oder bevor diesem Datum erstellt wurden created_end_time=2024-05-03

Beispiel Antwort:

{
    "data": [
        {
            "invoice_number": "24-274",
            "invoice_date": "2024-09-04T13:40:31+02:00",
            "service_date": "2024-09-04T17:38:28+02:00",
            "due_date": "2024-09-25T17:38:28+02:00",
            "invoice_type": "invoice",
            "position_text": "5.290000 fm",
            "tree_type": "LI",
            "usage": "ST",
            "net_price": 529,
            "gross_price": 630,
            "unit_price": 100,
            "position_identifier": "LI-ST-ZZQ",
            "amount": 4,
            "unit": "fm",
            "cashback_percent": 0,
            "cashback_due_date": "",
            "invoice_id": 123,
            "invoice_creator": {
                "id": 1234,
                "name": "Musteruser",
                "email": "example@timberdata.de"
            },
            "tax_rate": 19,
            "buyer": {
                "id": 91011,
                "name": "Sägewerk GmbH"
            }
        },
        {
            "invoice_number": "24-274",
            "invoice_date": "2024-09-04T13:40:31+02:00",
            "service_date": "2024-09-04T17:38:28+02:00",
            "due_date": "2024-09-25T17:38:28+02:00",
            "invoice_type": "invoice",
            "position_text": "5.942000 fm",
            "tree_type": "PAP",
            "usage": "BL",
            "net_price": 594,
            "gross_price": 636,
            "unit_price": 100,
            "position_identifier": "PAP-BL-ZZQ",
            "amount": 10,
            "unit": "fm",
            "cashback_percent": 0,
            "cashback_due_date": "",
            "invoice_id": 123,
            "invoice_creator": {
                "id": 1234,
                "name": "Musteruser",
                "email": "example@timberdata.de"
            },
            "tax_rate": 19,
            "buyer": {
                "id": 91011,
                "name": "Sägewerk GmbH"
            }
        },
        {
            "invoice_number": "24-274",
            "invoice_date": "2024-09-04T13:40:31+02:00",
            "service_date": "2024-09-04T17:38:28+02:00",
            "due_date": "2024-09-25T17:38:28+02:00",
            "invoice_type": "invoice",
            "position_text": "Freitext Artikel",
            "tree_type": "",
            "usage": "",
            "net_price": 500,
            "gross_price": 595,
            "unit_price": 500,
            "position_identifier": "",
            "amount": 1,
            "unit": "",
            "cashback_percent": 0,
            "cashback_due_date": "",
            "invoice_id": 123,
            "invoice_creator": {
                "id": 1234,
                "name": "Musteruser",
                "email": "example@timberdata.de"
            },
            "tax_rate": 19,
            "buyer": {
                "id": 91011,
                "name": "Sägewerk GmbH"
            }
        },
        {
            "invoice_number": "24-274",
            "invoice_date": "2024-09-04T13:40:31+02:00",
            "service_date": "2024-09-04T17:38:28+02:00",
            "due_date": "2024-09-25T17:38:28+02:00",
            "invoice_type": "invoice",
            "position_text": "Weinachtsbaum",
            "tree_type": "",
            "usage": "",
            "net_price": 2000,
            "gross_price": 2380,
            "unit_price": 2000,
            "position_identifier": "1",
            "amount": 1,
            "unit": "STK",
            "cashback_percent": 0,
            "cashback_due_date": "",
            "invoice_id": 123,
            "invoice_creator": {
                "id": 1234,
                "name": "Musteruser",
                "email": "example@timberdata.de"
            },
            "tax_rate": 19,
            "buyer": {
                "id": 91011,
                "name": "Sägewerk GmbH"
            }
        }
    ]
}