Documentazione tecnica
Integrazione con la Kaufland Seller API
Sellgrip lavora con le vostre chiavi per la Kaufland Seller API. Qui vedete cosa fa nel vostro shop e quale endpoint usa per ogni passaggio.
- Collegamento Chiavi, firma, marketplace e sincronizzazione.
- Ordini Spedizione, annullamento, rimborso, resi e fatture.
- Offerte Creare, modificare, eliminare e regole di prezzo.
- Dati prodotto Per lingua, con categorie, attributi e immagini.
- Ticket Leggere, rispondere, aprire e chiudere.
- Report Dieci report Kaufland, letti ogni giorno.
- API Sellgrip Giacenze e dati prodotto dal vostro sistema.
- Accanto ad altri software Cosa Sellgrip legge soltanto, cosa scrive, arresto di emergenza e registro.
Collegamento
Ogni modifica fatta da Sellgrip è una chiamata API.
| Accesso | Le vostre chiavi per la Kaufland Seller API: client key e secret key del Seller Portal. Le inserite nella dashboard di Sellgrip. |
|---|---|
| Autenticazione | Ogni richiesta è firmata con HMAC usando la secret key. |
| User agent | Sellgrip/1.0.0 (+https://sellgrip.com) |
| Marketplace | DE, AT, CZ, SK, PL, FR, IT, ES e NL. Vedete tutti e nove i paesi. |
| Valute | Prezzi nella valuta di ogni marketplace: EUR, CZK o PLN. Le conversioni usano i tassi di cambio della Banca centrale europea. |
| Sincronizzazione | Un nuovo ordine viene letto appena arriva la notifica push di Kaufland. Tutti gli ordini per marketplace vengono riletti ogni 15 minuti, per sicurezza. Magazzini, gruppi di spedizione e report ogni giorno, l’albero delle categorie ogni settimana. |
| Notifiche push | Sellgrip le registra quando collegate lo shop: order_new, order_unit_new, order_unit_status_changed, return_new, return_status_changed, return_unit_status_changed, item_unit_out_of_stock, item_unit_not_available, item_unit_available, item_unit_deleted. |
| Modifiche | Ogni modifica passa dall’API. Sellgrip non usa file ORDER-Command. |
| Chiavi API | Cifrate con AES-256-GCM. Non più mostrate dopo l’inserimento ed eliminate non appena scollegate Kaufland o eliminate il vostro account. |
| Ubicazione dei dati | Solo in data center nell’Unione europea. Il trattamento segue l’accordo sul trattamento dei dati ai sensi dell’art. 28 GDPR. |
Ordini
Sellgrip legge i vostri ordini per marketplace e riscrive ogni modifica tramite l’API.
| Cosa fa Sellgrip | Kaufland Seller API |
|---|---|
| Leggere un nuovo ordine appena arriva la notifica push di Kaufland. Leggere tutti gli ordini e le unità d’ordine per marketplace ogni 15 minuti, per sicurezza. | GET /order-unitsGET /orders |
| Segnare come spedito con corriere e numero di tracciamento. I corrieri vengono dall’elenco di Kaufland. | PATCH /order-units/{id}/sendGET /carriers |
| Più colli per unità d’ordine. | POST /shipments |
| Segnare molte unità d’ordine come spedite in un solo passaggio. | PATCH /order-units/{id}/send |
| Etichette di spedizione GLS. | POST /shipping-labels |
| Annullare per articolo, con tutti i motivi di annullamento di Kaufland. | PATCH /order-units/{id}/cancel |
| Rimborso parziale per articolo. | PATCH /order-units/{id}/refund |
| Leggere, creare e modificare i resi. | GET /returnsPOST /returnsPUT /returns/{id} |
| Accettare, rifiutare, far riparare o chiarire le unità di reso. | PATCH /return-units/{id}/acceptPATCH /return-units/{id}/rejectPATCH /return-units/{id}/repairPATCH /return-units/{id}/clarify |
| Caricare le fatture voi stessi o farle caricare in automatico dopo la spedizione. | POST /order-invoices/{id_order} |
| Fulfillment by Kaufland: Sellgrip legge anche queste unità d’ordine, resi e ticket e li segnala. Spedizione, annullamento, etichette e decisioni sui resi restano a Kaufland. | GET /order-unitsGET /returnsGET /return-unitsGET /ticketsfulfillment_type |
Offerte
Sellgrip invia le modifiche alle offerte campo per campo: a Kaufland va solo ciò che è cambiato.
| Cosa fa Sellgrip | Kaufland Seller API |
|---|---|
| Creare un’offerta, in ogni condizione dell’articolo prevista da Kaufland. | POST /units |
| Modificare prezzo, giacenza, tempo di lavorazione, stato, magazzino, gruppo di spedizione e prezzo minimo. | PATCH /units/{id}POST /units/bulk |
| Eliminare un’offerta. | DELETE /units/{id} |
| Stato dell’offerta, con i motivi di Kaufland. | POST /units/status |
| Applicare una modifica allo stesso prodotto su tutti i vostri marketplace, con conversione di valuta. | PATCH /units/{id} |
| Regole di prezzo: come proposta o automatiche, mai sotto il vostro punto di pareggio. | PATCH /units/{id} |
| Sincronizzazione delle giacenze da un caricamento CSV o da un feed https, da ogni 15 minuti a una volta al giorno, con scorta di sicurezza per tutto l’account o per articolo. | PATCH /units/{id}POST /units/bulk |
| Magazzini e gruppi di spedizione, letti ogni giorno. | GET /warehousesGET /shipping-groups |
Dati prodotto
Sellgrip scrive i dati prodotto per lingua e marketplace e mostra accanto il riscontro di Kaufland.
| Cosa fa Sellgrip | Kaufland Seller API |
|---|---|
| Scrivere i dati prodotto per lingua e marketplace. | PUT /product-dataPATCH /product-data |
Stato e riscontro di Kaufland per EAN, anche dai report invalid-items e product-data-changes. |
GET /product-data/status/{ean} |
| Scegliere una categoria tra quelle di Kaufland. L’albero delle categorie viene letto ogni settimana. | POST /categories/decideGET /categoriesGET /categories/tree |
| Gli attributi obbligatori sono segnalati. Altri attributi Kaufland si aggiungono per nome. | GET /attributes/searchGET /attributes/by-name/{name} |
| Più immagini per prodotto e per marketplace. | PATCH /product-data |
| Opzionale: copiare in automatico i valori indipendenti dalla lingua nelle vostre altre lingue. | PATCH /product-data |
| Importazione da CSV o da un feed, ogni ora o ogni giorno, con abbinamento delle colonne agli attributi. Vengono inviate solo le righe modificate. | PATCH /product-data |
| Nuovo EAN: prima creare i dati prodotto, poi pubblicare l’offerta. | PUT /product-dataPOST /units |
Ticket
L’assistenza clienti su Kaufland passa dai ticket. Sellgrip li legge e li gestisce tramite l’API.
| Cosa fa Sellgrip | Kaufland Seller API |
|---|---|
| Leggere ticket e messaggi, con motivo e argomento. Gli allegati di Kaufland si possono scaricare. | GET /ticketsGET /tickets/{id} |
| Rispondere, con allegati. | POST /tickets/{id}/messages |
| Aprire un ticket da un ordine. | POST /tickets |
| Chiudere un ticket. | PATCH /tickets/{id}/close |
Report
Sellgrip legge questi report di Kaufland una volta al giorno:
lost-buyboxbuybox-opportunityprice-competitivenesscompetitors-compareraccount-listinginvalid-itemsproduct-data-changesbookings-newsales-newcancellations
API Sellgrip
Il vostro shop, gestionale o ERP invia giacenze e dati prodotto a Sellgrip appena cambiano. Sellgrip li trasmette subito a Kaufland; l’API Sellgrip è inclusa in Business.
| Cosa fate voi | API Sellgrip |
|---|---|
Creare una chiave in Impostazioni › Chiavi API: solo il titolare, con conferma della password. Permessi stock:write e product-data:write, valida fino alla revoca, 90 giorni o un anno. Sellgrip mostra la chiave una sola volta; ogni chiamata la invia nell’intestazione. |
Authorization: Bearer sgk_… |
| Provare la chiave: la risposta indica il vostro account e i permessi della chiave. | GET /api/v1/ping |
Inviare le giacenze in JSON o CSV, fino a 1.000 articoli per chiamata. Sellgrip le scrive su Kaufland con POST /units/bulk prima di rispondere e trattiene la vostra scorta di sicurezza. |
POST /api/v1/stock |
| Inviare i dati prodotto per EAN e lingua, fino a 100 articoli per chiamata, controllati con le stesse regole del modulo Dati prodotto. I primi 20 vanno a Kaufland prima della risposta, il resto nei giri successivi ogni 15 minuti. | POST /api/v1/product-data |
| Vedere a che punto è un articolo: in coda, inviato o rifiutato con le parole di Kaufland, più l’ultimo stato segnalato da Kaufland. | GET /api/v1/product-data/{ean} |
Far leggere gli assistenti IA: con una chiave con il permesso read, Claude Desktop, Claude Code e altri client MCP consultano attività, utile, ordini, Buy Box e opportunità. L’accesso legge soltanto. Di più in Assistenti IA. |
POST /api/v1/mcp |
Accanto ad altri software
Se usate già un integratore o un repricer, scegliete una sola fonte per ogni campo. Qui vedete cosa Sellgrip legge soltanto e quando scrive.
| Solo lettura | Report, registrazioni contabili, versamenti, magazzini, gruppi di spedizione, categorie e opportunità di Kaufland. Sellgrip non ne modifica nulla. |
|---|---|
| Al vostro clic | Spedizione, annullamento, rimborso, resi, ticket, buoni sconto, offerte e dati prodotto. Sellgrip invia solo dopo la vostra conferma nella dashboard. |
| Prezzi automatici | Solo se attivate la modalità automatica delle Regole di prezzo e mettete un prodotto su Automatico. Se un altro strumento o Smart Pricing ha cambiato il prezzo, Sellgrip non invia nulla e rimette il prodotto su Con un clic. |
| Limiti di prezzo | Mai sotto il punto di pareggio, al massimo 5% per modifica e 15% al giorno, entrambi regolabili. Dopo tre errori di fila la modalità automatica si disattiva. |
| Giacenze automatiche | Solo se attivate la sincronizzazione giacenze con il vostro elenco o feed. Se l’elenco sembra sbagliato, per esempio troppi zeri o troppe modifiche insieme, Sellgrip non invia nulla. |
| Dati prodotto automatici | Solo se attivate il feed di importazione. Sellgrip invia allora solo le righe cambiate. |
| Fatture automatiche | Solo se attivate il caricamento automatico, per gli ordini da quel momento. Se Kaufland ha già una fattura per l’ordine, di chiunque sia, Sellgrip non ne carica. |
| API Sellgrip | Il vostro sistema invia giacenze e dati prodotto con una chiave che create voi. Senza una chiave valida non passa nulla. |
| Un campo, una fonte | Se un altro strumento imposta già prezzi o giacenze, lasciate spenta questa automazione in Sellgrip. Senza automazione Sellgrip scrive solo su vostro ordine. |
| Arresto di emergenza | In fondo alla pagina Regole di prezzo. Ferma subito regole di prezzo, sincronizzazione giacenze, importazione dei dati prodotto e modifiche tramite l’API Sellgrip, finché non lo revocate. Ciò che modificate voi in Offerte, le azioni su ordini e ticket e le fatture automatiche proseguono. |
| Registro | In Impostazioni › Registro trovate ciò che il vostro account ha inviato a Kaufland, con ora ed esito. I prezzi automatici sono anche nella cronologia delle Regole di prezzo. |
Collegate il vostro shop Kaufland
Collegate lo shop da soli nella dashboard, con due chiavi del Seller Portal. Poi parte la prima sincronizzazione, gratis in ogni piano.