Preistabellen eines Kunden auflisten

Liefert eine paginierte Liste der dem angegebenen Kunden zugeordneten Preistabellen.

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

Request

GET /api/v1/customers/{customer_number}/price-tables

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

Pfad-Parameter

Name
customer_number
Type
string
Description
Die Kundennummer des Kunden

Query-Parameter

Name
page
Type
integer, nullable
Description
Die zurückzugebende Ergebnisseite, beginnend bei 1.

Response

{
  "data": [
    {
      "id": 1,
      "start_date": "2024-01-15T00:00:00.000000Z",
      "customer_number": "K-12345",
      "project_id": 16,
      "type": {
        "id": "string",
        "name": "Basispreistabelle"
      },
      "prices": [
        {
          "id": 1,
          "price_group": "Junior-Entwickler",
          "price": 1.5,
          "price_table_id": "string",
          "type": {
            "id": "string",
            "name": "Stundensatz"
          },
          "activity": "string",
          "ahr_factor": 1.5
        }
      ],
      "factors": [
        {
          "id": 1,
          "day": {
            "id": 1,
            "name": "So"
          },
          "start_time": "11:10:49",
          "end_time": "15:10:49",
          "factor": 1.5,
          "price_table_id": 1,
          "activity_id": 1
        }
      ]
    }
  ],
  "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 Preistabelle.
Name
start_date
Type
string (date-time), nullable
Description
Datum, ab dem die Preistabelle gilt.
Name
customer_number
Type
string, nullable
Description
Nummer des Kunden, zu dem diese Preistabelle gehört, bei einer Preistabelle auf Kundenebene.
Name
project_id
Type
integer, nullable
Description
Kennung des Projekts, zu dem diese Preistabelle gehört, bei einer Preistabelle auf Projektebene.
Name
type
Type
object, nullable
Description
Ob die Preistabelle einem Kunden oder einem Projekt zugeordnet ist.
Name
type.id
Type
string
Description
Der gespeicherte Wert. Vergleichen Sie gegen diesen, nicht gegen name.
Name
type.name
Type
string
Description
Die lesbare Bezeichnung in der Sprache des Mandanten. Nicht parsen.
Einer der Werte: "Basispreistabelle", "Project Price Table", "Customer Price Table"
Name
prices
Type
Liste von Price
Description
In dieser Preistabelle definierte Preise.
Name
prices.id
Type
integer
Description
Eindeutige Kennung des Preises.
Name
prices.price_group
Type
string
Description
Preisgruppe, für die dieser Preis gilt.
Name
prices.price
Type
number
Description
Der Preisbetrag.
Name
prices.price_table_id
Type
string
Description
Kennung der Preistabelle, zu der dieser Preis gehört.
Name
prices.type
Type
object, nullable
Description
Ob dieser Preis ein Stundensatz, ein Tagessatz oder eine Pauschale ist.
Name
prices.activity
Type
string, nullable
Description
Tätigkeit, für die dieser Preis gilt, wenn er auf eine einzelne Tätigkeit beschränkt ist.
Name
prices.ahr_factor
Type
number, nullable
Description
Stundensatzzuschlag, der auf diesen Preis angewendet wird. Nur in Instanzen mit der Erweiterung MOD_3P. Keine allgemein verfügbare Funktion.
Name
factors
Type
Liste von PriceFactor
Description
In dieser Preistabelle definierte zeitabhängige Faktoren, z. B. für Nacht- oder Wochenendzuschläge.
Name
factors.id
Type
integer
Description
Eindeutige Kennung des Preisfaktors.
Name
factors.day
Type
object
Description
Wochentag, für den dieser Faktor gilt.
Name
factors.start_time
Type
string (date-time), nullable
Description
Uhrzeit, ab der dieser Faktor gilt.
Name
factors.end_time
Type
string (date-time), nullable
Description
Uhrzeit, bis zu der dieser Faktor gilt.
Name
factors.factor
Type
number
Description
Multiplikator, der in diesem Zeitfenster auf den Preis angewendet wird.
Name
factors.price_table_id
Type
integer
Description
Kennung der Preistabelle, zu der dieser Faktor gehört.
Name
factors.activity_id
Type
integer, nullable
Description
Kennung der Tätigkeit, auf die dieser Faktor beschränkt ist, falls vorhanden.

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

DELETE Ansprechpartner löschen GET Preistabelle eines Kunden abrufen