Documentación

Referencia de btodigital Facturas Siigo para comerciantes

Qué hace la app

btodigital Facturas Siigo integra tu tienda Shopify con la plataforma contable Siigo para automatizar la facturación electrónica de venta ante la DIAN (Colombia). A partir de cada pedido crea la factura en Siigo con el IVA correcto; genera notas de crédito por reembolsos; sincroniza el catálogo por SKU; y crea o actualiza los clientes (terceros).

Requisitos

• Una tienda Shopify (cualquier plan).
• Una cuenta activa de Siigo con acceso al API.
• Credenciales de API de Siigo (usuario y AccessKey). Partner-Id si eres aliado.
• SKU en los productos que vayas a facturar (el SKU es la identidad entre Shopify y Siigo).

Permisos que solicita

La app pide acceso de lectura a productos, pedidos, clientes e inventario, y de escritura a productos e inventario, para leer los pedidos, emitir las facturas y mantener el catálogo alineado. Solo usa estos datos para la función descrita.

Flujo de facturación

1. Ocurre el evento configurado (pedido pagado, creado o preparado).
2. La app lee el pedido y construye/actualiza el cliente en Siigo.
3. Verifica o crea los productos por SKU y calcula el IVA.
4. Crea la factura de venta en Siigo; si está activado, la timbra ante la DIAN.
5. Opcionalmente envía la copia por correo al cliente y guarda el estado.

Notas de crédito

Cuando registras un reembolso en Shopify, la app crea la nota de crédito electrónica correspondiente en Siigo, asociada a la factura original.

Webhooks

La app se suscribe a eventos de pedidos, reembolsos, productos e inventario de Shopify, y a los webhooks de cumplimiento de privacidad (customers/data_request, customers/redact, shop/redact). Todos responden de inmediato para no retrasar a Shopify.

Seguridad de los datos

Las credenciales de Siigo se cifran con AES-256-GCM antes de almacenarse. Los datos se guardan en Google Cloud (Firestore, EE. UU.) y viajan siempre por HTTPS. La app es multi-tienda: cada comercio usa sus propias credenciales, aisladas del resto. Consulta la política de privacidad para el detalle de retención y eliminación.

Precio

La app se lanza gratis. Cualquier cambio se anunciará con anticipación.

Soporte

Escríbenos a siigo@btodigital.com. También puedes revisar el tutorial y las preguntas frecuentes.