Integración con Shopify

Conectar tu tienda en línea con Digimart

La integración con Shopify escucha lo que pasa en tu tienda en línea y lo convierte en documentos de Digimart: clientes, pedidos y facturas. No hay que exportar nada ni cargar archivos: Shopify avisa a Digimart en el momento en que ocurre cada evento.

Qué hace exactamente

• Orden creada en Shopify → se crea el cliente (si no existe) y un pedido en Digimart.
• Pago confirmado → según cómo configures la tienda, el pedido se queda como pedido o se convierte en factura, con su NCF y su cobro registrado en la cuenta bancaria que elijas.
• Orden entregada (total o parcial) → el pedido cambia de estado.
• Orden cancelada → el pedido se anula, salvo que ya se haya facturado (una factura emitida no se toca sola).
• Cliente creado o actualizado en Shopify → se refleja en tu módulo de Clientes.

Todo documento nacido de Shopify queda con la etiqueta Shopify, que Digimart crea y activa sola la primera vez que conectas una tienda.

Requisitos

• Tu suscripción debe incluir el complemento Shopify. Si no lo incluye, la sección aparece bloqueada.
• El módulo debe estar activado por ti (viene apagado de fábrica). Se activa desde Configuración → Integraciones → Shopify, con el interruptor "Mostrar Shopify en el menú".
• Una tienda Shopify y permisos de administrador sobre la organización dueña de esa tienda.

Son dos permisos distintos y hacen falta los dos: el plan decide qué puedes tener; el interruptor decide qué quieres ver. Solo cuando ambos dicen que sí aparece la sección Shopify en el menú lateral.

Paso 1 · Crear la app en el Dev Dashboard de Shopify

Shopify retiró las "apps personalizadas" del panel de la tienda: la pestaña donde antes se copiaba el Admin API access token ya no existe. Desde 2026 la app se crea en el Dev Dashboard y lo que se copia es un Client ID y un Client Secret.

1. Entra a shopify.dev/dashboard con la cuenta dueña de la organización.
2. Crea una app nueva y llámala Digimart.
3. La app y la tienda tienen que estar en la misma organización; si no, el intercambio de credenciales no funciona.

Paso 2 · Permisos e instalación

En la versión de la app habilita estos permisos de Admin API:

• read_orders
• read_customers
• read_products

1. Instala la app en la tienda.
2. En Settings de la app, copia el Client ID y el Client Secret.

El Client Secret es también la llave con la que Shopify firma los webhooks que te envía. Trátalo como una contraseña: quien lo tenga puede hacerse pasar por tu tienda.

Paso 3 · Agregar la tienda en Digimart

1. Ve a Shopify → Configuración, pestaña Tiendas, y pulsa Agregar Tienda.
2. Escribe el dominio (mi-tienda.myshopify.com), el Client ID y el Client Secret.
3. Elige el almacén del que sale la mercancía, el cliente por defecto (opcional) y la cuenta bancaria donde entra el cobro.
4. Define qué documento se genera y con qué comprobante (ver el documento de configuración de documentos y NCF).
5. Al guardar aparece la URL del webhook de esa tienda.

Digimart intercambia tus credenciales por un token de acceso y lo renueva solo cada 24 horas. No tienes que volver a tocarlo. El Client Secret nunca vuelve a salir del servidor: la pantalla solo te dice si está configurado.

Puedes conectar hasta 3 tiendas por empresa, cada una con su propia configuración de almacén, cuenta bancaria y comprobante fiscal.

Paso 4 · Suscribir los eventos

En la app del Dev Dashboard → Event subscriptions, crea una suscripción HTTPS por cada evento apuntando a la URL de webhook que te mostró Digimart. Todos los eventos usan la misma URL: el sistema distingue el tipo por las cabeceras.

• orders/create
• orders/updated
• orders/paid
• orders/fulfilled
• orders/partially_fulfilled
• orders/cancelled
• customers/create
• customers/update
• customers/delete

La firma es obligatoria

Digimart rechaza todo webhook que no venga firmado correctamente. La URL del webhook no es un secreto suficiente: sin verificar la firma, cualquiera que la conociera podría inventar órdenes y hacer que se emitan facturas reales.

• Si conectaste con Client ID y Client Secret, ya está cubierto: se verifica con el Client Secret.
• Si usas un Access Token manual, copia el Signing secret de Shopify (Settings → Notifications → Webhooks) y pégalo en el campo Webhook Secret al editar la tienda.
• Si a una tienda le falta la llave, la pantalla te lo avisa en rojo y la prueba de conexión lo marca como error.

Paso 5 · Probar la conexión

En la pestaña Tiendas, cada tienda tiene un botón Probar. No modifica nada, se puede repetir las veces que quieras, y revisa de una vez las cinco cosas que de verdad rompen la integración:

• Credenciales: si el token sirve y se renueva solo.
• Permisos: si la app de Shopify concedió los tres scopes.
• Firma: si hay con qué verificar los webhooks. Sin esto, todos se rechazan.
• Webhooks registrados: qué eventos están dados de alta apuntando a tu URL y cuáles faltan.
• Configuración contable: si hay cuenta bancaria, almacén y una secuencia NCF vigente para el modo que elegiste.

El resultado queda en pantalla con un semáforo por cada punto y también se registra en la Bitácora, para que puedas comparar antes y después de arreglar algo.

Verificación final

1. Crea una orden de prueba en Shopify.
2. Compruébala en Shopify → Órdenes y en Shopify → Bitácora.
3. Verifica que se haya creado el pedido (o la factura) con la etiqueta Shopify.

Versión de la API

Shopify publica una versión de su API cada trimestre y sostiene cada una durante 12 meses. Digimart te deja elegir entre las vigentes; si no sabes cuál usar, deja la que viene por defecto. Cambiarla no afecta a las órdenes ya recibidas.

Problemas frecuentes

• No llega ninguna orden: revisa que la tienda esté activa (el interruptor de la tarjeta), que los webhooks estén suscritos a la URL correcta y que la firma esté configurada. La prueba de conexión te dice cuál de los tres falla.
• Llegan órdenes pero no se factura: falta la cuenta bancaria, el almacén o la secuencia NCF. La Bitácora lo dice con nombre y apellido en el evento "Facturación omitida".
• Las facturas no cuadran con lo que cobró Shopify: revisa el ajuste "Precio a facturar" de la tienda.
• Un evento falló: ve a Shopify → Eventos, ábrelo para ver el error y usa Reprocesar cuando hayas corregido la causa.