# Códigos de los servicios bancarios

En las siguientes secciones se detallan las convenciones utilizadas en los servicios bancarios que ofrecemos.

## Códigos de transacciones bancarias

En los servicios de Open Banking, el objeto `Transaction` puede contener el elemento `BankTransactionCode`, que se utiliza para identificar el tipo de transacción. Está compuesto por un `Code` y un `SubCode`, con valores basados en la [Norma ISO 20022](https://www.iso20022.org/), diseñada para actividades financieras.

Es de especial interés observar las definiciones de mensajería contenidas en los documentos enlazados en el [External code sets message catalog](https://www.iso20022.org/catalogue-messages/additional-content-messages/external-code-sets), ya que son la base de los códigos utilizados en los mensajes de respuesta.

Consulte los enlaces **Combinaciones de códigos de transacciones bancarias** y **Descripción de códigos de transacciones bancarias**, donde podrá descargar la última versión de cada documento con las definiciones de los códigos.

## Códigos de moneda para la denominación de servicios

En cuanto a los tipos de moneda, se especifican junto al nombre del servicio y están presentes en la ruta de la operación. Esta norma de denominación sólo se aplica a la ruta, ya que los objetos de respuesta tienen su propio campo `Moneda` con las siglas del tipo de moneda (`CLP`, `USD`, etc.).

Los códigos son los siguientes:

- **LCY** (Moneda Local): El servicio sólo envía datos con la moneda utilizada en el país donde opera el banco.
- **FCY** (Moneda extranjera): El servicio no envía datos en moneda local, sólo en la moneda extranjera pasada como parámetro de la petición.
- **ACY** (Cualquier moneda): El servicio puede responder en más de una moneda, correspondiendo la utilizada como parámetro de petición. También puede responder en moneda local y extranjera.


Cada nombre de servicio bancario será identificado por el tipo de moneda en base a su país de origen, por lo que para los bancos chilenos, los servicios con **LCY** sólo devolverán información en Pesos Chilenos (CLP).

## Transacciones reservadas vs pendientes

A continuación se presentan las definiciones oficiales de Open Banking para el posible estado de una transacción.

### Reservada

Reservada significa que la transferencia de dinero ha sido completada entre el administrador de la cuenta y el dueño de la cuenta.

Utilización: El estado Reservado no implica necesariamente que el dinero sea definitivo, ya que esto depende de otros factores como el sistema de pago utilizado, la finalización de la transacción de principio a fin y las condiciones acordadas entre el gestor y el titular de la cuenta.
El estado Reservado es el único que puede anularse.

### Pendiente

La anotación en la cuenta del titular en el libro mayor del administrador de la cuenta no se ha completado.

Utilización: puede utilizarse para partidas previstas o para partidas para las que aún deben cumplirse algunas condiciones antes de que puedan reservarse. Si se realiza el asiento, éste se incluirá con el estado Registrado en el informe o extracto de cuenta posterior. El estado Pendiente no puede anularse.

> ⚠️ Tenga en cuenta que para los bancos chilenos las transacciones siempre serán devueltas con `Estado "Registrado"` ya que todas las transacciones se consideran registradas inmediatamente después de su creación.