Basis-URL
https://{tenant}.logzi.com/api/price_list/
Jede Anfrage liefert eine JSON-Antwort zurück. Bei Erfolg ist result.code == 1, im Fehlerfall result.code == 0. Wenn beim get-Endpunkt weder product_id noch partnumber angegeben ist, werden die Preise aller Produkte zurückgegeben.
/api/price_list/get
Abrufen des Produktpreises nach Filterkriterien. Wenn weder product_id noch partnumber angegeben ist, werden die Preise aller Produkte zurückgegeben.
Query-Parameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
product_id | int | Produkt-ID | |
company_id | int | Firmen-ID | |
partner_id | int | Filterung nach partnerspezifischem Preis | |
currency_id | int | Währungs-ID | |
store_id | int | Lager-ID | |
price_list_id | int | Preisliste-ID |
Beispielanfrage
GET /api/price_list/get?product_id=5¤cy_id=1
X-API-KEY: {ihr_api_schluessel}
/api/price_list/list
Paginierbares Abrufen von Preislisteneinträgen mit Filtermöglichkeiten.
Query-Parameter
| Parameter | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
list_offset | int | Paginierungs-Offset (Standard: 0) | |
list_count | int | Anzahl der Datensätze pro Seite | |
list_condition | array | Filterbedingungen als assoziatives Array | |
list_params | array | Zusätzliche Abfrageparameter |
Beispielanfrage
GET /api/price_list/list?list_offset=0&list_count=50
X-API-KEY: {ihr_api_schluessel}
/api/price_list/save
Erstellen oder Ändern eines Preislisteneintrags. Das Produkt kann über product_id oder partnumber (Artikelnummer) angegeben werden, eines der beiden Felder ist erforderlich. Existiert für die Kombination aus Produkt, Firma, Partnertyp und Lager bereits ein Eintrag, wird dieser geändert, andernfalls wird ein neuer erstellt. Als Dezimaltrennzeichen sind Punkt und Komma zulässig.
POST-Felder - data-Objekt
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
product_id | int | Produkt-ID. Erforderlich, wenn partnumber nicht angegeben ist | |
partnumber | string | Artikelnummer (mind. 3 Zeichen). Erforderlich, wenn product_id nicht angegeben ist | |
id | int | Preislisteneintrag-ID. Nicht erforderlich: Das System erkennt den vorhandenen Datensatz anhand von Produkt, company_id, partner_type_id und store_id (siehe unten) | |
company_id | int | Firmen-ID (Standard: 1) | |
partner_type_id | int | Partnertyp-ID für partnertypspezifische Preise. Wenn nicht angegeben, ist der Preis allgemein | |
store_id | int | Lager-ID für lagerspezifische Preise. Wenn nicht angegeben, ist der Preis allgemein | |
price | float | Netto-Verkaufspreis | |
currency_id | int | Währungs-ID des Verkaufspreises | |
tax_id | int | MwSt.-Satz-ID des Verkaufspreises | |
price_discount | float | Rabatt in Prozent (%) | |
price_on_sale | float | Netto-Aktionspreis | |
price_on_sale_date_end | datetime | Ablaufdatum und -zeit des Aktionspreises (YYYY-MM-DD HH:MM:SS) | |
incoming_price | float | Netto-Einkaufspreis | |
incoming_currency_id | int | Währungs-ID des Einkaufspreises | |
incoming_tax_id | int | MwSt.-Satz-ID des Einkaufspreises | |
incoming_cost_price | float | Einkaufsselbstkostenpreis (um Nebenkosten erhöhter Einkaufspreis) | |
list_price | float | Netto-Listenpreis | |
list_currency_id | int | Währungs-ID des Listenpreises | |
list_tax_id | int | MwSt.-Satz-ID des Listenpreises |
Datensatzerkennung
Das System sucht den vorhandenen Eintrag anhand der Kombination aus product_id (oder partnumber), company_id, partner_type_id und store_id. Wenn partner_type_id oder store_id nicht angegeben ist, wird der allgemeine Preis (unabhängig von Partnertyp bzw. Lager) gespeichert. Es werden nur die in der Anfrage enthaltenen Felder geändert. Bei einer Änderung enthält das Feld data.id der Antwort die ID des geänderten Eintrags.
Beispielanfrage
POST /api/price_list/save
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json
{
"data": {
"product_id": 5,
"company_id": 1,
"partner_type_id": 2,
"store_id": 1,
"price": 9500,
"currency_id": 1,
"tax_id": 1,
"price_discount": 5,
"price_on_sale": 8900,
"price_on_sale_date_end": "2026-12-31 23:59:59",
"incoming_price": 6200,
"incoming_currency_id": 1,
"incoming_tax_id": 1,
"incoming_cost_price": 6350,
"list_price": 10500,
"list_currency_id": 1,
"list_tax_id": 1
}
}
/api/price_list/save_avg
Erfassen des Durchschnittspreises eines Produkts.
POST-Felder - data-Objekt
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
product_id | int | Produkt-ID | |
price | float | Zu erfassender Durchschnittspreis |
Beispielanfrage
POST /api/price_list/save_avg
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json
{ "data": { "product_id": 5, "price": 8750.50 } }
/api/price_list/delete
Löschen eines Preislisteneintrags anhand der ID.
POST-Felder - data-Objekt
| Feld | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
id | int | ID des zu löschenden Preislisteneintrags |
Beispielanfrage
POST /api/price_list/delete
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json
{ "data": { "id": 12 } }
Interessierst du dich für unsere Software? Schreib uns einfach!
Jetzt registrieren,
später bezahlen!