Guía de integración de Rappi Inventory
Nuestra integración de inventario es el primer paso para que todo socio esté presente en nuestras aplicaciones. Esta integración te permite:
- Controlar la disponibilidad de productos.
- Actualizar precios.
- Actualizar descuentos.
- Mantener el rango de productos para cada tienda.
Reunida, toda esta información es referida como datos de inventario.
Lista de integración
1. Planifica tu incorporación
Para empezar, agenda una reunión de validación con tu gerente técnico de cuentas (TAM).
Esta reunión te permitirá:
a. Conocer la respuesta a cualquier duda relacionada con la creación y mantenimiento del catálogo principal que servirá a todas tus tiendas (en caso de que el proceso no haya sido iniciado ya por parte de nuestro equipo comercial).
b. Asignar tus identificadores de tienda con los identificadores internos de tienda de Rappi.
c. Comprender los métodos disponibles para extraer datos de tus propios sistemas de una manera automatizada.
Uno de los mayores obstáculos para poder integrarse rápidamente con Rappi Inventory es el desconocimiento del comerciante de sus propios sistemas. Los datos de inventario pueden encontrarse usualmente en el sistema de planificación de recursos empresariales (ERP) del comerciante, pero es común que los datos asociados (disponibilidad, precios o promociones) se encuentren en sistemas distintos.
Comprender la complejidad de esto es fundamental para reducir el tiempo de espera de la integración. Por favor, lleva ingenieros a esa reunión y mantén a los socios comerciales en casa 😉.
d. Definir el tipo de integración de inventario que se ajusta a tus necesidades.
Actualmente Rappi ofrece a sus socios 2 métodos para alimentar los datos de inventario en nuestra plataforma, puedes consumir nuestra API REST de inventario o cargar archivos CSV a tu carpeta exclusiva para ello a través del STFP.
e. Establecer tu horario de alimentación de datos de inventario.
2. Crea un nuevo proceso ETL
ETL significa Extract, Transform, Load (Extraer, Transformar y Cargar). De eso trata la integración de inventario. Nada más ni nada menos.
a. Extraer datos de inventario desde los sistemas internos (sean uno o varios).
b. Transformar los datos para que coincidan con nuestras especificaciones de esquema.
c. Transferir (cargar) los datos de inventario a Rappi.
3. Obtener credenciales
Una vez que el equipo de comercio de Rappi ha creado tu catálogo principal así como una tienda de prueba, y tu equipo (o un proveedor de servicios tercero) ha creado un nuevo proceso ETL para sincronizar tus datos de inventario, recibirás tus credenciales.
Tu TAM te proporcionará las credenciales de autenticación. Una vez que estas credenciales se ajusten en tu proceso ETL, Rappi debería empezar a recibir tus datos de inventario.
Crea tu catálogo
El equipo comercial de Rappi trabajará contigo para crear tu catálogo. Nuestro equipo de comercio creará tu catálogo principal y el árbol de categorización para asegurar que los productos sean mostrados apropiadamente dentro de la aplicación
Gestionar rangos de tienda O Añadir nuevos productos al catálogo principal.
En cualquier momento, si el feed del inventario de cualquier tienda incluye un SKU que nunca se había vendido antes ahí, pero el SKU se encuentra en tu catálogo principal, ese SKU es añadido automáticamente al rango de la tienda.
Por otra parte, los SKUs faltantes en tu catálogo principal serán ignorados por el motor de ingestión si se envía a los feeds de inventario. Siempre contacta a tu gerente de cuentas cuando necesites añadir nuevos productos a tu catálogo principal.
Tu lista de tiendas
Ya sea que operes 1 o 100 tiendas, los identificadores únicos de tienda deben ser asignados con aquellos gestionados internamente por Rappi para tener una ingestión de datos apropiada.
Manejar este aspecto de la integración puede ser complicado cuando tus datos de inventario (disponibilidad, precios y promociones) residen en varios sistemas y los identificadores de tienda son distintos en cada una de ellas. En tales casos, es requerido que definas un identificador particular para cada tienda y tu proceso ETL debe mantener una asignación interna de esos identificadores en cada uno de tus sistemas internos.
Eliminar un artículo del catálogo
Actualmente no existe una disposición para eliminar un SKU de tu catálogo principal. Simplemente envía stock = 0 para cualquier SKU y se marcará como no disponible y dejará de aparecer en nuestra aplicación.
Gestión de inventario
Comunicar la disponibilidad y los precios actuales y precisos de la existencias es un componente esencial para generar confianza con tus consumidores. La gestión de disponibilidad y precios es responsabilidad de los comerciantes.
Rappi necesita recibir información en el menor tiempo posible cada vez que haya cambios significativos en los datos de inventario. Los retrasos en la alimentación de Rappi con datos de inventario actualizados pueden afectar la experiencia del usuario de varias maneras:
La información obsoleta sobre la disponibilidad de productos puede provocar que los consumidores compren productos que ya no se encuentran disponibles. Los recolectores se comunicarán con ellos para ofrecer artículos alternativos, PERO los consumidores pueden cancelar su pedido. En última instancia, Rappi puede limitar la variedad de productos que se muestran a los clientes en la aplicación con la finalidad de reducir tales incidencias.
La información obsoleta en los precios de los productos puede dar lugar a diferencias en los precios. Si esto resulta en un pago insuficiente por parte de los consumidores, estas diferencias de precio representan pérdidas intolerables para Rappi.
Los datos obsoletos respecto de las promociones puede llevar a reducir la conversión de tus tiendas cuando los consumidores las comparan con otros comerciantes que publican constantemente nuevas promociones.
Los comerciantes pueden ajustar sus precios temporalmente usando dos métodos: descuentos o promociones. La documentación respecto de las promociones estará disponible próximamente.
Categorización del tipo de venta
Los tipos de venta se refieren a cómo los productos son vendidos a los consumidores. Los SKUS pueden entrar en una de las 4 categorías siguientes:
UNIDADES. Son productos que son vendidos por unidades separadas, es decir, por artículo, requieren que el campo
pricesea completado y de la propiedadsale_type = “U”para unidades. Por ejemplo, la pasta dental es vendida por tubos. El consumidor comprende que el precio anunciado es el costo por cada tubo individual.PAQUETES. Son productos que vienen en unidades separadas pero pueden ser vendidos por paquetes. Toda vez que el id del producto debe ser único, Rappi recomienda usar el formato
<ean>_<quantity>(para cargas de archivos .CSV) ogtin_<quantity>(para cargas de API) para el id del producto, en caso de que no tengas un identificador de SKU único asignado a un paquete.PESO VARIABLE. Ciertos productos son vendidos por peso (Kg): esto es especialmente común para alimentos frescos como frutas, carnes o alimentos listos para consumir. El campo
pricedebe ser completado y la propiedadsale_type = “WW”debe ser configurada.TRANSFORMADOS. Los productos transformados son aquellos que son reducidos o alterados para su venta. Por ejemplo, una rueda de queso Parmesano puede ser recibida en almacén y después ser rebanada para que sea comprada por el consumidor. Esto es considerado como una relación padre/hijo, en existencias el producto “hijo” solo será mostrado si el producto “padre” tiene existencias disponibles. Un producto transformado debe tener el campo
pricecompletado con el precio por kilogramo y la propiedadsale_type = “WW”.
Horarios de alimentación de datos
Los comerciantes deben acordar con su TAM, cuál flujo de actualización de inventario se ajusta a su volumen de ventas y a sus sistemas. Esto determinará cuándo alimentar nuevos datos y qué canal de alimentación de datos usar.
CUANTO MAYOR SEA LA FRECUENCIA DE ACTUALIZACIÓN DE DATOS DE INVENTARIO...
… menores serán las instancias de incidentes de diferencias de precios o de falta de existencias. Por lo tanto la frecuencia con la que se realizan las actualizaciones tiene un impacto directo en los acuerdos de nivel de servicio (en inglés Service Level Agreements o SLA) que son parte de tu contrato con Rappi.
Los minoristas tienen la opción de realizar una transferencia completa de todo su catálogo una vez al día (Flujo de integración diaria) o transferir datos de SKUs individuales en un horario regular a lo largo del día motivado por cambios en la disponibilidad o los precios (Flujo delta).
 | Flujo de Integración Diaria Sugerido para los comerciantes con volúmenes de venta bajos a medios. El catálogo entero (o un subconjunto del catálogo que contiene únicamente los productos disponibles) se transfiere una vez al día, usualmente temprano en la mañana. Los comerciantes que usan este flujo generalmente alimentan datos a través de transferencias de archivos CSV a través del SFTP. |
 | Flujo Delta Sugerido para los comerciantes con volúmenes de venta medios a altos. Las cargas de alimentación de datos en este flujo son activadas por una combinación de cambios, ya sea en los niveles de existencias o en los precios de cualquier SKU, que son acumulados durante un período de tiempo determinado; el nombre "delta" se refiere a la variación en esas propiedades. Los comerciantes que usan este flujo preferentemente deben proporcionar datos a través de nuestra API de inventario. |
Para precisar el flujo delta, imagina que tus tiendas tienen un volumen de venta alto, lo que significa que la disponibilidad de productos está sujeta a cambios constantes a lo largo del día y te comprometiste a cargar datos actualizados cada 10 minutos.
Cada 10 minutos, tu proceso ETL acumularía cambios en los precios o en la disponibilidad de productos en tus tiendas.
Al final de este periodo de 10 minutos, se espera que alimentes datos actualizados para SKU2 y SKU3.
No se esperan datos para SKU1 toda vez que sus propiedades de inventario se mantuvieron sin cambios.
Comunica tu horario
La decisión de usar el Flujo delta o el Flujo de integración diaria debe ser tomada junto con tu TAM. Para integraciones diarias, comunica tu horario anticipado, es decir, la hora del día en que tienes la intención de iniciar tu transferencia de datos.
Cargar tus datos de inventario
Actualmente Rappi ofrece dos métodos distintos para cargar tus datos de inventario. Los comerciantes pueden optar por cargar archivos CSV en una carpeta FTP a través de SSH (SFTP) o enviar sus datos a nuestra API de inventario.
Es ampliamente recomendado que los comerciantes que usan el Flujo de Delta alimenten sus datos exclusivamente a través de nuestra API de inventario.
Los detalles de implementación para cada opción se pueden encontrar en las secciones Carga de archivos CSV sobre SFTP y Rappi Inventory API v2.
PENDIENTES, Nuevas características de productos próximamente...
- Ambiente sandbox para pruebas y control de calidad.
- Eliminación permanente de artículos descontinuados en el catálogo.