Skip to main content
Un escenario típico para procesar documentos mediante llamadas a la API separadas (para crear una transacción, cargar un archivo e iniciar una transacción) consta de los siguientes pasos:
  1. Recibir una lista de todas las skills disponibles
  2. Crear una transacción vacía
  3. Agregar un conjunto de archivos que se procesarán en la transacción
  4. Iniciar la transacción
  5. Supervisar el estado de la transacción
  6. Descargar archivos de origen y archivos de resultados
Cada solicitud al servidor debe incluir información de autenticación (como un token de acceso). Para obtener más información, consulte Authentication.

​
Obtener una lista de todas las skills disponibles

Para ello, envía una solicitud GET al recurso skills:
Ejecute el siguiente comando:
La respuesta contendrá un archivo JSON similar al siguiente:
Defina el identificador de la skill que va a utilizar. Puede encontrar descripciones detalladas de las skills en las skills integradas.

​
Creación de una transacción vacía

Para ello, envíe la siguiente solicitud POST al recurso transactions:
Ejecute el siguiente comando:
Una vez creada correctamente la transacción vacía, recibirá una respuesta con su identificador:

​
Añadir un conjunto de archivos para procesar en la transacción

El número máximo de archivos en una transacción es de 1000.
Un conjunto de archivos se puede añadir de dos maneras:

​
Añadir archivos directamente a la transacción

Para ello, envíe una solicitud POST al recurso transactions/<transaction-id>/files:
En el cuerpo de la solicitud, envíe el archivo que se va a procesar. Para obtener información sobre los Parameter disponibles para personalizar archivos, consulte la referencia de la API de Swagger para su región: US, EU o AU. Ejecute el siguiente comando:
Si la operación se realiza correctamente, el servidor devuelve HTTP 200 con un cuerpo de respuesta vacío. Para ver los archivos añadidos y sus identificadores, solicite GET transactions/<transaction-id>/documents. Puede añadir tantos archivos como necesite repitiendo esta llamada varias veces; tenga en cuenta que cada nombre de archivo debe ser único dentro de la transacción (añadir un archivo con un nombre duplicado devuelve HTTP 409). Opciones adicionales para la carga de archivos:

​
Adición de archivos a un documento

Primero, cree un documento enviando una solicitud POST al recurso transactions/<transaction-id>/documents:
Como resultado, recibirá una respuesta con el identificador del documento. A continuación, agregue archivos al documento enviando una solicitud POST al recurso transactions/<transaction-id>/documents/<document-id>/sourceFiles:

​
Inicio de la transacción

Para iniciar la transacción con el skill y los archivos especificados, envíe la siguiente solicitud POST al recurso transactions/<transaction-id>/start:

​
Supervisar el estado de la transacción

Para empezar a supervisar el estado de la transacción mediante un bucle con un breve tiempo de espera (no recomendamos comprobar el estado con más frecuencia que una vez por segundo), envíe una solicitud GET al recurso transactions/<transaction_id> con el identificador de la transacción en el URI de la solicitud:
La respuesta tendrá un aspecto similar al siguiente:
En la respuesta:
  • Si el valor de la clave status se establece en:
    • New — la transacción se ha creado, pero no está actualmente en curso.
    • Processing — la transacción se ha iniciado, pero los resultados aún no están listos.
    • Processed — la transacción se ha completado correctamente y podrá descargar los resultados.
    • Failed — la transacción ha fallado.
    • Canceled — la transacción se canceló.
  • La clave manualReviewLink contendrá un enlace a la interfaz web del cliente de revisión manual y un token de acceso de Vantage, si se requiere revisión manual. Este enlace y este token pueden utilizarse para revisar y corregir los resultados de la clasificación y la extracción de campos de una transacción concreta. Hasta que se complete la revisión, el valor de la clave status se establecerá en Processing. El enlace proporcionado es válido durante 168 horas, transcurridas las cuales debe crearse y obtenerse un nuevo enlace para otro período de 168 horas utilizando el mismo método. Consulte más información en Integrating manual review.
Los usuarios autorizados mediante este enlace no pueden ver ni modificar ningún otro documento o transacción.
Para un Skill de documento, la respuesta tendrá ahora un aspecto similar al siguiente:
En el array documents, cada documento tiene un array resultFiles. Use este array para obtener los valores de fileId. El formato de los archivos de salida lo define la skill que utilice. Actualmente, todas las skills devuelven los campos extraídos en formato JSON. En el caso de una Skill de clasificación, la respuesta recibida después de procesar los documentos tendrá un aspecto similar al siguiente:
Extraiga la clase del documento de la clave resultClass.name y compruebe el nivel de confianza de cada posible clase en las claves confidence (un entero de 0 a 100). Para una Habilidad de proceso, la respuesta puede contener toda o parte de la información que se devuelve para las habilidades de documento y Skills de clasificación, según las etapas disponibles en la Habilidad de proceso.

​
Descarga de archivos de origen y de resultados

Una vez finalizado el procesamiento, puede descargar dos tipos de archivos:
  • Archivos de origen — los archivos originales que cargó, devueltos en su formato binario original.
  • Archivos de resultados — la salida del procesamiento: los datos extraídos, en formato JSON de forma predeterminada (el formato de salida lo establece la skill).
Los archivos de origen y los archivos de resultados usan endpoints e identificadores de archivo diferentes:
  • Archivo de origen — GET transactions/<transaction-id>/documents/<document-id>/sourceFiles/<file-id>/download. El ID del archivo proviene de la respuesta de GET transactions/<transaction-id>/documents (sourceFiles[].id).
  • Archivo de resultados — GET transactions/<transaction-id>/files/<file-id>/download. El ID del archivo proviene del array resultFiles en la respuesta de estado de la transacción (documents[].resultFiles[].fileId).
Para obtener una lista de documentos con sus identificadores, envíe una solicitud GET al recurso transactions/<transaction-id>/documents y especifique el identificador de la transacción:
Como resultado, recibirá una lista de todos los documentos creados dentro de esta transacción. La respuesta también incluye los identificadores de estos documentos, que pueden ser necesarios para solicitar información detallada sobre documentos específicos.

​
Archivos de origen

Para descargar un archivo de origen necesario, envíe una solicitud GET al recurso transactions/<transaction-id>/documents/<document-id>/sourceFiles/<file-id>/download y especifique los identificadores de la transacción, el documento y el archivo (de la última respuesta):
Ejecute el siguiente comando:
La respuesta contendrá el archivo en formato binario. Repita este paso para todos los archivos de origen.

​
Archivos de resultados

Para descargar un archivo de resultados, envíe una solicitud GET al recurso transactions/<transaction-id>/files/<file-id>/download y especifique el identificador de la transacción y el fileId del archivo de resultados. Obtenga el fileId del array resultFiles devuelto al consultar el estado de la transacción (cada entrada tiene un fileId y un type, como Json):
Ejecute el siguiente comando: