Última actualización: 2026-11-10 · 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). Si envías ancho, alto, largo y peso, además obtienes el precio de "Otra Medida" (paquete con dimensiones propias) calculado por volumen. 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. Envía instanceId para cotizar con la tarifa de Shalom Pro de tu cuenta, la misma que se cobra al registrar la guía. Sin medidas devuelve la tarifa estándar de los productos fijos; con width, height, length y weight devuelve además el precio de "Otra Medida" por volumen. Respuesta cacheada ~5 minutos.
| Parámetro | Descripción |
|---|---|
| instanceId | ID de tu instancia con Shalom Pro conectada. Recomendado: sin él se usa el cotizador público de Shalom, que hoy está protegido y responde 503. |
| 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. |
| width | Ancho en metros (opcional). Para cotizar "otra medida" deben venir las 4 medidas juntas. |
| height | Alto en metros (máx. 1.5 m). |
| length | Largo en metros (máx. 1.5 m). |
| weight | Peso en kg (máx. 500 kg para "otra medida"). |
{
"instanceId": "UUID",
"origin": 7,
"destination": 582,
"width": 1.4,
"height": 1.4,
"length": 1.4,
"weight": 9
}{
"success": true,
"message": "Calculo realizado",
"modo": "personalizado",
"fuente": "pro",
"data": {
"price": 543,
"type": "volumen",
"message": "Cotización basada en el volumen",
"tariff": { "sobre": 8, "cajapaquetexxs": 8, "cajapaquetexs": 10, "cajapaquetes": 12, "cajapaquetem": 16, "cajapaquetel": 20 }
}
}Nota: Con instanceId cotiza con Shalom Pro (fuente "pro") y la caché es por instancia. Sin instanceId intenta el cotizador público de Shalom (fuente "publica"), que Shalom protegió con reCAPTCHA: si lo rechaza responde 503 pidiendo instanceId. Sin medidas devuelve la tarifa estándar (productos fijos) con modo "estandar"; con las 4 medidas devuelve el precio de "Otra Medida" en data.price (type "volumen"). El resultado se cachea 300 s por ruta y medidas.
/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/12345678" \
-H "x-api-key: TU_API_KEY"{
"success": true,
"message": "Información de DNI obtenida de la base de datos.",
"data": {
"dni": "12345678",
"nombres": "JUAN CARLOS",
"apellidoPaterno": "PEREZ",
"apellidoMaterno": "GOMEZ",
"digitoVerificador": 4
}
}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. Envía también el instanceId de tu cuenta Shalom Pro conectada: la cotización usa la tarifa de esa cuenta, la misma que se cobra al registrar, así que puedes mostrar precios exactos 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. |
| 403 | El instanceId no existe o no pertenece a tu API key. |
| 404 | DNI no encontrado en RENIEC. |
| 409 | La instancia perdió la sesión de Shalom Pro. Vuelve a iniciar sesión. |
| 503 | Cotizaste sin instanceId y el cotizador público de Shalom no está disponible. Reintenta enviando instanceId. |
Sí, es lo recomendado. Con instanceId la cotización usa la tarifa de tu cuenta Shalom Pro, la misma que se cobra al registrar, y funciona también en el checkout de tu tienda. Sin instanceId se intenta el cotizador público de Shalom, que hoy está protegido y responde 503.
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