Rechnungspositionen eines Projekts über alle seine Rechnungen hinweg auflisten

Entspricht GET /invoices/{invoice}/items, jedoch auf ein Projekt statt auf eine einzelne Rechnung bezogen.

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

Request

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

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

Pfad-Parameter

Name
id
Type
integer
Description
Die ID des Projekts

Query-Parameter

Name
perPage
Type
integer, nullable
Description
Wird auf diesem Endpunkt ignoriert — senden Sie stattdessen limit. Ein hier angegebener Wert wird durch limit ersetzt, oder durch den Standardwert, wenn limit fehlt.
Name
page
Type
integer, nullable
Description
Die zurückzugebende Ergebnisseite, beginnend bei 1.
Name
orderBy
Type
string, nullable
Description
Name des Feldes, nach dem sortiert wird.
Name
order
Type
string, nullable
Description
Sortierrichtung, aufsteigend oder absteigend.
Einer der Werte: "asc", "desc"
Name
limit
Type
integer, nullable
Description
Die Anzahl der Datensätze pro Seite, 1 bis 200. Standardwert ist 15.
Name
id[]
Type
Liste von integer
Description
Beschränkt das Ergebnis auf eine oder mehrere Rechnungspositions-IDs.
Name
status[]
Type
Liste von integer
Description
Beschränkt das Ergebnis auf einen oder mehrere Status: 0 geplant, 1 genehmigt, 2 abgerechnet, 3 storniert. Sowohl ein einzelner Wert als auch eine Liste wird akzeptiert (status[]=0&status[]=1).
Name
project_id[]
Type
Liste von integer
Description
Beschränkt das Ergebnis auf eine oder mehrere Projekt-IDs.
Name
planned_from
Type
string (date-time), nullable
Description
Nur Positionen zurückgeben, deren planned_date an oder nach diesem Datum liegt (einschließlich).
Name
planned_to
Type
string (date-time), nullable
Description
Nur Positionen zurückgeben, deren planned_date an oder vor diesem Datum liegt (einschließlich).

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"
    }
  ],
  "links": {
    "first": "string",
    "last": "string",
    "prev": "string",
    "next": "string"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {
        "url": "string",
        "label": "string",
        "active": true
      }
    ],
    "path": "string",
    "per_page": 1,
    "to": 1,
    "total": 1
  }
}

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 Einem Projekt zugeordnete Mitarbeiter auflisten GET Einem Projekt zugeordnete Einsatzorte auflisten