Suppliers Endpoint

NEU v2.3.0

Suppliers

Lieferantenverwaltung mit vollständigem CRUD-Support.

Übersicht

Operation	Method	Endpoint	Scope
Export	`GET`	`/xpanel/xoport/export/json/suppliers`	`suppliers:read`
Import	`POST`	`/xpanel/xoport/import/json/suppliers`	`suppliers:write`
Update	`PUT`	`/xpanel/xoport/import/json/suppliers`	`suppliers:write`
Delete	`DELETE`	`/xpanel/xoport/delete/json/suppliers`	`suppliers:delete`

Export (GET)

Query-Parameter

Parameter	Typ	Beschreibung
`suppliers_id`	int	Einzelnen Lieferanten exportieren
`limit`	int	Max. Anzahl (Default: 100)
`offset`	int	Startposition

Response-Felder

suppliers_id - Eindeutige ID
suppliers_name - Name des Lieferanten
suppliers_street, suppliers_postcode, suppliers_city
suppliers_country - Ländercode (DE, AT, etc.)
suppliers_email, suppliers_phone, suppliers_fax
suppliers_url - Website
languages{} - Sprachspezifische Infos

Import (POST/PUT)

Beispiel-Request

curl -X POST "https://shop.de/xpanel/xoport/import/json/suppliers" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "suppliers",
    "data": [{
      "suppliers_name": "Großhandel Meyer",
      "suppliers_street": "Industrieweg 15",
      "suppliers_postcode": "01234",
      "suppliers_city": "Leipzig",
      "suppliers_country": "DE",
      "suppliers_email": "info@meyer-grosshandel.de",
      "suppliers_phone": "+49 341 1234567",
      "languages": {
        "de": {
          "suppliers_info": "Spezialist für Bürobedarf"
        }
      }
    }]
  }'

Delete (DELETE)

curl -X DELETE "https://shop.de/xpanel/xoport/delete/json/suppliers?suppliers_id=5" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Hinweis: Produkt-Lieferanten-Zuordnungen werden ebenfalls entfernt.

Produkt-Zuordnung

Lieferanten können beim Produkt-Import zugeordnet werden:

{
  "type": "products",
  "data": [{
    "products_model": "PROD-001",
    "suppliers": [
      {"suppliers_id": 3, "products_model": "LF-4711"},
      {"suppliers_id": 7, "products_model": "A-0815"}
    ]
  }]
}

Hinweis: products_model ist hier die Artikelnummer des Lieferanten, nicht die Artikelnummer im Shop. Die Liste ersetzt alle Lieferanten-Zuordnungen des Artikels: Nicht genannte Lieferanten werden entfernt, und ein Eintrag ohne products_model legt die Zuordnung ohne Nummer an. Eine vorhandene Nummer geht dabei verloren. Wer nur andere Felder ändert, lässt suppliers weg. Der Produkt-Export liefert je Zuordnung suppliers_id, suppliers_name und products_model.