Documentation technique
Intégration de l’API Kaufland Seller
Sellgrip travaille avec vos propres clés pour l’API Kaufland Seller. Vous voyez ici ce qu’il fait dans votre boutique et quel endpoint il utilise pour chaque étape.
- Connexion Clés, signature, places de marché et synchronisation.
- Commandes Expédition, annulation, remboursement, retours et factures.
- Offres Créer, modifier, supprimer et règles de prix.
- Données produit Par langue, avec catégories, attributs et images.
- Tickets Lire, répondre, ouvrir et fermer.
- Rapports Dix rapports Kaufland, lus chaque jour.
- API Sellgrip Stock et données produit depuis votre système.
- À côté d’autres logiciels Ce que Sellgrip lit seulement, ce qu’il écrit, arrêt d’urgence et journal.
Connexion
Chaque modification faite par Sellgrip est un appel API.
| Accès | Vos propres clés pour l’API Kaufland Seller : la client key et la secret key du Seller Portal. Vous les saisissez dans le tableau de bord Sellgrip. |
|---|---|
| Authentification | Chaque requête est signée par HMAC avec la secret key. |
| User agent | Sellgrip/1.0.0 (+https://sellgrip.com) |
| Places de marché | DE, AT, CZ, SK, PL, FR, IT, ES et NL. Voir les neuf pays. |
| Devises | Les prix dans la devise de chaque place de marché : EUR, CZK ou PLN. Les conversions utilisent les taux de change de la Banque centrale européenne. |
| Synchronisation | Une nouvelle commande dès que la notification push de Kaufland arrive. Toutes les commandes par place de marché toutes les 15 minutes, par sécurité. Entrepôts, groupes d’expédition et rapports chaque jour, l’arborescence des catégories chaque semaine. |
| Notifications push | Sellgrip s’y abonne dès que vous vous connectez : 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. |
| Écritures | Chaque modification passe par l’API. Sellgrip n’utilise pas de fichiers ORDER-Command. |
| Clés API | Chiffrées en AES-256-GCM. Jamais réaffichées après la saisie et supprimées dès que vous déconnectez Kaufland ou supprimez votre compte. |
| Hébergement | Uniquement dans des centres de données de l’Union européenne. Le traitement suit l’accord de sous-traitance selon l’art. 28 RGPD. |
Commandes
Sellgrip lit vos commandes par place de marché et renvoie chaque modification par l’API.
| Ce que fait Sellgrip | API Kaufland Seller |
|---|---|
| Lire une nouvelle commande dès que la notification push de Kaufland arrive. Lire toutes les commandes et unités de commande par place de marché toutes les 15 minutes, par sécurité. | GET /order-unitsGET /orders |
| Marquer comme expédié avec le transporteur et le numéro de suivi. Les transporteurs viennent de la liste de Kaufland. | PATCH /order-units/{id}/sendGET /carriers |
| Plusieurs colis par unité de commande. | POST /shipments |
| Marquer de nombreuses unités de commande comme expédiées en une seule étape. | PATCH /order-units/{id}/send |
| Étiquettes d’expédition GLS. | POST /shipping-labels |
| Annuler par article, avec tous les motifs d’annulation de Kaufland. | PATCH /order-units/{id}/cancel |
| Remboursement partiel par article. | PATCH /order-units/{id}/refund |
| Lire, créer et modifier des retours. | GET /returnsPOST /returnsPUT /returns/{id} |
| Accepter, refuser, faire réparer ou clarifier des unités de retour. | PATCH /return-units/{id}/acceptPATCH /return-units/{id}/rejectPATCH /return-units/{id}/repairPATCH /return-units/{id}/clarify |
| Téléverser les factures vous-même ou les faire téléverser automatiquement après l’expédition. | POST /order-invoices/{id_order} |
| Fulfillment by Kaufland : Sellgrip lit aussi ces unités de commande, retours et tickets et les signale. L’expédition, l’annulation, les étiquettes et les décisions de retour restent chez Kaufland. | GET /order-unitsGET /returnsGET /return-unitsGET /ticketsfulfillment_type |
Offres
Sellgrip envoie les modifications d’offres champ par champ : seul ce qui a changé part chez Kaufland.
| Ce que fait Sellgrip | API Kaufland Seller |
|---|---|
| Créer une offre, dans chaque état d’article que Kaufland propose. | POST /units |
| Modifier le prix, le stock, le délai de traitement, le statut, l’entrepôt, le groupe d’expédition et le prix minimum. | PATCH /units/{id}POST /units/bulk |
| Supprimer une offre. | DELETE /units/{id} |
| Statut de l’offre, avec les motifs de Kaufland. | POST /units/status |
| Appliquer une modification au même produit sur toutes vos places de marché, avec conversion de devise. | PATCH /units/{id} |
| Règles de prix : en suggestion ou automatiques, jamais sous votre seuil de rentabilité. | PATCH /units/{id} |
| Synchronisation du stock depuis un import CSV ou un flux https, toutes les 15 minutes jusqu’à une fois par jour, avec un stock tampon pour tout le compte ou par article. | PATCH /units/{id}POST /units/bulk |
| Entrepôts et groupes d’expédition, lus chaque jour. | GET /warehousesGET /shipping-groups |
Données produit
Sellgrip écrit les données produit par langue et par place de marché et affiche la réponse de Kaufland à côté.
| Ce que fait Sellgrip | API Kaufland Seller |
|---|---|
| Écrire les données produit par langue et par place de marché. | PUT /product-dataPATCH /product-data |
Statut et réponse de Kaufland par EAN, aussi à partir des rapports invalid-items et product-data-changes. |
GET /product-data/status/{ean} |
| Choisir une catégorie parmi celles de Kaufland. L’arborescence est lue chaque semaine. | POST /categories/decideGET /categoriesGET /categories/tree |
| Les attributs obligatoires sont signalés. Vous ajoutez d’autres attributs Kaufland par leur nom. | GET /attributes/searchGET /attributes/by-name/{name} |
| Plusieurs images par produit et par place de marché. | PATCH /product-data |
| En option : copier automatiquement les valeurs indépendantes de la langue dans vos autres langues. | PATCH /product-data |
| Import depuis un CSV ou un flux, toutes les heures ou chaque jour, avec correspondance des colonnes aux attributs. Seules les lignes modifiées sont envoyées. | PATCH /product-data |
| Nouvel EAN : créer d’abord les données produit, puis mettre l’offre en ligne. | PUT /product-dataPOST /units |
Tickets
Le service client sur Kaufland passe par des tickets. Sellgrip les lit et les traite par l’API.
| Ce que fait Sellgrip | API Kaufland Seller |
|---|---|
| Lire les tickets et les messages, avec le motif et le sujet. Les pièces jointes de Kaufland sont téléchargeables. | GET /ticketsGET /tickets/{id} |
| Répondre, avec des pièces jointes. | POST /tickets/{id}/messages |
| Ouvrir un ticket depuis une commande. | POST /tickets |
| Fermer un ticket. | PATCH /tickets/{id}/close |
Rapports
Sellgrip lit ces rapports de Kaufland une fois par jour :
lost-buyboxbuybox-opportunityprice-competitivenesscompetitors-compareraccount-listinginvalid-itemsproduct-data-changesbookings-newsales-newcancellations
API Sellgrip
Votre boutique, votre gestion des stocks ou votre ERP envoie le stock et les données produit à Sellgrip dès qu’ils changent. Sellgrip les transmet aussitôt à Kaufland ; l’API Sellgrip est incluse dans Business.
| Ce que vous faites | API Sellgrip |
|---|---|
Créer une clé sous Paramètres › Clés API : réservé au propriétaire, confirmé par votre mot de passe. Droits stock:write et product-data:write, valable jusqu’à révocation, 90 jours ou un an. Sellgrip affiche la clé une seule fois ; chaque appel l’envoie dans l’en-tête. |
Authorization: Bearer sgk_… |
| Tester la clé : la réponse indique votre compte et les droits de la clé. | GET /api/v1/ping |
Envoyer le stock en JSON ou en CSV, jusqu’à 1 000 articles par appel. Sellgrip l’écrit chez Kaufland avec POST /units/bulk avant de répondre et retient votre stock tampon. |
POST /api/v1/stock |
| Envoyer les données produit par EAN et par langue, jusqu’à 100 articles par appel, contrôlées selon les mêmes règles que le formulaire Données produit. Les 20 premiers partent chez Kaufland avant la réponse, le reste lors des tours suivants de 15 minutes. | POST /api/v1/product-data |
| Savoir où en est un article : en attente, envoyé ou refusé avec les mots de Kaufland, ainsi que le dernier état signalé par Kaufland. | GET /api/v1/product-data/{ean} |
Laisser lire les assistants IA : avec une clé dotée du droit read, Claude Desktop, Claude Code et d’autres clients MCP consultent tâches, bénéfice, commandes, Buy Box et opportunités. L’accès lit seulement. Plus d’infos sur Assistants IA. |
POST /api/v1/mcp |
À côté d’autres logiciels
Si vous utilisez déjà un intégrateur ou un repricer, choisissez une seule source par champ. Voici ce que Sellgrip lit seulement et quand il écrit.
| Lecture seule | Rapports, écritures, versements, entrepôts, groupes d’expédition, catégories et opportunités de Kaufland. Sellgrip n’y change rien. |
|---|---|
| Sur votre clic | Expédition, annulation, remboursement, retours, tickets, bons de réduction, offres et données produit. Sellgrip n’envoie rien avant votre confirmation dans le tableau de bord. |
| Prix automatiques | Seulement si vous activez le mode automatique des Règles de prix et passez un produit en Automatique. Si un autre outil ou Smart Pricing a changé le prix, Sellgrip n’envoie rien et repasse le produit en Manuel. |
| Limites de prix | Jamais sous votre seuil de rentabilité, au plus 5 % par changement et 15 % par jour, les deux réglables. Après trois erreurs de suite, le mode automatique se désactive. |
| Stock automatique | Seulement si vous activez la synchronisation du stock avec votre liste ou votre flux. Si la liste semble fausse, par exemple trop de zéros ou trop de changements d’un coup, Sellgrip n’envoie rien. |
| Données produit automatiques | Seulement si vous activez le flux d’import. Sellgrip n’envoie alors que les lignes modifiées. |
| Factures automatiques | Seulement si vous activez l’envoi automatique, pour les commandes à partir de ce moment. Si Kaufland a déjà une facture pour la commande, de qui que ce soit, Sellgrip n’en envoie pas. |
| API Sellgrip | Votre propre système envoie stock et données produit avec une clé que vous créez. Sans clé valide, rien ne passe. |
| Un champ, une source | Si un autre outil fixe déjà les prix ou le stock, laissez cette automatisation désactivée dans Sellgrip. Sans automatisation, Sellgrip n’écrit que sur votre instruction. |
| Arrêt d’urgence | En bas de la page Règles de prix. Il arrête aussitôt les règles de prix, la synchronisation du stock, l’import de données produit et les modifications via l’API Sellgrip, jusqu’à ce que vous le leviez. Ce que vous modifiez vous-même dans Offres, les actions sur les commandes et les tickets ainsi que les factures automatiques continuent. |
| Journal | Paramètres › Journal liste ce que votre compte a envoyé à Kaufland, avec l’heure et le résultat. Les prix automatiques figurent aussi dans l’historique des Règles de prix. |
Connectez votre boutique Kaufland
Vous connectez vous-même votre boutique dans le tableau de bord, avec deux clés du Seller Portal. La première synchronisation démarre ensuite, gratuitement dans chaque formule.