# Shalom API > API REST para operar cuentas Shalom Pro (courier Shalom, Perú): crear guías, cotizar, agencias, rastreo, ticket y rótulo PDF, pendientes, webhooks y autogestión. Base https://shalom.smartflow.pe/v1, cabecera x-api-key: sk_…, respuestas {ok:true,data} o {ok:false,codigo_error,error}. Servicio de SmartFlow Solutions, no oficial de Shalom. ## Documentación - [Referencia completa en texto](https://shalom.smartflow.pe/llms-full.txt): todas las rutas, campos y ejemplos - [Inicio rápido](https://shalom.smartflow.pe/docs/inicio-rapido): llave, cuenta, cotizar, guía, rastreo y webhook en cURL, JavaScript, PHP y Python - [Conectar con IA (MCP)](https://shalom.smartflow.pe/docs/conectar-ia): Claude, ChatGPT y Cursor - [Especificación OpenAPI](https://shalom.smartflow.pe/v1/openapi.json) - [Referencia interactiva](https://shalom.smartflow.pe/docs/) ## Rutas ### Cuenta - GET /v1/yo: Datos del cliente, plan (prueba, vencimiento, guías de prueba restantes) y consumo. Responde aun con la prueba terminada. ### Cuentas Shalom - GET /v1/cuentas: Lista las cuentas Shalom Pro conectadas - POST /v1/cuentas: Conecta una cuenta Shalom Pro (email + password; se guarda cifrada y se prueba el inicio de sesión) - GET /v1/cuentas/{id}: Ver una cuenta - PUT /v1/cuentas/{id}: Cambiar email, clave o nombre (se vuelve a probar) - DELETE /v1/cuentas/{id}: Desconectar la cuenta (borra la clave guardada) - POST /v1/cuentas/{id}/probar: Probar el inicio de sesión en Shalom ### Consultas - GET /v1/agencias: Agencias Shalom con filtros y cercanía - GET /v1/agencias/{id}: Una agencia (con restricciones) - GET /v1/ubicaciones/departamentos: Departamentos - GET /v1/ubicaciones/provincias: Provincias de un departamento (por nombre) - GET /v1/ubicaciones/distritos: Distritos de una provincia (por nombre) - GET /v1/productos: Productos (tamaños) con medidas y peso estándar - POST /v1/cotizar: Cotizar una ruta - GET /v1/dni/{numero}: Nombres y apellidos de un DNI - GET /v1/perfil: Remitente de la cuenta y estado del cobro seguro ### Después de crear - GET /v1/guias/{referencia}/ticket: Ticket en PDF - GET /v1/guias/{referencia}/rotulo: Rótulo en PDF - GET /v1/pendientes: Guías pendientes (aún no entregadas en agencia) - DELETE /v1/pendientes/{id}: Anular una pendiente - POST /v1/pendientes/anular: Anular varias pendientes - POST /v1/pendientes/{id}/clave: Cambiar la clave de una pendiente - POST /v1/pendientes/clave: Cambiar la clave de varias pendientes - POST /v1/pendientes/{id}/clonar: Clonar una pendiente: devuelve su envío listo para POST /v1/guias (no crea nada en Shalom) ### Guías - GET /v1/guias: Listar guías - POST /v1/guias: Crear una guía (con todas las opciones del registro individual) - GET /v1/guias/{referencia}: Ver una guía por su referencia - POST /v1/guias/lote: Crear varias guías (máx. 100) ### Públicas (sin llave) - GET /v1/publico/agencias: Todas las agencias Shalom (sin llave) (sin llave) - GET /v1/publico/agencias/buscar: Buscar agencias por texto, ubicación o cercanía (sin llave) (sin llave) ### MCP (IA) - POST /mcp: Servidor MCP (Streamable HTTP, sin sesión) ### Seguimiento - GET /v1/rastreo/{guia}: Rastrear una guía - POST /v1/rastreo/lote: Rastrear hasta 50 guías - GET /v1/en-transito: Envíos en curso - GET /v1/entregados: Envíos entregados ### Comprobantes - GET /v1/comprobantes: Comprobantes que Shalom emitió a la cuenta - GET /v1/comprobantes/{serie}/{numero}: Enlace de descarga de un comprobante ### Avisos (webhook) - GET /v1/webhook: Ver el webhook configurado (sin el secreto) - PUT /v1/webhook: Crear o cambiar la URL del webhook - DELETE /v1/webhook: Quitar el webhook - GET /v1/webhook/entregas: Historial de intentos de aviso - GET /v1/suscripciones: Listar suscripciones (últimas 500) - POST /v1/suscripciones: Vigilar guías (máx. 50 por llamada) - GET /v1/suscripciones/{guia}: Ver una suscripción - DELETE /v1/suscripciones/{guia}: Dejar de vigilar una guía ### Autogestión - POST /v1/autogestion/{tipo}/iniciar: Paso 1: validar la guía y pedir el código - GET /v1/autogestion/tramites/{id}: Estado de un trámite - GET /v1/autogestion/reparto/ubigeo: Departamentos, provincias o distritos para el reparto a domicilio - POST /v1/autogestion/tramites/{id}/tarifa: Tarifa del reparto a domicilio - POST /v1/autogestion/tramites/{id}/confirmar: Paso 2: confirmar con el código recibido - GET /v1/autogestion/historial: Historial de autogestiones de la cuenta ## Opcional - [Servidor MCP](https://shalom.smartflow.pe/mcp): POST, JSON-RPC 2.0, misma llave sk_