Manejo de errores
Guía para el manejo de errores en la consulta de capacidades
Introducción
En la integración de capacidades de despacho, es fundamental manejar adecuadamente los errores que puedan surgir durante el proceso de consulta. Esta guía proporciona una visión general de cómo identificar y gestionar estos errores para garantizar una experiencia fluida y confiable.
Casos de error
Las causas de de error en la consulta de capacidades, se pueden clasificar en las siguientes categorías:
- Errores por la validación de los datos enviados en la solicitud.
- Errores en la configuración de rutas y zonas de entrega.
- Errores en el calculo de capacidades.
- Errores internos de la plataforma.
Errores HTTP
Estos errores ocurren cuando los datos enviados en la solicitud no cumplen con los requisitos esperados y provocan respuestas de error HTTP.
| Código HTTP | Descripción | Solución |
|---|---|---|
401 | Unauthorized - Falta la clave API o es inválida. | Asegurarse de incluir una clave API válida en la solicitud. |
422 | Unprocessable Entity - La solicitud contiene datos que no pueden ser procesados. | Verificar y corregir los datos enviados en la solicitud. |
500 | Internal Server Error - Error interno en la plataforma. | Contactar al soporte técnico para resolver el problema. |
A continuación, se detallan algunos ejemplos de estos errores:
Errores en el calculo de capacidades
Errores relacionados a la ruta de entrega
En la siguiente tabla se muestran los códigos de error relacionados con la configuración de rutas de entrega:
| Código de error | Descripción | Solución |
|---|---|---|
ROUTE_NOT_EXIST | La ruta especificada no existe. | Verificar y corregir la ruta en la solicitud. |
ROUTE_CONFIGURATION_ERROR | Error en la configuración de la ruta. | Verificar y corregir la configuración de la ruta. |
A continuación, se detallan algunos ejemplos de estos errores:
Errores relacionados al stock y disponibilidad de productos
Estos errores ocurren cuando los productos solicitados no están disponibles o no tienen suficiente stock para cumplir con la solicitud.
Este tipo de errores se detallan en el campo detailedCapacityError de la respuesta y tienen como código principal para identificarlos el valor CAPACITY_ERROR.
La siguiente tabla muestra los sub-códigos de error relacionados con el cálculo de capacidades:
| Código de error | Descripción | Solución |
|---|---|---|
PRODUCT_STOCK_NOT_AVAILABLE | No hay stock disponible para el producto solicitado. | Consultar el stock disponible y ajustar la solicitud en consecuencia. |
PRODUCT_NOT_FOUND | El producto solicitado no se encuentra en el catálogo. | Verificar el código del producto y corregirlo si es necesario. |
PRODUCT_STOCK_NOT_FOUND | No se encontró información de stock para el producto solicitado. | Verificar la información de stock del producto y corregirla si es necesario. |
INSUFFICIENT_STOCK | El stock disponible es insuficiente para cumplir con la solicitud. | Consultar el stock disponible y ajustar la solicitud en consecuencia. |
PRODUCT_STOCK_NOT_VALUE_DEFINED | No se ha definido un valor de stock para el producto solicitado. | Verificar y definir el valor de stock del producto. |
A continuación, se detallan algunos ejemplos de estos errores:
Errores relacionados al cálculo de capacidades
Estos errores ocurren cuando los productos solicitados no están disponibles o no tienen suficiente stock para cumplir con la solicitud.
Este tipo de errores se detallan en el campo detailedCapacityError de la respuesta y tienen como código principal para identificarlos el valor CAPACITY_ERROR.
La siguiente tabla muestra los sub-códigos de error relacionados con el cálculo de capacidades:
| Código de error | Descripción | Solución |
|---|---|---|
DISPATCH_NOT_AVAILABLE | No hay opciones de despacho disponibles para la solicitud. | Verificar las opciones de despacho y ajustar la solicitud en consecuencia. |
CALCULATION_CAPACITY_COST_ERROR | Error al calcular el costo de la capacidad. | Contactar al soporte técnico para resolver el problema. |
A continuación, se detallan algunos ejemplos de estos errores:
Errores internos de la plataforma
Estos errores ocurren durante el proceso de cálculo de capacidades y se reflejan en la respuesta de la consulta de capacidades.
Este tipo de errores se detallan en el campo detailedCapacityError de la respuesta y tienen como código principal para identificarlos el valor CAPACITY_ERROR.
La siguiente tabla muestra los sub-códigos de error relacionados con el cálculo de capacidades:
| Código de error | Descripción | Solución |
|---|---|---|
GENERIC_ERROR | Error genérico durante el cálculo de capacidades. | Contactar al soporte técnico para resolver el problema. |
A continuación, se detallan algunos ejemplos de estos errores: