Errores & Warnings

Errores más comunes (Logins)

A continuación encontrarás una tabla con los errores comunes al momento de intentar conectar una cuenta a una plataforma (Uber, Rappi, IMSS, etc.).

Código de Error	Código HTTP	Descripción
`missing_api_key`	401	El header x-api-key no esta presente. Intenta de nuevo usando el header the x-api-key.
`invalid_api_key`	401	La api key es invalida, intenta de nuevo usando una api key valida.
`bad_request`	422	La solicitud no era válida, a menudo debido a que faltaba un parámetro requerido. Por favor, revise su solicitud y asegúrese de que todos los parámetros sean correctos.
`invalid_credentials`	401	Las credenciales de inicio de sesión proporcionadas no son válidas. Por favor, solicite al usuario que vuelva a intentarlo con credenciales válidas.
`platform_unavailable`	503	La plataforma no está disponible actualmente. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`too_many_requests`	429	Esto es más común con las plataformas IMSS e ISSSTE. Le recomendamos que intente iniciar sesión con las credenciales del usuario al día siguiente.
`service_unavailable`	503	El servicio no está disponible actualmente. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`request_timeout`	504	El inicio de sesión falló debido a un tiempo de espera. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`curp_has_inconsistencies`	403	Este error está relacionado con la plataforma IMSS. La CURP no es válida o tiene inconsistencias. Por favor, solicite al usuario que acuda al establecimiento del IMSS más cercano para resolverlo.
`platform_error`	422	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`invalid_otp`	401	El OTP proporcionado no es válida. Por favor, solicite al usuario que vuelva a intentarlo con una OTP válida
`expired_otp`	401	El OTP proporcionado ha caducado. Por favor, solicite al usuario que vuelva a intentarlo con una OTP válida
`email_not_validated`	400	El correo electrónico utilizado no está validado. Por favor, verifica tu correo electrónico en la aplicación para continuar. Una vez verificado, puedes intentarlo de nuevo
`invalid_phone_number`	422	El número de teléfono proporcionado no es válido. Por favor, solicite al usuario que vuelva a intentarlo con un teléfono válido.
`invalid_email`	422	El número de teléfono proporcionado no es válido. Por favor, solicite al usuario que vuelva a intentarlo con una dirección de correo electrónico.
`lambda_error`	503	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte.
`login_refused` (formerly login_not_available)	400	Este error es más común en Uber. Ocurre cuando Uber bloquea un intento de inicio de sesión. En este caso, solicite al usuario que intente iniciar sesión nuevamente después de 30 minutos.
`invalid_otp_auth_key`	401	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte.
`curp_not_found`	404	No se encontró la CURP. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`could_not_send_otp`	401	Hubo un error al enviar el código OTP. Por favor, solicite al usuario que intente reenviar el código OTP nuevamente.
`unable_to_get_performance`	403	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte.
`recent_login_successful`	412	La cuenta inició sesión correctamente hace menos de 12 horas.
`missing_social_security_number`	403	El usuario no cuenta con un número de seguro social en la base de datos del IMSS. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`social_security_number_mismatch`	503	Parece haber una discrepancia entre la CURP del usuario y su número de seguro social. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`curp_not_in_platform`	401	Verificar que la CURP sea correcta. Si la CURP es correcta y trabajas en algún departamento o entidad afiliada al ISSSTE, acude al área de Recursos Humanos de tu lugar de trabajo para solicitar que verifiquen tu registro en el sistema del ISSSTE.
`nss_not_found_in_imss`	404	El NSS no fue encontrado en el IMSS. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`invalid_nss`	401	Estado NSS no válido. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`invalid_otp_session`	401	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte..
`renapo_unavailable`	400	No se encontró la CURP en Renapo. un error con la plataforma. Por favor, pide al usuario que vaya a la oficina del IMSS más cercana para resolverlo.

Lista completa de errores

Código de Error	Código HTTP	Descripción
`missing_api_key`	401	El header x-api-key no esta presente. Intenta de nuevo usando el header the x-api-key.
`invalid_api_key`	401	La api key es invalida, intenta de nuevo usando una api key valida.
`bad_request`	422	La solicitud no era válida, a menudo debido a que faltaba un parámetro requerido. Por favor, revise su solicitud y asegúrese de que
`invalid_credentials`	401	Las credenciales de inicio de sesión proporcionadas no son válidas. Por favor, solicite al usuario que vuelva a intentarlo con
`invalid_otp`	401	El OTP proporcionado no es válida. Por favor, solicite al usuario que vuelva a intentarlo con una OTP válida
`expired_otp`	401	El OTP proporcionado ha caducado. Por favor, solicite al usuario que vuelva a intentarlo con una OTP válida
`email_not_validated`	400	El correo electrónico utilizado no está validado. Por favor, verifica tu correo electrónico en la aplicación para continuar. Una vez verificado, puedes intentarlo de nuevo
`invalid_phone_number`	422	El número de teléfono proporcionado no es válido. Por favor, solicite al usuario que vuelva a intentarlo con un teléfono
`invalid_email`	422	El número de teléfono proporcionado no es válido. Por favor, solicite al usuario que vuelva a intentarlo con una dirección de correo
`login_refused`	400	Este error es más común en Uber. Ocurre cuando Uber bloquea un intento de inicio de sesión. En este caso, solicite al usuario que
`curp_not_found`	404	No se encontró la CURP. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`could_not_send_otp`	401	Hubo un error al enviar el código OTP. Por favor, solicite al usuario que intente reenviar el código OTP nuevamente.
`unable_to_get_performance`	403	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte.
`recent_login_successful`	412	La cuenta inició sesión correctamente hace menos de 12 horas.
`invalid_curp`	401	El CURP presenta un formato inválido.
`not_available_in_platform`	401	El CURP no se encuentra registrado en la plataforma.
`service_degradation`	400	Alguno de los servicios de la plataforma esta degradad. En el caso del IMSS, usualmente es su servicio de envío de correos
`proxy_max_retries_exeeded`	400	Hemos alcanzado la mayor cantidad de reintentos que se puede hacer a la plataform.
`curp_has_inconsistencies`	403	Este error está relacionado con la plataforma IMSS. La CURP no es válida o tiene inconsistencias. Por favor, solicite al
`platform_unavailable`	503	La plataforma no está disponible actualmente. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`too_many_requests`	429	Esto es más común con las plataformas IMSS e ISSSTE. Le recomendamos que intente iniciar sesión con las credenciales del
`service_unavailable`	503	El servicio no está disponible actualmente. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`request_timeout`	504	El inicio de sesión falló debido a un tiempo de espera. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`curp_has_inconsistencies`	403	Este error está relacionado con la plataforma IMSS. La CURP no es válida o tiene inconsistencias. Por favor, solicite
`platform_error`	422	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte
`lambda_error`	503	Hubo un error con la plataforma. Por favor, inténtelo de nuevo más tarde o comuníquese con el soporte.
`curp_not_found`	404	No se encontró la CURP. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`missing_social_security_number`	403	El usuario no cuenta con un número de seguro social en la base de datos del IMSS. Por favor, solicite al
`social_security_number_mismatch`	503	Parece haber una discrepancia entre la CURP del usuario y su número de seguro social. Por favor, solicite al
`curp_not_in_platform`	401	Verificar que la CURP sea correcta. Si la CURP es correcta y trabajas en algún departamento o entidad afiliada al ISSSTE,
`nss_not_found_in_imss`	404	El NSS no fue encontrado en el IMSS. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para
`invalid_nss`	401	Estado NSS no válido. Por favor, solicite al usuario que acuda a su establecimiento IMSS más cercano para resolverlo.
`renapo_unavailable`	400	No se encontró la CURP en Renapo. un error con la plataforma. Por favor, pide al usuario que vaya a la oficina del IMSS más
`invalid_schema_response`	503	El IMSS cambió su esquema de respuesta.
`pending_for_data`	400	La extracción de data esta pendiente. Este error puede quedarse permanentemente en casos en el cual el portal del IMSS o el ISSSTE
`zero_quoted_weeks`	200	El trabajador no cuenta con semanas cotizadas en el IMSS.
`curp_not_in_platform`	401	El CURP no se encuentra registrado en la plataforma.
`proxy_max_retries_exceeded`	400	Hemos hecho varias peticiones al IMSS para el mismo CURP y este nos ha bloqueado.
`validation_time_expired`	422	El tiempo de validación de un proceso ha expirado
`invalid_otp_auth_key`	401	La clave de autenticación OTP proporcionada no es válida
`invalid_otp_session`	401	La sesión OTP no es válida
`not_registered`	401	El usuario no está registrado.
`timeout`	504	La operación ha agotado el tiempo
`invalid_password`	401	La contraseña proporcionada no es válida
`unable_to_get_uber_metrics`	403	No se pueden recuperar las métricas de Uber
`reauthentication_required`	401	Se requiere reautenticación
`failed_refresh`	401	El proceso de actualización ha fallado
`account_setup_incomplete`	422	La configuración de la cuenta está incompleta
`platform_unknown_error`	503	Se produjo un error desconocido en la plataforma.
`unauthorized_error`	401	Error de acceso no autorizado.
`session_not_found`	401	Sesión no encontrada
`access_token_not_generated`	424	El token de acceso no se ha generado
`unknown_login_type`	422	Tipo de inicio de sesión desconocido
`account_banned_from_platform`	422	La cuenta está baneada de la plataforma.
`business_error`	400	Error relacionado con la lógica empresarial.
`login_not_completed`	400	El proceso de inicio de sesión no se ha completado
`connection_error`	400	Se produjo un error al establecer una conexión.
`curp_not_found_in_renapo`	404	CURP (Código Único de Registro de Población) no se encuentra en el registro nacional.
`not_found_error`	404	Recurso o información no encontrada
`employment_info_not_found`	404	Recurso o información no encontrada
`cdt_first_access`	404	Recurso o información no encontrada
`no_emails_received`	400	la cuenta no ha recibido ningún correo electrónico
`pdf_not_received`	400	El documento PDF no ha sido recibido.
`confirmation_url_not_found`	400	URL de confirmación no encontrada
`forbidden_error`	403	La clave API no tiene permiso para realizar la solicitud
`login_in_process`	400	Iniciar sesión en proceso
`entity_not_found`	404	No hay inicio de sesión previo para la cuenta.
`read_permissions_disabled`	401	La recuperación de información está deshabilitada para esta empresa.
`write_permissions_disabled`	401	La creación de cuenta está deshabilitada para esta empresa.
`already_connected`	403	El usuario ya está conectado
`account_not_in_gig_platform`	400	Cuenta no en una plataforma Gig
`schema_parse_error`	503	Error al analizar la respuesta de la plataforma
`failed_to_encrypt_data`	400	Error al descifrar datos
`missing_login`	400	Inicio de sesión no proporcionado
`inactive_user`	400	El usuario está inactivo
`transaction_not_sent`	400	Transacción no enviada
`max_transactions_exceeded`	400	Transacciones máximas excedidas
`operation_not_recognized`	400	Operación no reconocida
`operation_not_sent`	400	Operación no enviada
`option_deactivated`	400	Opción desactivada
`matricula_not_provided`	400	Matrícula no proporcionada
`rfc_not_provided`	400	RFC no proporcionado
`nomina_not_provided`	400	Nomina no proporcionada
`clave_descuento_not_provided`	400	Clave de descuento no proporcionada
`employee_has_no_margin`	400	El empleado no tiene margen
`invalid_matricula_rfc_fondos`	400	Matrícula, RFC o fondos no válidos
`invalid_rfc`	401	El formato RFC no es válido
`unable_to_generate_insights_pdf`	503	No se pueden generar insights pdf

Prueba de escenarios de error

Los escenarios de error podrían ocurrir en diferentes partes del flujo, podrían ocurrir:

Before Login
Before Validation
After Validation

Podrá reproducir cada uno de los errores enumerados a continuación solicitando puntos finales de creación o validación de cuenta.

Generar una peticion valida:

Puede utilizar el siguiente comando cURL para crear una solicitud para replicar escenarios de error Uber, DiDi, DiDi Food o Noventa Nove,

Antes de la creacion de una cuenta

cURL

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 de la validacion de una cuenta

cURL

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
}

Despues de la creacion de una cuenta

cURL

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
}

Al probar su integración con las plataformas Uber y Didi, es esencial simular varios escenarios, incluidos los diferentes valores de Identifier, OTP_Code o Password. A continuación se muestra una tabla que ilustra cómo rotar los parámetros en el comando curl para escenarios de error comunes.

Uber Examples

Error Scenario	Parameter in request	When is triggered
Login Refused	`login_refused@palenca.com`	Before Login
Invalid Credentials	`invalid_credentials@palenca.com`	Before Login
Platform Error	`platform_error@palenca.com`	Before Login
Service Unavailable	`login_refused@palenca.com`	Before Login
Invalid OTP Session	`9991`	Before Validation
Not Registered	`9992`	Before Validation
Invalid OTP	`9993`	Before Validation
Not Registered	`UberN0tR3gister3d0!` ( using `password` field)	Before Validation
Too Many Requests	`9994`	Before Validation
Too Many Requests	`T00M4ny0R3qu3st0!` ( using `password` field)	Before Validation
Service Unavailable	`9995`	Before Login
Request Timeout	`9996`	Before Validation
Invalid In Auth Session ID	`9997`	Before Validation
Invalid In Auth Session ID	`Inv4lid5e551on!` ( using `password` field)	Before Validation
Invalid Password	`P455wr0n6` ( using `password` field)	Before Validation
Unable to Get Uber Metrics	`9998`	After Validation
Unable to Get Uber Metrics	`UberUnabletoGetMetrics0!` ( using `password` field)	After Validation

Didi, DiDi Food and Noventa Nove Examples

Error Scenario	Parameter in request	When is triggered
Invalid Email	`invalid_email@palenca.com`	Before Login
Invalid Phone	`8881`	Before Login
Expired OTP	`8882`	Before Validation
Invalid OTP	`8883`	Before Validation
Password Missing	`M11551n6` ( using `password` field)	Before Validation
Too Many Requests	`8884`	Before Validation
Platform Error	`8885`	Before Validation
Platform Error	`DiDiPl4tformErr0r!`( using `password` field)	Before Validation

Warnings más comunes (Accounts)

Un warning se detona cuando una conexión a una cuenta fue exitosa pero existe algún factor que impide obtener los datos de empleo o ingresos. Estos warnings pueden verse en la Consola de Palenca. Por ejemplo:

La siguiente tabla muestra los warnings más comunes.

Warning	Plataformas	Descripción
`banned`	Gig economy	El trabajador se encuentra vetado de la plataforma.
`not_registered`	Gig economy	El trabajador no se encuentra registrado en la plataforma.
`curp_not_in_platform`	IMSS e ISSSTE	El CURP no se encuentra registrado en la plataforma.
`zero_quoted_weeks`	IMSS e ISSSTE	El trabajador no cuenta con semanas cotizadas en el IMSS.
`rider_account`	Gig economy	El usuario no está registrado como conductor en Uber, Didi, Indriver, etc.

Errores & Warnings

Errores más comunes (Logins)​

Lista completa de errores​

Prueba de escenarios de error​

Antes de la creacion de una cuenta​

Antes de la validacion de una cuenta​

Despues de la creacion de una cuenta​

Uber Examples​

Didi, DiDi Food and Noventa Nove Examples​

Warnings más comunes (Accounts)​