Saltar al contenido
Shalom APIpor SmartFlow
Para tu cuenta Shalom Pro

Registra tus envíos de Shalom desde tu propio sistema

Tu tienda o tu ERP crea cada guía al momento, una por una. Si un envío tiene un dato mal, solo falla ese: los demás salen igual. Sin subir Excel, sin copiar y pegar.

  • Alrededor de 1 segundo por guía
  • Tu clave de Shalom, cifrada
  • Nunca guías repetidas
POST/v1/guias
curl https://shalom.smartflow.pe/v1/guias \
  -H "x-api-key: sk_tu_llave" \
  -H "content-type: application/json" \
  -d '{
    "cuenta_id": "cta_123",
    "referencia": "PED-1001",
    "envio": {
      "documento": "11111111",
      "telefono": "987654321",
      "origen_ter_id": 219,
      "destino_ter_id": 543,
      "producto": "SOBRE"
    }
  }'

# Respuesta 201
{ "ok": true, "data": {
    "referencia": "PED-1001",
    "estado": "creada",
    "precio": 8,
    "clave": "4825",
    "rastreo_url": "https://…" } }
El problema

Un DNI mal escrito no debería frenar todo tu día

Con la carga masiva por Excel, si un solo destinatario tiene un dato que Shalom no reconoce, se cae el archivo entero y tienes que buscar cuál fue.

Con el Excel masivo

  • Un error y no sale ningún envío del archivo.
  • Copias los datos de tu sistema a mano.
  • Sabes el precio recién al final.
  • Revisas el estado de cada guía en la web, una por una.

Con Shalom API

  • Cada guía va sola: si una falla, te decimos cuál y por qué.
  • Tu sistema la crea al confirmar el pedido.
  • Cotizas antes y ves el flete en la respuesta.
  • Te avisamos cuando cambia el estado del envío.
Todo lo que haces en Shalom Pro

Lo mismo de la web, pero dentro de tu sistema

Una sola llave y una documentación clara. Tu equipo sigue trabajando donde ya trabaja.

Agencias siempre al día

Busca por nombre, departamento o cercanía; ve cuáles son aéreas y qué restricciones tienen.

Precio al instante

Cotiza una ruta antes de crear la guía y muéstrale el flete a tu cliente en tu carrito.

Ticket y rótulo en PDF

Descárgalos listos para imprimir apenas se crea la guía, sin entrar a la web.

Rastreo y avisos

Consulta el estado de una o de 50 guías, o recibe un aviso firmado (webhook) cuando cambia.

Anular y corregir

Anula pendientes, cambia la clave de recojo o clona un envío. También autogestiones como reparto a domicilio.

Comprobantes

Lista y descarga los comprobantes que Shalom emitió a tu cuenta, para tu contabilidad.

Cómo funciona

Tres pasos y ya estás enviando

  1. Conecta tu cuenta Shalom Pro

    Pones el correo y la clave de tu cuenta. Probamos el inicio de sesión al momento y guardamos la clave cifrada.

  2. Usa tu llave de API

    Tu sistema manda la cabecera x-api-key en cada llamada. Una llave por cliente, que puedes cambiar cuando quieras.

  3. Crea tus guías

    Envía los datos del destinatario y la agencia con tu propio número de pedido. Si lo mandas dos veces, no se duplica.

Para quién es

Para quien envía todos los días por Shalom

Tiendas en línea

Crea la guía apenas se paga el pedido y manda el enlace de rastreo a tu cliente.

ERPs y sistemas de facturación

Suma el envío por Shalom a tu venta, con ticket y estado en la misma pantalla.

Integradores y agencias

Conecta varias cuentas Shalom de tus clientes con una sola integración.

Integraciones

Conéctalo con lo que ya usas

Automatiza sin programar, pídeselo a tu asistente de IA o llámalo desde tu código. Todo usa la misma llave.

n8n

Nodo con cotizar, registrar guía, rastrear, agencias, DNI y anular, y un disparador por cambio de estado.

Paquete listo · pronto en n8n

Make

Módulos para crear y rastrear guías, cotizar y buscar agencias, más un webhook instantáneo.

App lista · pronto en Make

Zapier

Acciones, búsquedas y un disparador cuando cambia el estado de una guía.

App lista · pronto en Zapier

Claude

Conector MCP: «cotiza y registra este pedido» desde claude.ai, la app o Claude Code.

Disponible

ChatGPT y Cursor

El mismo servidor MCP en ChatGPT (modo desarrollador), Cursor, VS Code y otros.

Disponible

cURL, JavaScript, PHP y Python

Inicio rápido paso a paso con ejemplos listos para copiar, más OpenAPI y llms.txt.

Disponible
Precios

Guías y consultas ilimitadas en todos los planes

Prueba gratis sin tarjeta. Paga mensual o anual (pagas 10 meses y usas 12). Precios sin IGV.

Cargando planes…

Preguntas frecuentes

Lo que nos preguntan antes de conectar

¿Es seguro darles la clave de mi cuenta Shalom Pro?

Tu clave se guarda cifrada (AES-256) y solo se usa para iniciar sesión en tu cuenta. Nunca la mostramos de vuelta, ni siquiera en la API. Si desconectas la cuenta, la borramos junto con su sesión.

¿Pueden mover mi dinero o pagar algo por mí?

No. El servicio no hace pagos (agencia, Yape, tarjeta ni PagoEfectivo), no afilia el cobro seguro, no cambia tu contraseña ni tu perfil y no borra tu cuenta. Del cobro seguro solo lee el estado.

¿Qué pasa si mi sistema manda el mismo pedido dos veces?

Cada guía lleva tu propia referencia (tu número de pedido). Si llega otra vez, te devolvemos la guía que ya existe en lugar de crear otra.

¿Y si Shalom se cae a mitad del registro?

Nunca reintentamos un guardado por nuestra cuenta. Si Shalom no respondió, la guía queda como incierta y te lo decimos, para que revises antes de volver a intentar. Así no aparecen envíos repetidos.

¿Es un producto oficial de Shalom?

No. Shalom API es un servicio independiente de SmartFlow Solutions que trabaja con tu propia cuenta Shalom Pro. Tus envíos, tarifas y comprobantes siguen siendo los de tu cuenta con Shalom.

No soy programador, ¿me sirve?

Sí, si tu sistema ya lo trae conectado o si tu programador lo integra. La documentación tiene ejemplos listos para copiar y un probador para hacer llamadas desde el navegador.

Empieza a registrar tus envíos desde tu sistema

Crea tu cuenta gratis, conecta tu cuenta Shalom Pro y registra tus primeras 30 guías sin pagar nada.