Bestandsbewegungen-API

Verfolgen und erfassen Sie Bestandsbewegungen in Ihren Lagern. Jede Bestandsaenderung wird als Bewegung protokolliert.

Endpunkte

GET

/stock-movements

stock_movements:read

Eine paginierte Liste von Bestandsbewegungen abrufen. Unterstuetzt Filter nach Produkt, Lager, Typ und Datumsbereich.

POST

/stock-movements

stock_movements:write

Eine neue Bestandsbewegung erfassen. Die Bestandsmengen werden automatisch aktualisiert.

Feldreferenz

Feld	Typ	Erforderlich	Beschreibung
id	string	Nein	Eindeutige Bestandsbewegung-ID (schreibgeschuetzt)
productId	string	Ja	Produktkennung
productSku	string	Nein	Produkt-SKU (schreibgeschuetzt)
productName	string	Nein	Produktname (schreibgeschuetzt)
warehouseId	string	Ja	Lagerkennung
warehouseName	string	Nein	Lagername (schreibgeschuetzt)
variantId	string	Nein	Produktvarianten-ID (falls zutreffend)
quantity	integer	Ja	Bewegungsmenge (positive ganze Zahl)
movementType	string	Ja	IN, OUT, ADJUSTMENT, TRANSFER_OUT oder TRANSFER_IN
reference	string	Nein	Referenznummer (z.B. Bestellnummer)
unitCost	integer	Nein	Stueckkosten in Cent
batchNumber	string	Nein	Chargennummer
notes	string	Nein	Zusaetzliche Anmerkungen
createdAt	datetime	Nein	ISO 8601 Zeitstempel (schreibgeschuetzt)

Abfrageparameter (Liste)

Feld	Typ	Erforderlich	Beschreibung
page	integer	Nein	Seitennummer (Standard: 1)
limit	integer	Nein	Eintraege pro Seite (Standard: 20, Maximum: 100)
productId	string	Nein	Nach Produkt-ID filtern
warehouseId	string	Nein	Nach Lager-ID filtern
movementType	string	Nein	Nach Typ filtern: IN, OUT, ADJUSTMENT, TRANSFER_OUT, TRANSFER_IN
from	string	Nein	Startdatum-Filter (ISO 8601)
to	string	Nein	Enddatum-Filter (ISO 8601)

Beispiel

Bestandsbewegungen auflisten

bash

curl "https://api.mercozy.com/api/v1/external/stock-movements?page=1&limit=20&movementType=IN" \
  -H "X-API-Key: mk_live_xxxxx"

Eine Bestandsbewegung erstellen

bash

curl -X POST "https://api.mercozy.com/api/v1/external/stock-movements" \
  -H "X-API-Key: mk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "product-uuid",
    "warehouseId": "warehouse-uuid",
    "quantity": 100,
    "movementType": "IN",
    "reference": "PO-2024-001",
    "notes": "Initial stock"
  }'

Beispielantwort

json

{
  "data": {
    "id": "sm_abc123",
    "productId": "product-uuid",
    "productSku": "WDG-001",
    "productName": "Premium Widget",
    "warehouseId": "warehouse-uuid",
    "warehouseName": "Main Warehouse",
    "variantId": null,
    "quantity": 100,
    "movementType": "IN",
    "reference": "PO-2024-001",
    "unitCost": null,
    "batchNumber": null,
    "notes": "Initial stock",
    "createdAt": "2025-12-15T10:30:00Z"
  }
}