Códigos de errores en las APIs

Errores en Prometeo API

Los errores en las API de Prometeo están organizados por APIsAPIs - Es el proceso formal que permite a un usuario interactuar con otro sistema., 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 un número entero incremental.

📘

Los errores se agrupan en las siguientes series de APIs:

  • CXXXX - Comunes a todas las APIsAPIs - Es el proceso formal que permite a un usuario interactuar con otro sistema.
  • BXXXX - API BancariaAPI Bancaria - Permite conectar a la base de datos bancaria de los clientes para que puedas realizar movimientos de dinero.
  • FXXXX - API FiscalAPI Fiscal - Permite obtener y/o validar información tributaria o fiscal
  • IXXXX - API Identidad
  • VXXXX - API Validación

Los errores se retornan como objetos JSON con la siguiente estructura:

Atributo Tipo de dato Descripción Ejemplo
status str El estado de la respuesta. Hay 2 estados posibles: success y error. 'status': 'error'
code str El código del error retornado. 'code': 'B1001'
type str Tipo de error. 'type': 'wrong_credentials'
message str Mensaje de error. 'message': 'Credentials error'
description [str, list, dict] Campo opcional para describir el error con más detalles. Si está presente, es de alguno de los 3 tipos de datos especificados. 'description': 'Password can only contain digits'

BXXXX - Errores en la API BancariaAPI Bancaria - Permite conectar a la base de datos bancaria de los clientes para que puedas realizar movimientos de dinero.

A continuación describimos los códigos de error diseñados para la API BancariaAPI Bancaria - Permite conectar a la base de datos bancaria de los clientes para que puedas realizar movimientos de dinero.. Los mismos están divididos de la siguiente manera:

  • B1XXX - Errores de autenticación y de sesión
  • B2XXX - Errores en el flujo de cuentas
  • B3XXX - Errores en el flujo de tarjetas
  • B4XXX - Errores en el flujo de transferencias

B1XXX - Errores de autenticación y de sesión


Name

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


Name

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


Name

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


Name

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'}

Did this page help you?