Skip to content
Guía del Centro de ayuda
4 min de lecturaVerificado 2026-11-16

Exportación de datos e informes

Descarga listados filtrados en CSV, programa cargas automáticas FTP/SFTP o consulta reportes vía API.

En esta guía

Descripción General

Passinstance ofrece endpoints de exportación de datos por transmisión en cada dominio operativo principal, incluidas las instancias de pases (POST /api/v1/passes/export), historiales de escaneo de validación, claves de dispositivos de escáner, informes ejecutivos del panel, facturas fiscales con IVA, archivos de interesados del RGPD y registros de auditoría de cumplimiento (GET /api/v1/audit-log/export.csv o en el Panel en /settings/workspace/developer/audit-logs). Todas las exportaciones están estrictamente delimitadas a su espacio de trabajo autenticado (Customer) y se transmiten con encabezados MIME estándar para su consumo inmediato por software de hojas de cálculo, canalizaciones ERP o sistemas SIEM.

Arquitectura de Exportación de Datos Multidominio

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
MOTOR DE EXPORTACIÓN Y CUMPLIMIENTO EN STREAMING
ETAPA 01 CAPA DE SOLICITUD DE CLIENTE Y AUTOMATIZACIÓN
Interfaz Export. Panel
(Vistas Filtradas)
Trabajo BI / ERP Prog.
(x-api-key / Bearer)
Cumplimiento y Legal
(DSR RGPD y Audit.)
ETAPA 02 CONTROLADORES DE EXPORTACIÓN DE PASSINSTANCE (API)
Exportaciones Operativas (CSV UTF-8)
POST/api/v1/passes/export
GET/api/v1/validation/scans/*
GET/api/v1/dashboards/export
Exportaciones Financieras y Cumpl.
GET/api/v1/billing/invoices/*
POST .../data-subject-export
GET/api/v1/audit-log/export.csv
ETAPA 03 FORMATOS DE SALIDA Y DESTINOS
text/csv; charset=utf8
Filas Escapadas RFC4180 (Pases, Escaneos,Claves)
application/pdf
Facturas Fiscales Det. e Instantáneas Panel
application/json
Archivos RGPD y
JSON del Panel

Importante: Los archivos CSV y JSON exportados suelen contener Información de Identificación Personal (PII) de los titulares de pases, como nombres, direcciones de correo electrónico, valores externalId e historiales de transacciones. Almacene y depure siempre las exportaciones descargadas de acuerdo con las políticas de retención de Privacidad de Datos y RGPD de su organización.

Catálogo Completo de Endpoints de Exportación

Instancias de Pases
POST
Ruta del Endpoint
/api/v1/passes/export
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Transmite filas CSV (passes-export.csv) para una lista explícita de hasta 2000 UUID (request payload: { passIds, format: "csv" }).
Historial de Escaneos de Config.
GET
Ruta del Endpoint
/api/v1/validation/configs/:id/scans/export
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Exporta eventos de escaneo y canjes de mecánicas delimitados a una única ScannerConfiguration.
Escaneos del Espacio
GET
Ruta del Endpoint
/api/v1/validation/scans/export
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Exporta el historial de escaneos de validación de todo el espacio de trabajo en todas las configuraciones.
Registro de Auditoría de Escaneos
GET
Ruta del Endpoint
/api/v1/validation/scan-results/export/csv
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Registro de auditoría completo y detallado de los resultados de escaneo, incluidos decision, reasonCode, ID de operador y efectos en el saldo.
Claves de Dispositivos de Escáner
GET
Ruta del Endpoint
/api/v1/validation/configs/:id/scanner-keys/export/csv
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Inventario de claves de escáner emitidas, estados de vinculación, fechas de vencimiento y metadatos de telemetría del dispositivo.
Resumen del Panel
GET
Ruta del Endpoint
`/api/v1/dashboards/export?format=csv\
Verbo HTTP
json\
Formatos de Salida (Content-Type)
pdf`
Salida de Trabajo por Lotes
GET
Ruta del Endpoint
/api/v1/batch-processing/:id/result.csv
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Descarga las filas de salida procesadas de un trabajo asíncrono de creación o actualización por lotes.
Facturas de Facturación
GET
Ruta del Endpoint
/api/v1/billing/invoices/:id/download
Formatos de Salida (Content-Type)
application/pdf
Descripción
Transmite el PDF oficial de la factura fiscal/IVA detallada para un ciclo de facturación específico.
Interesado del RGPD
POST
Ruta del Endpoint
/api/v1/customer/:customerId/privacy-settings/data-subject-export
Formatos de Salida (Content-Type)
application/json
Descripción
Genera una carga útil estructurada de portabilidad conforme a los artículos 15 y 20 del RGPD (IDataSubjectExportPayload) que coincide con request payload.query.
Registro de Auditoría de Seguridad
GET
Ruta del Endpoint
/api/v1/audit-log/export.csv
Formatos de Salida (Content-Type)
text/csv; charset=utf-8
Descripción
Exporta hasta 1000 filas de actividad administrativa inmutable (admite action, entityType, userId, startDate, endDate, customerId).

Ejemplos de Uso de la API

1. Exportación CSV de Instancias de Pases (POST /api/v1/passes/export)

Consulte los UUID de los pases coincidentes mediante GET /api/v1/passes o POST /api/v1/passes/query-builder y, a continuación, transmítalos como passes-export.csv mediante POST /api/v1/passes/export (request payload requiere entre 1 y 2,000 UUID en passIds y "format": "csv"):

HTTP
POST /api/v1/passes/export HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "passIds": [
    "55a19c88-102b-4f33-8d99-ccddff001122",
    "77b20d99-304c-4a11-9e00-112233445566"
  ],
  "format": "csv"
}

Encabezados de Respuesta y CSV Transmitido (200 OK)

HTTP
HTTP/1.1 200 OK
Content-Type: text/csv; charset=utf-8
Content-Disposition: attachment; filename="passes-export.csv"
CSV
id,serialNumber,externalId,status,walletPlatform,activeRegistrations,firstName,email,tier,pointsBalance,createdAt
55a19c88-102b-4f33-8d99-ccddff001122,PI-2026-994812,CRM-88210,ACTIVE,APPLE_WALLET,2,Elena,elena@example.com,GOLD,1450,2026-10-14T09:15:22.000Z
77b20d99-304c-4a11-9e00-112233445566,PI-2026-994815,CRM-88219,ACTIVE,GOOGLE_WALLET,1,Marcus,marcus@example.com,GOLD,980,2026-10-18T14:40:05.000Z

2. Exportaciones CSV del Registro de Auditoría de Escaneos y del Registro de Auditoría de Seguridad

Exporte los resultados de escaneo o los registros de auditoría administrativa para el cumplimiento normativo y la conciliación financiera:

HTTP
GET /api/v1/validation/scan-results/export/csv?startDate=2026-11-01T00:00:00.000Z&endDate=2026-11-16T23:59:59.999Z&decision=SUCCESS HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
HTTP
GET /api/v1/audit-log/export.csv?startDate=2026-11-01T00:00:00.000Z&endDate=2026-11-16T23:59:59.999Z HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>

3. Exportación de Portabilidad del Interesado según el RGPD (request payload)

Cuando un titular de pase envía una Solicitud de Acceso del Interesado (DSAR) verificada, pase una única consulta query de búsqueda de 3 a 256 caracteres (como dirección de correo electrónico, número de serie o externalId) a Privacy Compliance API:

HTTP
POST /api/v1/customer/cus_89a12b34-56c7-4d89-9e01-23456789abcd/privacy-settings/data-subject-export HTTP/1.1
Host: api.passinstance.com
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "query": "elena@example.com"
}
JSON
{
  "exportedAt": "2026-11-16T10:34:10.000Z",
  "workspaceId": "cus_89a12b34-56c7-4d89-9e01-23456789abcd",
  "queryLength": 17,
  "totalCount": 2,
  "groups": [
    {
      "resourceType": "passes",
      "items": [
        {
          "id": "55a19c88-102b-4f33-8d99-ccddff001122",
          "identifier": "PI-2026-994812",
          "createdAt": "2026-10-14T09:15:22.000Z",
          "updatedAt": "2026-11-16T08:42:11.000Z",
          "source": "api",
          "processingPurpose": "loyalty_program",
          "retentionStatus": "ACTIVE",
          "relatedResourceIds": ["scn_019331f4-8e2a-7b00-9c11-44a8e2019b3c"]
        }
      ]
    }
  ]
}

Documentación Relacionada

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.