Api cotizador nacional externo

API para calcular la cotización de envíos nacionales dentro de Colombia.

Flujo general del servicio

El servicio de Cotizador Nacional permite calcular el valor de un envío a partir de la información del cliente, el origen, el destino y las características físicas de la carga.

El flujo de funcionamiento es el siguiente:

1. Validación de credenciales

Al recibir la solicitud, el servicio valida que el NIT, la *apikey* y la *clave* correspondan a un cliente autorizado. Si las credenciales no son válidas, la solicitud es rechazada.

1. Identificación de origen y destino

El servicio determina el origen y el destino del envío usando una de las siguientes opciones:

• Códigos postales de origen y destino (si están disponibles).
• Códigos de ciudad (origen y destino), cuando no se envían códigos postales.

En caso de enviar ambos, los códigos postales tienen prioridad.

1. Validación territorial

Con la información de origen y destino, el sistema consulta los territorios correspondientes. Si no se encuentra información válida para alguno de los puntos, la cotización no puede continuar.

1. Cálculo de la cotización

Una vez validados los datos, el servicio consulta el sistema de tarifas para calcular los valores del envío, teniendo en cuenta peso, volumen, unidades, producto y valor declarado.

1. Determinación del tipo de trayecto

El sistema identifica el tipo de trayecto aplicable al envío (por ejemplo, trayecto nacional) según el producto y las ciudades involucradas.

1. Respuesta final

El servicio retorna la cotización final, incluyendo el valor total del flete, sus componentes y la información relevante del cálculo.

Si ocurre cualquier error durante el proceso (credenciales inválidas, datos incompletos o validaciones de negocio), el servicio responde con un mensaje descriptivo y el código de estado correspondiente.