Endpoint dei fornitori
Fornitori
Gestione dei fornitori con supporto CRUD completo.
Panoramica
| Operazione | Metodo | Endpoint | Ambito |
|---|---|---|---|
| Esportazione | GET | /xpanel/xoPort/export/json/suppliers | fornitori:lettura |
| Import | POST | /xpanel/xoPort/import/json/suppliers | fornitori:scrittura |
| Aggiorna | PUT | /xpanel/xoPort/import/json/fornitori | fornitori:scrittura |
| Elimina | DELETE | /xpanel/xoPort/delete/json/suppliers | fornitori:elimina |
Esporta (GET)
Parametri di query
| Parametri | Tipo | Descrizione |
|---|---|---|
suppliers_id | int | Esporta singoli fornitori |
limit | int | Numero massimo (impostazione predefinita: 100) |
offset | int | Posizione iniziale |
Campi della risposta
suppliers_id- ID univocosuppliers_name- Nome del fornitoresuppliers_street,suppliers_postcode,suppliers_citysuppliers_country- Codice paese (DE, AT, ecc.)suppliers_email,suppliers_phone,suppliers_faxsuppliers_url- Sito weblanguages{}- 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.