Point d'accès des fournisseurs

NOUVEAU v2.3.0

Fournisseurs

Gestion des fournisseurs avec prise en charge complète des opérations CRUD.

Aperçu

Opération	Méthode	Point de terminaison	Portée
Exportation	`GET`	`/xpanel/xoPort/export/json/suppliers`	`fournisseurs : lecture`
Import	`POST`	`/xpanel/xoPort/import/json/suppliers`	`fournisseurs : écriture`
Mise à jour	`PUT`	`/xpanel/xoPort/import/json/fournisseurs`	`fournisseurs : écriture`
Supprimer	`DELETE`	`/xpanel/xoPort/delete/json/suppliers`	`suppliers:delete`

Exportation (GET)

Paramètres de requête

Paramètres	Type	Description
`suppliers_id`	int	Exporter un fournisseur individuel
`limit`	int	Nombre maximal (par défaut : 100)
`offset`	int	Position de départ

Champs de réponse

suppliers_id - Identifiant unique
suppliers_name - Nom du fournisseur
suppliers_street, suppliers_postcode, suppliers_city
suppliers_country - Code pays (DE, AT, etc.)
suppliers_email, suppliers_phone, suppliers_fax
suppliers_url - Site web
languages{} - Informations spécifiques à la langue

Importation (POST/PUT)

Exemple de requête

curl -X POST "https://shop.de/xpanel/xoPort/import/json/suppliers" \
  -H "Authorization: Bearer VOTRE_JETON_D'ACCÈS" \
  -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"
        }
      }
    }]
  }'

Supprimer (DELETE)

curl -X DELETE "https://shop.de/xpanel/xoPort/delete/json/suppliers?suppliers_id=5" \
  -H "Authorization: Bearer VOTRE_JETON_D'ACCÈS"

Remarque : les associations produit-fournisseur sont également supprimées.

Association de produits

Les fournisseurs peuvent être associés lors de l'importation des produits :

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

Remarque : products_model correspond ici à la référence du fournisseur, et non à la référence de l'article dans la boutique. Cette liste remplace toutes les affectations de fournisseurs de l'article : les fournisseurs non mentionnés sont supprimés, et une entrée sans products_model crée l'affectation sans numéro. Un numéro existant est alors perdu. Si vous ne modifiez que d'autres champs, omettez suppliers. L'exportation des produits fournit, pour chaque affectation, suppliers_id, suppliers_name et products_model.