Integración con Shopify

Qué documento tributario se emite y cuándo

Qué documento se emite

Boleta electrónica (T39) o factura electrónica (T33). La decisión sale, en orden: de lo que el cliente eligió explícitamente en el checkout (campo de tipo de documento, con su RUT, razón social y giro), y si no existe ese campo, de un RUT válido en la dirección de facturación.

Validación del receptor

Cuando la factura se decide por el RUT de la dirección de facturación, Astrobit consulta ese RUT en el SII para confirmar razón social y giro antes de emitir.

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 el cliente pidió factura pero no dejó ningún RUT utilizable, Astrobit no la degrada a boleta: respeta la intención y retiene la emisión para que alguien complete el RUT. 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 Shopify?

Cuando el documento se emite al cerrar el empaque, el tipo y el folio del DTE se escriben de vuelta en el pedido de Shopify. Es el único canal donde esa devolución del folio está implementada. 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 Shopify 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.

Ventas de Shopify POS

Los pedidos que vienen del punto de venta de Shopify siempre emiten boleta: en mostrador la señal de dirección de facturación no es confiable para decidir factura.

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 Shopify

Eliges qué bodegas alimentan cada canal. El canal publica la suma de esas bodegas, no el total de la empresa.

Ubicaciones de Shopify

Cada ubicación de Shopify se mapea a una bodega de Astrobit, así el stock publicado por ubicación es el de esa bodega.

Devoluciones y notas de crédito

Cómo se entera Astrobit

Por los reembolsos y las ediciones del pedido en Shopify. Astrobit compara el pedido nuevo contra el que tenía y calcula qué líneas se sacaron, cuáles se agregaron y qué cambió de precio.

Nota de crédito

Si la venta tenía documento emitido, se emite la nota de crédito (T61) referenciada a ese documento. Si la edición además agrega productos, se emite el documento de reemplazo que corresponde.

Cambios y devoluciones parciales

Sí. Un cambio (saca un producto y agrega otro) se distingue de una devolución pura, y cada uno genera los documentos que corresponden.

Cambios que no generan documento

Una edición que solo toca el despacho, o solo el precio sin cambiar lo vendido, no emite documentos nuevos.

Portal de devoluciones

Se puede abrir un portal público para que el cliente inicie la devolución. Por canal se define si la solicitud se aprueba sola o queda como borrador para revisión.

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.

Variantes

Cada variante de Shopify se trata como un producto con su propio SKU, su propio stock y su propio costo.

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 Shopify no hay comisión de marketplace. Lo que entra como costo del canal son los cargos que configures (por ejemplo, la comisión de la pasarela de pago) 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