Saltar al contenido principal
Los informes de procesamiento empresarial muestran qué tan bien se procesan los documentos y proporcionan trazabilidad de las transacciones de extremo a extremo para fines de auditoría. El Warehouse registra todas las transacciones —completadas y en curso— para su análisis y visualización en herramientas de inteligencia de negocios. Los datos se conservan durante 12 meses, lo que permite el análisis y la auditoría en períodos de tiempo definidos. Se realiza un seguimiento de los siguientes datos:
  • ID de transacción.
  • ID y versión de la skill.
  • Ruta de procesamiento por pasos:
    • Tipos de paso
    • Nombres
    • Fecha y hora de inicio y finalización del paso
    • Duración (en segundos)
  • Nombre y correo electrónico del operador de revisión manual.
  • Parámetros de registro del documento y de la transacción.
Nota: El Warehouse no almacena información sobre eventos de procesamiento de documentos en actividades que nunca se ejecutan según su configuración. Por ejemplo, la configuración Assemble by files corresponde al comportamiento predeterminado de Vantage, por lo tanto, el procesamiento de documentos en esta actividad se omitirá en el flujo de trabajo.

​
Migración de v1 a v2

En Vantage 3.0 y versiones posteriores, el endpoint transaction-steps v1 ha quedado obsoleto. Para garantizar la compatibilidad con versiones anteriores, el endpoint v2 funciona de manera similar, con un cambio en el nombre del endpoint y con los parámetros de consulta trasladados al cuerpo de la solicitud. El endpoint v2 ha pasado a un modelo asíncrono para gestionar mejor las solicitudes con grandes volúmenes de datos. Después de solicitar un informe, puede consultar periódicamente el estado hasta que el informe esté listo. Una vez completado, puede descargar los resultados. 
// v1: One synchronous call with query parameters
1. GET {{baseUrl}}/api/reporting/v1/transaction-steps?skillId=ABCD&startDate=2025-11-01&endDate=2025-11-18

// v2: Multiple async calls
1. POST {base_url}/api/reporting/v2/exports/transaction-steps
{
  "filters": {
    "skillId": "d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae",
    "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "startDate": "2025-11-03T17:19:54.386Z",
    "endDate": "2025-11-17T20:05:26.097Z"
  },
  "sendEmailNotification": true
}

// Receive request Id
2. GET {{baseUrl}}/api/reporting/v2/exports/transaction-steps/{{requestId}}/status

// Una vez que el estado = "Succeeded", descargar los archivos del informe
3. GET {{baseUrl}}/api/reporting/v2/exports/transaction-steps/{{requestId}}/result/{fileIndex}

​
¿Qué hay de nuevo?

En la solicitud (/api/reporting/v2/exports/transaction-steps):
  • Los filtros se han trasladado de los parámetros de consulta al cuerpo de la solicitud (objeto JSON filters).
  • startDate, especificado dentro del objeto filters, ahora es obligatorio.
  • Campo nuevo: sendEmailNotification (true/false): envía un correo electrónico al usuario que solicitó el informe cuando el informe esté listo para descargar.
En los archivos CSV descargados del resultado final (/api/reporting/v2/exports/transaction-steps/{{requestId}}/result/{fileIndex}), se han añadido dos columnas:
  • DocumentsCount: el número de documentos procesados en una transacción.
  • PagesCount: el número de páginas procesadas en una transacción.
Continúe leyendo más abajo para ver los detalles sobre cómo funciona el endpoint v2.

​
Descarga de un informe de datos

Nota: Solo los usuarios con los roles de Tenant Administrator y Processing Supervisor pueden descargar un informe de datos desde Warehouse. Para obtener más información, consulta la sección Control de acceso basado en roles.
Puedes obtener datos de Warehouse en un archivo CSV mediante la Vantage API. Para hacerlo, envía una solicitud POST al siguiente recurso: 
POST {base_url}/api/reporting/v2/exports/transaction-steps
El cuerpo de la solicitud debe incluir las siguientes propiedades dentro de un objeto filters:
  • skillId. El ID de la Habilidad cuyas transacciones se deben descargar. Opcional.
  • transactionId. El ID de la transacción por la que se debe filtrar. Opcional.
  • startDate. El primer día del período (formato de ejemplo: 2022-01-07T13:03:38, la hora debe estar en UTC) para el cual se deben descargar las transacciones. Obligatorio.
  • endDate. El último día del período (formato de ejemplo: 2022-09-07T13:03:38, la hora debe estar en UTC) para el cual se deben descargar las transacciones. Opcional.
  • sendEmailNotification. Enviar un correo electrónico al usuario que creó la solicitud de informe para informarle que el informe está listo para descargar. Opcional.
{
  "filters": {
    "skillId": "d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae",
    "transactionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "startDate": "2025-11-03T17:19:54.386Z",
    "endDate": "2025-11-17T20:05:26.097Z"
  },
  "sendEmailNotification": true
}
Las solicitudes de informes se procesan de forma asíncrona, por lo que la respuesta devuelve un requestId que se utiliza para comprobar el estado de la solicitud. Resultado: 
{
  "requestId": "8f772512-099c-4050-8dd3-6c4d7af69747”
}
Para consultar el estado del informe, incluya el requestId en la solicitud GET: 
GET {{baseUrl}}/api/reporting/v2/exports/transaction-steps/{{requestId}}/status
Una vez creado el informe, el valor de status será “Succeeded” y totalFileCount mostrará el número de archivos disponibles para descargar: 
{
  "status": "Succeeded",
  "totalFileCount": 3,
  "filters": {
      "skillId": "d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae",
      "startDate": "2025-11-03T17:19:54.386+00:00",
      "endDate": "2025-11-17T20:05:26.097+00:00"
  }
}
Para descargar los archivos de informe resultantes, realice una solicitud GET a lo siguiente, pasando nuevamente el requestId y agregando el fileIndex, el índice que comienza en cero del archivo. Por ejemplo, si "totalFileCount": 3, entonces los índices de archivo disponibles serían 0, 1 y 2. 
GET {{baseUrl}}/api/reporting/v2/exports/transaction-steps/{{requestId}}/result/{fileIndex}
Este es un ejemplo de cómo es la respuesta CSV:
SkillIdSkillVersionSkillNameTransactionIdStepNameStepTypeManualReviewOperatorNameManualReviewOperatorEmailStartedUtcCompletedUtcStatusDurationDocumentsCountPagesCountdocument_SourceFileNamedocument_SourceTypetransaction_App
d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae1Redaction Test6d7e9eeb-86e3-4952-8e29-3f76b3fae59fInputInput11/17/2025 19:37:5211/17/2025 19:38:01FinishedSuccessfully9Invoice CA_2.pdfPublicAPIPublicAPI
d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae1Redaction Test6d7e9eeb-86e3-4952-8e29-3f76b3fae59fOCROCR11/17/2025 19:38:0211/17/2025 19:38:17FinishedSuccessfully15Invoice CA_2.pdfPublicAPIPublicAPI
d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae1Redaction Test6d7e9eeb-86e3-4952-8e29-3f76b3fae59fClassifyClassification11/17/2025 19:38:1711/17/2025 19:38:20FinishedSuccessfully3Invoice CA_2.pdfPublicAPIPublicAPI
d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae1Redaction Test6d7e9eeb-86e3-4952-8e29-3f76b3fae59fExtractExtraction11/17/2025 19:38:2111/17/2025 19:38:44FinishedSuccessfully23Invoice CA_2.pdfPublicAPIPublicAPI
d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae1Redaction Test6d7e9eeb-86e3-4952-8e29-3f76b3fae59fOutputOutput11/17/2025 19:38:4711/17/2025 19:39:01Failed13Invoice CA_2.pdfPublicAPIPublicAPI

​
Estructura de la respuesta

Cada fila de un archivo CSV es una operación realizada sobre una transacción. Por ejemplo, la importación de documentos, el reconocimiento o la revisión manual. Para cada operación en el Warehouse, sus detalles se almacenan en columnas:
ColumnDescription
SkillIdEl ID del skill.
SkillVersionLa versión del skill.
SkillNameEl nombre del skill.
TransactionIdID de la transacción.
StepNameEl nombre del evento o el nombre de la actividad en el caso del skill de tipo Process.
StepTypeEl tipo de evento. Valores posibles:
- Input (disponible para todos los tipos de skill)
- Ocr (disponible para skills de OCR o skills de tipo Process con actividad de OCR agregada)
- Classification (disponible para skills de Classification o skills de tipo Process con actividad de Classification agregada)
- Extraction (disponible para todos los tipos de skill)
- Condition (disponible para skills de tipo Process con actividad de Condition agregada)
- CustomActivity (disponible para skills de tipo Process con actividad Custom agregada)
- WaitingForManualReview (disponible para skills de tipo Process con la actividad Manual Review agregada). El tiempo durante el cual una transacción está en espera de revisión manual
- ManualReview (disponible para skills de tipo Process con la actividad Manual Review agregada). El tiempo durante el cual el Operador está verificando una transacción
- Output (disponible para todos los tipos de skill)
ManualReviewOperatorNameEl nombre del Operador de Manual Review.
ManualReviewOperatorEmailEl correo electrónico del Operador de Manual Review.
StartedUtcHora de inicio del evento (UTC). Por ejemplo, 5/3/2022 1:59:02 PM.
CompletedUtcHora de finalización del evento (UTC).
StatusEl estado del evento. Valores posibles:
- Processing
- Finished Successfully
- Canceled
- Failed
DurationDuración del evento (en segundos).
DocumentsCountEl número de documentos procesados en una transacción.
PagesCountEl número de páginas procesadas en una transacción.
document_*, transaction_*Parámetros de documento o de transacción pasados para el procesamiento. El prefijo document_ se agrega a los parámetros de documento en el encabezado, y el prefijo transaction_ se agrega a los parámetros de transacción. Por ejemplo, document_SourceFileName. Si una transacción contiene documentos con parámetros idénticos en nombre pero diferentes en valor, el Warehouse enumerará todos los valores únicos de este parámetro separados por comas. Por ejemplo, todos los nombres de archivo dentro de una transacción.
Los datos preparados se almacenan durante 2 semanas después de que se complete la solicitud. Los datos obtenidos en formato CSV pueden analizarse posteriormente en cualquier herramienta de BI.

​
Recuperar una lista de solicitudes de informes

Para recuperar la lista de solicitudes de informes realizadas dentro de un período de tiempo determinado, realice una solicitud GET al siguiente endpoint, donde createdFrom y createdTo representan el intervalo de fechas y statusFilter es uno de los siguientes valores: New, Queued, Processing, Succeeded, Failed o Cancelled. Esto es útil en caso de extravío de identificadores de solicitud. 
GET {{baseUrl}}/api/reporting/v2/exports/transaction-steps?statusFilter=Succeeded&createdFrom=2025-11-05&createdTo=2025-11-17
La respuesta incluye una matriz de solicitudes de generación de informes. 
{
  "requests": [
    {
      "requestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "status": "Nuevo",
      "completedUtc": "2025-11-18T22:22:00.294Z",
      "createdUtc": "2025-11-18T22:20:49.294Z",
      "totalFileCount": "2",
      "filters": {
        "skillId": "d0e27b2d-bcc6-4129-bfd1-c1e37ee3efae",
        "startDate": "2025-11-03T17:19:54.386+00:00",
        "endDate": "2025-11-17T20:05:26.097+00:00"
      }
    },
    {
      "requestId": "48293032-5717-4562-b3fc-2c963f66afa6",
      "status": "Correcto",
      "completedUtc": "2025-12-18T22:22:00.294Z",
      "createdUtc": "2025-12-18T22:20:49.294Z",
      "totalFileCount": "4",
      "filters": {
        "skillId": "dk3ioda-bcc6-4129-bfd1-c1e37ee3efae",
        "startDate": "2025-11-03T17:19:54.386+00:00",
        "endDate": "2025-11-17T20:05:26.097+00:00"
      }
    }
  ]
}