Shopify: órdenes, eventos y bitácora

Dónde mirar cuando algo no cuadra

La sección Shopify tiene tres pantallas de consulta, y cada una responde una pregunta distinta. Saber cuál abrir ahorra la mitad del trabajo de diagnóstico.

• Órdenes — ¿qué vendí y en qué documento terminó?
• Eventos — ¿Shopify me avisó y pude procesarlo?
• Bitácora — ¿qué decidió el sistema, paso por paso?

Órdenes

El listado de todas las órdenes recibidas desde Shopify, con su cliente, su total en la moneda de la orden, el estado de pago y el de entrega.

La columna Documento es la más útil: te lleva directo al pedido o a la factura que esa orden generó en Digimart. Si está vacía, la orden llegó pero no produjo documento — la Bitácora te dirá por qué.

• Filtra por tienda, estado de pago, estado de entrega y rango de fechas.
• Busca por número de orden, nombre del cliente o correo.
• El botón del ojo abre la línea de tiempo de esa orden: todo lo que pasó con ella, en orden.

Eventos

La recepción técnica de cada webhook que mandó Shopify. Es el registro de control que evita procesar dos veces la misma orden y el que permite reprocesar lo que falló.

• Procesado: el evento se recibió y se manejó bien.
• Pendiente: se recibió pero aún no terminó de procesarse.
• Error: algo falló. La columna Error dice qué, y el evento se puede reprocesar.

Reprocesar vuelve a ejecutar el evento como si acabara de llegar: crea el pedido o la factura correspondiente. Úsalo solo cuando hayas corregido la causa del error — si faltaba la cuenta bancaria, configúrala primero y luego reprocesa.

El contenido completo del webhook se puede ver desde el ojo. Cuando el evento ya se procesó bien, ese contenido se recupera del archivo histórico; la pantalla te indica de dónde salió.

Bitácora

La historia de negocio de la integración: qué decidió el sistema y por qué. Es donde se ve, en palabras, que una orden se recibió, que el pago se confirmó, que se creó la factura número tal, que se encoló el e-CF o que la facturación se omitió por falta de cuenta bancaria.

• Filtra por tienda, tipo de evento, nivel (información, advertencia, error) y rango de fechas.
• Busca por número de orden de Shopify.
• Cada fila se abre para ver el detalle completo, incluido el contenido del webhook cuando aplica.
• Cuando el evento produjo una factura, hay un acceso directo a ella.

Si no eliges un rango de fechas, se muestran los últimos 30 días. La bitácora se guarda fuera de la base operativa, en el mismo almacén analítico que usan las demás bitácoras de Digimart: una tienda activa genera muchísimas más líneas de bitácora que documentos, y no tiene sentido que eso pese sobre el sistema del día a día.

Niveles

• Información: el curso normal. Orden recibida, factura creada, pago confirmado.
• Advertencia: algo no ideal pero no roto. Un webhook repetido, una facturación omitida por configuración incompleta, una tienda desactivada.
• Error: algo falló. Firma inválida, credenciales rechazadas, error al facturar.

Diagnóstico rápido

• Vendí en Shopify y no veo nada en Digimart: mira Eventos. Si no hay filas, Shopify no está avisando — revisa las suscripciones de webhook y la firma con el botón Probar de la tienda. Si hay filas con error, ahí está la causa.
• Veo la orden pero no hay documento: mira la Bitácora filtrando por ese número de orden. Los eventos "Facturación omitida" y "Falló la facturación" dicen exactamente qué faltó.
• La factura no cuadra con lo cobrado: abre la orden en Órdenes, compara el total con la factura y revisa el ajuste "Precio a facturar" de la tienda.
• El e-CF no salió: busca en la Bitácora los eventos "e-CF encolado" y "Emisión DGII omitida" de esa orden. Si se encoló pero no salió, el detalle de la factura permite emitirla a mano.
• Todos los webhooks se rechazan: a la tienda le falta la llave de firma. La tarjeta de la tienda lo avisa en rojo y la prueba de conexión lo marca como error.

Permisos

Estas pantallas muestran datos personales del comprador (nombre, correo, dirección) y montos, así que requieren permiso explícito:

• Ver tiendas, órdenes y bitácora de Shopify — para consultar las tres pantallas.
• Conectar/configurar tiendas Shopify — para agregar o editar tiendas, mapear productos, probar la conexión y reprocesar eventos (que crea documentos contables).

Ambos se asignan por rol desde Usuarios y Roles.