Einzelne Rechnungsposition anhand ihrer ID abrufen

Enthält die Erlöskontenaufteilung der Position, sofern eine dafür konfiguriert ist.

Verfügbarkeit: Nur Vollversion — eine Clock-Instanz antwortet auf diesen Endpunkt mit 404.

Request

GET /api/v1/invoice-items/{id}

curl --request GET \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/invoice-items/{id}' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Pfad-Parameter

Name
id
Type
integer
Description
Die ID der Rechnungsposition

Response

{
  "data": {
    "id": 1,
    "project_id": 16,
    "customer_number": "K-12345",
    "from": "2026-01-31T09:00:00.000000Z",
    "to": "2026-01-31T09:00:00.000000Z",
    "repetition": 1,
    "quantity": 1.5,
    "unit_price": 1.5,
    "unit": "Stunde",
    "currency": "EUR",
    "language": "de",
    "status": {
      "id": 1,
      "name": "Geplante"
    },
    "kind": {
      "id": 1,
      "name": "Aufwand"
    },
    "invoice_number": "20240001",
    "invoice_text": "string",
    "sorting": 1,
    "contains_working_hours": true,
    "contains_receipts": true,
    "contains_travel_expenses": true,
    "planned_amount": 1.5,
    "planned_date": "2024-05-31T00:00:00.000000Z",
    "billed_amount": 1.5,
    "billed_date": "2024-05-31T00:00:00.000000Z",
    "vat": 1.5,
    "project_task_id": 1,
    "ticket_id": 1234,
    "article_id": 1,
    "revenueAccounts": [
      {
        "vat": "string",
        "revenue_account": "string"
      }
    ],
    "sales_manager": "string"
  }
}

Response-Felder

Name
id
Type
integer
Description
Eindeutige Kennung der Rechnungsposition.
Name
project_id
Type
integer, nullable
Description
Das Projekt, gegen das diese Position abgerechnet wird.
Name
customer_number
Type
string, nullable
Description
Der Kunde, zu dem das Projekt der Position gehört.
Name
from
Type
string (date-time), nullable
Description
Beginn des Leistungszeitraums, den diese Position abdeckt.
Name
to
Type
string (date-time), nullable
Description
Ende des Leistungszeitraums, den diese Position abdeckt.
Name
repetition
Type
integer, nullable
Description
Wie oft sich diese Position wiederholt, bei wiederkehrenden Positionen.
Name
quantity
Type
number, nullable
Description
Die abgerechnete Menge, in der Einheit der Position.
Name
unit_price
Type
number, nullable
Description
Der Preis pro Einheit, in der Währung der Position.
Name
unit
Type
string, nullable
Description
Die Einheit, in der Menge und Preis angegeben sind.
Name
currency
Type
string, nullable
Description
Der dreistellige Währungscode von unit_price und der abgeleiteten Beträge.
Name
language
Type
string, nullable
Description
Die Sprache, in der der Rechnungstext verfasst ist.
Name
status
Type
object
Description
Der Bearbeitungsstatus der Position — geplant, freigegeben, abgerechnet oder storniert.
Name
status.id
Type
integer
Description
Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.
Name
status.name
Type
string
Description
Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.
Einer der Werte: "Geplante", "genehmigt", "Billed", "Canceled"
Name
kind
Type
object
Description
Was diese Position abrechnet — Arbeitsstunden, Belege, eine Pauschale oder einen manuellen Eintrag.
Name
kind.id
Type
integer
Description
Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.
Name
kind.name
Type
string
Description
Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.
Einer der Werte: "Aufwand", "Flat Rate", "Project Task", "Other Receipts", "Travel Flat Rates", "Ticket", "Artikel", "Cancellation Credit", "Final Performance Level", "Partial Payment on Performance Level", "Partial Payment Percent", "Final Payment Percent", "Partial Payment Fixed Price", "Final Payment Fixed Price", "Partial Payment Costs", "Partial Payment Costs VMA", "Partial Payment Costs Receipts", "Final Payment Costs", "Final Payment Costs Receipts", "Final Invoice Costs VMA", "Prozent", "Careforce Month End"
Name
invoice_number
Type
string, nullable
Description
Die Rechnung, auf der diese Position abgerechnet wurde, sobald sie abgerechnet ist.
Name
invoice_text
Type
string, nullable
Description
Der Text, der für diese Position auf der Rechnung gedruckt wird.
Name
sorting
Type
integer, nullable
Description
Die Reihenfolge der Position unter den übrigen Positionen der Rechnung.
Name
contains_working_hours
Type
boolean, nullable
Description
Ob diese Position erfasste Arbeitsstunden abrechnet.
Name
contains_receipts
Type
boolean, nullable
Description
Ob diese Position erfasste Belege abrechnet.
Name
contains_travel_expenses
Type
boolean, nullable
Description
Ob diese Position erfasste Reisekosten abrechnet.
Name
planned_amount
Type
number, nullable
Description
Der prognostizierte Betrag dieser Position, solange sie nur geplant oder freigegeben ist.
Name
planned_date
Type
string (date-time)
Description
Das geplante Rechnungsdatum, zu dem diese Position abgerechnet werden soll; die Listenfilter wirken auf dieses Feld, nicht auf from/to.
Name
billed_amount
Type
number, nullable
Description
Der abgerechnete Nettobetrag; 0, solange die Position nur geplant oder freigegeben und noch nicht storniert ist.
Name
billed_date
Type
string, nullable
Description
Das Datum der Rechnung, auf der diese Position tatsächlich abgerechnet wurde.
Name
vat
Type
number, nullable
Description
Der auf diese Position angewendete Mehrwertsteuersatz in Prozent.
Name
project_task_id
Type
integer, nullable
Description
Der Vorgang, gegen den diese Position abgerechnet wird, sofern das Projekt Vorgänge verwendet.
Name
ticket_id
Type
integer, nullable
Description
Das Ticket, gegen das diese Position abgerechnet wird, sofern sie aus einem Ticket stammt.
Name
article_id
Type
integer, nullable
Description
Der Artikel, den diese Position abrechnet, sofern sie aus dem Artikelkatalog erstellt wurde.
Name
revenueAccounts
Type
Liste von object
Description
Die Buchhaltungskonten, auf die der Umsatz dieser Position aufgeteilt wird; nur vorhanden, wenn Erlöskonten geführt werden.
Name
revenueAccounts.vat
Type
string
Description
Der Mehrwertsteuersatz in Prozent, für den dieser Buchhaltungseintrag gilt.
Name
revenueAccounts.revenue_account
Type
string
Description
Das Buchhaltungskonto, auf das der Umsatz zu diesem Satz gebucht wird.
Name
sales_manager
Type
string
Description
Der Mitarbeiter, der die Umsatzverantwortung für diese Position trägt. Nur in Instanzen mit der Erweiterung MOD_HHPBERLIN. Keine allgemein verfügbare Funktion.

Aus der OpenAPI-Spezifikation erzeugt — Änderungen gehören in den Quellcode, nicht auf diese Seite.

GET Rechnungspositionen auflisten Artikel