Integración con Walmart Marketplace
Astrobit se conecta a la API global de Walmart apuntada al mercado chileno, ingresa cada orden, emite el documento, descuenta stock y separa comisión, despacho y descuento línea por línea.
Qué hace hoy esta integración
- Ingreso de órdenes en tiempo real por webhook de Walmart.
- Recarga por rango de fechas desde el panel, con paginación.
- Empuje de stock por el feed de inventario de Walmart.
- Cancelaciones parciales leídas del estado de cada línea.
Qué documento tributario se emite y cuándo
- Qué documento se emite
- Boleta electrónica (T39). Hoy la integración de Walmart trata todas sus órdenes como venta sin factura. Si necesitas factura para una venta de Walmart, 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 Walmart?
- Astrobit transmite el DTE al SII y lo envía por correo al comprador, si el canal tiene el envío activado. La subida a tu cuenta de Walmart no ocurre al ingresar la venta: se encola cuando el documento se emite al cerrar el empaque. Para órdenes ya facturadas por otra vía, el panel tiene un reenvío manual que las sube en lote.
- 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.
- Cómo llega a Walmart
- Por el feed de inventario de Walmart, con la cantidad por SKU. Nunca se envía un número negativo: un disponible bajo cero se publica como cero.
- 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 Walmart
- 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 trae sus estados. Cuando una línea aparece cancelada con su cantidad, Astrobit registra esas unidades como devueltas.
- 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í. Se toma la cantidad cancelada de esa línea, no la orden completa.
- Stock
- Las unidades devueltas vuelven a bodega y el disponible se re-publica a Walmart 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 Walmart
- Walmart declara los cargos por línea y Astrobit los separa uno por uno: comisión, despacho, descuento y precio del producto. La comisión se registra contra la orden; el despacho entra como costo de despacho; el descuento se descuenta donde corresponde.
- 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
- Client ID y client secret de tu cuenta de Walmart Marketplace.
Las credenciales se guardan cifradas. Ningún operador de Astrobit las ve en texto plano.
Pasos
- 1Cargas client ID y client secret en el asistente de conexión.
- 2Astrobit los guarda cifrados y gestiona solo la renovación del token de acceso.
- 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. En Walmart la conexión son dos campos y hay recarga histórica por rango de fechas, así que el catálogo se puede ir pareando por tramos.
Preguntas frecuentes
¿Walmart emite factura desde Astrobit?
Hoy no de forma automática: la integración trata las ventas de Walmart como boleta, igual que Ripley. Una factura para una venta de Walmart se emite manualmente desde Astrobit.
¿Cómo llega el stock a Walmart?
Por el feed de inventario de Walmart. Astrobit envía la cantidad por SKU cada vez que el disponible publicable cambia, y nunca envía un número negativo.
¿La comisión que muestra Astrobit incluye el despacho?
No, van separados. Walmart declara los cargos por línea y Astrobit los distingue: la comisión es comisión, el despacho es costo de despacho, y el descuento se aplica donde corresponde. Mezclarlos deformaría el margen.
¿Puedo traer las órdenes de Walmart de meses anteriores?
Sí. Desde el panel se pide una carga por rango de fechas, que recorre las órdenes página por página en segundo plano.
Otros canales
Conecta tu cuenta de Walmart
Crea tu cuenta y conecta Walmart con tus credenciales de la API, o agenda una reunión y lo revisamos con tus órdenes.