Lista de operaciones
Lista las operaciones individuales dentro de los flujos. Se usa para conciliación operativa, trabajo de backoffice y seguimiento de cobros.
Paginado. Admite filtrado por UUID de operación, externalId, UUID del flujo padre, estado, tipo, ID externo de factura, rango de importe y rangos de fechas. Los resultados pueden ordenarse por createdAt, statusUpdatedAt, status, flowUuid, operationUuid, externalId, paymentAmount o invoiceExternalId.
Autorizaciones
Esquema de seguridad OAuth2
clientCredentials Flow
"/api/v2/auth/token""zertiban-api"Access to the API
Parámetros
Header Parameters
Identificador del tenant que contiene el UUID de la organización
"1f56c928-7621-44fe-8cda-c211fda0a828""uuid"Query Parameters
Tamaño de página
010010Desplazamiento (offset) desde cero
00Indica la propiedad por la que ordenar la lista de resultados (no distingue mayúsculas/minúsculas)
"operationUuid""externalId""status""flowUuid""createdAt""statusUpdatedAt""paymentAmount""invoiceExternalId""createdAt"Indica el sentido de la ordenación (no distingue mayúsculas/minúsculas)
"ASC""DESC""DESC"Filtra operaciones por UUID (coincidencia exacta)
"f47ac10b-58cc-4372-a567-0e02b2c3d479""uuid"Filtra operaciones por ID externo (coincidencia exacta)
"EXT-2025-0001"Filtra operaciones por UUID del flujo (coincidencia exacta)
"3fa85f64-5717-4562-b3fc-2c963f66afa6""uuid"Filtra operaciones por estado (no distingue mayúsculas/minúsculas). Admite 0, 1 o N valores separados por comas.
"OPENED""CREATED"Filtra operaciones por tipo (no distingue mayúsculas/minúsculas). Admite 0, 1 o N valores separados por comas.
"PAYMENT""SIGNATURE"Busca operaciones cuyo 'createdAt' sea posterior o igual a la fecha-hora indicada
"2025-03-10T14:23:45Z""ISO 8601"Busca operaciones cuyo 'createdAt' sea anterior o igual a la fecha-hora indicada
"2025-03-10T14:23:45Z""ISO 8601"Busca operaciones cuyo 'statusUpdatedAt' sea posterior o igual a la fecha-hora indicada
"2025-03-10T14:23:45Z""ISO 8601"Busca operaciones cuyo 'statusUpdatedAt' sea anterior o igual a la fecha-hora indicada
"2025-03-10T14:23:45Z""ISO 8601"Filtra operaciones PAYMENT cuyo importe sea mayor o igual que este valor
1000Filtra operaciones PAYMENT cuyo importe sea menor o igual que este valor
5000Filtra operaciones PAYMENT por ID externo de la factura (coincidencia exacta)
"INV-2025-0012"Filtra las operaciones por el origen de canal del flujo al que pertenecen (no distingue mayúsculas):
DIRECT para flujos creados directamente por la organización, COLLABORATOR para flujos creados
en nombre de la organización por un colaborador delegado. Incompatible con q_collaboratorUuid y/o
q_collaboratorLegalName cuando vale DIRECT, ya que un flujo directo no tiene atribución de
colaborador.
Este filtro se combina (AND) con el aislamiento de canal de quien llama: un llamante colaborador
solo ve las operaciones de los flujos atribuidos a su propio canal, por lo que DIRECT siempre
devuelve una lista vacía para llamantes colaboradores.
"DIRECT""COLLABORATOR""COLLABORATOR"Filtra las operaciones cuyo flujo propietario está atribuido a este UUID de colaborador
(coincidencia exacta, FLOWS.COLLABORATOR_BUSINESS_UUID). Solo selecciona operaciones de flujos
originados por colaborador (COLLABORATOR). No puede combinarse con q_origin=DIRECT (400).
"7f70e314-32d7-49eb-9721-1f986574f912""uuid"Filtra las operaciones cuyo flujo propietario tiene una razón social de colaborador que contiene
este valor (coincidencia parcial sin distinguir mayúsculas sobre la razón social capturada en la
creación del flujo, FLOWS.COLLABORATOR_LEGAL_NAME). Solo selecciona operaciones de flujos
originados por colaborador (COLLABORATOR). No puede combinarse con q_origin=DIRECT (400).
"Gestoria Perez SL"Respuestas
Lista de operaciones