Códigos de errores en las APIs
Errores en Prometeo API
Los errores en las API de Prometeo están organizados por APIs, y dentro de estas, en secciones y flujos. Esto se puede apreciar en la conformación de los códigos de error, donde el primer caracter es una letra que indica la API a la que pertenece ese error, el segundo carácter se refiere a la sección o flujo donde se produjo, y los restantes son números enteros incrementales.
Los errores se agrupan en las siguientes series de APIs:
CXXXX
- Comunes a todas las APIsBXXXX
- API BancariaFXXXX
- API FiscalIXXXX
- API IdentidadVXXXX
- API Validación
Los errores se retornan como objetos JSON con la siguiente estructura:
BXXXX
- Errores en la API Bancaria
BXXXX
- Errores en la API BancariaA continuación describimos los códigos de error diseñados para la API Bancaria. Los mismos están divididos de la siguiente manera:
B1XXX
- Errores de autenticación y de sesiónB2XXX
- Errores en el flujo de cuentasB3XXX
- Errores en el flujo de tarjetasB4XXX
- Errores en el flujo de transferencias
B1XXX
- Errores de autenticación y de sesión
B1XXX
- Errores de autenticación y de sesiónName | Description | Example |
---|---|---|
B1001 | ❌ Credentials Exception - Credentials error | (1) |
B1002 | ❌ Token Exception - Token error | (2) |
B1003 | ❌ Missing Token Exception - Token not sent | (3) |
B1004 | ❌ Interactive Answer Exception - Interactive response | (4) |
B1005 | ❌ Missing Interactive Answer Exception - Interactive response not sent | (5) |
B1006 | ❌ Provider Session Expired Exception - Session expired at provider | (6) |
B1007 | ❌ Provider Login Exception - Provider login failed | (7) |
B1008 | ❌ Provider Change Password Exception - You have to change the password at the provider | (8) |
B1009 | ❌ Logout Exception - Failed to log out | (9) |
B1010 | ❌ Client Selected Exception - Selected client does not exist | (10) |
(1) - CredentialsException
{'status': 'error', 'code': 'B1001', 'type': 'wrong_credentials', 'message': 'Credentials error'}
(2) - TokenException
{'status': 'error', 'code': 'B1002', 'type': 'wrong_token', 'message': 'Token error'}
(3) - MissingTokenException
{'status': 'error', 'code': 'B1003', 'type': 'missing_token', 'message': 'Token not sent'}
(4) - InteractiveAnswerException
{'status': 'success', 'code': 'B1004', 'type': 'interaction_required', 'message': 'Interactive response'}
(5) - MissingInteractiveAnswerException
{'status': 'error', 'code': 'B1005', 'type': 'missing_interactive_answer', 'message': 'Interactive response not sent'}
(6) - ProviderSessionExpiredException**
{'status': 'error', 'code': 'B1006', 'type': 'provider_session_expired', 'message': 'Session expired at provider'}
(7) - ProviderLoginException
{'status': 'error', 'code': 'B1007', 'type': 'provider_login_error', 'message': 'Provider login failed'}
(8) - ProviderChangePasswordException
{'status': 'error', 'code': 'B1008', 'type': 'provider_change_password', 'message': 'You have to change the password at the provider'}
(9) - LogoutException
{'status': 'error', 'code': 'B1009', 'type': 'logout_error', 'message': 'Failed to log out'}
(10) - ClientSelectedException
{'status': 'error', 'code': 'B1010', 'type': 'wrong_client', 'message': 'Selected client does not exist'}
B2XXX
- Errores en el flujo de cuentas
B2XXX
- Errores en el flujo de cuentasName | Description | Example |
---|---|---|
B2001 | ❌ Listing Accounts Exception - Error listing accounts | (1) |
B2002 | ❌ Movements Account Query Exception - Error querying account movements | (2) |
B2003 | ❌ Account Number Exception - Account number not available for this customer | (3) |
B2004 | ❌ AccountCurrencyException - Currency not supported by the account | (4) |
B2005 | ❌ Account Movements Date Exception - Wrong date | (5) |
(1) - ListingAccountsException
{'status': 'error', 'code': 'B2001', 'type': 'listing_accounts_error', 'message': 'Error listing accounts'}
(2) - MovementsAccountQueryException
{'status': 'error', 'code': 'B2002', 'type': 'movements_query_error', 'message': 'Error querying account movements'}
(3) - AccountNumberException
{'status': 'error', 'code': 'B2003', 'type': 'wrong_account_number', 'message': 'Account number not available for this customer'}
(4) - AccountCurrencyException
{'status': 'error', 'code': 'B2004', 'type': 'wrong_account_currency', 'message': 'Currency not supported by the account'}
(5) - AccountMovementsDateException
{'status': 'error', 'code': 'B2005', 'type': 'wrong_date', 'message': 'Wrong date'}
B3XXX
- Errores en el flujo de tarjetas
B3XXX
- Errores en el flujo de tarjetasName | Description | Example |
---|---|---|
B3001 | ❌ Listing Cards Exception - Error listing cards | (1) |
B3002 | ❌ Movements Card Query Exception - Error querying card movements | (2) |
B3003 | ❌ Card Number Exception - Card number not available for this customer | (3) |
B3004 | ❌ Card Currency Exception - Currency not supported by the card | (4) |
B3005 | ❌ Card Movements Date Exception - Wrong date | (5) |
(1) - ListingCardsException
{'status': 'error', 'code': 'B3001', 'type': 'listing_cards_error', 'message': 'Error listing cards'}
(2) - MovementsCardQueryException
{'status': 'error', 'code': 'B3002', 'type': 'movements_query_error', 'message': 'Error querying card movements'}
(3) - CardNumberException
{'status': 'error', 'code': 'B3003', 'type': 'wrong_card_number', 'message': 'Card number not available for this customer'}
(4) - CardCurrencyException
{'status': 'error', 'code': 'B3004', 'type': 'wrong_card_currency', 'message': 'Currency not supported by the card'}
(5) - CardMovementsDateException
{'status': 'error', 'code': 'B3005', 'type': 'wrong_date', 'message': 'Wrong date'}
B4XXX
- Errores en el flujo de transferencias
B4XXX
- Errores en el flujo de transferenciasName | Description | Example |
---|---|---|
B4001 | ❌ Enroll Account Exception - Error enrolling account | (1) |
B4002 | ❌ Destination Institution Exception - Destination institution not supported | (2) |
B4003 | ❌ Account Number NonExistent Exception - Account number does not exist | (3) |
B4004 | ❌ Origin Destination Same Account Exception - Same source and destination account | (4) |
B4005 | ❌ Wrong Currency Exception - Invalid currency | (5) |
B4006 | ❌ Token Required Exception - Token value required | (6) |
B4007 | ❌ Token InvalidException - Invalid token value | (7) |
B4008 | ❌ RequestId NonExistent Exception - There is no request with that ID | (8) |
B4009 | ❌ Enroll Rejected Exception - Enrollment rejected | (9) |
B4010 | ❌ Insufficient Balance Exception - Insufficient balance | (10) |
B4011 | ❌ Currency UnsupportedAccount Exception - Currency not supported by the account | (11) |
B4012 | ❌ Transfer Exception - Transfer carry out error | (12) |
B4013 | ❌ Transfer Rejected Exception - Transfer rejected | (13) |
(1) - EnrollAccountException
{'status': 'error', 'code': 'B4001', 'type': 'account_enroll_error', 'message': 'Error enrolling account'}
(2) - DestinationInstitutionException
{'status': 'error', 'code': 'B4002', 'type': 'destination_institution_error', 'message': 'Destination institution not supported'}
(3) - AccountNumberNonExistentException
{'status': 'error', 'code': 'B4003', 'type': 'account_number_nonexistent', 'message': 'Account number does not exist'}
(4) - OriginDestinationSameAccountException
{'status': 'error', 'code': 'B4004', 'type': 'same_origin_destiny_account', 'message': 'Same source and destination account'}
(5) - WrongCurrencyException
{'status': 'error', 'code': 'B4005', 'type': 'wrong_currency', 'message': 'Invalid currency'}
(6) - TokenRequiredException
{'status': 'success', 'code': 'B4006', 'type': 'token_required', 'message': 'Token value required'}
(7) - TokenInvalidException
{'status': 'error', 'code': 'B4007', 'type': 'invalid_token', 'message': 'Invalid token value'}
(8) - RequestIdNonExistentException
{'status': 'error', 'code': 'B4008', 'type': 'request_id_nonexistent', 'message': 'There is no request with that ID'}
(9) - EnrollRejectedException
{'status': 'error', 'code': 'B4009', 'type': 'enrollment_rejected', 'message': 'Enrollment rejected'}
(10) - InsufficientBalanceException
{'status': 'error', 'code': 'B4010', 'type': 'insufficient_balance', 'message': 'Insufficient balance'}
(11) - CurrencyUnsupportedAccountException
{'status': 'error', 'code': 'B4011', 'type': 'unsupported_currency', 'message': 'Currency not supported by the account'}
(12) - TransferException
{'status': 'error', 'code': 'B4012', 'type': 'transfer_error', 'message': 'Transfer carry out error'}
(13) - TransferRejectedException
{'status': 'error', 'code': 'B4013', 'type': 'transfer_rejected', 'message': 'Transfer rejected'}
Updated 9 months ago