Cartola Tarjeta de Crédito
Documentación detallada de la estructura de datos de la Cartola Tarjeta de Crédito
Cartola Tarjeta de Crédito con detalle de cupos, montos facturados y detalle de transacciones.
Código del tipo de documento: cartola_tc
Estructura de respuesta
{
"data": {
"extractedData": {
"titular": "Juan Pérez",
"numero_tarjeta": "XXXX-XXXX-XXXX-1234",
"fecha_estado_cuenta": "2023-12-01T00:00:00Z",
"monto_total_facturado": 125000,
"tipo_cartola": "nacional",
"moneda": "CLP",
"cupo_disponible": 1500000,
"cupo_utilizado": 500000,
"cupo_total": 2000000,
"saldo_periodo_anterior": 75000,
"monto_total_facturado_periodo_anterior": 150000,
"transacciones": [
{
"fecha": "2023-11-15T00:00:00Z",
"descripcion": "SUPERMERCADO XYZ",
"monto_mensual": 45000,
"compra_en_cuotas": true,
"numero_cuota": 2,
"total_cuotas": 6,
"monto_total": 270000
},
{
"fecha": "2023-11-20T00:00:00Z",
"descripcion": "FARMACIA ABC",
"monto_mensual": 15000,
"compra_en_cuotas": false,
"numero_cuota": null,
"total_cuotas": null,
"monto_total": null
},
{
"fecha": "2023-11-25T00:00:00Z",
"descripcion": "PAGO POR INTERNET",
"monto_mensual": -75000,
"compra_en_cuotas": false,
"numero_cuota": null,
"total_cuotas": null,
"monto_total": null
}
]
}
}
}Campos principales
| Campo | Tipo | Descripción |
|---|---|---|
titular | String | Nombre del titular de la tarjeta |
numero_tarjeta | String | Número de tarjeta con formato enmascarado |
fecha_estado_cuenta | String (date-time) | Fecha del estado de cuenta |
monto_total_facturado | Number | Monto total facturado |
tipo_cartola | String (enum) | Indica si es nacional o internacional |
moneda | String (enum) | CLP para cartolas nacionales, USD para internacionales |
cupo_disponible | Number | Cupo disponible en la tarjeta |
cupo_utilizado | Number | Cupo utilizado en la tarjeta |
cupo_total | Number | Cupo total de la tarjeta |
saldo_periodo_anterior | Number (nullable) | Saldo de periodo anterior, puede aparecer también como saldo adeudado final periodo anterior, saldo anterior facturado, etc. Ten en consideración que en algunas cartolas aparece el Saldo Adeudado Inicio Periodo anterior, pero para ti siempre es importante encontrar el Final, que puede llamarse Saldo Adeudado Final del Periodo Anterior |
monto_total_facturado_periodo_anterior | Number | Monto total facturado del periodo anterior |
Campos de transacciones
| Campo | Tipo | Descripción |
|---|---|---|
fecha | String (date-time) | Fecha de la transacción |
descripcion | String | Descripción de la transacción |
monto_mensual | Number | Monto de la transacción a pagar en el mes |
compra_en_cuotas | Boolean | Indica si la transacción es una compra en cuotas |
numero_cuota | Number (nullable) | Número de la cuota a pagar en el mes, solo para compras en cuotas |
total_cuotas | Number (nullable) | Total de cuotas, solo para compras en cuotas |
monto_total | Number (nullable) | Monto total de la transacción, solo para compras en cuotas |
Consideraciones importantes
- El listado de transacciones puede incluir filas con nombres como MONTO CANCELADO o PAGO POR INTERNET, que tienen montos negativos, pero que también tienen que incluirse
- La cartola nacional usa moneda en CLP e internacional en USD
- Las transacciones en cuotas muestran el detalle de cada cuota y el monto total original
- Es importante verificar la fecha del estado de cuenta para el período correcto
- Estado de cuenta de una tarjeta de crédito con información completa de cupos y transacciones