Preisliste API

Abfrage und Festlegung von Produktpreisen nach Partner, Währung und Lager

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.

GET /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

ParameterTypPflichtfeldBeschreibung
product_idintProdukt-ID
company_idintFirmen-ID
partner_idintFilterung nach partnerspezifischem Preis
currency_idintWährungs-ID
store_idintLager-ID
price_list_idintPreisliste-ID

Beispielanfrage

GET /api/price_list/get?product_id=5¤cy_id=1
X-API-KEY: {ihr_api_schluessel}
GET /api/price_list/list

Paginierbares Abrufen von Preislisteneinträgen mit Filtermöglichkeiten.

Query-Parameter

ParameterTypPflichtfeldBeschreibung
list_offsetintPaginierungs-Offset (Standard: 0)
list_countintAnzahl der Datensätze pro Seite
list_conditionarrayFilterbedingungen als assoziatives Array
list_paramsarrayZusätzliche Abfrageparameter

Beispielanfrage

GET /api/price_list/list?list_offset=0&list_count=50
X-API-KEY: {ihr_api_schluessel}
POST /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

FeldTypPflichtfeldBeschreibung
product_idintProdukt-ID. Erforderlich, wenn partnumber nicht angegeben ist
partnumberstringArtikelnummer (mind. 3 Zeichen). Erforderlich, wenn product_id nicht angegeben ist
idintPreislisteneintrag-ID. Nicht erforderlich: Das System erkennt den vorhandenen Datensatz anhand von Produkt, company_id, partner_type_id und store_id (siehe unten)
company_idintFirmen-ID (Standard: 1)
partner_type_idintPartnertyp-ID für partnertypspezifische Preise. Wenn nicht angegeben, ist der Preis allgemein
store_idintLager-ID für lagerspezifische Preise. Wenn nicht angegeben, ist der Preis allgemein
pricefloatNetto-Verkaufspreis
currency_idintWährungs-ID des Verkaufspreises
tax_idintMwSt.-Satz-ID des Verkaufspreises
price_discountfloatRabatt in Prozent (%)
price_on_salefloatNetto-Aktionspreis
price_on_sale_date_enddatetimeAblaufdatum und -zeit des Aktionspreises (YYYY-MM-DD HH:MM:SS)
incoming_pricefloatNetto-Einkaufspreis
incoming_currency_idintWährungs-ID des Einkaufspreises
incoming_tax_idintMwSt.-Satz-ID des Einkaufspreises
incoming_cost_pricefloatEinkaufsselbstkostenpreis (um Nebenkosten erhöhter Einkaufspreis)
list_pricefloatNetto-Listenpreis
list_currency_idintWährungs-ID des Listenpreises
list_tax_idintMwSt.-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
  }
}
POST /api/price_list/save_avg

Erfassen des Durchschnittspreises eines Produkts.

POST-Felder - data-Objekt

FeldTypPflichtfeldBeschreibung
product_idintProdukt-ID
pricefloatZu 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 } }
POST /api/price_list/delete

Löschen eines Preislisteneintrags anhand der ID.

POST-Felder - data-Objekt

FeldTypPflichtfeldBeschreibung
idintID des zu löschenden Preislisteneintrags

Beispielanfrage

POST /api/price_list/delete
X-API-KEY: {ihr_api_schluessel}
Content-Type: application/json

{ "data": { "id": 12 } }

Nimm Kontakt mit uns auf

Interessierst du dich für unsere Software? Schreib uns einfach!

Brauchst du Hilfe?

Wenn du keine Antwort findest und Unterstützung brauchst

Jetzt registrieren,
später bezahlen!

Teste es 3 Tage kostenlos, ohne Risiko und Verpflichtungen!