Integración con Mercado Libre
Astrobit se conecta por OAuth a tu cuenta de vendedor, ingresa cada venta, decide boleta o factura con los datos de facturación que entrega Mercado Libre, descuenta stock y registra la comisión del canal.
Qué hace hoy esta integración
- Ingreso de órdenes en tiempo real por webhook de Mercado Libre.
- Recarga por rango de fechas desde el panel.
- Preguntas de compradores y reclamos: Astrobit los lee y permite responder.
- Varias cuentas de vendedor conectadas en paralelo, cada una con sus bodegas de origen.
Qué documento tributario se emite y cuándo
- Qué documento se emite
- Boleta electrónica (T39) o factura electrónica (T33). Astrobit consulta los datos de facturación de la venta en la API de Mercado Libre: cuando el comprador está identificado como empresa, emite factura con el RUT, la razón social y el giro económico que entrega ML. En caso contrario emite boleta.
- 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.
- Cuándo NO emite solo
- Si la orden pide factura y el receptor no tiene giro o llega con RUT genérico, Astrobit retiene la emisión automática y deja la orden marcada para completar los datos tributarios a mano. No emite una factura mal formada.
- ¿Se adjunta en la cuenta de ML?
- 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 Mercado Libre 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 ML
- Eliges qué bodegas alimentan cada canal. El canal publica la suma de esas bodegas, no el total de la empresa.
- Full y bodegas de origen
- Se mapea cada origen de Mercado Libre a una bodega de Astrobit, así el stock que ve cada origen es el de sus propias bodegas y no el total de la empresa.
Devoluciones y notas de crédito
- Cómo se entera Astrobit
- Por los cambios de estado de la venta en Mercado Libre: cancelaciones, devoluciones y reembolsos.
- Nota de crédito
- Si la venta tenía documento emitido, se emite la nota de crédito (T61) referenciada a ese documento.
- Carritos que Mercado Libre divide
- Cuando ML parte un carrito, cancela la venta original y crea ventas sucesoras. Astrobit devuelve el stock de la venta original antes de descontar el de las sucesoras, para que las unidades no queden descontadas dos veces. La devolución de esas unidades ocurre una sola vez, aunque lleguen varias sucesoras y después el aviso de cancelación del padre.
- Stock
- Las unidades devueltas vuelven a bodega y el disponible se re-publica a ML 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 ML
- De la comisión que Mercado Libre declara en la venta, más los cargos fijos y variables que configures a nivel de canal para el costo de envío que ML te cobra.
- 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.
- Despacho
- El despacho entra por dos lados: lo que el comprador pagó por despacho es parte de la venta, y lo que el canal te cobró por el envío entra como comisión. Si hay devolución, el despacho devuelto se resta de la venta.
Qué se necesita para conectarlo
Credenciales
- Autorización OAuth de tu cuenta de vendedor de Mercado Libre. No se pide ni se guarda tu contraseña.
Las credenciales se guardan cifradas. Ningún operador de Astrobit las ve en texto plano.
Pasos
- 1Desde el asistente de conexión abres el flujo de autorización de Mercado Libre.
- 2Autorizas a Astrobit con tu usuario de vendedor.
- 3Mapeas los orígenes de ML a tus bodegas.
- 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. En Mercado Libre la autorización es un OAuth de un par de clics. El grueso es parear publicaciones con SKU, que suele ser el catálogo más grande de todos los canales.
Preguntas frecuentes
¿Cómo decide Astrobit entre boleta y factura en Mercado Libre?
Consulta los datos de facturación de la venta en la API de Mercado Libre. Si el comprador está identificado como empresa, Astrobit toma el RUT, la razón social y el giro económico de ahí y emite factura electrónica. Si no, emite boleta.
¿Puedo conectar más de una cuenta de Mercado Libre?
Sí. Cada cuenta se conecta por separado, con sus propias credenciales, sus propias bodegas de origen y sus propios interruptores de automatización.
¿Qué pasa si vendo el mismo producto en varias publicaciones?
Pareas todas esas publicaciones al mismo producto de Astrobit. Cuando el disponible cambia, se actualizan todas en la misma corrida.
¿Se pueden responder preguntas y reclamos desde Astrobit?
Sí. Astrobit lee las preguntas de compradores y los reclamos de Mercado Libre y permite responder desde la plataforma, sin entrar al panel de ML.
Otros canales
Conecta tu cuenta de Mercado Libre
Crea tu cuenta y autoriza Mercado Libre por OAuth, o agenda una reunión y lo vemos con tus publicaciones.