Manejo de Errores
Durante el proceso de integración pueden surgir errores que impidan la correcta transferencia de pedidos. El sistema implementa mecanismos de registro y control para facilitar su identificación y resolución.
🗒️ Registro de errores
Cuando se detecta un error:
- Se registra el detalle en la tabla
SFI_OrdenErrorLogpara su trazabilidad. - Se añade la etiqueta ERROR_INTEGRACION al pedido en Shopify, indicando que requiere intervención.
🚦 Tipos de errores controlados
A continuación se describen los errores más comunes que pueden presentarse durante la integración, junto con una explicación clara y pasos detallados para su solución.
🛑 Dirección de Facturación
Código: DireccionFacturacion
Descripción: El pedido no contiene información de dirección de facturación, lo que impide su procesamiento correcto.
Solución:
- Ingresa a Shopify y localiza el pedido con la etiqueta ERROR_INTEGRACION.
- Edita la información del cliente y añade una dirección de facturación válida y completa (nombre, dirección, ciudad, país, etc.).
- Guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
📦 Dirección de Despacho
Código: DireccionDespacho
Descripción: El pedido no tiene información de dirección de despacho, necesaria para la entrega del producto.
Solución:
- Accede al pedido en Shopify.
- Completa todos los campos requeridos en la dirección de despacho (nombre, dirección, ciudad, país, etc.).
- Guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
💸 Totales Descuadrados
Código: TotalesDescuadrados
Descripción: Los totales del pedido no coinciden o presentan inconsistencias, lo que puede deberse a descuentos, cargos o errores en los productos.
Solución:
- Revisa los productos, descuentos y cargos adicionales del pedido en Shopify.
- Asegúrate de que los totales sumen correctamente y que no existan diferencias entre el detalle y el total.
- Corrige cualquier discrepancia y guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
🆔 RUT de Cliente Inválido
Código: RutClienteInvalido
Descripción: El RUT del cliente de facturación es inválido o está mal ingresado.
Solución:
- Accede al pedido en Shopify y localiza la sección de metacampos.
- Completa los campos de facturación:
- Rut Empresa: Ingresa un RUT válido, respetando el formato requerido (sin puntos, con guion y dígito verificador).
- Razón Social: Ingresa la razón social del cliente.
- Guarda los cambios en los metacampos del pedido.
- Ver Reprocesamiento tras corrección para completar el proceso.
🏷️ Producto sin SKU
Código: ProductoSinSKU
Descripción: Alguna variante de producto en el pedido no tiene SKU asignado, lo que impide su identificación en Flexline.
Solución:
- Identifica el producto sin SKU en el detalle del pedido.
- Ve al catálogo de productos en Shopify y asigna un SKU único a la variante correspondiente.
- Guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
💳 Pasarela No Configurada
Código: PasarelaNoConfigurada
Descripción: El método de pago utilizado en el pedido no está configurado en Flexline.
Solución:
- Consulta el método de pago del pedido en Shopify.
- Ingresa a Flexline y agrega la pasarela correspondiente en la tabla
SHOPIFY_PAGOS. - Verifica que el nombre coincida exactamente con el método usado en Shopify.
- Guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
🏬 Sucursal No Configurada
Código: SucursalNoConfigurada
Descripción: La sucursal asociada al pedido no está configurada en Flexline.
Solución:
- Revisa la sucursal asignada al pedido en Shopify.
- Ingresa a Flexline y agrega la sucursal en la tabla
SHOPIFY_LOCALES. - Asegúrate de que los datos coincidan con los de Shopify.
- Guarda los cambios.
- Ver Reprocesamiento tras corrección para completar el proceso.
🔄 Reprocesamiento tras corrección
Cuando un error ha sido corregido:
- Elimina la etiqueta ERROR_INTEGRACION en el pedido de Shopify.
- El integrador detectará la corrección y volverá a intentar la integración automáticamente.
Revisa periódicamente los pedidos con errores y mantén actualizada la información en Shopify y Flexline para minimizar incidencias.