Registro de Pessoas

Esta seção aborda as diferentes formas de integrar o cadastro de pessoas em seu site.

Visão Geral

A integração de registro de pessoas permite que você capture e armazene informações de clientes diretamente na base de dados da Niara, facilitando o gerenciamento de programas de fidelidade e o processo de reservas.

Métodos de Integração

Oferecemos duas abordagens para integração de acordo com suas necessidades:

1. Formulário de Registro (Básico)

Integração simplificada usando um formulário HTML padrão. Ideal para quem:

• Deseja uma implementação rápida e direta
• Não precisa de controle total sobre o fluxo de submissão
• Prefere utilizar a estrutura de formulário HTML tradicional

Ver documentação completa →

2. Registro sem Formulário (Avançado)

Integração programática onde você tem controle total sobre os dados e submissão. Ideal para quem:

• Precisa de maior flexibilidade no processo de cadastro
• Já possui um formulário customizado
• Deseja integrar o registro em fluxos mais complexos

Ver documentação completa →

Pré-requisitos

Para qualquer tipo de integração, você precisará receber da Niara os seguintes parâmetros:

• tenantId - Identificador do tenant
• clientId - Identificador do cliente
• storefrontId - Identificador da loja
• loyaltyProgramId - Identificador do programa de fidelidade

Contato

Entre em contato com a equipe Niara para obter suas credenciais de integração.

Campos Principais

Ambos os métodos utilizam os mesmos campos básicos para criação de pessoas:

Campo	Descrição	Obrigatório
firstName	Nome	Sim
lastName	Sobrenome	Sim
email	E-mail	Sim
nationality	Nacionalidade (ISO 3166)	Sim
cpf	Número de CPF	Sim, se Nacionalidade for BR
passport	Número de passaporte	Sim, se Nacionalidade não for BR
phone	Número de telefone	Não
dob	Data de nascimento	Não
loyaltyOptIn	Aceite de políticas	Não
acceptTerms	Aceite de termos e condições	Não

Validação Importante

É fundamental implementar validação para CPF e Passaporte baseada na nacionalidade:

• CPF: Obrigatório apenas quando nacionalidade = "BR"
• Passaporte: Obrigatório para todas as outras nacionalidades :::

Próximos Passos

Escolha o método de integração mais adequado para seu caso de uso:

1. Formulário de Registro de Pessoas - Comece aqui se você quer uma integração simples e rápida
2. Registro de Pessoas sem Formulário - Para integração avançada com controle total

Recursos Adicionais

Ambos os métodos suportam:

• ✅ Validação automática de dados
• ✅ Feedback de erros customizável
• ✅ Callbacks de sucesso e erro
• ✅ Integração com programa de fidelidade
• ✅ Suporte a múltiplas nacionalidades