Solo esta semana: 50 % de descuento en los 3 primeros meses de Pro y Business pagando cada mes. Hasta el 25 de octubre de 2026. Ver preciosEsta semana: Pro y Business 3 meses a mitad de precio

ES
Iniciar sesión Probar gratis
Menú
Funciones
Ver las funciones
Recursos Todas las herramientas gratuitas
Guías Todos los artículos
Probar gratis

Documentación técnica

Integración con la Kaufland Seller API

Sellgrip trabaja con sus propias claves para la Kaufland Seller API. Aquí ve qué hace en su tienda y qué endpoint usa en cada paso.

Conexión

Cada cambio que hace Sellgrip es una llamada a la API.

Acceso Sus propias claves para la Kaufland Seller API: la client key y la secret key del Seller Portal. Usted las introduce en el panel de Sellgrip.
Autenticación Cada petición se firma con HMAC usando la secret key.
User agent Sellgrip/1.0.0 (+https://sellgrip.com)
Marketplaces DE, AT, CZ, SK, PL, FR, IT, ES y NL. Consulte los nueve países.
Monedas Precios en la moneda de cada marketplace: EUR, CZK o PLN. Las conversiones usan los tipos de cambio del Banco Central Europeo.
Sincronización Un pedido nuevo en cuanto llega la notificación push de Kaufland. Todos los pedidos por marketplace cada 15 minutos, como respaldo. Almacenes, grupos de envío e informes cada día, el árbol de categorías cada semana.
Notificaciones push Sellgrip se suscribe a ellas al conectar su tienda: 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.
Cambios en Kaufland Cada cambio pasa por la API. Sellgrip no usa archivos ORDER-Command.
Claves API Cifradas con AES-256-GCM. No se vuelven a mostrar tras introducirlas y se eliminan en cuanto desconecte la cuenta o elimine su cuenta de Sellgrip.
Ubicación de los datos Solo en centros de datos de la Unión Europea. El tratamiento sigue el contrato de encargo de tratamiento según el art. 28 RGPD.

Pedidos

Sellgrip lee sus pedidos por marketplace y devuelve cada cambio a Kaufland a través de la API.

Qué hace Sellgrip Kaufland Seller API
Leer un pedido nuevo en cuanto llega la notificación push de Kaufland. Leer todos los pedidos y unidades de pedido por marketplace cada 15 minutos, como respaldo. GET /order-units
GET /orders
Marcar como enviado con transportista y número de seguimiento. Los transportistas vienen de la lista de Kaufland. PATCH /order-units/{id}/send
GET /carriers
Varios paquetes por unidad de pedido. POST /shipments
Marcar muchas unidades de pedido como enviadas en un solo paso. PATCH /order-units/{id}/send
Etiquetas de envío de GLS. POST /shipping-labels
Cancelar por artículo, con todos los motivos de cancelación de Kaufland. PATCH /order-units/{id}/cancel
Reembolso parcial por artículo. PATCH /order-units/{id}/refund
Leer, crear y modificar devoluciones. GET /returns
POST /returns
PUT /returns/{id}
Aceptar, rechazar, enviar a reparar o aclarar unidades de devolución. PATCH /return-units/{id}/accept
PATCH /return-units/{id}/reject
PATCH /return-units/{id}/repair
PATCH /return-units/{id}/clarify
Subir las facturas usted mismo o dejar que se suban solas tras el envío. POST /order-invoices/{id_order}
Fulfillment by Kaufland: Sellgrip también lee estas unidades de pedido, devoluciones y tickets y las marca. El envío, la cancelación, las etiquetas y las decisiones sobre devoluciones quedan en manos de Kaufland. GET /order-units
GET /returns
GET /return-units
GET /tickets
fulfillment_type

Ofertas

Sellgrip envía los cambios en las ofertas campo por campo: a Kaufland solo va lo que ha cambiado.

Qué hace Sellgrip Kaufland Seller API
Crear una oferta, en cualquier estado del artículo que admita Kaufland. POST /units
Modificar precio, stock, plazo de preparación, estado, almacén, grupo de envío y precio mínimo. PATCH /units/{id}
POST /units/bulk
Eliminar una oferta. DELETE /units/{id}
Estado de la oferta, con los motivos de Kaufland. POST /units/status
Aplicar un cambio al mismo producto en todos sus marketplaces, con conversión de moneda. PATCH /units/{id}
Reglas de precios: como sugerencia o automáticas, nunca por debajo de su umbral de rentabilidad. PATCH /units/{id}
Sincronización de stock desde una carga CSV o un feed https, desde cada 15 minutos hasta una vez al día, con stock de reserva para toda la cuenta o por artículo. PATCH /units/{id}
POST /units/bulk
Almacenes y grupos de envío, leídos cada día. GET /warehouses
GET /shipping-groups

Datos de producto

Sellgrip escribe los datos de producto por idioma y marketplace y muestra al lado la respuesta de Kaufland.

Qué hace Sellgrip Kaufland Seller API
Escribir los datos de producto por idioma y marketplace. PUT /product-data
PATCH /product-data
Estado y respuesta de Kaufland por EAN, también de los informes invalid-items y product-data-changes. GET /product-data/status/{ean}
Elegir una categoría entre las de Kaufland. El árbol de categorías se lee cada semana. POST /categories/decide
GET /categories
GET /categories/tree
Los atributos obligatorios están marcados. Otros atributos de Kaufland se añaden por nombre. GET /attributes/search
GET /attributes/by-name/{name}
Varias imágenes por producto y por marketplace. PATCH /product-data
Opcional: copiar automáticamente los valores independientes del idioma a sus demás idiomas. PATCH /product-data
Importación desde CSV o un feed, cada hora o cada día, con asignación de columnas a atributos. Solo se envían las filas modificadas. PATCH /product-data
Nuevo EAN: primero crear los datos de producto, después publicar la oferta. PUT /product-data
POST /units

Tickets

La atención al cliente en Kaufland pasa por tickets. Sellgrip los lee y los gestiona a través de la API.

Qué hace Sellgrip Kaufland Seller API
Leer tickets y mensajes, con motivo y tema. Los adjuntos de Kaufland se pueden descargar. GET /tickets
GET /tickets/{id}
Responder, con adjuntos. POST /tickets/{id}/messages
Abrir un ticket desde un pedido. POST /tickets
Cerrar un ticket. PATCH /tickets/{id}/close

Informes

Sellgrip lee estos informes de Kaufland una vez al día:

  • lost-buybox
  • buybox-opportunity
  • price-competitiveness
  • competitors-comparer
  • account-listing
  • invalid-items
  • product-data-changes
  • bookings-new
  • sales-new
  • cancellations

API de Sellgrip

Su tienda, su gestión de stock o su ERP envía stock y datos de producto a Sellgrip en cuanto cambian. Sellgrip los pasa al momento a Kaufland; la API de Sellgrip está incluida en Business.

Lo que hace usted API de Sellgrip
Crear una clave en Ajustes › Claves API: solo el titular, con confirmación de la contraseña. Permisos stock:write y product-data:write, válida hasta que se revoque, 90 días o un año. Sellgrip muestra la clave una sola vez; cada llamada la envía en la cabecera. Authorization: Bearer sgk_…
Probar la clave: la respuesta indica su cuenta y los permisos de la clave. GET /api/v1/ping
Enviar stock en JSON o CSV, hasta 1.000 artículos por llamada. Sellgrip las escribe en Kaufland con POST /units/bulk antes de responder y retiene su stock de reserva. POST /api/v1/stock
Enviar datos de producto por EAN e idioma, hasta 100 artículos por llamada, revisados con las mismas reglas que el formulario de Datos de producto. Los primeros 20 van a Kaufland antes de la respuesta, el resto en las siguientes rondas de 15 minutos. POST /api/v1/product-data
Consultar en qué punto está un artículo: en cola, enviado o rechazado con las palabras de Kaufland, más el último estado que comunicó Kaufland. GET /api/v1/product-data/{ean}
Dejar leer a los asistentes de IA: con una clave con el permiso read, Claude Desktop, Claude Code y otros clientes MCP consultan tareas, beneficio, pedidos, Buy Box y oportunidades. El acceso solo lee. Más en Asistentes de IA. POST /api/v1/mcp
Claves API en Sellgrip: las claves con sus permisos, último uso y caducidad.Claves API en Sellgrip: las claves con sus permisos, último uso y caducidad.

Junto a otro software

Si ya usa un integrador o un repricer, elija una sola fuente por campo. Aquí ve lo que Sellgrip solo lee y cuándo escribe.

Solo lectura Informes, asientos, pagos, almacenes, grupos de envío, categorías y oportunidades de Kaufland. Sellgrip no cambia nada de esto.
Con su clic Envío, cancelación, reembolso, devoluciones, tickets, cupones, ofertas y datos de producto. Sellgrip no envía nada hasta que usted lo confirma en el panel.
Precios automáticos Solo si activa el modo automático de las reglas de precios y pone un producto en Automático. Si otra herramienta o Smart Pricing ha cambiado el precio, Sellgrip no envía nada y devuelve el producto a Con un clic.
Límites de precio Nunca por debajo de su umbral de rentabilidad, como máximo un 5% por cambio y un 15% al día, ambos ajustables. Tras tres errores seguidos el modo automático se desactiva.
Stock automático Solo si activa la sincronización de stock con su lista o feed. Si la lista parece errónea, por ejemplo demasiados ceros o demasiados cambios a la vez, Sellgrip no envía nada.
Datos de producto automáticos Solo si activa el feed de importación. Sellgrip envía entonces solo las filas que han cambiado.
Facturas automáticas Solo si activa la subida automática, para pedidos desde ese momento. Si Kaufland ya tiene una factura del pedido, de quien sea, Sellgrip no sube ninguna.
API de Sellgrip Su propio sistema envía stock y datos de producto con una clave que usted crea. Sin una clave válida no pasa nada.
Un campo, una fuente Si otra herramienta ya fija precios o stock, deje desactivada esa automatización en Sellgrip. Sin automatización Sellgrip solo escribe por orden suya.
Parada de emergencia Abajo en la página Reglas de precios. Detiene al instante las reglas de precios, la sincronización de stock, la importación de datos de producto y los cambios a través de la API de Sellgrip, hasta que la desactive. Lo que usted cambie en Ofertas, las acciones sobre pedidos y tickets y las facturas automáticas siguen funcionando.
Registro En Ajustes › Registro está lo que su cuenta ha enviado a Kaufland, con hora y resultado. Los precios automáticos también figuran en el historial de las reglas de precios.

Conecte su tienda de Kaufland

Usted conecta su tienda en el panel, con dos claves del Seller Portal. Después empieza la primera sincronización, gratis en todos los planes.

Crear una cuenta gratis Contacte con nosotros