> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Ejecutar
Ejecuta una tarea de captura de facturas. Se pueden especificar varios archivos en la solicitud.
Puede usar cualquiera de sus aplicaciones para procesar el documento. Para cambiar la aplicación de procesamiento de documentos, use el [header Authentication](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-auth) con el identificador y el token de la aplicación correspondiente al ejecutar la tarea.
ABBYY FlexiCapture for Invoices Cloud procesa facturas procedentes de distintos países y admite una amplia gama de idiomas. Para obtener más información, consulte la sección [Especificación](/es/flexi-capture/cloud/cloud-f-cfor-invoices-languages). Cada aplicación aplica un conjunto predefinido de reglas de procesamiento, palabras clave y otros ajustes específicos de cada país una vez que identifica el país de la unidad de negocio a la que se factura.
Especifique correctamente la región de la que espera recibir facturas. Usar el idioma correcto mejora significativamente la calidad de reconocimiento.
## Solicitud HTTP
```http theme={null}
POST https://api-{location-id}.flexicapture.com/v2/task/capture/invoices
```
Sustituye `{location-id}` por tu [ubicación admitida](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api#icaas-supported-countries).
## Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
```json theme={null}
{
"files": [
{
"id": "string",
"token": "string"
}
],
"properties": {
"region": "US",
"export_format": "Xls",
"verification_type": "NoVerification"
}
}
```
| Campo | Tipo | Descripción |
| ------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `files[]` | object | Obligatorio. Lista de archivos que se van a procesar. |
| `files[].id` | string | Obligatorio. El ID del archivo que se devolvió en la respuesta del método **file.Upload**. |
| `files[].token` | string | Obligatorio. El token de acceso al archivo que se devolvió en la respuesta del método **file.Upload**. |
| `region` | string | Obligatorio. Región de la factura. Regiones admitidas: `US`: USA, `AU`: Australia, `EU`: países de la Unión Europea, `CA`: Canadá. |
| `export_format` | string | Obligatorio. Formato del archivo de salida. Los formatos disponibles se enumeran en la sección [Especificación](/es/flexi-capture/cloud/cloud-f-cfor-invoices-formats#output). |
| `verification_type` | string | Obligatorio. Tipo de verificación. Tipos disponibles: `NoVerification` — los documentos siempre se procesan sin verificación; `Troubleshooting` — los documentos se envían a verificación si hay caracteres inciertos o errores; `UserVerification` — los documentos siempre se envían a verificación. |
## Respuesta
Si la solicitud se realiza correctamente, el cuerpo de la respuesta contiene una instancia de `CaptureTask`.
```json theme={null}
{
"id": "string",
"number": "string",
"verification_id": "string",
"type": "ic",
"properties": {
"property_name": "string"
},
"email": "string",
"account": "string",
"application": "string",
"created": "YYYY-MM-DDT00:00:00.000",
"started": "YYYY-MM-DDT00:00:00.000",
"action_required": "YYYY-MM-DDT00:00:00.000",
"billed": "YYYY-MM-DDT00:00:00.000",
"delivered": "YYYY-MM-DDT00:00:00.000",
"deleted": "YYYY-MM-DDT00:00:00.000",
"progress": 0,
"status": "Submitted",
"is_deleted": true,
"is_demo": true,
"is_billed": true,
"documents_count": 0,
"pages_count": 0,
"documents": [
{
"files": {},
"data": {},
"is_moved": true
}
]
}
```
### CaptureTask
| Campo | Tipo | Descripción |
| ----------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `id` | string | Obligatorio. ID único de la tarea. |
| `number` | string | Obligatorio. Número de tarea. |
| `verification_id` | string | Obligatorio. Este ID se usa para abrir la página de verificación, es decir, `https://{cloud-host}/verification/{verification_id}`. |
| `type` | string | Obligatorio. Tipo de tarea. Tipos admitidos: `ic`: captura de facturas, `dc`: captura de documentos. |
| `properties` | object | Opcional. Configuración de procesamiento o parámetros de registro personalizados. Cualquier número de pares nombre-valor. |
| `email` | string | Obligatorio. Dirección de correo electrónico utilizada para crear la tarea. |
| `account` | string | Obligatorio. ID de la cuenta utilizada para crear la tarea. |
| `application` | string | Obligatorio. ID de la aplicación utilizada para crear la tarea. |
| `created` | string (\$date-time) | Obligatorio. Fecha de creación de la tarea. |
| `started` | string (\$date-time) | Opcional. Fecha de inicio de la tarea. |
| `action_required` | string (\$date-time) | Opcional. Fecha en la que la tarea recibió el estado WaitForAction. |
| `billed` | string (\$date-time) | Opcional. Fecha de facturación de la tarea. |
| `delivered` | string (\$date-time) | Opcional. Fecha de finalización de la tarea. |
| `deleted` | string (\$date-time) | Opcional. Fecha de eliminación de los datos. |
| `progress` | number (\$double) | Obligatorio. Progreso general de la tarea. |
| `status` | string | Obligatorio. Estado de la tarea. Estados admitidos: `Submitted`, `InProgress`, `WaitForAction`, `Done`, `Failed`, `Canceled`. |
| `is_deleted` | boolean | Obligatorio. Especifica si se eliminaron los datos de la tarea. |
| `is_demo` | boolean | Obligatorio. Especifica si la tarea se creó en la aplicación demo. |
| `is_billed` | boolean | Obligatorio. Especifica si la tarea fue facturada. |
| `documents_count` | integer (\$int32) | Opcional. Número de documentos en la tarea. |
| `pages_count` | integer (\$int32) | Opcional. Número de páginas en la tarea. |
| `documents[]` | object (DataCaptureDocumentModel) | Obligatorio. Documentos de la tarea. |
### DataCaptureDocumentModel
| Campo | Tipo | Descripción |
| ---------- | --------------------------------- | ----------------------------------------------------------------------- |
| `files` | object (DataCaptureFileLinkModel) | Obligatorio. Lista de archivos vinculados al documento. |
| `data` | string | Opcional. Datos del documento. |
| `is_moved` | boolean | Obligatorio. Indica si el documento se eliminó durante la verificación. |
### DataCaptureFileLinkModel
| Campo | Tipo | Descripción |
| ------- | ------ | ---------------------------------------- |
| `id` | string | Obligatorio. ID del archivo. |
| `token` | string | Obligatorio. token de acceso al archivo. |
| `name` | string | Obligatorio. Nombre del archivo. |