Manual de Configuración: Integración Shopify - Dataico

La integración entre Shopify y DATAICO permite automatizar la creación y envío de facturas electrónicas a la DIAN a partir de las órdenes generadas en tu tienda online.

Con esta integración podrás:

• Generar facturas electrónicas automáticamente.
• Cumplir con la normativa de la DIAN.

El proceso funciona en tres momentos clave:

1. Se crea una orden en Shopify.
2. La orden se paga o se marca con un tag específico.
3. DATAICO genera la factura electrónica y, si así lo configuras, la envía a la DIAN.

Requisitos previos

• Tener una numeración de facturación electrónica activa en Dataico.
• Que el Auth Token de la cuenta esté activo en Opciones > Configuración (ver la advertencia al final).

Configurar Shopify en Dataico

1. Inicia sesión en tu cuenta Dataico y ve a Opciones > Configuración.
2. Da clic en Generar Shopify (o Editar Shopify, si ya lo configuraste antes).
3. Elige la numeración con la que se registrarán las ventas de Shopify.
4. Define el trigger, es decir, cuándo Dataico genera la factura a partir de la orden de Shopify. Se elige con dos listas, campo y valor:
   • financial_status + paid: crea la factura electrónica cuando la orden de Shopify se paga (ya sea por una plataforma de e-commerce o manualmente).
   • tags + DATAICO: esta opción es la más flexible. Al marcar una orden con el tag "DATAICO" en Shopify, esta se envía a DATAICO. El tagging normalmente se realiza después de que el cliente paga. En la sección de cualquier orden en Shopify, en la parte inferior derecha, se encuentra la sección Tags. Agrega el tag DATAICO para hacer el tagging manual.
5. Define si quieres enviar las facturas automáticamente a la DIAN:
   • Marcada: la factura se crea en Dataico y se envía automáticamente a la DIAN.
   • No marcada: la factura se crea en Dataico pero debes ingresar a la plataforma y enviarla manualmente a la DIAN.
6. Copia el Shopify url que aparece en esa sección. Cópialo después de elegir la numeración, porque la URL incluye la numeración elegida.
7. Guarda la configuración.

Configurar el Webhook en Shopify

1. Accede a tu tienda en línea desde Shopify. Al final del menú, selecciona la opción Configuración (o Settings).
2. Dirígete a la opción Notificaciones (o Notifications).
3. Ubica el item Webhooks.
4. Da clic en la opción Crear webhook (o Create webhook).
5. En la ventana de configuración:
   • Evento: el que Shopify dispara cuando la orden cumple el trigger que elegiste. Si usas financial_status: paid, el evento de pago de la orden. Si usas el tag DATAICO, el evento de actualización de la orden, porque el tag se agrega después de crearla. Dataico revisa la orden cada vez que Shopify la envía y solo crea la factura si cumple el trigger.
   • Formato: JSON.
   • URL: pega el Shopify url que copiaste en Dataico.
6. Guarda el webhook.

Visualizar Facturas en DATAICO

En Dataico, en Ventas > Facturas, elige la numeración configurada para Shopify para ver el listado de facturas generadas desde la integración.

Si una orden no se puede facturar, Dataico envía un correo con el error.

Ten en cuenta

• La URL depende de la numeración. Si cambias la numeración en la configuración de Shopify en Dataico, copia la URL nueva y reemplázala en el webhook de Shopify.
• La integración usa el Auth Token de la cuenta. La URL incluye el Auth Token que aparece en Opciones > Configuración, no una llave API. Si revocas ese Auth Token, la integración con Shopify deja de funcionar y las órdenes dejan de facturarse. No hay forma de generar otro desde la plataforma. Si necesitas reactivar la integración, escríbenos al chat de soporte.