Response Errors

Código dos erros e suas possíveis soluções

CreateProcess

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém a selfie da pessoa.
20004	O parâmetro subject não foi informado	Falta o parâmetro subject, que contém os dados da pessoa (cpf, nome).
20005	O parâmetro subject.code não foi informado	Falta o parâmetro subject.code, que contém o cpf da pessoa.
20507	O parâmetro subject.code é inválido	CPF fora do padrão ou inexistente.
20006	O parâmetro subject.name não foi informado	Falta o parâmetro subject.name, que contém o nome da pessoa.
20508	O parâmetro subject.gender é inválido	Gênero inválido. Os valores possíveis são: M, F ou vazio.
20019	O parâmetro birthdate é inválido.	A data de nascimento está formatada incorretamente. O formato correto é dd/mm/aaaa.
20048	Parâmetro birthdate não permitido. Idade mínima é de 15 anos.	Idade não permitida. A idade mínima permitida é de 15 anos.
20047	Parâmetro birthdate não permitido. Idade máxima é de 150 anos.	Idade não permitida. A idade máxima permitida é de 150 anos.
20811	O parâmetro webHookSecret não pode ser passado sem o parâmetro webHookUrl.	O parâmetro webHookSecret deve ser informado junto com o parâmetro webHookUrl.
60001	O usuário informado não possui uma loja associada a ele.	Entrar em contato com o suporte da biometria.
50002	Este cadastro foi enviado para a fila de análise biométrica e não pode ser modificado neste momento! Aguarde alguns instantes e tente novamente.	CPF na fila de processamento de biometria. É preciso aguardar.
40009	Este CPF possui uma requisição de envio para Score Suspeito em andamento!	Solicitado pelo cliente o envio desse CPF para lista de escore suspeito. É preciso aguardar.
20505	O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp	Base64 inválido. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20900	O base64 informado não é válido	O parâmetro base64 é inválido. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20807	A imagem precisa estar no padrão HD ou possuir uma resolução superior a 640 x 480.	A resolução da imagem enviada é muito pequena.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
500	Centralize o rosto na área de captura!	Rosto na imagem não identificado. Possíveis causas: qualidade da imagem, posicionamento, iluminação ambiente.
502	Aproxime o rosto da câmera!	O rosto da pessoa está muito longe da câmera.
503	Afaste o rosto da câmera!	O rosto da pessoa está muito perto da câmera.
504	Iluminação não satisfatória! Verifique se o ambiente não está muito escuro e se a câmera não está direcionada contra uma fonte de iluminação.	A iluminação da imagem é muito ruim. No entanto, um rosto foi encontrado. Possíveis causas: muito claro ou muito escuro.
505	Imagem embaçada ou fora de foco! Aproxime o rosto da câmera. Se ainda assim o foco estiver ruim, entre em contato com a equipe de suporte e solicite o ajuste da câmera.	Imagem borrada ou qualidade muito baixa.
507	Rosto inclinado! Mantenha o rosto reto e olhe para a câmera.	O rosto está inclinado. Tire a foto com o rosto em posição reta para a câmera.
508	Rosto de lado! Mantenha o rosto reto e olhe para a câmera.	O rosto está de lado. Tire a foto com o rosto em posição reta para a câmera.
511	Centralize o rosto na área de captura!	Não é possível identificar se é uma imagem ao vivo.
512	Parece que você está de óculos. Por favor, tire a foto SEM o óculos.	Óculos não são permitidos.
514	Imagem embaçada ou fora de foco!	Imagem embaçada.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no cabeçalho da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no cabeçalho da requisição.
10506	O bundle informado é inválido.	APIKEY usa um método de segurança e esta solicitação não atende aos requisitos de segurança (SDK).
20003	The request body is missing or invalid.	Payload nulo ou inválido.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
510	Falha interna!	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
20502	A URI de biometria não foi definida no banco de dados	Defina a URI de biometria no banco de dados e tente novamente!
20503	O token de biometria não foi definido no banco de dados	Defina o token de biometria no banco de dados e tente novamente!
20504	A URI do TF não foi definido no banco de dados	Defina a URI do tensor flow no banco de dados e tente novamente!
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentInsert

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém a selfie da pessoa.
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20010	O parâmetro documenttype não foi informado	Falta o parâmetro de tipo de documento.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no cabeçalho da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no cabeçalho da requisição.
50004	Não é possível executar o processo! O processo foi cancelado	Processo cancelado e não pode ser alterado.
20403	O base64 é inválido para o tipo de documento informado	A base64 é inválida para o tipo de documento fornecido.
50005	Não é possível executar o processo! Este processo já foi concluído	Processo concluído e não pode ser alterado.
50006	Não é possível executar um processo! Ele está com erro.	Erro de processo.
50009	Foto do cliente já existente.	A foto do cliente não pode ser adicionada mais de uma vez no mesmo processo.
50016	Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítida	Não foi possível realizar a tipificação do documento. Possíveis causas: documento inválido ou documento fora do padrão. Para obter mais detalhes sobre padronização, consulte a seção Padrão de Captura.
50019	Não conseguimos verificar a qualidade do documento. Verifique a iluminação e se a foto está bem nítida	Baixa qualidade da foto. Melhore a iluminação e o ângulo da foto. Para obter mais detalhes sobre padronização, consulte a seção Padrão de Captura.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ExecuteProcess

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
50003	Não é possível executar o processo! Informe um documento para prosseguir	Faltando alguma etapa de integração. Aguardando a selfie.
50004	Não é possível executar o processo! O processo foi cancelado	Processo cancelado e não pode ser alterado.
50005	Não é possível executar o processo! Este processo já foi concluído	Processo concluído e não pode ser alterado.
50006	Não é possível executar um processo! Ele está com erro.	Erro de processo.
50014	O processo informado não teve a foto capturada.	Faltando a foto no processo.
50016	Não conseguimos identificar o documento. Verifique a iluminação e se a foto está bem nítida	Baixa qualidade da foto. Melhorar a iluminação e o ângulo da foto.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetProcess

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetDocuments

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.
20403	O base64 é inválido para o tipo de documento informado	base64 inválido para o tipo de documento.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

CancelProcess

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.
50008	Este processo já está na fila de processamento ou foi concluído e não pode ser mais cancelado.	Processo concluído, não pode ser cancelado.
50020	Não é possível cancelar processos desse tipo.	Cancelamento negado. Apenas os processos de mensagens podem ser cancelados.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

CreateMessage

Response400

Código	Descrição	Explicação
20004	O parâmetro subject não foi informado	Falta o parâmetro subject, que contém os dados da pessoa (cpf, nome).
20005	O parâmetro subject.code não foi informado	Falta o parâmetro subject.code, que contém o cpf da pessoa.
20507	O parâmetro subject.code é inválido	CPF fora do padrão ou inexistente.
20006	O parâmetro subject.name não foi informado	Falta o parâmetro subject.name, que contém o nome da pessoa.
20508	O parâmetro subject.gender é inválido	Gênero inválido. Os valores possíveis são: M, F ou vazio.
20509	O parâmetro subject.name é inválido	Nome não é válido.
20019	O parâmetro birthdate é inválido.	A data de nascimento está formatada incorretamente. O formato correto é dd/mm/aaaa.
20048	Parâmetro birthdate não permitido. Idade mínima é de 15 anos.	Idade não permitida. A idade mínima permitida é de 150 anos.
20047	Parâmetro birthdate não permitido. Idade máxima é de 150 anos.	Idade não permitida. A idade máxima permitida é de 150 anos.
60001	O usuário informado não possui uma loja associada a ele.	Entrar em contato com o suporte da biometria.
20037	O template escolhido está inativo.	O template está inativo na instância.
20038	O template informado não existe	O template não existe.
20020	O parâmetro phone não foi informado	Faltando o parâmetro phone que contém o celular da pessoa.
20021	O parâmetro phone não está no formato correto. Deve ter o código do pais seguido do codigo de área e o telefone do cliente (EX: 0011333333333)	O número do celular está no formato errado. Siga o formato de exemplo: 0011333333333.
40006	Informe o e-mail do cliente.	Faltando e-mail do cliente. E-mail é um campo obrigatório.
40007	O e-mail do cliente é muito grande.	O e-mail informado é muito grande.
40008	O e-mail do cliente é inválido.	O e-mail informado é inválido.
50012	O valor do índice número do pedido é muito grande.	O número do pedido é muito grande. Máximo de 20 caracteres permitidos.
50013	O índice número do pedido é inválido.	O número do pedido possui caracteres inválidos.
20033	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Falta o parâmetro índice key.
20034	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Falta o parâmetro de índice value.
20035	Um dos índices não foi configurado da maneira correta. O parâmetro key não pode ser vazio	Falta o parâmetro de índice da página.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99998	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentMessageInsert

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém a selfie da pessoa.
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20010	O parâmetro documenttype não foi informado	Falta o parâmetro de tipo de documento.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20027	O parâmetro signature não foi informado	Falta o parâmetro de assinatura.
20028	O parâmetro signature.proposalResume não foi informado	Falta o parâmetro signature.proposalResume que contém o resumo da proposta.
20029	O parâmetro signature.signaturesPositions não foi informado	Falta o parâmetro signature.signaturesPositions que contém as posições de assinatura.
20030	O parâmetro signature.signaturesPositions[].X não foi informado	Falta o parâmetro signature.signaturesPositions[].X que contém as posições de assinatura.
20031	O parâmetro signature.signaturesPositions[].Y não foi informado	Falta o parâmetro signature.signaturesPositions[].Y que contém as posições de assinatura.
20032	O parâmetro signature.signaturesPositions[].Page não foi informado	Falta o parâmetro signature.signaturesPositions[].Page que contém as posições de assinatura.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.
50004	Não é possível executar o processo! O processo foi cancelado	Processo cancelado e não pode ser alterado.
50005	Não é possível executar o processo! Este processo já foi concluído	Processo concluído e não pode ser alterado.
50006	Não é possível executar um processo! Ele está com erro.	Erro de processo.
20041	A página informada para assinatura não existe no pdf.	Faltando a página para assinatura no PDF.
20042	O ponto X deve ser menor que '252' para que a assinatura caiba no documento.	Eixo inválido para assinatura.
20043	O ponto Y deve ser menor que '566' para que a assinatura caiba no documento.	Eixo inválido para assinatura.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ResumeMessageInsert

Response400

Código	Descrição	Explicação
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20023	O parâmetro processoId não foi informado	Falta o parâmetro id do processo.
20056	O parâmetro processoId é inválido	O id do processo é inválido.
20059	O parâmetro resumes não foi informado	Falta o parâmetro resumes.
20060	O parâmetro resumes é inválido	O resumo enviado é inválido.
50004	Não é possível executar o processo! O processo foi cancelado	Processo cancelado e não pode ser alterado.
50005	Não é possível executar o processo! Este processo já foi concluído	Processo concluído e não pode ser alterado.
50006	Não é possível executar um processo! Ele está com erro.	Erro de processo.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

ExecuteMessage

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.
50004	Não é possível executar o processo! O processo foi cancelado	Processo cancelado e não pode ser alterado.
50005	Não é possível executar o processo! Este processo já foi concluído	Processo concluído e não pode ser alterado.
20036	Um processo que contêm um passo de proposta deve ter no mínimo uma proposta anexada ao processo	Falta proposta. A proposta deve ser anexada ao processo.
20061	Um processo que contêm um passo de resumo deve ter no mínimo um resumo anexado ao processo	Falta resumo. O resumo deve ser anexado ao processo.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetMessage

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	O processo informado não foi encontrado	O processo não existe na base de dados.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetSentMessage

Response400

Código	Descrição	Explicação
20023	O parâmetro processId não foi informado	Falta o parâmetro id do processo.
20056	O parâmetro processId é inválido	O id do processo é inválido.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

GetSubject

Response400

Código	Descrição	Explicação
20507	O parâmetro subject.code é inválido	CPF fora do padrão ou inexistente.
20005	O parâmetro subject.code não foi informado	Falta o parâmetro subject.code, que contém o cpf da pessoa.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
40001	O subject informado não foi encontrado	A pessoa não existe na base de dados. Possíveis causas: pode ter sido removida por alguém ou por alguma divergência.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

OCRCode

Response400

Código	Descrição	Explicação
20507	O parâmetro subject.code é inválido	CPF fora do padrão ou inexistente.
20005	O parâmetro subject.code não foi informado	Falta o parâmetro subject.code, que contém o cpf da pessoa.
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém o documento.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

OCR

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém o documento.
20010	O parâmetro type não foi informado	Falta o parâmetro de tipo de documento.
99992	Tipo de documento inválido	O parâmetro type é inválido.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

DocumentConfirmation

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém o documento.
20010	O parâmetro type não foi informado	Falta o parâmetro de tipo de documento.
20506	O base64 informado é muito grande. O tamanho máximo suportado é até 800kb.	A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20505	O base64 informado não é suportado. Os formatos aceitos são png, jpeg e webp	Base64 inválida. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20900	O base64 informado não é válido	O parâmetro base64 é inválido. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

FaceMatch

Response400

Código	Descrição	Explicação
20009	O parâmetro imagebase64 não foi informado	Falta o parâmetro imagebase64, que contém o documento.
20002	O parâmetro APIKey não foi informado	Falta o parâmetro APIKEY no header da requisição.
20001	O parâmetro authtoken não foi informado	Falta o parâmetro do token de integração no header da requisição.

Response403

Código	Descrição	Explicação
30017	O usuário não tem permissão para executar está ação	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	O AppKey informado é inválido	O parâmetro APIKEY não foi informado ou não existe.
10501	O token informado é inválido	O token de autenticação é inválido.
10502	O token informado está expirado	O token de autenticação expirou.

Response429

Código	Descrição	Explicação
42900	O limite de requisições nos últimos 2 minutos foi excedido.	O limite de solicitações nos últimos 2 minutos foi excedido. Aguarde um momento e tente novamente! O limite de requisições depende da configuração do parâmetro rate limit. Caso não tenha rate limit configurado, o limite de requisições é de 150 requisições por minuto.

Response500

Código	Descrição	Explicação
10700	Falha Interna! Erro ao validar o token informado	Erro genérico de validação de token. Possíveis causas: Token expirado ou inválido.
99999	Falha Interna! Tente novamente em alguns minutos	Erro inesperado. Possíveis causas: Erro interno ou problema de parâmetro.

BiometryToken

Response400

Código	Descrição	Explicação
20009	The selfie parameter was not informed.	Falta o parâmetro imagebase64, que contém a selfie da pessoa.
20023	The processId parameter was not informed.	O id do processo não foi enviado por parâmetro.
20505	The selfie is not of a supported format. Accepted formats are png and jpeg.	A selfie enviada é inválida. Possíveis causas: não é uma imagem válida ou prefixo inválido.
20506	The selfie is too large. The maximum supported size is up to 800kb.	A imagem é muito grande. A imagem pode ser comprimida para JPEG92 sem perda de qualidade.
20900	The selfie is invalid.	A selfie enviada é inválida. Possíveis causas: Não é uma imagem ou é uma tentativa de injection.
20807	The image must be in the HD standard or have a resolution greater than 640x480.	A resolução da imagem é muito pequena.
20903	The processId has expired.	O processId fornecido expirou e não pode ser usado em novas chamadas. Use outro processId ou crie um novo processo. Esse erro ocorre quando um onboarding não foi finalizado, ou seja, processos com status = 4 (Cancelado).
500	The face must be centered in the capture area.	Rosto na imagem não identificado. Possíveis causas: qualidade da imagem, posicionamento, iluminação ambiente.
502	The face must be closer to the camera.	O rosto da pessoa está muito longe da câmera.
503	The face must be further away from the camera.	O rosto da pessoa está muito perto da câmera.
504	Bad lighting! Make sure the environment is not too dark and that the camera is not pointed against a light source.	A iluminação da imagem é muito ruim. No entanto, um rosto foi encontrado. Possíveis causas: muito claro ou muito escuro.
505	Image blurred or out of focus! The face must be brought closer to the camera. If the focus is still poor, contact the support team and ask for the camera to be adjusted.	Imagem embaçada ou a qualidade está muito baixa.
507	Tilted face! The face must be straight and looking at the camera.	O rosto está inclinado, deve estar com o rosto reto em comparação a câmera.
508	Side face! The face must be straight and looking at the camera.	O rosto está de lado. Tire a foto com o rosto em posição reta para a câmera.
511	The face must be centered in the capture area.	Não é possível identificar se é uma imagem ao vivo.
512	The selfie must be taken without glasses.	Óculos não são permitidos.
514	Image blurred or out of focus.	Imagem embaçada.
20002	The APIKEY parameter was not informed.	Falta o parâmetro APIKEY no cabeçalho da requisição.
20001	The authorization token was not informed.	Falta o parâmetro do token de integração no cabeçalho da requisição.
10506	The bundle is invalid.	O APIKEY utiliza um método de segurança via bundle, e essa requisição não atende aos requisitos de segurança (via SDK)

Response403

Código	Descrição	Explicação
30017	The user is not allowed to perform this action.	Sem permissão para utilizar este método, entrar em contato com a Unico.
10201	The APIKEY is invalid.	O parâmetro APIKEY não foi informado ou não existe.
10501	The authentication token is invalid.	O token de autenticação é inválido.
10502	The authentication token has expired.	O token de autenticação expirou.

Response404

Código	Descrição	Explicação
50001	The processId was not found.	O processo não foi encontrado na base de dados. Isso pode ter acontecido porque ele expirou, ou por ser um id de processo que realmente não existe. Este erro também pode ocorrer eventualmente caso a chamada do Token Biométrico tenha sido feita em um espaço muito curto de tempo após o processo ter sido criado.

Response500

Código	Descrição	Explicação
510	Internal failure!	Erro interno no processamento da biometria não esperado pela aplicação.
99999	Internal failure! Try again later.	Erro interno não esperado pela aplicação.

Dúvidas?

Não encontrou algo ou ainda precisa de ajuda? Se já é um cliente ou parceiro, pode entrar em contato através da Central de Ajuda.