¿Cómo integrar iFood con ANYMARKET? – Anytools Latam

iFood es el mayor marketplace de delivery de Brasil y conecta a los consumidores con establecimientos comerciales para compras con entrega rápida según su radio de cobertura.

Con la integración a ANYMARKET, gestionas múltiples tiendas de iFood de forma centralizada y sincronizas catálogo, inventario, precios y pedidos en un único hub.

Requisitos previos

Antes de iniciar la integración de iFood con ANYMARKET, necesitas tener:

Una cuenta activa en iFood para cada tienda que deseas integrar.
Una cuenta en ANYMARKET para cada tienda de iFood. La integración es obligatoriamente multicuenta: cada cuenta en ANYMARKET representa una tienda individual en iFood, con su propio token.
La regla de logística "Local de inventario por marketplace" configurada en ANYMARKET. Esta regla está disponible en los planes Performance y Enterprise y garantiza que el inventario dedicado a iFood no compita con el inventario de los demás marketplaces.

Cómo configurar la autenticación con iFood

La autenticación con iFood se realiza mediante OAuth2 con aplicación distribuida. El proceso sigue los pasos a continuación:

ANYMARKET genera un UserCode y lo pone a tu disposición.
Accede al portal de iFood, entra en Aplicaciones y haz clic en "Activar aplicación por código".
Ingresa el UserCode en el portal de iFood.
iFood muestra la confirmación y genera un nuevo código de autorización.
Copia el código de autorización e ingrésalo en ANYMARKET.
ANYMARKET completa la autenticación y genera el token de acceso exclusivo de tu cuenta.

ANYMARKET renueva el token automáticamente, sin que necesites repetir el proceso de autenticación periódicamente.

Si operas varias tiendas en iFood, puedes registrar múltiples cuentas en el mismo acceso de ANYMARKET y gestionarlas todas de forma centralizada.

Regla de inventario obligatoria para iFood

iFood opera con tiendas locales y un radio de entrega definido por establecimiento. Por eso, el inventario publicado en cada tienda de iFood debe estar dedicado a esa operación y no puede sumar los mismos CD (centros de distribución) que usan los marketplaces con cobertura nacional.

Sin la regla "Local de inventario por marketplace" configurada, ANYMARKET consideraría todos los CD registrados para calcular el inventario enviado a iFood. Esa situación genera conflicto con otros canales y riesgo de quiebre de stock: venderías en iFood con base en un inventario que puede estar siendo consumido al mismo tiempo por Mercado Libre, Shopee u otros canales.

Cómo configurar la regla "Por local de inventario":

Accede a Inventario > Reglas de logística.
Haz clic en Nueva Regla.
Selecciona la condición "Por local de inventario".
Define los CD de cada cuenta de iFood.
Haz clic en Salvar.

Envío de productos a iFood

En la integración de iFood con ANYMARKET no es necesario vincular categorías, marcas ni atributos. Sin embargo, los productos deben enviarse por dos vías:

Por ANYMARKET, a través de la integración.
Por planilla en el portal de iFood.

Todas las publicaciones pasan por el proceso de catalogación y aprobación de la curaduría de iFood.

Puntos de atención sobre el envío de productos:

El match de productos en iFood se realiza exclusivamente por el código de barras (EAN). iFood no publica los productos con EAN no reconocido, y ANYMARKET no recibe respuesta de iFood sobre esos casos. Por eso, asegúrate de que todos los EAN sean correctos antes del envío.
El estado de aprobación de las publicaciones debe consultarse directamente en el portal de iFood, ya que esa consulta no está disponible vía API.
No es posible vincular publicaciones ya existentes en iFood a través de la integración: todos los productos deben enviarse desde ANYMARKET.
Para pausar una publicación, basta con desactivarla en ANYMARKET. ANYMARKET envía inventario 0 automáticamente a iFood, y el producto queda no disponible para la compra sin que se elimine el registro.

Precio e inventario en iFood

Es obligatorio configurar el precio mayorista y la cantidad mínima para activar el precio mayorista.
El envío de precio e inventario tiene un límite de 10 mil SKU cada 15 minutos.
El inventario publicado en iFood considera solo los CD vinculados a esa cuenta mediante la regla de logística "Local de inventario por marketplace".

Flujo de pedidos de iFood en ANYMARKET

iFood GROCERIES opera con un flujo de eventos: cada cambio en el recorrido del pedido dispara un evento que ANYMARKET recibe y procesa automáticamente. La siguiente tabla muestra cómo se refleja en ANYMARKET cada evento de iFood:

Evento en iFood	Acción en ANYMARKET
PLACED	Crea una reserva de inventario (aún no genera pedido)
CONFIRMED	Mantiene la reserva de inventario
SEPARATION_STARTED	Espera a que finalice la preparación
SEPARATION_ENDED	Crea el pedido en estado Facturado
DISPATCHED	Actualiza el pedido a Enviado
CONCLUDED	Actualiza el pedido a Concluido
CANCELLED	Libera la reserva o cancela el pedido

Puntos importantes sobre la operación de pedidos:

La preparación y el despacho de los pedidos los realizas directamente en la App Separador de iFood.
La entrega la ejecuta 100% iFood.
Solo se admite la cancelación total. No es posible cancelar solo una parte de un pedido en esta categoría.
Los detalles del pedido están disponibles en la API de iFood solo durante 7 días. Después de ese período, el historial debe consultarse directamente en el portal de iFood.
iFood no proporciona los datos fiscales del pedido a través de la integración.

Particularidades de la integración con iFood

La integración con iFood no emite etiquetas de envío, ya que la entrega la realiza el propio iFood.
El comprador final solo ve las tiendas disponibles dentro de su radio geográfico.
La tarifa y el tiempo de entrega son definiciones fijas de iFood por tienda y ANYMARKET no los calcula.
Los pedidos IMMEDIATE deben confirmarse en un plazo de 8 minutos después de su creación.
Los pedidos SCHEDULED deben confirmarse en un plazo de 8 minutos después del horario de inicio de la preparación.

Preguntas frecuentes

¿Puedo integrar varias tiendas de iFood en el mismo ANYMARKET?
Sí. La integración es obligatoriamente multicuenta: cada tienda de iFood corresponde a una cuenta en ANYMARKET, con su propio token. Todas las cuentas pueden gestionarse desde el mismo acceso.

¿Necesito configurar la regla "Por local de inventario" aunque solo venda en iFood?
Sí. La regla es obligatoria para que la integración funcione correctamente y garantiza que el inventario dedicado a cada tienda de iFood se calcule solo con los CD de esa operación.

¿Por qué mi producto se envió desde ANYMARKET pero no aparece en iFood?
El match de productos en iFood se realiza exclusivamente por el código de barras (EAN). Si iFood no reconoce el EAN, el producto no se publica. Verifica que el EAN sea correcto en el registro del producto en ANYMARKET.

¿Cómo hago seguimiento a la aprobación de mis publicaciones en iFood?
El estado de aprobación de las publicaciones debe consultarse directamente en el portal de iFood, ya que esa información no está disponible a través de la integración.

¿Cómo pauso una publicación de iFood desde ANYMARKET?
Basta con desactivar la publicación en ANYMARKET. ANYMARKET envía inventario 0 automáticamente a iFood, y el producto queda no disponible para la compra sin que se elimine el registro.

¿Puedo vincular a ANYMARKET publicaciones que ya existen en iFood?
No. No es posible vincular publicaciones ya existentes en iFood a través de la integración. Todos los productos deben enviarse desde ANYMARKET.

¿Puedo cancelar solo una parte de un pedido de iFood?
No. En esta categoría, iFood solo admite la cancelación total del pedido.

¿Dónde hago la preparación y el despacho de los pedidos de iFood?
La preparación y el despacho se realizan en la App Separador de iFood. La entrega la ejecuta iFood.

¿Durante cuánto tiempo puedo consultar un pedido de iFood a través de la integración?
iFood mantiene los detalles del pedido disponibles vía API durante 7 días. Después de ese período, la consulta debe hacerse directamente en el portal de iFood.

¿Dónde veo los datos fiscales de los pedidos de iFood?
iFood no proporciona los datos fiscales de los pedidos a través de la integración. Esa información debe consultarse en el portal de iFood.