Última actualización: 2026-09-21 · Base URL: https://api.shalom-api.lat
Antes de crear una guía puedes cotizar la tarifa exacta entre terminal de origen y destino (ID del terminal, numérico). Solo requiere tu API key de usuario. El mismo grupo incluye la consulta de DNI contra RENIEC para autocompletar nombres de destinatarios.
/account/quoteCalcula el costo de un envío basado en origen y destino (ter_id o nombre de agencia). Respuesta cacheada ~5 minutos.
| Parámetro | Descripción |
|---|---|
| origin* | ter_id del terminal de origen (numérico) o el nombre de la agencia, ej. 7. |
| destination* | ter_id del terminal de destino (numérico) o el nombre de la agencia, ej. 582. |
{
"origin": 7,
"destination": 582
}{
"...": "espejo de la tarifa calculada por el sistema de Shalom (tarifa/mostrar)"
}Nota: No requiere instanceId. El resultado se cachea en Redis 300 s.
/account/dni/{dni}Obtiene información de una persona por su número de DNI (espejo RENIEC).
| Parámetro | Descripción |
|---|---|
| {dni}* | Número de DNI (string de 8 dígitos), ej. 12345678. |
curl -X GET "https://api.shalom-api.lat/account/dni/44273815" \
-H "x-api-key: TU_API_KEY"{
"...": "espejo de la información RENIEC del DNI consultado"
}Nota: Los campos provienen tal cual del servicio de consulta (Olva Courier → RENIEC).
Una cotización necesita origen y destino, y ambos son identificadores de agencia obtenidos del catálogo. La cotización funciona con tu API key de usuario y no requiere instancia, así que puedes mostrar precios en tu tienda antes de que el cliente compre.
El catálogo marca qué agencias atienden servicio aéreo. Si cotizas usando solo agencias terrestres, el precio y el plazo corresponden al servicio terrestre.
Verifica esa marca antes de prometer una fecha de entrega: la diferencia entre aéreo y terrestre en una ruta larga no es de horas.
La cotización es una consulta de precio: no crea la guía ni bloquea la tarifa. Si tu flujo es «cotizar y luego registrar», hazlo seguido para que el precio que cobraste coincida con el que vas a pagar.
Además de validar que el documento existe, el nombre devuelto te permite confirmar que el pedido y el documento pertenecen a la misma persona. Es una comprobación barata que evita guías rechazadas y reduce el riesgo en envíos de pago contra entrega.
| 400 | El DNI no tiene 8 dígitos o faltan origin/destination. |
| 404 | DNI no encontrado en RENIEC. |
No. La cotización funciona con tu API key de usuario, sin instancia, así que puedes usarla en el checkout de tu tienda.
Los IDs de agencia del catálogo, que obtienes con GET /agencies o GET /agencies/search.
No. Es una consulta de precio: no crea la guía ni bloquea el costo. Cotiza y registra seguido para que ambos coincidan.
El catálogo marca con el campo ter_aereo las agencias que atienden envíos aéreos.
Para confirmar que el documento del destinatario es correcto y que el nombre coincide con el del pedido antes de crear la guía.
Escríbenos por WhatsApp y la recibes de inmediato para probar todos estos ejemplos.
Solicitar API key