{"id":1158,"date":"2025-10-07T09:02:07","date_gmt":"2025-10-07T09:02:07","guid":{"rendered":"https:\/\/seshospedajes.es\/?page_id=1158"},"modified":"2025-10-07T09:07:09","modified_gmt":"2025-10-07T09:07:09","slug":"api-ses-hospedajes","status":"publish","type":"page","link":"https:\/\/seshospedajes.es\/en\/api-ses-hospedajes\/","title":{"rendered":"API"},"content":{"rendered":"
\n\n\n \n \n \n API SES.Hospedajes \u00b7 R\u00e1pida, segura y lista para producci\u00f3n<\/title>\n <meta name=\"description\" content=\"Conecta tu PMS, web o app con la API de SES.Hospedajes. Alta de viajeros, contratos, reservas y comunicaci\u00f3n al Ministerio del Interior. Sandbox, webhooks, versionado y seguridad de nivel empresarial.\">\n <link rel=\"canonical\" href=\"https:\/\/seshospedajes.es\/funciones\/api\/\">\n\n <!-- OPEN GRAPH -->\n <meta property=\"og:type\" content=\"website\">\n <meta property=\"og:title\" content=\"API SES.Hospedajes \u00b7 R\u00e1pida, segura y lista para producci\u00f3n\">\n <meta property=\"og:description\" content=\"SDKs, sandbox, webhooks y documentaci\u00f3n clara para integrar en d\u00edas, no semanas.\">\n <meta property=\"og:url\" content=\"https:\/\/seshospedajes.es\/funciones\/api\/\">\n <meta property=\"og:image\" content=\"https:\/\/seshospedajes.es\/wp-content\/uploads\/2025\/10\/og-ses-api.jpg\">\n <meta name=\"twitter:card\" content=\"summary_large_image\">\n\n <!-- CSS global SES Blocks -->\n <link rel=\"stylesheet\" href=\"\/assets\/css\/ses-blocks.css\">\n\n <!-- Schema.org (WebAPI) -->\n <script type=\"application\/ld+json\">{\n \"@context\": \"https:\\\/\\\/schema.org\",\n \"@type\": \"WebAPI\",\n \"name\": \"SES.Hospedajes API\",\n \"description\": \"API para alta de viajeros, contratos, reservas y comunicaci\\u00f3n oficial al Ministerio del Interior.\",\n \"documentation\": \"https:\\\/\\\/seshospedajes.es\\\/app\\\/api\\\/docs\\\/\",\n \"provider\": {\n \"@type\": \"Organization\",\n \"name\": \"SES.Hospedajes\",\n \"url\": \"https:\\\/\\\/seshospedajes.es\"\n },\n \"endpointUrl\": \"https:\\\/\\\/api.seshospedajes.es\\\/v1\\\/\",\n \"conformsTo\": \"HTTPS TLS 1.2+\",\n \"audience\": {\n \"@type\": \"Audience\",\n \"audienceType\": \"Developers \\\/ Integrators\"\n },\n \"softwareVersion\": \"v1\"\n}<\/script>\n\n <style>\n \/* Opcional: resalta bloques de c\u00f3digo si no tienes un highlighter global *\/\n pre.ses-code{background:#0b2531;color:#e6edf3;border-radius:12px;padding:16px;overflow:auto;font-family:ui-monospace,Consolas,monospace;font-size:13px;line-height:1.55;border:1px solid rgba(255,255,255,.08)}\n .ses-chip{display:inline-block;padding:.25rem .6rem;border-radius:999px;background:#e9eff3;color:#18435a;font-weight:700;font-size:.75rem;letter-spacing:.2px}\n <\/style>\n<\/head>\n\n<body style=\"background:#f9fbfd;font-family:'Inter',system-ui,sans-serif;\">\n\n <!-- ===================== HERO ===================== -->\n <section class=\"ses-hero ses-center\">\n <div class=\"ses-container\" style=\"max-width:980px;\">\n <span class=\"ses-badge\">Para desarrolladores \u00b7 Listo para producci\u00f3n<\/span>\n <h1 class=\"ses-hero-title\">API<\/h1>\n <p class=\"ses-hero-subtitle\">\n La forma m\u00e1s r\u00e1pida y segura de integrar <strong>viajeros, contratos, reservas<\/strong> y\n <strong>comunicaciones oficiales<\/strong>. Documentaci\u00f3n clara, sandbox, webhooks y versionado estable.\n <\/p>\n <div class=\"ses-btn-group\">\n <a href=\"https:\/\/seshospedajes.es\/en\/app\/api\/docs\/\" class=\"ses-btn ses-btn-gold\"><i class=\"fa fa-book\"><\/i> Ver documentaci\u00f3n<\/a>\n <a href=\"https:\/\/seshospedajes.es\/en\/#precios\" class=\"ses-btn ses-btn-blue\"><i class=\"fa fa-rocket\"><\/i> Planes<\/a>\n <\/div>\n <div style=\"margin-top:.75rem;\">\n <span class=\"ses-chip\">SDK JS<\/span>\n <span class=\"ses-chip\">SDK PHP<\/span>\n <span class=\"ses-chip\">SDK Python<\/span>\n <span class=\"ses-chip\">Sandbox<\/span>\n <span class=\"ses-chip\">Webhooks<\/span>\n <span class=\"ses-chip\">Idempotency<\/span>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== BENEFICIOS CLAVE (Feature band) ============== -->\n <section class=\"ses-band\">\n <div class=\"ses-container\">\n <div class=\"ses-center\" style=\"margin-bottom:1rem;\">\n <span class=\"ses-kicker\">Dise\u00f1ada para devs<\/span>\n <h2 class=\"ses-card-title\" style=\"font-size:1.9rem;\">Integra en d\u00edas, duerme tranquilo<\/h2>\n <\/div>\n\n <div class=\"ses-grid ses-grid-3\">\n <article class=\"ses-card-feature\">\n <div class=\"ses-card-head\">\n <span class=\"ses-ico-lg gold\"><i class=\"fa fa-plug\"><\/i><\/span>\n <h3 class=\"ses-card-title\">Endpoints intuitivos<\/h3>\n <\/div>\n <p class=\"ses-card-desc\">Recursos claros: hu\u00e9spedes, documentos, reservas, contratos y comunicaciones. JSON limpio y consistente.<\/p>\n <\/article>\n\n <article class=\"ses-card-feature\">\n <div class=\"ses-card-head\">\n <span class=\"ses-ico-lg\"><i class=\"fa fa-shield-alt\"><\/i><\/span>\n <h3 class=\"ses-card-title\">Seguridad real<\/h3>\n <\/div>\n <p class=\"ses-card-desc\">API keys con scopes, HTTPS obligatorio, control de IPs, rate limiting, auditor\u00eda y claves rotables.<\/p>\n <\/article>\n\n <article class=\"ses-card-feature\">\n <div class=\"ses-card-head\">\n <span class=\"ses-ico-lg green\"><i class=\"fa fa-code\"><\/i><\/span>\n <h3 class=\"ses-card-title\">SDKs & sandbox<\/h3>\n <\/div>\n <p class=\"ses-card-desc\">Ambiente de pruebas aislado, ejemplos end-to-end y webhooks para eventos: alta, lote enviado, acuse, error.<\/p>\n <\/article>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== DEMO R\u00c1PIDA (C\u00f3digo) ============== -->\n <section class=\"ses-section\">\n <div class=\"ses-container\">\n <div class=\"ses-grid ses-grid-2\">\n <div class=\"card-ses\">\n <h3 class=\"ses-card-title\">Crear viajero (ejemplo fetch)<\/h3>\n <pre class=\"ses-code\"><code>await fetch('https:\/\/api.seshospedajes.es\/v1\/guests', {\n method:'POST',\n headers:{\n 'Authorization':'Bearer <API_KEY>',\n 'Content-Type':'application\/json',\n 'Idempotency-Key':'a1b2c3-unique-123'\n },\n body:JSON.stringify({\n first_name:'Ana', last_name:'G\u00f3mez',\n document:{type:'DNI', number:'12345678A'},\n nationality:'ES', birth_date:'1992-03-12'\n })\n})<\/code><\/pre>\n <p class=\"ses-card-desc\" style=\"margin-top:.5rem;\">Respuesta 201 con <em>guest_id<\/em> y trazabilidad. Reintentable (idempotente).<\/p>\n <\/div>\n\n <div class=\"card-ses\">\n <h3 class=\"ses-card-title\">Comunicar lote al MIR<\/h3>\n <pre class=\"ses-code\"><code>POST \/v1\/mir\/batches\nAuthorization: Bearer <API_KEY>\n\n{\n \"type\":\"PV\", \/\/ PV, RH, AV, RV\n \"xml\":\"<base64_zip>\", \/\/ ZIP + base64\n \"callback_url\":\"https:\/\/tuservidor.com\/webhooks\/mir\"\n}<\/code><\/pre>\n <p class=\"ses-card-desc\" style=\"margin-top:.5rem;\">Recibir\u00e1s eventos: <em>batch.accepted<\/em>, <em>batch.processed<\/em>, <em>batch.failed<\/em> con c\u00f3digos explicativos.<\/p>\n <\/div>\n <\/div>\n\n <div class=\"ses-center\" style=\"margin-top:1rem;\">\n <a href=\"\/en\/developers\/\" class=\"ses-btn ses-btn-gold\"><i class=\"fa fa-book\"><\/i> Abrir documentaci\u00f3n<\/a>\n <a href=\"https:\/\/seshospedajes.es\/en\/#precios\" class=\"ses-btn ses-btn-blue\"><i class=\"fa fa-rocket\"><\/i> Planes<\/a>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== C\u00d3MO FUNCIONA (Steps Pro) ============== -->\n <section class=\"ses-steps-band\" id=\"como-funciona\">\n <div class=\"ses-container\">\n <div class=\"ses-center\" style=\"margin-bottom:1rem;\">\n <h2 class=\"ses-card-title\" style=\"font-size:1.7rem;\">C\u00f3mo integrar tu proyecto con la API<\/h2>\n <p class=\"ses-card-desc\">Tu stack, nuestra API. Nueva app o migraci\u00f3n progresiva: funciona igual de bien.<\/p>\n <\/div>\n\n <div class=\"ses-steps\">\n <article class=\"ses-step gold\">\n <div class=\"ses-step-num\">1<\/div>\n <h3 class=\"ses-step-title\">Obt\u00e9n API key<\/h3>\n <p class=\"ses-step-desc\">Desde tu panel: clave por entorno (sandbox\/producci\u00f3n), scopes y rotaci\u00f3n.<\/p>\n <\/article>\n\n <article class=\"ses-step\">\n <div class=\"ses-step-num\">2<\/div>\n <h3 class=\"ses-step-title\">Conecta endpoints<\/h3>\n <p class=\"ses-step-desc\">Guests, documents, reservations, contracts y MIR batches con JSON consistente.<\/p>\n <\/article>\n\n <article class=\"ses-step\">\n <div class=\"ses-step-num\">3<\/div>\n <h3 class=\"ses-step-title\">Gestiona eventos<\/h3>\n <p class=\"ses-step-desc\">Configura webhooks para altas, acuses, estados y errores corregibles.<\/p>\n <\/article>\n\n <article class=\"ses-step\">\n <div class=\"ses-step-num\">4<\/div>\n <h3 class=\"ses-step-title\">Pasa a producci\u00f3n<\/h3>\n <p class=\"ses-step-desc\">Versionado estable, l\u00edmites claros y soporte t\u00e9cnico para go-live.<\/p>\n <\/article>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== COMPATIBILIDAD Y SEGURIDAD ============== -->\n <section class=\"ses-band\">\n <div class=\"ses-container\">\n <div class=\"ses-grid ses-grid-2\">\n <div class=\"ses-card\">\n <h3 class=\"ses-card-title\">Compatibilidad<\/h3>\n <ul class=\"ses-list\">\n <li>REST JSON. SDKs para JS\/Node, PHP y Python.<\/li>\n <li>Idempotencia en POST\/PUT, <em>retry-after<\/em> y paginaci\u00f3n cursada.<\/li>\n <li>Internacionalizaci\u00f3n: ES\/EN en panel y payloads normalizados.<\/li>\n <\/ul>\n <\/div>\n <div class=\"ses-card\">\n <h3 class=\"ses-card-title\">Seguridad<\/h3>\n <ul class=\"ses-list\">\n <li>HTTPS obligatorio (TLS 1.2+), API keys con scopes y expiraci\u00f3n.<\/li>\n <li>Rate limits por cliente, bloqueo de IP y auditor\u00eda completa.<\/li>\n <li>Datos en la UE; logs y PII gestionados seg\u00fan RGPD.<\/li>\n <\/ul>\n <\/div>\n <\/div>\n\n <div class=\"ses-center\" style=\"margin-top:.75rem;\">\n <a href=\"\/en\/developers\/security\/\" class=\"ses-btn ses-btn-outline\"><i class=\"fa fa-shield-alt\"><\/i> Gu\u00eda de seguridad<\/a>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== CASOS DE USO ============== -->\n <section class=\"ses-section\">\n <div class=\"ses-container\">\n <div class=\"ses-grid ses-grid-3\">\n <div class=\"card-ses\">\n <h3 class=\"ses-card-title\">PMS \/ Channel Manager<\/h3>\n <p class=\"ses-card-desc\">Sincroniza hu\u00e9spedes y reservas, genera partes y comunica autom\u00e1ticamente al MIR.<\/p>\n <\/div>\n <div class=\"card-ses\">\n <h3 class=\"ses-card-title\">Web de check-in<\/h3>\n <p class=\"ses-card-desc\">Integra nuestro pre-check-in multi-idioma y recibe los datos limpios y validados.<\/p>\n <\/div>\n <div class=\"card-ses\">\n <h3 class=\"ses-card-title\">Rent a Car<\/h3>\n <p class=\"ses-card-desc\">Sube contratos, asocia conductores y dispara el lote MIR desde tu ERP.<\/p>\n <\/div>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== FAQ ============== -->\n <section class=\"ses-band\">\n <div class=\"ses-container\">\n <div class=\"ses-center\" style=\"margin-bottom:1rem;\">\n <span class=\"ses-kicker\">FAQ<\/span>\n <h2 class=\"ses-card-title\" style=\"font-size:1.6rem;\">Frequently asked questions<\/h2>\n <\/div>\n <div class=\"ses-grid ses-grid-3\">\n <div class=\"ses-card\">\n <h3 class=\"ses-card-title\">\u00bfD\u00f3nde est\u00e1 la documentaci\u00f3n?<\/h3>\n <p class=\"ses-card-desc\">En nuestro <a href=\"https:\/\/seshospedajes.es\/en\/app\/api\/docs\/\">Centro de Desarrolladores<\/a> tienes gu\u00edas, referencia y ejemplos.<\/p>\n <\/div>\n <div class=\"ses-card\">\n <h3 class=\"ses-card-title\">\u00bfHay entorno de pruebas?<\/h3>\n <p class=\"ses-card-desc\">S\u00ed. Sandbox aislado con datos ficticios, claves propias y webhooks de test.<\/p>\n <\/div>\n <div class=\"ses-card\">\n <h3 class=\"ses-card-title\">\u00bfC\u00f3mo se versiona?<\/h3>\n <p class=\"ses-card-desc\">Versi\u00f3n mayor estable (v1). Cambios incompatibles se anuncian con tiempo y rutas \/v2.<\/p>\n <\/div>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- ============== CTA FINAL ============== -->\n <section class=\"ses-hero ses-center\" style=\"padding:70px 0;\">\n <div class=\"ses-container\" style=\"max-width:800px;\">\n <h2 class=\"ses-hero-title\" style=\"font-size:2rem;\">Construye sobre una API que te cuida<\/h2>\n <p class=\"ses-hero-subtitle\">Integra r\u00e1pido, opera seguro y automatiza tus comunicaciones oficiales.<\/p>\n <div class=\"ses-btn-group\">\n <a href=\"https:\/\/seshospedajes.es\/en\/app\/api\/docs\/\" class=\"ses-btn ses-btn-gold\"><i class=\"fa fa-book\"><\/i> Empezar con la docs<\/a>\n <a href=\"https:\/\/seshospedajes.es\/en\/#precios\" class=\"ses-btn ses-btn-blue\"><i class=\"fa fa-list\"><\/i> Planes<\/a>\n <\/div>\n <\/div>\n <\/section>\n\n <!-- Iconos si no est\u00e1n ya globales -->\n <link rel=\"stylesheet\" href=\"https:\/\/cdnjs.cloudflare.com\/ajax\/libs\/font-awesome\/5.15.4\/css\/all.min.css\">\n<\/body>\n<\/html>\n<\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"100-width.php","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"class_list":["post-1158","page","type-page","status-publish","hentry"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/pages\/1158","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/comments?post=1158"}],"version-history":[{"count":3,"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/pages\/1158\/revisions"}],"predecessor-version":[{"id":1161,"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/pages\/1158\/revisions\/1161"}],"wp:attachment":[{"href":"https:\/\/seshospedajes.es\/en\/wp-json\/wp\/v2\/media?parent=1158"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}