---
title: "Libreta de ahorros"
url: https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/identity-scanner/passbook/
description: "Esta API te permite extraer campos de datos de una libreta bancaria india y obtener los parámetros reconocidos de ella."
last_updated: 2026-03-30T08:10:30Z
service: Zia Services
type: api
---

# Passbook

El modelo `PASSBOOK` es parte de la funcionalidad de Document Processing de [Identity Scanner](https://docs.catalyst.zoho.com/es/zia-services/help/identity-scanner/introduction/) que te permite procesar libretas bancarias indias como documentos financieros o de prueba de identidad.

> **Nota:** 

* Catalyst no almacena ninguno de los archivos que subes en sus sistemas. Los documentos que subes se utilizan solo para procesamiento único. Tampoco se utilizan para propósitos de entrenamiento de modelos ML. Los componentes de Catalyst cumplen completamente con todas las leyes aplicables de protección de datos y privacidad.

* Document Processing solo es relevante para usuarios indios y está **disponible únicamente en el DC de IN**. Esta funcionalidad no estará disponible para usuarios que acceden desde los centros de datos EU, AU, US, JP, SA o CA. Los usuarios fuera de India desde los otros DCs pueden acceder al [componente OCR general](https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/identity-scanner/passbook/#OCR) para leer y procesar contenido textual.

## Procesar Passbook

### Descripción

Esta API extrae campos de datos de una libreta bancaria usando la tecnología OCR y devuelve los parámetros reconocidos de la libreta como una respuesta JSON. Debes proporcionar la ruta al archivo de imagen de la primera página de la libreta bancaria, y especificar el tipo de modelo como `PASSBOOK` en la solicitud de la API.

También puedes opcionalmente ingresar los idiomas presentes en la libreta en la solicitud de la API. El proceso de reconocimiento y extracción de texto es más rápido y preciso si especificas los idiomas. 

### Detalles de la Solicitud

#### URL de Solicitud

`POST` {api-domain}/baas/v1/project/{project_id}/ml/ocr

- **api-domain** (URL): El dominio específico del DC para acceder a la API de Catalyst

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### Encabezados de Solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**content-type:** multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

**Encabezados Opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance

ZohoCatalyst.mlkit.READ

#### Propiedades del JSON de Solicitud

- **image** (file, mandatory):  La imagen de la primera página de la libreta bancaria. Debes proporcionar la ruta en tu sistema local.

Formatos permitidos: *.webp, .jpeg, .png, .bmp, .tiff, .pdf*

Límite de tamaño de archivo: 15 MB

- **model_type** (string, mandatory):  El tipo de modelo de la imagen

Valor a pasar: `PASSBOOK`

- **language** (string, optional):  El código de idioma de los idiomas a identificar. Puedes pasar múltiples idiomas. El modelo `PASSBOOK` soporta los idiomas indios e internacionales especificados en las tablas a continuación.

Valor predeterminado: `eng`

#### Idiomas Internacionales Soportados por el Tipo de Modelo Passbook

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Idioma</th>
			<th class="w50p">Códigos de Idioma</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>English</td>
			<td>`eng`</td>
		</tr>
		<tr>
			<td>Arabic</td>
			<td>`ara`</td>
		</tr>
		<tr>
			<td>Chinese</td>
			<td>`chi_sim`</td>
		</tr>
		<tr>
			<td>French</td>
			<td>`fra`</td>
		</tr>
		<tr>
			<td>Italian</td>
			<td>`ita`</td>
		</tr>
		<tr>
			<td>Japanese</td>
			<td>`jpn`</td>
		</tr>
		<tr>
			<td>Portuguese</td>
			<td>`por`</td>
		</tr>
		<tr>
			<td>Romanian</td>
			<td>`ron`</td>
		</tr>
        <tr>
			<td>Spanish</td>
			<td>`spa`</td>
		</tr>
	</tbody>
</table>

#### Idiomas Indios Soportados por el Tipo de Modelo Passbook

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Idioma</th>
			<th class="w50p">Códigos de Idioma</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Hindi</td>
			<td>`hin`</td>
		</tr>
		<tr>
			<td>Bengali</td>
			<td>`ben`</td>
		</tr>
		<tr>
			<td>Marathi</td>
			<td>`mar`</td>
		</tr>
		<tr>
			<td>Telugu</td>
			<td>`tel`</td>
		</tr>
		<tr>
			<td>Tamil</td>
			<td>`tam`</td>
		</tr>
		<tr>
			<td>Gujarati</td>
			<td>`guj`</td>
		</tr>
		<tr>
			<td>Urdu</td>
			<td>`urd`</td>
		</tr>
        <tr>
			<td>Kannada</td>
			<td>`kan`</td>
		</tr>
        <tr>
			<td>Malayalam</td>
			<td>`mal`</td>
		</tr>
        <tr>
			<td>Sanskrit</td>
			<td>`san`</td>
		</tr>
	</tbody>
</table>

### Detalles de la Respuesta

La respuesta contiene los datos bancarios y los datos de cuenta reconocidos de la libreta, como el nombre del banco, sucursal, dirección, número de cuenta. Los campos de información extraídos se asignan a sus claves respectivas. La respuesta también muestra si RTGS, NEFT e IMPS han sido habilitados para esa cuenta devolviendo `true` o `false` para esas claves.

> **Nota:** Identity Scanner devolverá la respuesta solo en inglés, independientemente de los idiomas presentes en la libreta.

**Sample Request**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/ocr \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \
-F image=/Desktop/MyPassbook.pdf \
-F model_type=PASSBOOK \
-F "language=eng"

```

**Sample Response**

```json

		{
		"status":"success",
		"data":{
		"text": "{\"address\":\"NO.20 ,SUNSHINE LANE,ANNA NAGAR,CHENNAI\",\"city\":\"CHENNAI\",\"centre\":\"CHENNAI\",\"bankName\":\"ABC BANK LIMITED\",\"accountNumber\":\"000000001111222\",\"branch\":\"ANNA NAGAR\",\"dateOfOpening\":\"30/08/2012\",\"imps\":\"true\",\"neft\":\"true\",\"district\":\"CHENNAI\",\"contact\":\"2891289\",\"micr\":\"0101010\",\"name\":\" 999919\",\"state\":\"TAMIL NADU\",\"rtgs\":\"true\",\"ifsc\":\"ABCB0000111\"}"
		}	
		}
```

### SDK Documentation

[Identity Scanner: Passbook- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/identity-scanner/passbook)

[Identity Scanner: Passbook- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/identity-scanner/passbook)

[Identity Scanner: Passbook- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/identity-scanner/passbook)