Supplier Endpoint

NEW v2.3.0

Suppliers

Supplier management with full CRUD support.


Overview

OperationMethodEndpointScope
ExportGET/xpanel/xoport/export/json/supplierssuppliers:read
ImportPOST/xpanel/xoport/import/json/supplierssuppliers:write
UpdatePUT/xpanel/xoport/import/json/supplierssuppliers:write
DeleteDELETE/xpanel/xoport/delete/json/supplierssuppliers:delete

Export (GET)

Query Parameters

ParameterTypeDescription
suppliers_idintExport individual suppliers
limitintMax. number (Default: 100)
offsetintStart position

Response fields

  • suppliers_id - Unique ID
  • suppliers_name - Supplier name
  • suppliers_street, suppliers_postcode, suppliers_city
  • suppliers_country - Country code (DE, AT, etc.)
  • suppliers_email, suppliers_phone, suppliers_fax
  • suppliers_url - Website
  • languages{} - Language-specific information

Import (POST/PUT)

Sample 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"

Note: Product-vendor mappings are also removed.


Product Assignment

Suppliers can be assigned during product import:

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

Note: Here, products_model is the supplier's article number, not the article number in the shop. The list replaces all supplier assignments of the product: suppliers that are not listed are removed, and an entry without products_model creates the assignment without a number. An existing number is lost. If you only change other fields, leave out suppliers. The product export returns suppliers_id, suppliers_name and products_model for each assignment.