> ## 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.

# Procesar facturas mediante la API

> Procese sus primeras facturas con la API de FlexiCapture for Invoices Cloud: cree el encabezado de autorización, cargue un archivo, inicie una tarea y descargue los resultados.

En esta guía se muestra cómo procesar sus primeras facturas con la API de ABBYY FlexiCapture for Invoices Cloud: crear el encabezado de autorización, cargar un archivo, iniciar una tarea y descargar los resultados.

Todos los endpoint usan la URL base `https://api-{location-id}.flexicapture.com`, donde `{location-id}` es la [ubicación admitida](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api#icaas-supported-countries): `us` (USA y Canadá), `au` (Australia) o `eu` (los países de la Unión Europea).

<Steps>
  <Step title="Crear una cuenta">
    Para interactuar con la API, necesitas una cuenta. Si todavía no has creado una, hazlo a través del [portal web de ABBYY FlexiCapture Cloud](https://flexicapture.com).
  </Step>

  <Step title="Obtenga el encabezado de autorización">
    Todas las solicitudes a la API deben contener un encabezado de autorización, construido a partir de su ID de la aplicación y token. Para obtener instrucciones, consulte [Autenticación](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-auth). Los ejemplos siguientes usan el encabezado de ejemplo `Basic QWxhZGRpbjpPcGVuU2VzYW1l`.
  </Step>

  <Step title="Cargar un archivo">
    [Cargue un archivo al servidor](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-upload-file). Obtendrá el identificador y el token del archivo en la respuesta; se usan en todas las solicitudes posteriores relacionadas con este archivo.

    ```bash theme={null}
    curl -X POST \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      --form "file=@/path/to/file/Letter.tif" \
      "https://api-{location-id}.flexicapture.com/v2/file"
    ```

    <Warning>
      La configuración del proyecto para el ensamblado de documentos se omite al cargar un archivo mediante la REST API. Se crea un documento independiente por cada archivo.
    </Warning>
  </Step>

  <Step title="Iniciar una tarea">
    Una vez cargado el documento, inicie una tarea para comenzar la extracción de datos. En esta solicitud puede especificar varios archivos. La solicitud puede incluir los siguientes parámetros opcionales: la [región](/es/flexi-capture/cloud/cloud-f-cfor-invoices-languages) de la factura, el tipo de verificación y el [formato de exportación](/es/flexi-capture/cloud/cloud-f-cfor-invoices-formats) de los resultados. La respuesta contiene un identificador de tarea.

    ```bash theme={null}
    curl -X POST \
      --header "Content-Type: application/json" \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      -d '{
        "properties": {
          "region": "US",
          "export_format": "Xls",
          "verification_type": "NoVerification"
        },
        "files": [
          {
            "id": "5ea16ff21b777315586713bf",
            "token": "34FB84AA68684F0F2BF496045224EB6C436F596B"
          }
        ]
      }' \
      "https://api-{location-id}.flexicapture.com/v2/task/capture/invoices"
    ```
  </Step>

  <Step title="Obtener el estado de la tarea">
    El procesamiento de la tarea tarda algo de tiempo, por lo que los datos extraídos no están disponibles de inmediato. Puede [consultar el estado de la tarea](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-get-task) usando el identificador que recibió al iniciar la tarea. Espere hasta que el estado cambie a `Done`.

    ```bash theme={null}
    curl -X GET \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/task/5ea18adc220e0d1c58177c59"
    ```
  </Step>

  <Step title="Descargar el resultado">
    Después de que el estado de la tarea cambie a `Done`, puede [descargar](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-download-file) los archivos de salida usando sus identificadores y tokens. Repita esta solicitud para cada archivo de entrada incluido en la solicitud de la tarea.

    ```bash theme={null}
    curl -X GET \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/file/5ea21f6b7a9ae6193831d671/D188E5EFC0042A83529899AC1E1D94400A25DCF6"
    ```
  </Step>

  <Step title="Eliminar la tarea">
    Después de descargar los datos de salida, [elimine la tarea](/es/flexi-capture/cloud/cloud-f-cfor-invoices-api-delete-task) para eliminar todos los archivos de entrada y de salida.

    ```bash theme={null}
    curl -X DELETE \
      --header "Accept: application/json" \
      --header "Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l" \
      "https://api-{location-id}.flexicapture.com/v2/task/5ea18adc220e0d1c58177c59"
    ```
  </Step>
</Steps>