Neue API-Version v7.12 wurde veröffentlicht! 🎉
REST DokumentationKundenGET Preistabelle eines Kunden abrufen

Preistabelle eines Kunden abrufen

Liefert eine einzelne dem angegebenen Kunden zugeordnete Preistabelle, einschließlich ihrer Preise und Faktoren.

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

Request

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

Pfad-Parameter

  • Name
    customer_number
    Type
    string
    Description

    Die Kundennummer des Kunden

  • Name
    id
    Type
    integer
    Description

    Die ID der Preistabelle

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
      }
    ]
  }
}

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.