GetPaymentsByStatusDate

Lista los pagos de una empresa, el dinero que ha pagado a proveedores y otras entidades por sus facturas de proveedor, por estado: los borradores creados, los pagos aprobados o los pagos finalizados en un intervalo de fechas. Utilícelo para recoger los pagos aprobados o finalizados desde su última llamada y, después, lea cada uno, con las facturas de proveedor que paga, con GetTransaction. Los cobros, el dinero recibido por facturas, no se listan. Los pagos se describen en la página Cobro o pago.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

GET /api/v1/GetPaymentsByStatusDate?CompID=3&Status=Approved&FromDate=2026-10-01&ToDate=2026-10-08
Token: your-token

Parámetro	Obligatorio	Significado
CompID	Sí	El identificador de la empresa que realizó los pagos, un número entero.
Status	Sí	Draft, Approved o Finalised. Las mayúsculas no importan. Consulte Estado y fechas.
FromDate	Sí	El inicio del intervalo, con el formato yyyy-MM-dd, o yyyy-MM-ddTHH:mm:ss para una hora, en UTC. Incluido.
ToDate	Sí	El final del intervalo, con el mismo formato. Incluido. Como máximo 365 días después de FromDate.

Envíe las fechas con el formato yyyy-MM-dd o yyyy-MM-ddTHH:mm:ss: los demás formatos dependen de la configuración regional del servidor. Consulte Fechas.

Estado y fechas

Status elige a la vez los pagos y la fecha a la que se aplica el intervalo (para los estados, consulte Cómo avanza un cobro):

Status	Lista los pagos que están	El intervalo se aplica a
Draft	Todavía sin aprobar.	Cuándo se creó el pago.
Approved	Aprobados, y todavía sin finalizar.	Cuándo se aprobó el pago.
Finalised	Finalizados.	Cuándo se finalizó el pago.

Así, un pago se lista con un solo estado a la vez: un pago aprobado ya no aparece con Draft, y uno finalizado ya no aparece con Approved. Un pago que se restablece a borrador vuelve a aparecer con Draft.

Las fechas incluyen la hora, en UTC. Una fecha sin hora es el inicio de ese día, por lo que ToDate=2026-10-08 termina a la medianoche del inicio del 8 de octubre. Para incluir el día completo, envíe ToDate=2026-10-08T23:59:59 o el día siguiente.

Reglas

Regla	Info si no se cumple
El encabezado Token contiene un token válido.	Token missing in header, Token invalid or expired, u otra respuesta indicada en Token de inicio de sesión
El usuario es un administrador del sistema con acceso a la API.	API User must be SysAdmin with API Access
Status tiene un valor.	Status is required
FromDate tiene un valor.	FromDate is required
ToDate tiene un valor.	ToDate is required
CompID es mayor que 0.	CompID is invalid
Status es uno de los tres valores.	Invalid Status. Status must be one of the following: Draft, Approved, Finalised
FromDate es una fecha.	FromDate is not valid
ToDate es una fecha.	ToDate is not valid
ToDate no es anterior a FromDate.	ToDate must be later than FromDate
Las fechas tienen como máximo 365 días de diferencia.	Days between FromDate and ToDate cannot exceed 365

TrakIT quita los espacios de las fechas antes de leerlas, así que escriba la hora con la T: 2026-10-08 23:59:59 se rechaza.

Respuesta

Si tiene éxito, Code es 1, RetInfo es la lista, por orden de identificador, y RowsAffected es el número de pagos que contiene. Cuando ningún pago coincide, incluso cuando ninguna empresa tiene ese CompID, la lista está vacía: Code sigue siendo 1 y RowsAffected es 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    { "ID": 60218, "Date": "2026-10-06T00:00:00", "Curr": "USD", "Amount": 1150.00, "Seq": "HQ20260012" },
    { "ID": 60231, "Date": "2026-10-07T00:00:00", "Curr": "EUR", "Amount": 420.00, "Seq": "HQ20260013" }
  ],
  "RowsAffected": 2,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
ID	El identificador del pago. Utilícelo con GetTransaction.
Date	La Transaction Date del pago, como fecha y hora a medianoche.
Curr	La moneda del pago.
Amount	El importe pagado.
Seq	El Sequence Number del pago, asignado en la aprobación: el código de la empresa, el año y un número correlativo. null en un borrador.

Notas

• Envíe todos los parámetros: si falta alguno, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).