# Validar o registo de viajantes antes de o enviar | aiGuest

> O aiGuest valida o registo de viajantes antes de o gerar: letra de controlo do DNI e do NIE, códigos ISO de país, prefixo telefónico, datas coerentes e menores com tutor.

- **Fonte (source):** https://aistohire.com/pt/aiguest-declaracao-viajantes-ses-hospedajes-178/f/validar-registo-de-viajantes-evitar-rejeicoes
- **Plataforma (platform):** AIstoHire
- **Idioma (language):** pt

## Em resumo

- Validador rigoroso anti-rejeição
- Antes de permitir gerar o relatório de registo de viajantes, o aiGuest revê o registo dado por dado: letra de controlo do DNI, códigos de país, prefixo telefónico, datas coerentes, menores com o seu adulto responsável. Se algo não bate certo, informa-te em linguagem clara.
- Diz-te o que corrigir, não "erro de validação"
- A letra do DNI e do NIE, calculada
- Nacionalidade e residência de lista fechada

## Validador rigoroso anti-rejeição

O validador do aiGuest é uma camada de regras centralizadas e versionadas junto aos catálogos oficiais, e executa-se sobre o conjunto completo antes de gerar seja o que for: a reserva, o alojamento turístico, o meio de pagamento e a ficha de cada viajante. Não é um "campo obrigatório" a vermelho: é uma lista de problemas concretos, cada um com o nome do viajante e o campo exacto ao qual tens de ir.

Verifica o que realmente faz com que um registo saia mal. Calcula a letra de controlo do DNI e do NIE a partir do número, em vez de a dar como boa. Aceita o passaporte com um formato flexível, mas avisa quando tem um aspecto pouco habitual. Exige que a nacionalidade e o país de residência saiam da lista fechada de códigos ISO do catálogo, nunca texto livre. Pede o telefone com prefixo internacional, ou um email válido, porque é necessário pelo menos um meio de contacto. Revê que as datas façam sentido entre si: nascimento que não esteja no futuro nem a mais de 120 anos, emissão do documento que não seja posterior a hoje, saída posterior à entrada. Obriga a que todo menor de idade tenha indicado com que adulto da viagem viaja e que relação de parentesco tem, e não permite registar um grupo formado apenas por menores. Conta os viajantes registados contra os declarados na reserva, assinala dois viajantes com o mesmo documento e avisa de caracteres estranhos nos nomes que depois podem não ser admitidos.

E distingue dois níveis, que é a diferença entre uma validação útil e uma pesada. O bloqueante impede gerar, e o botão indica-te com um número: "Corrige 3 dados para gerar". O que é apenas um aviso —um passaporte estranho, um carácter pouco comum, um viajante a mais— podes assumir com um "Sei, continua", e então fica registado no próprio relatório de registo de viajantes: fica constância de que o viste e decidiste prosseguir. A mesma validação volta a executar-se no servidor no momento de gerar, portanto não é um enfeite do ecrã: se houver bloqueantes, o relatório de registo de viajantes não é emitido. Um caso tem nuance própria: sem código de estabelecimento SES não se pode construir o XML, mas o PDF e a cópia do hóspede geram-se na mesma.

O validador faz parte do aiGuest, a mini app de registo de viajantes e relatório de registo de viajantes do SES.HOSPEDAJES da AIsToHire: https://aistohire.com/pt/aiguest-declaracao-viajantes-ses-hospedajes-178

## O que inclui

- **Diz-te o que corrigir, não "erro de validação"** — Cada problema chega com o nome do viajante, o campo concreto e uma frase em linguagem clara. Clicas e vais direto ao dado que falta, sem ter de rever fichas uma por uma.
- **A letra do DNI e do NIE, calculada** — O aiGuest deriva a letra de controlo a partir do número em vez de a aceitar tal e qual. Um dígito mal copiado do documento cai aí, no teu ecrã, e não na plataforma oficial.
- **Nacionalidade e residência de lista fechada** — Os países saem do catálogo com o seu código ISO, nunca de texto livre. Não há forma de enviar "Reino Unido" escrito de cinco maneiras diferentes em cinco partes diferentes.
- **Menores sempre com tutor e parentesco** — Nenhum menor passa sem indicar com que adulto da viagem vai e que relação tem com ele, como exige o RD 933/2021. E um grupo que só tenha menores não pode ser registado.
- **Conta os viajantes por si** — Compara os registados com os declarados na reserva e avisa se faltam, se sobram ou se duas fichas levam o mesmo número de documento. O clássico "éramos quatro e só há três" já não lhe escapa.
- **Dois níveis** — o que bloqueia e o que pode assumir: O grave impede gerar; o discutível despacha com um "Eu sei, continuar" e fica registado na parte de viajeiros. Não o trava por um acento estranho, mas também não o esquece.
- **Também valida no servidor, não só no ecrã** — Ao gerar, as regras voltam a aplicar-se no backend. Se houver algo bloqueante, a parte de viajeros simplesmente não é emitida, mesmo que alguém force o ecrã.
- **Sem código SES, o PDF sai na mesma** — Se faltar ao alojamento turístico o código de estabelecimento, o validador marca-o para o XML mas deixa-o gerar o PDF e a cópia do hóspede. Nunca fica sem documento.

## Perguntas frequentes

### Por que o meu traveller registration report é rejeitado?

Quase sempre por causa dos dados, não do envio: um número de documento com a DNI check letter errada, um país escrito à mão em vez do código oficial, um telefone sem prefixo internacional, um menor sem indicar com que adulto viaja, datas incoerentes ou menos viajantes registados do que os declarados na reserva. O validador da aiGuest verifica exatamente esse tipo de situações antes de permitir gerar o relatório, para que o erro apareça no seu ecrã e não mais tarde.

### A aiGuest verifica realmente se o DNI é válido?

Verifica a sua estrutura: calcula a DNI check letter do DNI e do NIE a partir do número e rejeita as combinações impossíveis, que é a falha mais habitual ao copiar um documento manualmente. Com o passaporte é mais permissivo — os formatos variam muito por país —, portanto aceita o número mas avisa se tem uma forma pouco habitual para que o reveja. O que não faz, e convém dizê-lo, é verificar se o documento existe ou é autêntico: isso nenhuma app pode fazer, apenas valida o dado.

### Posso gerar o relatório se o validador me avisar de algo?

Depende do nível. Se for bloqueante (falta um dado obrigatório, um NIF impossível, um menor sem responsável, um grupo sem nenhum adulto), não: o botão indica quantos dados corrigir e a geração está bloqueada, também no servidor. Se for um aviso (um passaporte com formato estranho, um caractere incomum num nome, um viajante a mais), sim: clica em "Estou ciente, continuar" e segue, e essa decisão fica registada no relatório.

### Como é que o aiGuest valida as crianças que vêm na reserva?

Os menores têm regras próprias. O aiGuest calcula a idade com a data de entrada e, se o viajante for menor, exige indicar qual dos adultos da viagem é o responsável e a relação de parentesco com ele, tal como pede o RD 933/2021. Admite "Sem documento" unicamente para menores —num adulto rejeita— e não permite registar um grupo formado apenas por menores.

### O validador garante que me aceitem o relatório?

Não, e preferimos dizê-lo claramente. O aiGuest reduz muito os erros de dados, que são a causa mais frequente de um registo mal preenchido, mas não envia o relatório por si: a comunicação ao SES.HOSPEDAJES continua a fazê-la através da plataforma oficial, e o XML do aiGuest é gerado num formato preliminar que o próprio ecrã identifica como tal. O validador deixa o registo completo e coerente; a aceitação final depende da plataforma.

- [aiGuest — Registo de viajantes e declaração SES.HOSPEDAJES para alojamento turístico](https://aistohire.com/pt/aiguest-declaracao-viajantes-ses-hospedajes-178)

## Sobre a plataforma

**aiGuest — Registo de viajantes e declaração SES.HOSPEDAJES para alojamento turístico** — uma aplicação de AIstoHire. Disponível em: https://aistohire.com/pt/aiguest-declaracao-viajantes-ses-hospedajes-178/f/validar-registo-de-viajantes-evitar-rejeicoes

### Outros idiomas

- `es`: https://aistohire.com/es/aiguest-parte-de-viajeros-ses-hospedajes-178/f/validar-parte-de-viajeros-evitar-rechazos
- `en`: https://aistohire.com/aiguest-guest-registration-report-ses-hospedajes-178/f/validate-traveller-registration-report-avoid-rejections
- `fr`: https://aistohire.com/fr/aiguest-declaration-voyageurs-ses-hospedajes-178/f/valider-rapport-enregistrement-voyageurs-eviter-rejets
- `it`: https://aistohire.com/it/aiguest-comunicazione-viaggiatori-ses-hospedajes-178/f/validare-registro-viaggiatori-evitare-rifiuti
- `de`: https://aistohire.com/de/aiguest-gaestemeldung-ses-hospedajes-178/f/gaestemeldeformular-validieren-ablehnungen-vermeiden
- `bg`: https://aistohire.com/bg/aiguest-spravka-za-patnitsite-i-registar-za-turisticheski-zhilishta-178/f/validirane-na-deklaratsiya-za-patnitsi-bez-otkazi
- `ja`: https://aistohire.com/ja/minpaku-shukuhakusha-toroku-spain-178/f/ryokosha-joho-hokokusho-kensho-sashimodoshi-boshi
- `nl`: https://aistohire.com/nl/aiguest-reizigersmelding-en-register-voor-toeristische-woningen-178/f/reizigersmelding-valideren-weigeringen-voorkomen
- `ko`: https://aistohire.com/ko/aiguest-yeohaengja-deungrok-ses-hospedajes-178/f/tusukgaek-myeongdan-geomjeung-banryeo-bangji
- `sv`: https://aistohire.com/sv/aiguest-gastrapport-och-registerbok-for-turistlagenheter-178/f/validera-resenarsrapport-undvik-avslag
- `da`: https://aistohire.com/da/aiguest-gaesteindberetning-og-registerbog-til-turistboliger-178/f/valider-rejsendeindberetning-undgaa-afvisninger
- `ar`: https://aistohire.com/ar/aiguest-blagh-almsafrin-wdftr-altsjil-llshqq-alsiahia-178/f/altahaqquq-min-balagh-almusafirin-tajannub-alrafd
- `no`: https://aistohire.com/no/aiguest-gjesterapport-og-registerbok-for-turistleiligheter-178/f/validere-reisenderapport-unnga-avvisning
- `fi`: https://aistohire.com/fi/aiguest-matkustajailmoitus-ja-rekisterikirja-matkailuasunnoille-178/f/matkustajailmoituksen-tarkistus-hylkaysten-valttaminen
- `zh`: https://aistohire.com/zh/aiguest-traveler-registration-ses-hospedajes-178/f/yanzheng-lvke-tongbaodan-bimian-tuijian
- `pl`: https://aistohire.com/pl/aiguest-raport-podroznych-i-ksiega-rejestrow-dla-apartamentow-178/f/walidacja-zgloszenia-podroznych-unikanie-odrzucen
- `he`: https://aistohire.com/he/aiguest-diooch-mtiilim-vspr-rishom-ldirot-nopsh-178/f/lehaamet-doch-metaylim-lemniat-dchiyot
- `cs`: https://aistohire.com/cs/aiguest-hlaseni-ubytovanych-a-evidencni-kniha-pro-turisticke-byty-178/f/overit-hlaseni-cestujicich-predejit-odmitnutim
- `id`: https://aistohire.com/id/aiguest-laporan-tamu-dan-buku-register-untuk-apartemen-wisata-178/f/validasi-laporan-tamu-hindari-penolakan
