{"openapi":"3.1.2","info":{"title":"Shalom API","version":"0.1.0","description":"Servicio independiente, no oficial de Shalom. API local con sandbox persistente y conector Pro experimental: login normal, cotización, alta de un sobre propio con DNI y rótulo PDF verificados. No acredita recepción física, tránsito o entrega. Otros contenidos, documentos y seguimiento real siguen pendientes de validación. La suscripción, los permisos y el entorno se verifican en servidor.","license":{"name":"Propietaria; condiciones comerciales por definir"},"contact":{"name":"Solicitar acceso por WhatsApp","url":"https://wa.me/51983589679"}},"servers":[{"url":"http://localhost:3100","description":"Servidor local de desarrollo. No hay dominio de producción desplegado."}],"x-contract-stage":"local-preview","x-provider-integration-status":"experimental-pro-browser-pilot","tags":[{"name":"Service","description":"Salud y capacidades."},{"name":"Connections","description":"Conexiones aisladas y autorización."},{"name":"Keys","description":"Credenciales de consumidores."},{"name":"Catalog","description":"Agencias y embalajes."},{"name":"Quotes","description":"Cotización del transporte."},{"name":"Recipients","description":"Destinatarios locales privados."},{"name":"Shipments","description":"Procesamiento y transporte separados."},{"name":"Documents","description":"Acceso a documentos privados."},{"name":"Operations","description":"Trabajos persistentes."},{"name":"Usage","description":"Consumo y límites propios."},{"name":"PublicCatalog","description":"Copia pública capturada de agencias."},{"name":"DeveloperResources","description":"Contratos y paquetes descargables sin secretos."},{"name":"Sandbox","description":"Controles exclusivos del desarrollo local."}],"security":[{"ApiKey":[]},{"AdminSession":[]}],"paths":{"/v1/health":{"get":{"operationId":"getHealth","summary":"Comprobar vida del servicio","description":"Liveness propio; no comprueba Shalom.","tags":["Service"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[],"x-rate-policy":"cache_local_no_upstream"}},"/v1/capabilities":{"get":{"operationId":"getCapabilities","summary":"Consultar capacidades verificadas","description":"Capacidades live desactivadas hasta validación real.","tags":["Service"],"x-required-scopes":["connections:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/OptionalConnectionQuery"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"shipments_read"}},"/v1/connections":{"get":{"operationId":"listConnections","summary":"Listar conexiones propias","description":"Solo conexiones permitidas a la identidad; sin secretos.","tags":["Connections"],"x-required-scopes":["connections:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"connections"},"post":{"operationId":"createConnection","summary":"Crear conexión local","description":"Crea pending_authorization local; no hace login externo.","tags":["Connections"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"201":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":true,"parameters":[{"$ref":"#/components/parameters/OptionalIdempotencyKey"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionCreate"}}}},"x-rate-policy":"connections"}},"/v1/connections/{connection_id}":{"get":{"operationId":"getConnection","summary":"Consultar conexión propia","description":"Estado y capacidades, sin credenciales. En live, data.authorization indica el ?ltimo intento de conexi?n si existe.","tags":["Connections"],"x-required-scopes":["connections:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ConnectionId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"connections"},"patch":{"operationId":"updateConnection","summary":"Configurar remitente y origen","description":"Propietario cambia solo datos logísticos propios; no credenciales.","tags":["Connections"],"x-required-scopes":["connections:configure"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":false,"parameters":[{"$ref":"#/components/parameters/ConnectionId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionPatch"}}}},"x-rate-policy":"connections"},"delete":{"operationId":"disconnectConnection","summary":"Desconectar acceso del servicio","description":"Revoca uso local, bloquea nuevas tareas y conserva historial. No cancela envíos ni garantiza invalidar sesiones remotas.","tags":["Connections"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"204":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":true,"parameters":[{"$ref":"#/components/parameters/ConnectionId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"connections"}},"/v1/connections/{connection_id}/authorization-sessions":{"post":{"operationId":"startConnectionAuthorization","summary":"Iniciar autorización del propietario","description":"Inicia conexión normal a la cuenta Pro del negocio mediante navegador y trabajo persistente. Requiere configurar el conector experimental y una suscripción activa. No es OAuth ni API oficial de Shalom. Si aparece una verificación manual se detiene. La contraseña es writeOnly y se elimina al terminar el intento. Una solicitud con un intento vigente en cola o en ejecuci?n devuelve el mismo intento. La cuota se aplica al iniciar uno nuevo; Retry-After indica cu?ndo reintentar si se recibe 429.","tags":["Connections"],"x-required-scopes":["connections:authorize"],"x-implementation-status":"experimental_live_pilot","responses":{"202":{"description":"Solicitud persistida para el worker de conexión.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationSessionResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":false,"parameters":[{"$ref":"#/components/parameters/ConnectionId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationCreate"}}}},"x-rate-policy":"authorization"}},"/v1/authorization-sessions/{authorization_session_id}":{"get":{"operationId":"getConnectionAuthorization","summary":"Consultar autorización propia","description":"Consulta el estado del intento propio sin devolver contraseña, cookies ni tokens de Pro.","tags":["Connections"],"x-required-scopes":["connections:read"],"x-implementation-status":"experimental_live_pilot","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationSessionResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":false,"parameters":[{"$ref":"#/components/parameters/AuthorizationId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"operations"}},"/v1/keys":{"get":{"operationId":"listApiKeys","summary":"Listar metadatos de claves","description":"Solo propietario; no devuelve secretos ni hashes.","tags":["Keys"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":true,"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"keys"},"post":{"operationId":"issueApiKey","summary":"Emitir clave restringida","description":"Secreto una vez, sin replay por idempotencia. Ante respuesta perdida, listar/revocar y crear otra. Verifica conexión/entorno.","tags":["Keys"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"201":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyIssuedResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreate"}}}},"x-rate-policy":"keys","parameters":[{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}]}},"/v1/keys/{key_id}":{"delete":{"operationId":"revokeApiKey","summary":"Revocar clave propia","description":"Bloquea nuevas solicitudes; conserva auditoría y no cancela efectos externos ya ejecutados.","tags":["Keys"],"x-required-scopes":[],"x-implementation-status":"implemented","responses":{"204":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"security":[{"AdminSession":[]}],"x-owner-only":true,"parameters":[{"$ref":"#/components/parameters/KeyId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"keys"}},"/v1/agencies":{"get":{"operationId":"listAgencies","summary":"Buscar agencias habilitadas","description":"Catálogo normalizado y fecha de actualización; no infiere servicios solo por distrito.","tags":["Catalog"],"x-required-scopes":["catalog:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgencyListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ConnectionQuery"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"name":"department_code","in":"query","required":false,"description":"Filtro de catálogo normalizado.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"province_code","in":"query","required":false,"description":"Filtro de catálogo normalizado.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"district_code","in":"query","required":false,"description":"Filtro de catálogo normalizado.","schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"search","in":"query","required":false,"description":"Filtro de catálogo normalizado.","schema":{"type":"string","minLength":1,"maxLength":100}},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"catalog"}},"/v1/package-types":{"get":{"operationId":"listPackageTypes","summary":"Consultar embalajes","description":"Solo entrega medidas normalizadas verificadas; no catálogo comercial de Kova.","tags":["Catalog"],"x-required-scopes":["catalog:read"],"x-implementation-status":"experimental_live_pilot","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageTypeListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ConnectionQuery"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"catalog"}},"/v1/quotes":{"post":{"operationId":"createQuote","summary":"Obtener cotización estimada","description":"Cotiza y persiste precio y paquetes; no registra envío. valid_until es política del servicio, no garantía de tarifa del proveedor.","tags":["Quotes"],"x-required-scopes":["quotes:write"],"x-implementation-status":"experimental_live_pilot","responses":{"201":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/OptionalIdempotencyKey"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuoteCreate"}}}},"x-rate-policy":"quotes"}},"/v1/recipients":{"post":{"operationId":"createRecipient","summary":"Guardar destinatario local","description":"Guarda localmente; alta remota cuando corresponda dentro del trabajo de envío. Valida persona/empresa.","tags":["Recipients"],"x-required-scopes":["recipients:write"],"x-implementation-status":"implemented","responses":{"201":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipientResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/OptionalIdempotencyKey"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipientCreate"}}}},"x-rate-policy":"recipients"}},"/v1/recipients/search":{"post":{"operationId":"searchRecipients","summary":"Buscar destinatarios propios","description":"Documento en cuerpo privado. Coincidencia local exacta; no directorio global ni consulta RENIEC.","tags":["Recipients"],"x-required-scopes":["recipients:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipientListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipientSearch"}}}},"x-rate-policy":"recipients"}},"/v1/recipients/{recipient_id}":{"get":{"operationId":"getRecipient","summary":"Consultar destinatario propio","description":"Datos privados locales autorizados por negocio.","tags":["Recipients"],"x-required-scopes":["recipients:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecipientResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/RecipientId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"recipients"}},"/v1/shipments":{"get":{"operationId":"listShipments","summary":"Listar envíos propios","description":"Historial persistido propio; filtros siempre acotados al negocio.","tags":["Shipments"],"x-required-scopes":["shipments:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"name":"connection_id","in":"query","required":false,"description":"Conexión propia.","schema":{"type":"string","format":"uuid"}},{"name":"external_reference","in":"query","required":false,"description":"Referencia comercial sin DNI; recupera un intento después de perder acuse.","schema":{"type":"string","minLength":1,"maxLength":100}},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"shipments_read"},"post":{"operationId":"createShipment","summary":"Solicitar registro idempotente de envío","description":"Transacción crea envío, operación y tarea.202 no acredita registro externo. Requiere capacidad verificada y conexión habilitada. Unicidad permanente negocio+conexión+external_reference. Resultados inciertos requieren reconciliación. El envio usa las agencias de origen y destino de la cotizacion vigente. El origen guardado en la conexion es opcional.","tags":["Shipments"],"x-required-scopes":["shipments:write"],"x-implementation-status":"experimental_live_pilot","responses":{"202":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}},"Location":{"description":"Ruta relativa para consultar la operación persistida.","schema":{"type":"string","pattern":"^/v1/operations/[a-fA-F0-9-]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentAcceptedResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentCreate"}}}},"x-rate-policy":"shipments_create"}},"/v1/shipments/{shipment_id}":{"get":{"operationId":"getShipment","summary":"Consultar envío propio","description":"Procesamiento y transporte separados; referencias externas solo con evidencia. No devuelve claves de recojo.","tags":["Shipments"],"x-required-scopes":["shipments:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ShipmentId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"shipments_read"}},"/v1/shipments/{shipment_id}/events":{"get":{"operationId":"listShipmentEvents","summary":"Consultar eventos del envío","description":"Fuente y fechas observadas; sin cronología ni llegada inventadas.","tags":["Shipments"],"x-required-scopes":["shipments:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentEventListResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ShipmentId"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"shipments_read"}},"/v1/shipments/{shipment_id}/refresh":{"post":{"operationId":"refreshShipment","summary":"Solicitar actualización de seguimiento","description":"Programa lectura; no recrea envío. Agrupa mientras exista refresh activo y limita frecuencia.","tags":["Shipments"],"x-required-scopes":["shipments:read"],"x-implementation-status":"sandbox_implemented_live_gated","responses":{"202":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}},"Location":{"description":"Ruta relativa para consultar la operación persistida.","schema":{"type":"string","pattern":"^/v1/operations/[a-fA-F0-9-]+$"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationAcceptedResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ShipmentId"},{"$ref":"#/components/parameters/OptionalIdempotencyKey"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"refresh"}},"/v1/shipments/{shipment_id}/documents/{kind}":{"get":{"operationId":"getShipmentDocument","summary":"Obtener acceso temporal a documento","description":"Documento propio ya disponible;409 document_not_ready si falta. No crea envío. Acceso proveedor pendiente de validación real.","tags":["Documents"],"x-required-scopes":["documents:read"],"x-implementation-status":"experimental_live_pilot","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentLinkResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/ShipmentId"},{"name":"kind","in":"path","required":true,"description":"Documento privado.","schema":{"type":"string","enum":["label","ticket"]}},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"documents"}},"/v1/operations/{operation_id}":{"get":{"operationId":"getOperation","summary":"Consultar resultado de tarea","description":"Estado persistido. succeeded no implica entrega física.","tags":["Operations"],"x-required-scopes":["operations:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"parameters":[{"$ref":"#/components/parameters/OperationId"},{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}],"x-rate-policy":"operations"}},"/v1/usage":{"get":{"operationId":"getUsage","summary":"Consultar consumo propio","description":"Contadores propios. No paga ni factura. Alta confirmada se cuenta una vez; reintentos internos no son otra alta.","tags":["Usage"],"x-required-scopes":["usage:read"],"x-implementation-status":"implemented","responses":{"200":{"description":"Resultado del servicio propio; no respuesta cruda del proveedor.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"409":{"$ref":"#/components/responses/409"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"422":{"$ref":"#/components/responses/422"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"},"502":{"$ref":"#/components/responses/502"},"503":{"$ref":"#/components/responses/503"}},"x-rate-policy":"usage","parameters":[{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}]}},"/public/agencies":{"get":{"operationId":"listPublicAgencies","summary":"Consultar copia pública de agencias","description":"Catálogo observado con procedencia/fecha. El estado reportado no es disponibilidad en tiempo real.","tags":["PublicCatalog"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAgencyCatalog"}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream","parameters":[{"name":"department_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"province_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"district_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"search","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}}]}},"/public/agencies.geojson":{"get":{"operationId":"getAgencyGeoJSON","summary":"Consultar puntos de agencias","description":"Solo coordenadas capturadas válidas, sin llamadas nuevas a Shalom.","tags":["PublicCatalog"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/geo+json":{"schema":{"$ref":"#/components/schemas/AgencyGeoJSON"}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream","parameters":[{"name":"department_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"province_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"district_code","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}},{"name":"search","in":"query","required":false,"description":"Filtro de la copia pública.","schema":{"type":"string","maxLength":100}}]}},"/openapi.json":{"get":{"operationId":"downloadOpenAPI","summary":"Descargar contrato OpenAPI","description":"Contrato propio de este servicio; no contrato interno de Shalom.","tags":["DeveloperResources"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream"}},"/limits.json":{"get":{"operationId":"downloadLimits","summary":"Consultar políticas de límites","description":"Límites iniciales de Kova; no cuotas oficiales ni garantía contra bloqueos.","tags":["DeveloperResources"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream"}},"/llms.txt":{"get":{"operationId":"getAgentIndex","summary":"Leer índice para agentes","description":"Referencia pública sin credenciales ni datos de clientes.","tags":["DeveloperResources"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream"}},"/downloads/{artifact}":{"get":{"operationId":"downloadIntegration","summary":"Descargar MCP, skill o ejemplo","description":"Artefactos locales preparados; no implica publicación en npm.","tags":["DeveloperResources"],"security":[],"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/400"}},"x-implementation-status":"implemented","x-rate-policy":"cache_local_no_upstream","parameters":[{"name":"artifact","in":"path","required":true,"description":"Paquete o ejemplo permitido.","schema":{"type":"string","enum":["skill","mcp","quickstart"]}}]}},"/v1/sandbox/tick":{"post":{"operationId":"tickSandbox","summary":"Procesar una tarea del sandbox local","description":"Solo propietario, desarrollo local y entorno sandbox. Espera el trabajo antes de responder. No existe en producción y no llama al transportista.","tags":["Sandbox"],"security":[{"AdminSession":[]}],"x-owner-only":true,"x-required-scopes":[],"responses":{"200":{"description":"Contenido público local; no consulta a Shalom por solicitud.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"processed":{"type":"boolean"},"operation_id":{"type":"string","format":"uuid"},"environment":{"type":"string"}},"required":["processed"]},"meta":{"type":"object","additionalProperties":true}},"required":["data","meta"]}}}},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"500":{"$ref":"#/components/responses/500"}},"x-implementation-status":"implemented","x-rate-policy":"sandbox_tick","parameters":[{"$ref":"#/components/parameters/WorkspaceHeader"},{"$ref":"#/components/parameters/EnvironmentHeader"}]}},"/private-documents/{document_id}":{"get":{"operationId":"downloadPrivateDocument","summary":"Descargar un rótulo privado temporal","description":"Enlace generado por getShipmentDocument. Firma y vencimiento máximo de cinco minutos; valida vigencia del negocio y conexión. Sirve PDF cifrado en almacenamiento temporal. No devuelve cookies ni enlaces del proveedor. No construir esta URL manualmente ni registrarla en logs.","tags":["Documents"],"security":[{"DocumentToken":[]}],"x-required-scopes":[],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"until","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9]{13}$"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":43,"maxLength":43}}],"responses":{"200":{"description":"PDF privado con Cache-Control: private, no-store.","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"403":{"$ref":"#/components/responses/403"},"404":{"$ref":"#/components/responses/404"},"413":{"$ref":"#/components/responses/413"},"415":{"$ref":"#/components/responses/415"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}},"x-implementation-status":"experimental_live_pilot","x-rate-policy":"documents"}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Backend a backend. Determina negocio, entorno, scopes y conexiones. No usar en tienda pública."},"AdminSession":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT verificado del proyecto Supabase Auth del servicio. Roles se verifican en servidor; otro issuer no se acepta por defecto."},"DocumentToken":{"type":"apiKey","in":"query","name":"token","description":"Firma temporal generada por el servidor, vinculada al documento y a until. No es una API key ni token del transportista. Enlace privado; no registrar la query."}},"parameters":{"ConnectionId":{"name":"connection_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"AuthorizationId":{"name":"authorization_session_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"KeyId":{"name":"key_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"RecipientId":{"name":"recipient_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"ShipmentId":{"name":"shipment_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"OperationId":{"name":"operation_id","in":"path","required":true,"description":"ID de recurso del negocio autenticado; 404 si es ajeno.","schema":{"type":"string","format":"uuid"}},"ConnectionQuery":{"name":"connection_id","in":"query","required":true,"description":"Conexión propia habilitada.","schema":{"type":"string","format":"uuid"}},"OptionalConnectionQuery":{"name":"connection_id","in":"query","required":false,"description":"Conexión propia; si falta, manifiesto general de capacidades.","schema":{"type":"string","format":"uuid"}},"Cursor":{"name":"cursor","in":"query","required":false,"description":"Cursor opaco vinculado a negocio, filtros y orden.","schema":{"type":"string","minLength":1,"maxLength":512}},"Limit":{"name":"limit","in":"query","required":false,"description":"Tamaño de página.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Clave estable del intento. Mismo cuerpo devuelve acuse original; cuerpo diferente409. No cambiar para reintentar un timeout.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}},"OptionalIdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"description":"Deduplicación opcional local; misma clave con otro cuerpo409.","schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9_-]+$"}},"WorkspaceHeader":{"name":"X-Workspace-Id","in":"header","required":false,"description":"Obligatorio para sesión JWT; el servidor verifica membresía. Una API key ya determina el negocio.","schema":{"type":"string","format":"uuid"}},"EnvironmentHeader":{"name":"X-Environment","in":"header","required":false,"description":"Para administración JWT: sandbox por defecto o live. Una API key solo permite su propio entorno.","schema":{"type":"string","enum":["sandbox","live"]}}},"schemas":{"Meta":{"type":"object","properties":{"request_id":{"type":"string","minLength":1,"maxLength":128},"environment":{"type":"string","enum":["sandbox","live"]}},"required":["request_id"],"additionalProperties":true},"Page":{"type":"object","properties":{"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"],"maxLength":512}},"required":["has_more","next_cursor"],"additionalProperties":true},"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"maxLength":160},"status":{"type":"integer","minimum":400,"maximum":599},"code":{"type":"string","minLength":1,"maxLength":80},"detail":{"type":"string","minLength":1,"maxLength":500},"request_id":{"type":"string","minLength":1,"maxLength":128},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":160},"code":{"type":"string","minLength":1,"maxLength":80},"message":{"type":"string","minLength":1,"maxLength":240}},"required":["field","code","message"],"additionalProperties":false},"maxItems":30}},"required":["type","title","status","code","request_id"],"additionalProperties":true},"Health":{"type":"object","properties":{"status":{"type":"string","const":"ok"},"service":{"type":"string","const":"kova-shipping-api"}},"required":["status","service"],"additionalProperties":true},"Capability":{"type":"object","properties":{"name":{"type":"string","enum":["agency_catalog","packaging_catalog","quote","shipment_create","shipment_tracking","shipment_documents","interactive_authorization"]},"status":{"type":"string","enum":["pending_validation","available","temporarily_unavailable","unsupported"]},"reason_code":{"type":"string","minLength":1,"maxLength":80},"last_verified_at":{"type":"string","format":"date-time"}},"required":["name","status"],"additionalProperties":true},"Capabilities":{"type":"object","properties":{"provider":{"type":"string","const":"shalom"},"connection_id":{"type":"string","format":"uuid"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"},"maxItems":20}},"required":["provider","capabilities"],"additionalProperties":true},"PersonDocument":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"DNI"},"number":{"type":"string","pattern":"^[0-9]{8}$"}},"required":["type","number"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"CE"},"number":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[A-Za-z0-9]+$"}},"required":["type","number"],"additionalProperties":false}],"description":"Validación de formato; no acredita identidad, titularidad o aceptación de documento por el proveedor."},"CompanyDocument":{"type":"object","properties":{"type":{"type":"string","const":"RUC"},"number":{"type":"string","pattern":"^[0-9]{11}$"}},"required":["type","number"],"additionalProperties":false},"Document":{"oneOf":[{"$ref":"#/components/schemas/PersonDocument"},{"$ref":"#/components/schemas/CompanyDocument"}]},"Person":{"type":"object","properties":{"document":{"$ref":"#/components/schemas/PersonDocument"},"given_names":{"type":"string","minLength":1,"maxLength":120},"paternal_surname":{"type":"string","minLength":1,"maxLength":100},"maternal_surname":{"type":"string","minLength":1,"maxLength":100},"phone":{"type":"string","pattern":"^\\+[1-9][0-9]{7,14}$"}},"required":["document","given_names","paternal_surname","phone"],"additionalProperties":false},"RecipientData":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"person"},"person":{"$ref":"#/components/schemas/Person"}},"required":["kind","person"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"company"},"document":{"$ref":"#/components/schemas/CompanyDocument"},"legal_name":{"type":"string","minLength":1,"maxLength":180},"authorized_contact":{"$ref":"#/components/schemas/Person"}},"required":["kind","document","legal_name","authorized_contact"],"additionalProperties":false}],"description":"DNI/CE para personas y RUC para empresas con contacto DNI/CE; el servidor valida capacidades reales del proveedor."},"RecipientCreate":{"type":"object","properties":{"recipient":{"$ref":"#/components/schemas/RecipientData"},"external_reference":{"type":"string","minLength":1,"maxLength":100}},"required":["recipient"],"additionalProperties":false},"Recipient":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"recipient":{"$ref":"#/components/schemas/RecipientData"},"external_reference":{"type":"string","minLength":1,"maxLength":100},"created_at":{"type":"string","format":"date-time"}},"required":["id","recipient","created_at"],"additionalProperties":true},"RecipientSearch":{"type":"object","properties":{"document":{"$ref":"#/components/schemas/Document"}},"required":["document"],"additionalProperties":false},"ConnectionCreate":{"type":"object","properties":{"provider":{"type":"string","const":"shalom"},"label":{"type":"string","minLength":1,"maxLength":100},"environment":{"type":"string","enum":["sandbox","live"]}},"required":["provider","label","environment"],"additionalProperties":false},"ConnectionPatch":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100},"sender":{"$ref":"#/components/schemas/RecipientData"},"origin_agency_id":{"type":"string","format":"uuid"}},"required":[],"additionalProperties":false,"minProperties":1},"Connection":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"provider":{"type":"string","const":"shalom"},"label":{"type":"string","minLength":1,"maxLength":100},"environment":{"type":"string","enum":["sandbox","live"]},"status":{"type":"string","enum":["pending_authorization","connected","reauthorization_required","unavailable","disconnected"]},"sender_configured":{"type":"boolean"},"origin_agency_id":{"type":"string","format":"uuid"},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"},"maxItems":20},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"authorization":{"$ref":"#/components/schemas/AuthorizationSession","description":"?ltimo intento de conexi?n, disponible en el detalle live cuando existe."}},"required":["id","provider","label","environment","status","sender_configured","capabilities","created_at","updated_at"],"additionalProperties":true},"AuthorizationCreate":{"type":"object","properties":{"email":{"type":"string","format":"email","maxLength":254},"password":{"type":"string","minLength":1,"maxLength":256,"writeOnly":true},"callback_id":{"type":"string","minLength":1,"maxLength":80}},"required":["email","password"],"additionalProperties":false,"description":"Acceso normal a la cuenta Pro del propietario. Se cifra solo mientras el worker completa el login; no se devuelve ni conserva la contraseña tras procesarla. Requiere permiso connections:authorize. Una verificación de CAPTCHA/OTP no se resuelve automáticamente."},"AuthorizationSession":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"connection_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending","completed","expired","failed","queued","running","succeeded","awaiting_authorization"]},"expires_at":{"type":"string","format":"date-time"}},"required":["id","connection_id","status","expires_at"],"additionalProperties":true},"Scope":{"type":"string","enum":["connections:read","catalog:read","quotes:write","recipients:read","recipients:write","shipments:read","shipments:write","documents:read","operations:read","usage:read","connections:authorize","connections:configure"]},"ApiKeyCreate":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100},"environment":{"type":"string","enum":["sandbox","live"]},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"},"maxItems":20,"minItems":1,"uniqueItems":true},"connection_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":20,"minItems":1,"uniqueItems":true},"expires_at":{"type":"string","format":"date-time"}},"required":["label","environment","scopes","connection_ids"],"additionalProperties":false},"ApiKey":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"label":{"type":"string","minLength":1,"maxLength":100},"prefix":{"type":"string","minLength":1,"maxLength":24},"environment":{"type":"string","enum":["sandbox","live"]},"scopes":{"type":"array","items":{"$ref":"#/components/schemas/Scope"},"maxItems":20},"connection_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":20},"created_at":{"type":"string","format":"date-time"},"expires_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"}},"required":["id","label","prefix","environment","scopes","connection_ids","created_at"],"additionalProperties":true},"ApiKeyIssued":{"type":"object","properties":{"key":{"$ref":"#/components/schemas/ApiKey"},"secret":{"type":"string","minLength":1,"maxLength":256,"description":"Se muestra una vez; el servicio conserva solo hash. No enviar a URL, logs o frontend."}},"required":["key","secret"],"additionalProperties":true},"Agency":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"provider_agency_id":{"type":"string","minLength":1,"maxLength":80},"name":{"type":"string","minLength":1,"maxLength":160},"department_code":{"type":"string","minLength":1,"maxLength":20},"province_code":{"type":"string","minLength":1,"maxLength":20},"district_code":{"type":"string","minLength":1,"maxLength":20},"address":{"type":"string","minLength":1,"maxLength":300},"can_send":{"type":"boolean"},"can_receive":{"type":"boolean"},"is_active":{"type":"boolean"},"updated_at":{"type":"string","format":"date-time"},"latitude":{"type":["number","null"],"minimum":-90,"maximum":90},"longitude":{"type":["number","null"],"minimum":-180,"maximum":180},"department":{"type":"string"},"province":{"type":"string"},"district":{"type":"string"},"status_reported":{"type":"string"},"hours_reported":{"type":"string"}},"required":["id","provider_agency_id","name","department_code","province_code","district_code","can_send","can_receive","updated_at"],"additionalProperties":true},"PackageType":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","minLength":1,"maxLength":300},"dimensions_verified":{"type":"boolean"},"length_mm":{"type":"integer","minimum":1,"maximum":2147483647},"width_mm":{"type":"integer","minimum":1,"maximum":2147483647},"height_mm":{"type":"integer","minimum":1,"maximum":2147483647},"max_weight_g":{"type":"integer","minimum":1,"maximum":2147483647},"updated_at":{"type":"string","format":"date-time"}},"required":["id","name","dimensions_verified","updated_at"],"additionalProperties":true},"Package":{"type":"object","properties":{"packaging_type_id":{"type":"string","format":"uuid"},"quantity":{"type":"integer","minimum":1,"maximum":100},"weight_g":{"type":"integer","minimum":1,"maximum":2147483647},"length_mm":{"type":"integer","minimum":1,"maximum":2147483647},"width_mm":{"type":"integer","minimum":1,"maximum":2147483647},"height_mm":{"type":"integer","minimum":1,"maximum":2147483647}},"required":["quantity","weight_g","length_mm","width_mm","height_mm"],"additionalProperties":false,"description":"Valores por bulto; quantity es cantidad de bultos iguales. El maximo100 es límite técnico inicial del servicio, no límite confirmado de Shalom."},"QuoteCreate":{"type":"object","properties":{"connection_id":{"type":"string","format":"uuid"},"origin_agency_id":{"type":"string","format":"uuid"},"destination_agency_id":{"type":"string","format":"uuid"},"packages":{"type":"array","items":{"$ref":"#/components/schemas/Package"},"maxItems":20,"minItems":1}},"required":["connection_id","origin_agency_id","destination_agency_id","packages"],"additionalProperties":false},"Quote":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"connection_id":{"type":"string","format":"uuid"},"origin_agency_id":{"type":"string","format":"uuid"},"destination_agency_id":{"type":"string","format":"uuid"},"packages":{"type":"array","items":{"$ref":"#/components/schemas/Package"},"maxItems":20},"currency":{"type":"string","const":"PEN"},"estimated_freight_minor":{"type":"integer","minimum":0,"maximum":2147483647},"is_estimate":{"type":"boolean","const":true},"observed_at":{"type":"string","format":"date-time"},"valid_until":{"type":"string","format":"date-time"}},"required":["id","connection_id","origin_agency_id","destination_agency_id","packages","currency","estimated_freight_minor","is_estimate","observed_at","valid_until"],"additionalProperties":true},"SenderDocument":{"type":"object","properties":{"kind":{"type":"string","const":"remission_guide"},"series":{"type":"string","minLength":1,"maxLength":20},"number":{"type":"string","minLength":1,"maxLength":30}},"required":["kind","series","number"],"additionalProperties":false},"ShipmentCreate":{"type":"object","properties":{"connection_id":{"type":"string","format":"uuid"},"external_reference":{"type":"string","minLength":1,"maxLength":100,"description":"Única permanentemente por negocio+conexión. No incluir documentos personales."},"quote_id":{"type":"string","format":"uuid"},"recipient_id":{"type":"string","format":"uuid"},"additional_contact":{"$ref":"#/components/schemas/Person"},"content_description":{"type":"string","minLength":1,"maxLength":300},"delivery_method":{"type":"string","const":"agency_pickup"},"freight_payer":{"type":"string","const":"sender"},"sender_documents":{"type":"array","items":{"$ref":"#/components/schemas/SenderDocument"},"maxItems":10},"content_type":{"type":"string","enum":["documents","goods"],"description":"El piloto live actual admite únicamente documents en embalaje Sobre y un bulto. Otros registros siguen pendientes de validación."}},"required":["connection_id","external_reference","quote_id","recipient_id","content_description","delivery_method","freight_payer"],"additionalProperties":false,"description":"Servidor comprueba pertenencia y entorno de todos los recursos, vigencia de cotización, remitente y documentos requeridos según proveedor validado. Copia paquetes y agencias de cotización. No verifica el pago comercial del comprador."},"Shipment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"connection_id":{"type":"string","format":"uuid"},"external_reference":{"type":"string","minLength":1,"maxLength":100},"recipient_id":{"type":"string","format":"uuid"},"quote_id":{"type":"string","format":"uuid"},"processing_status":{"type":"string","enum":["queued","processing","awaiting_authorization","reconciliation_required","registered","failed"]},"transport_status":{"type":"string","enum":["unknown","at_origin","in_transit","out_for_delivery","ready_for_pickup","delivered","incident"]},"provider_reference":{"type":"string","minLength":1,"maxLength":120},"provider_series":{"type":"string","minLength":1,"maxLength":40},"operation_id":{"type":"string","format":"uuid"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"origin_agency_id":{"type":"string","format":"uuid","description":"Agency from the quote. Available on new shipments."},"destination_agency_id":{"type":"string","format":"uuid","description":"Agency from the quote. Available on new shipments."}},"required":["id","connection_id","external_reference","recipient_id","quote_id","processing_status","transport_status","operation_id","created_at","updated_at"],"additionalProperties":true,"description":"Referencias externas solo tras resultado verificable. No incluye DNI completo, clave de recojo ni código cuya exposición no esté autorizada."},"ShipmentAccepted":{"type":"object","properties":{"shipment_id":{"type":"string","format":"uuid"},"operation_id":{"type":"string","format":"uuid"},"processing_status":{"type":"string","const":"queued"}},"required":["shipment_id","operation_id","processing_status"],"additionalProperties":true},"OperationAccepted":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid"}},"required":["operation_id"],"additionalProperties":true},"ShipmentEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"shipment_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["unknown","at_origin","in_transit","out_for_delivery","ready_for_pickup","delivered","incident"]},"source":{"type":"string","enum":["provider","operator","sandbox"]},"occurred_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"description":{"type":"string","minLength":1,"maxLength":300}},"required":["id","shipment_id","status","source","observed_at"],"additionalProperties":true},"DocumentLink":{"type":"object","properties":{"shipment_id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["label","ticket"]},"url":{"type":"string","format":"uri","description":"URL privada firmada temporal; no registrar ni enviar a analítica."},"expires_at":{"type":"string","format":"date-time"}},"required":["shipment_id","kind","url","expires_at"],"additionalProperties":true},"Operation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["shipment_create","shipment_refresh"]},"status":{"type":"string","enum":["queued","running","awaiting_authorization","reconciliation_required","succeeded","failed"]},"resource_id":{"type":"string","format":"uuid"},"error_code":{"type":"string","minLength":1,"maxLength":80},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}},"required":["id","kind","status","resource_id","created_at","updated_at"],"additionalProperties":true},"Usage":{"type":"object","properties":{"period_start":{"type":"string","format":"date-time"},"period_end":{"type":"string","format":"date-time"},"requests_used":{"type":"integer","minimum":0,"maximum":2147483647},"requests_limit":{"type":["integer","null"],"minimum":0},"confirmed_shipments_used":{"type":"integer","minimum":0,"maximum":2147483647},"confirmed_shipments_limit":{"type":["integer","null"],"minimum":0}},"required":["period_start","period_end","requests_used","requests_limit","confirmed_shipments_used","confirmed_shipments_limit"],"additionalProperties":true},"HealthResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Health"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"CapabilitiesResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Capabilities"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"ConnectionResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Connection"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"AuthorizationSessionResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AuthorizationSession"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"ApiKeyIssuedResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiKeyIssued"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"QuoteResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Quote"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"RecipientResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Recipient"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"ShipmentResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Shipment"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"ShipmentAcceptedResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ShipmentAccepted"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"OperationAcceptedResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/OperationAccepted"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"OperationResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Operation"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"DocumentLinkResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DocumentLink"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"UsageResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Usage"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"],"additionalProperties":true},"ConnectionListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Connection"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"ApiKeyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiKey"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"AgencyListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Agency"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"PackageTypeListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/PackageType"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"RecipientListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Recipient"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"ShipmentListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Shipment"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"ShipmentEventListResponse":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ShipmentEvent"},"maxItems":100},"pagination":{"$ref":"#/components/schemas/Page"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","pagination","meta"],"additionalProperties":true},"PublicAgencyCatalog":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Agency"}},"pagination":{"type":"object","properties":{"offset":{"type":"integer"},"limit":{"type":"integer"},"has_more":{"type":"boolean"}}},"meta":{"type":"object","properties":{"source":{"type":"string","const":"public_snapshot"},"captured_at":{"type":"string","format":"date-time"},"source_url":{"type":"string","format":"uri"},"stale":{"type":"boolean"},"total":{"type":"integer"}},"required":["source","captured_at","source_url","stale","total"]}},"required":["data","pagination","meta"]},"AgencyGeoJSON":{"type":"object","properties":{"type":{"type":"string","const":"FeatureCollection"},"features":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"Feature"},"id":{"type":"string","format":"uuid"},"geometry":{"type":"object","properties":{"type":{"type":"string","const":"Point"},"coordinates":{"type":"array","items":{"type":"number"},"minItems":2,"maxItems":2}}},"properties":{"type":"object","additionalProperties":true}}}},"meta":{"type":"object","properties":{"source":{"type":"string","const":"public_snapshot"},"captured_at":{"type":"string","format":"date-time"},"source_url":{"type":"string","format":"uri"},"stale":{"type":"boolean"},"total":{"type":"integer"}},"required":["source","captured_at","source_url","stale","total"]}},"required":["type","features","meta"]}},"responses":{"400":{"description":"JSON o cabeceras inválidos.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Credencial ausente, inválida o revocada.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Acceso denegado por permisos, entorno o suscripción pendiente, suspendida o vencida (subscription_inactive). La revocación de claves por su propietario sigue disponible.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Recurso ausente o ajeno; no revela existencia.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Conflicto de estado, referencia, idempotencia o documento no disponible.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"413":{"description":"El cuerpo excede128KiB.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"415":{"description":"Content-Type incompatible. Usa application/json.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Datos de negocio incompatibles o incompletos.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Límite de solicitudes, concurrencia o cuota.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}},"Retry-After":{"description":"Segundos o fecha HTTP para nuevo intento permitido.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Error interno sin detalles del proveedor ni datos sensibles.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"Fallo de proveedor; no se filtra su respuesta cruda.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Capacidad pendiente de validar o proveedor no disponible.","headers":{"X-Request-Id":{"description":"ID técnico de soporte sin datos personales.","schema":{"type":"string","minLength":1,"maxLength":128}},"Cache-Control":{"description":"Respuestas privadas fuera de cachés compartidas.","schema":{"type":"string","const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}