Integración con WooCommerce
Astrobit se conecta a tu tienda WooCommerce por la API REST, ingresa cada pedido, emite el documento tributario y mantiene el stock alineado con el resto de tus canales.
Qué hace hoy esta integración
- Ingreso de pedidos en tiempo real por webhook.
- Recarga por rango de fechas desde el panel.
- Varias tiendas WooCommerce conectadas en paralelo.
Qué documento tributario se emite y cuándo
- Qué documento se emite
- Boleta electrónica (T39) o factura electrónica (T33). Astrobit lee el campo de comprobante del pedido: cuando dice factura, toma los datos fiscales del pedido y emite factura electrónica. En caso contrario, 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 tienda?
- 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 WooCommerce 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.
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 la tienda
- 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
- Por los reembolsos y los cambios de estado del pedido en WooCommerce.
- Nota de crédito
- Si la venta tenía documento emitido, se emite la nota de crédito (T61) referenciada a ese documento.
- Stock
- Las unidades devueltas vuelven a bodega y el disponible se re-publica a WooCommerce 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 salen los costos del canal
- En WooCommerce no hay comisión de marketplace. Entran los cargos que configures a nivel de canal y el costo de despacho.
- 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
- URL de tu tienda WooCommerce.
- Consumer key y consumer secret de la API REST de WooCommerce (los generas desde WooCommerce → Ajustes → Avanzado → API REST).
Las credenciales se guardan cifradas. Ningún operador de Astrobit las ve en texto plano.
Pasos
- 1Generas las claves de API REST en WooCommerce.
- 2Las cargas junto con la URL de la tienda en el asistente de conexión.
- 3Eliges qué bodegas alimentan el canal y el piso de stock.
- 4Activas ingreso de pedidos, 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 WooCommerce el paso previo es generar las claves de la API REST desde tu propio WordPress.
Preguntas frecuentes
¿Cómo decide Astrobit entre boleta y factura en WooCommerce?
Lee el campo de comprobante del pedido. Si el pedido viene marcado como factura, Astrobit toma los datos fiscales del pedido y emite factura electrónica; si no, emite boleta.
¿Funciona con cualquier plugin de WooCommerce?
La integración usa la API REST estándar de WooCommerce. Un plugin que cambie la estructura de los pedidos o el nombre de los campos fiscales puede requerir ajustar el mapeo.
¿Puedo conectar más de una tienda WooCommerce?
Sí. Cada tienda se conecta por separado con sus propias claves.
Otros canales
Conecta tu tienda WooCommerce
Crea tu cuenta y conecta WooCommerce con tus claves de API REST, o agenda una reunión y lo vemos con tus pedidos.