BookCheckin
Guia regulatório · Última atualização: 21 de setembro de 2026

Acesso ao SES Hospedajes: que credencial é cada uma e onde encontrá-la

O SES Hospedajes não entrega uma credencial, mas várias, e a maioria dos problemas de acesso vem de usar uma onde era preciso outra. Este guia separa-as, diz onde vive cada uma dentro do portal do Ministério do Interior espanhol e que ecrã é preciso abrir para a ver.

Começar grátis

Em resumo

Ao concluir o registo, o Ministério do Interior entrega dois conjuntos de credenciais distintos: as de acesso à aplicação e as do serviço web, que é o procedimento automático pelo qual um programa envia as comunicações por si. Ao portal entra-se com certificado digital ou com Cl@ve, ou com o utilizador e a palavra-passe que lhe deram no registo; ao serviço web entra-se apenas com o utilizador e a palavra-passe do serviço web. Tem além disso dois códigos que não são credenciais: o «código de arrendador» (código do locador), que identifica o titular obrigado, e o «código de establecimiento» (código do estabelecimento), que identifica cada alojamento. Um erro 401 ao enviar quase sempre significa que se colocou a credencial do portal onde devia ir a do serviço web.

Quantas credenciais diferentes há no SES Hospedajes?

Dois conjuntos, e convém ter isso claro desde o princípio, porque quase todos os tropeções de acesso vêm daí. A sede eletrónica (o portal administrativo) do Ministério do Interior di-lo com todas as letras ao descrever o registo de estabelecimentos e entidades: uma vez concluído o registo, são fornecidas tanto as credenciais de acesso à aplicação como as que permitem o envio da comunicação através do procedimento automático mediante um serviço web.

As primeiras são as que usa você mesmo, com o navegador, para entrar, consultar ou enviar algo à mão. As segundas não as escreve uma pessoa: usa-as um programa para se autenticar perante o serviço de envio, e são as que se colam numa ferramenta como o BookCheckin. São diferentes, alteram-se em sítios diferentes e não são intercambiáveis.

Além das credenciais há dois códigos que não autenticam nada, mas sem os quais também não se pode apresentar um boletim de alojamento: o «código de arrendador» (código do locador), que identifica o titular obrigado e viaja no cabeçalho de cada comunicação, e o «código de establecimiento» (código do estabelecimento), que identifica o alojamento concreto. A tabela resume o que é cada coisa e de onde vem.

O que é cada credencial e cada código, e onde se obtém
O que éOnde se obtémQuem precisa dela
Certificado digital, cartão de identidade eletrónico (DNIe) ou Cl@veFora do SES Hospedajes: a FNMT, o seu próprio cartão de identidade eletrónico ou o registo prévio no Cl@veQuem faz o registo e quem entra no registo de entidades e estabelecimentos
Utilizador e palavra-passe de acesso à aplicaçãoFornecem-se ao concluir o registo. O utilizador é o número de documento («número de documento»)Quem consulta ou envia comunicações à mão a partir do navegador
Utilizador e palavra-passe do serviço webFornecem-se ao concluir o registo e gerem-se em «Servicio de comunicación» → «Credenciales»Qualquer programa que envie por si, o BookCheckin incluído
Código de arrendador (código do locador)«Mis datos» → «Datos de la empresa» → campo «Código»Vai no cabeçalho de cada comunicação que envia
Código de establecimiento (código do estabelecimento)«Mis datos» → «Lista de establecimientos» → ver o alojamento → campo «Código»Identifica o alojamento concreto em cada boletim de alojamento

Fontes: sede eletrónica do Ministério do Interior, informação de hospedajes; e Guía visual de la plataforma Hospedajes (guia visual da plataforma publicado pelo Ministério), v. 29.08.2025.

Fontes oficiais

Por onde se entra? Os três acessos da sede eletrónica

Na sede eletrónica, dentro do agrupamento «Hospedajes y alquiler de vehículos» (alojamentos e aluguer de veículos), não há um botão de acesso mas três, e cada um leva a um sítio diferente. Escolher o errado é a forma mais rápida de acabar num ecrã que não tem o que procurava.

O primeiro, «Acceso al registro de establecimientos y entidades», abre a zona de registo: é onde se registam a entidade e os estabelecimentos, onde se consultam os dois códigos e onde se gerem as credenciais do serviço web. Identifica-o com Cl@ve, que por sua vez oferece três métodos: Cl@ve Móvil, cartão de identidade eletrónico ou certificado eletrónico, e Cl@ve permanente.

Os outros dois levam à aplicação de consulta e envio de comunicações: um através do Cl@ve e outro sem certificado, que é o que pede o utilizador e a palavra-passe que lhe deram ao registar-se. Se o que precisa é ver os seus códigos ou as suas credenciais de serviço web, nenhum destes dois é o seu caminho: tem de entrar pelo primeiro.

Para o registo inicial é preciso, além disso, poder assinar: a sede indica que é preciso estar registado no Cl@ve Firma ou ter instalado o autofirm@ para usar certificados locais. Esse passo é prévio a tudo o resto e não se pode saltar.

Fontes oficiais

Onde vejo o código de arrendador e o código de establecimiento?

Os dois estão no mesmo ecrã, a dois cliques de distância, e é a pergunta que mais se repete. Entre por «Acceso al registro de establecimientos y entidades», identifique-se e verá o ecrã «Registro de entidades y establecimientos» com quatro blocos: Entidades, Establecimientos, Mis datos registrados e Servicio de comunicación.

Carregue em «Mis datos». Em cima, sob o título «Datos de la empresa», há um campo «Código»: esse é o seu código de arrendador. Nessa mesma secção está a caixa «Envío de comunicaciones por servicio web», que convém verificar já agora porque é uma das causas habituais de as credenciais do serviço web não funcionarem.

Desça nesse mesmo ecrã até «Lista de establecimientos». Cada linha é um alojamento e já mostra o seu código na primeira coluna; se abrir a ficha com a ação de ver, a janela «Ver establecimiento» repete o campo «Código» junto dos restantes dados do imóvel. Esse é o código de establecimiento do alojamento concreto.

Tenha em conta que são duas coisas distintas e que nenhuma das duas é o seu número de registo turístico autonómico. Os códigos do Ministério são curtos, de dez caracteres ou menos, com a forma 0000102467. Se o que tem à frente é um VT, um VFT ou um identificador longo da sua comunidade autónoma, esse pertence a outro registo e não serve aqui.

Recursos relacionados

Onde estão as credenciais do serviço web?

No mesmo ecrã de registo, no quarto bloco: «Servicio de comunicación», descrito como a gestão das suas credenciais de acesso ao serviço web, com o botão «Credenciales». Ao carregar, abre-se «Usuario servicio web», onde primeiro escolhe a entidade se tiver mais do que uma registada.

Por baixo, em «Datos del usuario», o Ministério mostra a informação do seu utilizador para o envio de comunicações por serviço web: o utilizador, o nome e a data de registo. Esta é a parte que surpreende muita gente e convém dizê-la com clareza: a palavra-passe não aparece. O ecrã não a mostra nem a lembra. A única coisa que pode fazer é carregar em «Cambiar contraseña» e definir uma nova.

A própria janela indica o requisito: a nova palavra-passe deve ter no mínimo oito caracteres, uma maiúscula, uma minúscula e um número. Se a alteração correr bem, o sistema responde com «¡Contraseña cambiada!». A partir desse momento a anterior deixa de valer, pelo que, se tinha a credencial colocada num programa, é preciso atualizá-la também aí, ou os envios começarão a falhar.

Nesse mesmo ecrã há uma secção de descarga da documentação do serviço, para o caso de quem vai integrar precisar da especificação técnica atualizada.

Fontes oficiais

Porque recebo o erro 401 se as credenciais parecem corretas?

Um 401 é uma rejeição de autenticação: o Ministério nem sequer chegou a ver os dados do hóspede. Três causas explicam praticamente todos os casos.

A primeira, e de longe a mais frequente, é ter colocado a credencial do portal onde devia ir a do serviço web. Distinguem-se à primeira vista: o utilizador com que entra na aplicação é o seu número de documento, enquanto o utilizador do serviço web é o que aparece em «Usuario servicio web» e, na prática, costuma terminar em «WS». Se escreveu um DNI ou um NIE no campo do utilizador de uma ferramenta de envio, esse é o problema.

A segunda é que a entidade não tenha ativado o envio por serviço web. É a caixa «Envío de comunicaciones por servicio web» de «Datos de la empresa» que mencionámos antes. Quando falta, a rejeição chega por falta de permissões, e um envio real acaba por devolver o erro 10119, «El arrendador no puede realizar ese tipo de comunicaciones» (o locador não pode realizar esse tipo de comunicações): não se resolve mexendo nos dados do hóspede, mas na configuração do locador.

A terceira é um erro de escrita ou um espaço a mais copiado ao colar. O BookCheckin corta os espaços ao guardar e outra vez antes de se autenticar, pelo que aqui é um problema menos frequente do que noutras ferramentas, mas continua a existir em qualquer sítio onde cole a credencial à mão.

Se a rejeição não é de autenticação mas de dados, o caminho é outro: o Ministério resolve os envios de forma assíncrona e devolve o resultado no estado do lote, com a sua própria mensagem de erro.

Recursos relacionados

O que lhe pede o BookCheckin e onde se cola cada coisa?

Quatro dados, todos seus e todos obtidos no portal do Ministério: o utilizador e a palavra-passe do serviço web, o código de establecimiento e o código de arrendador. Não pedimos o seu certificado digital nem o seu Cl@ve, e não os poderíamos usar mesmo que no-los desse: a comunicação com o Ministério autentica-se com utilizador e palavra-passe, não com certificado de cliente.

Convém dizer também o que não fazemos. O BookCheckin não o regista no SES Hospedajes nem gera os seus códigos: o registo é um trâmite seu perante o Ministério, e os códigos atribui-os ele. Nós só usamos o que ele já lhe deu.

Os quatro campos guardam-se na ficha do alojamento e as credenciais armazenam-se cifradas. Ao guardar, o BookCheckin corta os espaços a mais e rejeita um código com mais de dez caracteres em vez de o cortar, porque cortá-lo significaria apresentar boletins de alojamento contra um estabelecimento que não é o seu.

O botão «Probar conexión» faz uma consulta só de leitura ao Ministério e é um requisito antes de poder criar links de check-in. É preciso perceber bem o que prova e o que não prova: confirma que o utilizador e a palavra-passe autenticam, porque essa consulta não leva nenhum código. Não confirma o seu código de arrendador, que só se verifica quando sai o primeiro boletim de alojamento real.

Na Catalunha o fluxo é diferente e convém dizê-lo com clareza: o BookCheckin prepara o ficheiro de viajantes no formato oficial dos Mossos d’Esquadra e é você quem o carrega no portal; nunca enviamos nada nós próprios. Com a Ertzaintza, no País Basco, é igual: depois de guardar na propriedade o código de estabelecimento que a Ertzaintza lhe atribuiu, o BookCheckin prepara o ficheiro XML para o Registro Hostelero da Ertzaintza e é você quem o carrega no portal deles; também aí não enviamos nada nós próprios.

Recursos relacionados

Para continuar

Se o que procurava não era localizar uma credencial mas o trâmite completo, estes guias contam-no:

Recursos relacionados

Como encontrar os seus códigos e as suas credenciais de serviço web no SES Hospedajes

Os cinco ecrãs do portal do Ministério do Interior em que estão o código de arrendador, o código de establecimiento e o utilizador do serviço web.

  1. 1

    Abra o agrupamento de hospedajes na sede eletrónica

    Entre na sede eletrónica do Ministério do Interior e abra o agrupamento «Hospedajes y alquiler de vehículos». Verá três acessos distintos, todos com o mesmo código SIA.

  2. 2

    Escolha o acesso ao registo e identifique-se

    Carregue no acesso ao registo de estabelecimentos e entidades, não nos de consulta e envio. Identificar-se-á com Cl@ve, que oferece Cl@ve Móvil, cartão de identidade eletrónico ou certificado eletrónico, e Cl@ve permanente.

  3. 3

    Abra «Mis datos» e anote o código de arrendador

    No ecrã «Registro de entidades y establecimientos», carregue em «Mis datos». Sob «Datos de la empresa» está o campo «Código»: esse é o código de arrendador. Verifique já agora a caixa «Envío de comunicaciones por servicio web».

  4. 4

    Desça até «Lista de establecimientos» e anote o código de cada alojamento

    No mesmo ecrã, a lista de estabelecimentos mostra o código de cada alojamento na primeira coluna. Abrir a ficha com a ação de ver apresenta «Ver establecimiento» com o mesmo campo «Código».

  5. 5

    Volte ao início e abra «Credenciales»

    No bloco «Servicio de comunicación» carregue em «Credenciales». Em «Usuario servicio web» escolha a entidade e anote o utilizador. A palavra-passe não é mostrada: se não a tiver, carregue em «Cambiar contraseña» e defina uma nova com pelo menos oito caracteres, uma maiúscula, uma minúscula e um número.

Perguntas frequentes

Como se acede ao SES Hospedajes?+

Depende do que quer aceder. Ao registo de entidades e estabelecimentos acede-se com certificado digital ou com Cl@ve, a partir do acesso que a sede eletrónica chama «Acceso al registro de establecimientos y entidades». À aplicação de consulta e envio de comunicações acede-se de duas maneiras: com o certificado usado no registo, ou com o utilizador e a palavra-passe que o Ministério fornece ao concluir o registo.

Qual é o meu utilizador do SES Hospedajes?+

Há dois e não são o mesmo. O da aplicação é o seu número de documento: o ecrã de acesso pede «Número de documento» e «Contraseña», e a recuperação da palavra-passe pede esse mesmo número juntamente com o e-mail que usou ao registar-se. O do serviço web é outro, aparece no ecrã «Usuario servicio web» do portal e, na prática, costuma terminar em «WS».

Onde vejo o código de arrendador?+

Entre pelo acesso ao registo de estabelecimentos e entidades, identifique-se e carregue em «Mis datos». Na secção «Datos de la empresa» há um campo «Código»: esse é o código de arrendador (código do locador), o que identifica o titular obrigado e viaja no cabeçalho de cada comunicação. É um código curto do Ministério, de dez caracteres ou menos, não o seu número de registo turístico autonómico.

Onde vejo o código de establecimiento?+

No mesmo ecrã «Mis datos», mais abaixo, em «Lista de establecimientos». Cada alojamento aparece com o seu código na primeira coluna, e ao abrir a sua ficha a janela «Ver establecimiento» repete-o no campo «Código». Se gere vários alojamentos, cada um tem o seu.

Onde consigo as credenciais do serviço web?+

Fornecem-se ao concluir o registo, juntamente com as de acesso à aplicação, e gerem-se depois no portal: ecrã «Registro de entidades y establecimientos», bloco «Servicio de comunicación», botão «Credenciales». Aí, em «Usuario servicio web», escolhe a entidade e vê os dados do seu utilizador para o envio de comunicações por serviço web.

Posso ver a minha palavra-passe do serviço web?+

Não. O ecrã mostra o utilizador, o nome e a data de registo, mas não a palavra-passe, e não há forma de a recuperar. A única coisa que pode fazer é carregar em «Cambiar contraseña» e definir uma nova, que deve ter pelo menos oito caracteres, uma maiúscula, uma minúscula e um número. Ao alterá-la, a anterior deixa de funcionar: atualize-a também em qualquer programa que a estivesse a usar.

Porque recebo o erro 401 ao criar o boletim de alojamento?+

Porque o Ministério rejeitou a autenticação antes de ver qualquer dado do hóspede. As três causas habituais são: ter colocado a credencial de acesso ao portal onde devia ir a do serviço web, a entidade não ter marcada a caixa «Envío de comunicaciones por servicio web», ou um erro de escrita ou um espaço a mais ao colar. Comece pela primeira: se o utilizador que escreveu é um DNI ou um NIE, não é a credencial do serviço web.

Preciso de certificado digital ou basta o Cl@ve?+

A sede eletrónica admite as duas vias: para se registar exige-se certificado digital ou estar registado no Cl@ve, e para assinar o registo é preciso estar no Cl@ve Firma ou ter instalado o autofirm@ se usar certificados locais. Qual lhe convém, e o que fazer quando o certificado não deixa entrar, conta-o em detalhe o nosso guia sobre certificado digital e Cl@ve.

Podem criar-se mais utilizadores para o meu gestor ou a minha equipa?+

Sim. A plataforma tem um procedimento próprio de gestão de utilizadores, a que se acede com o certificado digital com que se registou ou com as credenciais de acesso à plataforma, e que permite registar utilizadores indicando os dados pessoais da pessoa a quem corresponde cada um. Independentemente disso, o Ministério admite que a comunicação dos dados seja feita por um terceiro desde que esteja autorizado pelo sujeito obrigado por alguma das formas admitidas em direito para agir em nome de outra pessoa.

Em que se diferencia este guia do de registo no SES Hospedajes?+

Este guia dá por assente que já está registado e responde a «onde está cada credencial e cada código». O guia de registo conta o trâmite desde o zero: o que precisa antes de começar, como se registam a entidade e cada estabelecimento e que ecrãs é preciso preencher. Se ainda não se registou, comece por esse.

Que credenciais preciso se o meu alojamento está na Catalunha ou no País Basco?+

Nenhuma destas. Essas duas comunidades não comunicam ao SES Hospedajes, mas ao registo dos Mossos d’Esquadra ou ao da Ertzaintza, que têm os seus próprios registos, formatos e credenciais. O código de arrendador, o código de establecimiento e o utilizador do serviço web são próprios do SES Hospedajes. O BookCheckin cobre o caso catalão preparando o ficheiro de viajantes no formato oficial para que o carregue você no portal dos Mossos; com a Ertzaintza é igual: o BookCheckin prepara o ficheiro XML para o Registro Hostelero da Ertzaintza e é você que o carrega no portal deles, com o seu próprio acesso.

Cole as suas credenciais uma vez

O BookCheckin recolhe os dados dos seus hóspedes e comunica o boletim de alojamento ao SES Hospedajes por si.

Começar grátis

Utilizamos cookies para melhorar a sua experiência e analisar o tráfego do site. Ao aceitar, consente a nossa utilização de cookies.