Erros & Avisos

Erros mais comuns (Logins)

Abaixo, você encontrará uma tabela com erro comum de erro tentando conectar uma conta à plataforma (Uber, Rappi, IMSS, etc.).

Erro de código	Código HTTP	Descrição
`missing_api_key`	401	Atualmente, o cabeçalho X-Api-Key está ausente. Tente novamente incluir o cabeçalho X-Api-Key.
`invalid_api_key`	401	A chave da API é inválida. Tente novamente com uma chave de API válida.
`bad_request`	422	A solicitação não foi válida, possivelmente devido à falta de um parâmetro necessário. Revise sua solicitação e certifique-se de que todos os parâmetros estão corretos.
`invalid_credentials`	401	As credenciais de login fornecidas são inválidas. Por favor, peça ao usuário que tente novamente com credenciais válidas.
`platform_unavailable`	503	A plataforma está atualmente indisponível. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`too_many_requests`	429	Isto é mais comum com as plataformas IMSS e ISSSTE. Recomendamos que você tente fazer login com as credenciais do usuário no dia seguinte.
`service_unavailable`	503	O serviço está indisponível no momento. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`request_timeout`	504	O login falhou devido ao tempo limite. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`curp_has_inconsistencies`	403	Este erro está relacionado à plataforma IMSS. O CURP não é válido ou apresenta inconsistências. Por favor, peça ao usuário que se dirija ao estabelecimento do IMSS mais próximo para resolver o problema.
`platform_error`	422	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`invalid_otp`	401	A OTP fornecida é inválida. Por favor, peça ao usuário para tentar novamente com uma OTP válida.
`expired_otp`	401	O OTP fornecido expirou. Por favor, peça ao usuário para tentar novamente com uma OTP válida.
`email_not_validated`	400	O e-mail utilizado não é validado. Por favor, confirme seu e-mail no aplicativo para continuar. Depois de verificado, você pode tentar novamente.
`invalid_phone_number`	422	O número de telefone fornecido é inválido. Por favor, peça ao usuário para tentar novamente com um número de telefone válido.
`invalid_email`	422	O endereço de e-mail fornecido é inválido. Por favor, peça ao usuário para tentar novamente com um endereço de e-mail válido.
`lambda_error`	503	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`login_refused` (formerly login_not_available)	400	Este erro é mais comum no Uber. Ocorre quando o Uber bloqueia uma tentativa de login. Nesse caso, peça ao usuário para tentar fazer login novamente após 30 minutos.
`invalid_otp_auth_key`	401	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`curp_not_found`	404	O CURP não foi encontrado. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.
`could_not_send_otp`	401	Houve um erro ao enviar o código OTP. Por favor, peça ao usuário para tentar reenviar o código OTP novamente.
`unable_to_get_performance`	403	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`recent_login_successful`	412	A conta fez login com sucesso há menos de 12 horas.
`missing_social_security_number`	403	O usuário não possui um número de seguridade social no banco de dados do IMSS. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.
`social_security_number_mismatch`	503	Parece haver uma incompatibilidade entre o CURP do usuário e o número de seguridade social. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.
`curp_not_in_platform`	401	Verifique se o CURP está correto. Se o CURP estiver correto e você trabalha em um departamento ou entidade afiliada ao ISSSTE, vá à área de Recursos Humanos do seu local de trabalho para solicitar que verifiquem seu registro no sistema ISSSTE.
`nss_not_found_in_imss`	404	O NSS não foi encontrado no IMSS. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.
`invalid_nss`	401	Status do NSS inválido. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.
`invalid_otp_session`	401	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`renapo_unavailable`	400	O CURP não foi encontrado no Renapo. Houve um erro com a plataforma. Por favor, peça ao usuário para ir ao estabelecimento do IMSS mais próximo para resolver o problema.

Lista completa de erros

Código de Erro	Código HTTP	Descrição
`missing_api_key`	401	O cabeçalho x-api-key não está presente. Tente novamente usando o cabeçalho x-api-key.
`invalid_api_key`	401	A chave da API é inválida, tente novamente usando uma chave da API válida.
`bad_request`	422	A solicitação não é válida, muitas vezes porque um parâmetro necessário está faltando. Por favor, revise sua solicitação e garanta que todos os parâmetros estejam corretos
`invalid_credentials`	401	As credenciais de login fornecidas não são válidas. Por favor, peça ao usuário para tentar novamente com credenciais válidas
`invalid_otp`	401	O OTP fornecido não é válido. Por favor, peça ao usuário para tentar novamente com um OTP válido
`expired_otp`	401	O OTP fornecido expirou. Por favor, peça ao usuário para tentar novamente com um OTP válido
`email_not_validated`	400	O e-mail utilizado não é validado. Por favor, confirme seu e-mail no aplicativo para continuar. Depois de verificado, você pode tentar novamente.
`invalid_phone_number`	422	O número de telefone fornecido não é válido. Por favor, peça ao usuário para tentar novamente com um número de telefone válido
`invalid_email`	422	O número de telefone ou e-mail fornecido não é válido. Por favor, peça ao usuário para tentar novamente com um endereço de e-mail válido
`login_refused`	400	Este erro é comum com o Uber. Ele ocorre quando o Uber bloqueia uma tentativa de login. Neste caso, peça ao usuário para tentar fazer login novamente após 30 minutos
`curp_not_found`	404	O CURP não foi encontrado. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso.
`could_not_send_otp`	401	Houve um erro ao enviar o código OTP. Por favor, peça ao usuário para tentar reenviar o código OTP.
`unable_to_get_performance`	403	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`recent_login_successful`	412	A conta fez login com sucesso menos de 12 horas atrás.
`invalid_curp`	401	O CURP tem um formato inválido.
`not_available_in_platform`	401	O CURP não está registrado na plataforma.
`service_degradation`	400	Alguns serviços da plataforma estão degradados. No caso do IMSS, geralmente é o serviço de correio eletrônico
`proxy_max_retries_exeeded`	400	Atingimos o número máximo de tentativas na plataforma.
`curp_has_inconsistencies`	403	Este erro está relacionado à plataforma do IMSS. O CURP não é válido ou tem inconsistências. Por favor, peça ao usuário para ir à unidade do IMSS mais próxima para resolver isso
`platform_unavailable`	503	A plataforma não está disponível no momento. Por favor, tente novamente mais tarde ou entre em contato com o suporte
`too_many_requests`	429	Isso é mais comum com as plataformas do IMSS e ISSSTE. Recomendamos que você tente fazer login com as credenciais do usuário no dia seguinte
`service_unavailable`	503	O serviço não está disponível no momento. Por favor, tente novamente mais tarde ou entre em contato com o suporte
`request_timeout`	504	O login falhou devido a um tempo limite. Por favor, tente novamente mais tarde ou entre em contato com o suporte
`curp_has_inconsistencies`	403	Este erro está relacionado à plataforma do IMSS. O CURP não é válido ou tem inconsistências. Por favor, peça ao usuário para ir à unidade do IMSS mais próxima para resolver isso
`platform_error`	422	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte
`lambda_error`	503	Houve um erro com a plataforma. Por favor, tente novamente mais tarde ou entre em contato com o suporte.
`curp_not_found`	404	O CURP não foi encontrado. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso.
`missing_social_security_number`	403	O usuário não tem número de seguridade social no banco de dados do IMSS. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso
`social_security_number_mismatch`	503	Parece haver uma discrepância entre o CURP do usuário e seu número de seguridade social. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso
`curp_not_in_platform`	401	Verifique se o CURP está correto. Se o CURP estiver correto e você trabalha em um departamento ou entidade afiliada ao ISSSTE, vá à área de Recursos Humanos de seu local de trabalho para solicitar que verifiquem seu registro no sistema do ISSSTE
`nss_not_found_in_imss`	404	O NSS não foi encontrado no IMSS. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso
`invalid_nss`	401	Status de NSS inválido. Por favor, peça ao usuário para ir à sua unidade do IMSS mais próxima para resolver isso.
`renapo_unavailable`	400	O CURP não foi encontrado no Renapo. Há um erro com a plataforma. Por favor, peça ao usuário para ir ao escritório do IMSS mais próximo para resolver isso
`invalid_schema_response`	503	O IMSS alterou seu esquema de resposta.
`pending_for_data`	400	A extração de dados está pendente. Este erro pode permanecer permanente nos casos em que o portal do IMSS ou ISSSTE está degradado.
`zero_quoted_weeks`	200	O trabalhador não possui semanas de contribuição no IMSS.
`curp_not_in_platform`	401	O CURP não está registrado na plataforma.
`proxy_max_retries_exceeded`	400	Fizemos várias solicitações ao IMSS para o mesmo CURP e eles nos bloquearam.
`validation_time_expired`	422	O tempo de validação de um processo expirou
`invalid_otp_auth_key`	401	O código de autenticação OTP fornecido não é válido
`invalid_otp_session`	401	A sessão OTP não é válida
`not_registered`	401	O usuário não está registrado.
`timeout`	504	A operação excedeu o limite de tempo
`invalid_password`	401	A senha fornecida não é válida
`unable_to_get_uber_metrics`	403	Métricas do Uber não podem ser recuperadas
`reauthentication_required`	401	Re-autenticação é necessária
`failed_refresh`	401	O processo de atualização falhou
`account_setup_incomplete`	422	A configuração da conta está incompleta
`platform_unknown_error`	503	Ocorreu um erro desconhecido na plataforma.
`unauthorized_error`	401	Erro de acesso não autorizado.
`session_not_found`	401	Sessão não encontrada
`access_token_not_generated`	424	O token de acesso não foi gerado
`unknown_login_type`	422	Tipo de login desconhecido
`account_banned_from_platform`	422	A conta está banida da plataforma.
`business_error`	400	Erro relacionado à lógica de negócios.
`login_not_completed`	400	O processo de login não foi concluído
`connection_error`	400	Ocorreu um erro ao estabelecer uma conexão.
`curp_not_found_in_renapo`	404	CURP (Código Único de Registro de População) não encontrado no registro nacional.
`not_found_error`	404	Recurso ou informação não encontrada
`employment_info_not_found`	404	Recurso ou informação não encontrada
`cdt_first_access`	404	Recurso ou informação não encontrada
`no_emails_received`	400	A conta não recebeu nenhum e-mail
`pdf_not_received`	400	O documento PDF não foi recebido.
`confirmation_url_not_found`	400	URL de confirmação não encontrada
`forbidden_error`	403	A chave da API não tem permissão para fazer a solicitação
`login_in_process`	400	Login em progresso
`entity_not_found`	404	Não há login anterior para a conta.
`read_permissions_disabled`	401	A recuperação de informações está desativada para esta empresa.
`write_permissions_disabled`	401	A criação de conta está desativada para esta empresa.
`already_connected`	403	O usuário já está conectado
`account_not_in_gig_platform`	400	A conta não está em uma plataforma Gig
`schema_parse_error`	503	Erro ao analisar a resposta da plataforma
`failed_to_encrypt_data`	400	Falha ao criptografar os dados
`missing_login`	400	Login não fornecido
`inactive_user`	400	O usuário está inativo
`transaction_not_sent`	400	Transação não enviada
`max_transactions_exceeded`	400	Transações máximas excedidas
`operation_not_recognized`	400	Operação não reconhecida
`operation_not_sent`	400	Operação não enviada
`option_deactivated`	400	Opção desativada
`matricula_not_provided`	400	Matrícula não fornecida
`rfc_not_provided`	400	RFC não fornecido
`nomina_not_provided`	400	Folha de pagamento não fornecida
`clave_descuento_not_provided`	400	Código de desconto não fornecido
`employee_has_no_margin`	400	O funcionário não tem margem
`invalid_matricula_rfc_fondos`	400	Matrícula, RFC ou fundos inválidos
`invalid_rfc`	401	O formato do RFC não é válido
`unable_to_generate_insights_pdf`	503	O PDF de insights não pode ser gerado

Testando cenários de erro

Cenários de erro podem acontecer em diferentes partes do fluxo, eles podem acontecer:

Antes do login
Antes da validação
Após validação

Você seria capaz de reproduzir cada um dos erros listados abaixo solicitando a criação de conta ou pontos de extremidade de validação de conta.

Gere uma solicitação válida:

Você pode usar o seguinte comando cURL para criar uma solicitação para replicar cenários de erro Uber, DiDi, DiDi Food ou Noventa Nove

Antes da criação da conta

curl -x POST 'https://sandbox.palenca.com/v1/accounts' \
--header 'X-API-Key: your_valid_private_api_key' \
--header 'Content-Type: application/json' \
--data-raw '{
    "identifier": "login_refused@palenca.com",
    "platform": "uber",
    "country": "mx",
    "user_id": "you_previously_generated_user_id"
}'

# response
{
    "success": false,
    "error": {
        "code": "login_refused",
        "message": "Login refused",
        "errors": null
    },
    "data": null
}

Antes da validação da conta

curl -x POST 'https://sandbox.palenca.com/v1/accounts/your_previously_created_account_id/validate' \
--header 'X-API-Key: your_valid_private_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "password": "S3rvic3Un4v41l4bl3"
}'

# response
{
    "success": false,
    "error": {
        "code": "service_unavailable",
        "message": "Service is unavailable",
        "errors": null
    },
    "data": null
}

Após validação da conta

curl -x POST 'https://sandbox.palenca.com/v1/accounts/your_previously_created_account_id/validate' \
--header 'X-API-Key: your_valid_private_api_key' \
--header 'Content-Type: application/json' \
--data '{
    "otp_code": "9998"
}'

# response
{
    "success": false,
    "error": {
        "code": "unable_to_get_uber_metrics",
        "message": "Unable to get metrics from Uber",
        "errors": null
    },
    "data": null
}

Ao testar sua integração com as plataformas Uber e Didi, é essencial simular vários cenários, incluindo diferentes valores de identifier, otp_code ou password. Abaixo está uma tabela que ilustra como girar os parâmetros no comando cURL para cenários de erro comuns.

Uber Examples

Cenário de Erro	Parâmetro na solicitação	Quando é acionado
Login Refused	`login_refused@palenca.com`	Antes do Login
Invalid Credentials	`invalid_credentials@palenca.com`	Antes do Login
Platform Error	`platform_error@palenca.com`	Antes do Login
Service Unavailable	`login_refused@palenca.com`	Antes do Login
Invalid OTP Session	`9991`	Antes da Validação
Not Registered	`9992`	Antes da Validação
Invalid OTP	`9993`	Antes da Validação
Not Registered	`UberN0tR3gister3d0!` ( using `password` field)	Antes da Validação
Too Many Requests	`9994`	Antes da Validação
Too Many Requests	`T00M4ny0R3qu3st0!` ( using `password` field)	Antes da Validação
Service Unavailable	`9995`	Antes do Login
Request Timeout	`9996`	Antes da Validação
Invalid In Auth Session ID	`9997`	Antes da Validação
Invalid In Auth Session ID	`Inv4lid5e551on!` ( using `password` field)	Antes da Validaçãon
Invalid Password	`P455wr0n6` ( using `password` field)	Antes da Validaçãon
Unable to Get Uber Metrics	`9998`	Depois da Validação
Unable to Get Uber Metrics	`UberUnabletoGetMetrics0!` ( using `password` field)	Depois da Validação

Didi, DiDi Food and Noventa Nove Examples

Cenário de Erro	Parâmetro na solicitação	Quando é acionado
Invalid Email	`invalid_email@palenca.com`	Antes do Login
Invalid Phone	`8881`	Antes do Login
Expired OTP	`8882`	Antes da Validação
Invalid OTP	`8883`	Antes da Validação
Password Missing	`M11551n6` ( using `password` field)	Antes da Validação
Too Many Requests	`8884`	Antes da Validação
Platform Error	`8885`	Antes da Validação
Platform Error	`DiDiPl4tformErr0r!`( using `password` field)	Antes da Validação

Avisos comuns (Accounts)

Um aviso é acionado quando uma conexão com uma conta foi bem -sucedida, mas há o envio que impede que obtenha dados de emprego ou renda. Esses avisos podem ser vistos no console de palenciamento. Por exemplo:

A tabela a seguir mostra os avisos mais comuns.

Aviso	Plataformas	Descrição
`banned`	Gig economy	O trabalhador é banido da plataforma.
`not_registered`	Gig economy	O trabalhador não está registrado na plataforma.
`curp_not_in_platform`	IMSS and ISSSTE	O CURP não está registrado na plataforma.
`zero_quoted_weeks`	IMSS and ISSSTE	O trabalhador não tem semanas pagas no IMSS.
`rider_account`	Gig economy	O usuário não é registrado como motorista com Uber, Didi, Indriver, etc.

Erros & Avisos

Erros mais comuns (Logins)​

Lista completa de erros​

Testando cenários de erro​

Antes da criação da conta​

Antes da validação da conta​

Após validação da conta​

Uber Examples​

Didi, DiDi Food and Noventa Nove Examples​

Avisos comuns (Accounts)​