Guía completa de configuración

Todo lo que necesitas para dejar tu facturación automática funcionando — paso a paso, campo por campo. Si sigues esta guía no deberías necesitar ayuda; y si algo falla, al final está la sección de solución de problemas.

1. Antes de empezar

Necesitas tres cosas:

• Una tienda Shopify (cualquier plan).
• Una cuenta activa de Siigo con acceso al API (Siigo Nube).
• Que tus productos tengan SKU. El SKU es la “identidad” que empareja cada producto de Shopify con el de Siigo. Los productos sin SKU se omiten al facturar.

2. Instalar la app y elegir plan

Instala btodigital Facturas Siigo desde la Shopify App Store. Al instalar, Shopify te mostrará los planes (Emprende, Crece y Pro) según el volumen de facturas que emitas al mes. Elige uno; puedes empezar con la prueba gratuita y cambiar de plan cuando quieras.

Al abrir la app verás el panel con la guía de Primeros pasos: conectar Siigo, configurar la facturación y sincronizar el catálogo. Vamos una a una.

3. Obtener tus credenciales de API en Siigo

La app necesita un usuario y una AccessKey de Siigo para poder crear facturas por ti. Se generan una sola vez:

1. Ingresa al portal de clientes de Siigo con tu usuario administrador.
2. Ve a Configuración → Alianzas e integraciones → Credenciales Siigo API (o “Generar credenciales API”).
3. Copia tu usuario (es un correo) y genera/copía tu AccessKey. Guárdala; la pegarás en la app.

4. Conectar Siigo en la app

En la app, entra a Ajustes Siigo → 1. Credenciales de Siigo API y llena:

• Usuario API (email): el correo de tu credencial de Siigo.
• AccessKey: la clave que generaste. Se guarda cifrada (AES-256-GCM); nunca queda a la vista.
• Ambiente: Producción para facturar de verdad; Sandbox solo para pruebas.
• Partner-Id (opcional): déjalo vacío si no aplica. Si tu cuenta lo exige o eres aliado, ponlo aquí.

Dale Guardar y validar. La app verifica las credenciales contra Siigo y carga tus catálogos (tipos de comprobante, impuestos, vendedores, etc.). Si ves un aviso verde de “validadas”, vas bien.

5. Configurar la facturación (cada campo)

En Ajustes Siigo → 2. Configuración de facturación:

Comprobantes e impuestos

• Tipo de comprobante de venta (FV): elige tu factura electrónica de venta (la que llega a la DIAN). Los ejemplos marcados “electrónica DIAN ✓ recomendada” son los correctos.
• Tipo de nota de crédito (NC): el comprobante que se usará cuando hagas un reembolso en Shopify.
• Impuesto IVA: normalmente IVA 19%. La app lo usa para calcular la base gravable exacta.
• Método de pago por defecto y Vendedor por defecto: con qué método y a nombre de qué vendedor se registran las facturas.
• Bodega y Centro de costos (opcionales): si los manejas en Siigo.

Manejo del IVA en el precio

• El precio ya incluye IVA (recomendado): lo más común en tiendas colombianas. La app calcula la base para que el total cuadre al centavo.
• El precio NO incluye IVA: Siigo lo suma encima.
• Sin IVA: para productos excluidos.

Envío

Si tus pedidos cobran envío, pon el código del producto de envío en Siigo (por ejemplo 001). Ese producto debe existir en tu catálogo de Siigo. Si no cobras envío, déjalo vacío.

Sincronización de productos

• Solo verificar (recomendado): no toca tu catálogo de Siigo, solo comprueba que los SKU existan.
• Crear los que falten: crea en Siigo los productos que no existan.
• Crear y actualizar: además sobrescribe datos en Siigo (úsalo con cuidado).

6. Elegir cuándo y cómo facturar

¿Cuándo se crea la factura?

• Cuando la orden se paga (recomendado): factura solo pedidos efectivamente pagados.
• Cuando la orden se crea: factura apenas entra el pedido.
• Cuando se prepara / se paga y se prepara: para flujos con fulfillment.
• No facturar automáticamente: creas cada factura a mano desde la sección Facturas.

¿Se envía a la DIAN?

• Enviar automáticamente a la DIAN al crear la factura: la timbra de una vez.
• Si lo dejas desmarcado, la factura queda en borrador en Siigo y la emites cuando quieras. Ideal para tus primeras pruebas.
• Enviar copia por email al cliente: opcional.

7. Sincronizar tu catálogo

En Productos, dale Sincronizar ahora. La app recorre tus variantes activas y las empareja con Siigo por SKU. Verás, por cada variante, el estado: OK, error o saltado (sin SKU). El proceso corre en segundo plano; la pantalla se actualiza sola.

8. Tu primera factura

1. Crea o recibe un pedido con un producto que tenga SKU.
2. Asegúrate de que el pedido traiga la identificación del cliente (cédula o NIT) — ver el aviso de más abajo.
3. Según tu trigger, la app crea la factura en Siigo. Revísala en la sección Facturas.
4. Cuando confirmes que todo está bien, activa el envío automático a la DIAN.

9. Notas de crédito (devoluciones)

Cuando registras un reembolso en Shopify, la app crea la nota de crédito electrónica correspondiente en Siigo, asociada a la factura original. También puedes crear una nota de crédito manual desde la sección Facturas.

10. Consumo del plan y límites

Cada plan incluye un número de facturas al mes (Emprende 500, Crece 1.500, Pro 4.000). En el panel verás tu consumo del mes con una barra de progreso. Te avisamos cuando te acercas al límite (80%) y cuando lo alcanzas. Si necesitas más, subes de plan en un clic desde Shopify y el nuevo límite aplica de inmediato. El contador se reinicia cada mes.

Solución de problemas