---
title: "Escáner de códigos de barras"
url: https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/barcode-scanner/
description: "Esta API te permite decodificar los datos codificados en un código de barras a partir de un archivo de imagen."
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: api
---

# Barcode Scanner

[Zia Barcode Scanner](https://docs.catalyst.zoho.com/es/zia-services/help/barcode-scanner/introduction/) te permite escanear los formatos de códigos de barras lineales y 2D más comúnmente utilizados y decodificar los datos codificados. Barcode Scanner puede detectar formatos como Codabar, EAN-13, ITF, UPC-A, QR Code y más.

# Ejecutar Barcode Scanner

### Descripción

Esta API se usa para decodificar los datos codificados en un código de barras a partir de un archivo de imagen. Debes especificar la ruta al archivo de imagen en la solicitud de la API, como se muestra en la solicitud de ejemplo.

Opcionalmente puedes especificar el formato del código de barras. Si no lo especificas, Catalyst procesará automáticamente el valor predeterminado `all` para este campo. La respuesta JSON devuelve los datos decodificados.

### Detalles de la Solicitud

#### URL de Solicitud

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

- **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

- **file** (file, mandatory):  El archivo de entrada con el código de barras a escanear. 

Formatos permitidos: *.webp, .jpeg, .png*, .txt 

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

Límite de resolución: 36000000 píxeles

- **format** (string, optional):  El formato del código de barras en la imagen. Los códigos de formato se especifican en la tabla a continuación.

Debes proporcionar la ruta en tu sistema local.

Formatos permitidos: .webp, .jpeg, .png 

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

#### Códigos de Formato de Código de Barras

<table class="content-table">
	<thead>
		<tr>
			<th class="w50p">Formato de Código de Barras</th>
			<th class="w50p">Código de Formato</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>Code 39</td>
			<td>`code39`</td>
		</tr>
		<tr>
			<td>Code 128</td>
			<td>`code128`</td>
		</tr>
		<tr>
			<td>Code 93</td>
			<td>`code93`</td>
		</tr>
		<tr>
			<td>Ean 8</td>
			<td>`ean8`</td>
		</tr>
		<tr>
			<td>Ean 13</td>
			<td>`ean13`</td>
		</tr>
		<tr>
			<td>Codabar</td>
			<td>`codabar`</td>
		</tr>
		<tr>
			<td>ITF</td>
			<td>`itf`</td>
		</tr>
		<tr>
			<td>UPC-A</td>
			<td>`upca`</td>
		</tr>
		<tr>
			<td>UPC-E</td>
			<td>`upce`</td>
		</tr>
		<tr>
			<td>RSS</td>
			<td>`rss`</td>
		</tr>
		<tr>
			<td>QR code</td>
			<td>`qrcode`</td>
		</tr>
		<tr>
			<td>Aztec</td>
			<td>`aztec`</td>
		</tr>
		<tr>
			<td>PDF417</td>
			<td>`pdf417`</td>
		</tr>
		<tr>
			<td>Data Matrix</td>
			<td>`datamatrix`</td>
		</tr>
		<tr>
			<td>Si no conoces el formato

			o si no lo especificas</td>
			<td>`all`</td>
		</tr>
	</tbody>
</table>

### Detalles de la Respuesta

La respuesta contendrá los datos detectados en el código de barras en el campo `content`.

**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 "file=@attachment1.txt"  \
-d '{
        "format": "ITF"
      }'

```

**Sample Response**

```json

	{
		"status": "success",
		"data": {
			"content": "40156"
		}
	}
```

### SDK Documentation

[Barcode Scanner- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/barcode-scanner)</br></br>
[Barcode Scanner- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/barcode-scanner)</br></br>
[Barcode Scanner- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/barcode-scanner)</br></br>