Integración con Ripley Marketplace
Astrobit se conecta a la API Mirakl de Ripley, ingresa cada orden, emite el documento, descuenta stock y registra la comisión que Ripley cobró en cada línea.
Qué hace hoy esta integración
- Ingreso de órdenes en tiempo real por webhook de Ripley.
- Comisión por línea leída del campo de comisión total que entrega Mirakl.
- Devoluciones y cancelaciones parciales leídas línea por línea.
- Ripley es el canal con menos superficie de API de los cinco. Hoy Astrobit consulta la orden puntual; la recarga masiva por rango de fechas —que sí existe para Mercado Libre, Falabella, Paris, Shopify y WooCommerce— todavía no está implementada para Ripley.
Qué documento tributario se emite y cuándo
- Qué documento se emite
- Boleta electrónica (T39). Hoy la integración de Ripley trata todas sus órdenes como venta sin factura. Si necesitas factura para una venta de Ripley, se emite a mano desde Astrobit.
- En qué momento del flujo
- Hay dos momentos y se elige por cuenta. Por defecto, al ingresar la orden: el webhook del canal encola la venta, Astrobit la crea y emite el documento en ese mismo paso. La otra opción es emitir al cerrar el empaque, para que el documento salga con lo que efectivamente se empacó y no con lo que se pidió.
- Qué se puede automatizar
- La emisión automática se configura por cuenta, no por sistema: apagada, solo boletas, solo facturas, todo, o al empacar.
- ¿Se adjunta en la cuenta de Ripley?
- Astrobit transmite el DTE al SII y lo envía por correo al comprador, si el canal tiene el envío activado. Además sube el documento a tu cuenta de Ripley apenas se emite, referenciado al número de orden. Es automático en el camino de ingreso de la venta.
- Guía de despacho
- Se puede emitir guía de despacho (T52) junto con la venta, según la política del canal.
Cómo sincroniza el stock
- Cada cuánto sincroniza
- Por evento, no por intervalo. Cada cambio de stock en Astrobit (venta, devolución, recepción de compra, traspaso, ajuste de inventario) encola el envío del nuevo disponible al canal. No hay una ventana de N minutos en la que el canal quede desactualizado a la espera del siguiente ciclo.
- Qué se envía
- Solo se envían los SKU cuyo disponible publicable cambió. Un movimiento que no altera lo que el canal debe mostrar (por ejemplo, uno que queda bajo el piso configurado) no genera llamada.
- Piso y techo
- Piso y techo por canal: el piso reserva unidades que nunca se publican (colchón anti-sobreventa) y el techo limita el máximo publicable. El piso además se puede sobrescribir producto por producto.
- Qué bodegas alimentan Ripley
- Eliges qué bodegas alimentan cada canal. El canal publica la suma de esas bodegas, no el total de la empresa.
Devoluciones y notas de crédito
- Cómo se entera Astrobit
- Cada línea de la orden Mirakl trae sus devoluciones y sus cancelaciones con la cantidad afectada. Astrobit las suma por SKU y crea la devolución con esas unidades.
- Nota de crédito
- Si la venta tenía documento emitido, se emite la nota de crédito (T61) referenciada a ese documento.
- Devolución parcial
- Sí. La cantidad devuelta se toma por línea y nunca supera lo vendido en esa línea.
- Stock
- Las unidades devueltas vuelven a bodega y el disponible se re-publica a Ripley y al resto de los canales.
Packs y publicaciones múltiples del mismo SKU
- Packs
- Un pack se define por sus componentes y cantidades. Su disponible publicado no se digita: se deriva de cuántos packs se pueden armar con el stock de los componentes. Vender un componente suelto baja el disponible del pack en el mismo evento, y viceversa.
- Costo del pack
- El costo del pack tampoco se digita: se calcula sumando el costo de sus componentes por la cantidad de cada uno. Por eso el margen de un pack no queda en cero cuando nadie le puso precio de costo.
- Un SKU en varias publicaciones
- Un mismo producto de Astrobit puede estar pareado con varios SKU del canal. Cuando el disponible cambia, se envía a todos los SKU pareados en la misma corrida, no solo al principal.
Cómo se calcula el margen real
La comisión del canal y el despacho son la diferencia entre lo que crees que ganaste y lo que ganaste.
- De dónde sale la comisión de Ripley
- De la comisión total que Mirakl declara en cada línea de la orden. Se registra como una comisión por línea, con su SKU, contra esa orden.
- Despacho
- El precio de despacho que viene en la orden de Ripley se registra como costo de despacho de la venta.
- Cómo se calcula el margen
- Margen = (venta − comisiones del canal − costo de los productos) ÷ 1,19. Se descuenta el IVA al final para que la cifra sea comparable con el resultado, no con la caja.
Qué se necesita para conectarlo
Credenciales
- Clave API de tu cuenta de Ripley (Mirakl).
Las credenciales se guardan cifradas. Ningún operador de Astrobit las ve en texto plano.
Pasos
- 1Pegas la clave API de Ripley en el asistente de conexión.
- 2Astrobit la guarda cifrada y la usa para consultar las órdenes en la API Mirakl de Ripley.
- 3Eliges qué bodegas alimentan el canal y el piso de stock.
- 4Activas ingreso de órdenes, emisión de documentos y sincronización de stock por separado.
Cuánto demora
Astrobit no compromete un plazo, y es deliberado: el tiempo depende de cosas que no controla. Lo que sí se puede decir es de qué depende y qué se puede hacer mientras tanto. Cargar las credenciales y activar los interruptores es cuestión de minutos. Lo que toma tiempo es parear tus SKU con los del canal y traer el histórico que quieras cargar, y eso escala con el tamaño de tu catálogo. Aparte va la certificación ante el SII, que la define el SII y no nosotros: puedes operar desde el primer día con los módulos que no dependen de ella. Ripley es la conexión con menos campos: una sola clave API. En contrapartida no tiene carga histórica automática, así que el arranque cubre desde que se conecta hacia adelante.
Preguntas frecuentes
¿Ripley emite factura desde Astrobit?
Hoy no de forma automática: la integración trata las ventas de Ripley como boleta. Una factura para una venta de Ripley se emite manualmente desde Astrobit. Es la diferencia principal con Paris y Falabella, que sí declaran en la orden si el comprador pidió factura.
¿Cómo llega una orden de Ripley a Astrobit?
Ripley avisa por webhook. Astrobit consulta esa orden en la API Mirakl, la crea, descuenta stock y emite el documento si la emisión automática está activada.
¿Puedo cargar el histórico de Ripley?
Todavía no de forma automática. La recarga masiva por rango de fechas está implementada para Mercado Libre, Falabella, Paris, Shopify, WooCommerce y Walmart, pero no para Ripley.
¿Qué pasa si Ripley cancela solo una parte de la orden?
Se registra la devolución solo por las unidades canceladas de esa línea. El resto de la orden sigue vendido, con su documento y su stock descontado.
Otros canales
Conecta tu cuenta de Ripley
Crea tu cuenta y conecta Ripley con tu clave API, o agenda una reunión para revisar el alcance con tus órdenes.