Endpoint dei fornitori

NOVITÀ v2.3.0

Fornitori

Gestione dei fornitori con supporto CRUD completo.


Panoramica

OperazioneMetodoEndpointAmbito
EsportazioneGET/xpanel/xoPort/export/json/suppliersfornitori:lettura
ImportPOST/xpanel/xoPort/import/json/suppliersfornitori:scrittura
AggiornaPUT/xpanel/xoPort/import/json/fornitorifornitori:scrittura
EliminaDELETE/xpanel/xoPort/delete/json/suppliersfornitori:elimina

Esporta (GET)

Parametri di query

ParametriTipoDescrizione
suppliers_idintEsporta singoli fornitori
limitintNumero massimo (impostazione predefinita: 100)
offsetintPosizione iniziale

Campi della risposta

  • suppliers_id - ID univoco
  • suppliers_name - Nome del fornitore
  • suppliers_street, suppliers_postcode, suppliers_city
  • suppliers_country - Codice paese (DE, AT, ecc.)
  • suppliers_email, suppliers_phone, suppliers_fax
  • suppliers_url - Sito web
  • languages{} - Informazioni specifiche per lingua

Importazione (POST/PUT)

Richiesta di esempio

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"
        }
      }
    }]
  }'

Elimina (DELETE)

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

Nota: verranno rimosse anche le associazioni tra prodotti e fornitori.


Assegnazione dei prodotti

I fornitori possono essere associati durante l'importazione dei prodotti:

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

Nota: products_model è il codice articolo del fornitore, non il codice articolo presente nel negozio. L'elenco sostituisce tutte le associazioni del fornitore relative all'articolo: i fornitori non menzionati vengono rimossi e una voce senza products_model crea l'associazione senza numero. In questo caso, un numero esistente andrà perso. Chi modifica solo altri campi, ometta suppliers. L'esportazione dei prodotti fornisce per ogni associazione suppliers_id, suppliers_name e products_model.