GetBillList

Lista las facturas de proveedor de un intervalo de fechas: las facturas que le han enviado sus proveedores y otras entidades, con su número, su estado, sus importes y sus expedientes. Utilícelo para recoger las facturas de proveedor que se han introducido, validado o finalizado desde su última llamada y, después, lea cada una completa con GetBill. Para saber qué significa cada estado, consulte Cómo avanza una factura de proveedor en TrakIT.

La lista contiene las facturas de proveedor de una sola empresa: la del campo Company del usuario de TrakIT que ha iniciado sesión (consulte Campos del usuario).

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

GET /api/v1/GetBillList?DateType=Validated&FromDate=2026-10-01&ToDate=2026-10-08
Token: your-token

Parámetro	Obligatorio	Significado
DateType	Sí	La fecha a la que se aplica el intervalo: BillDate, Added, Validated o Finalised. Las mayúsculas no importan. Consulte Intervalo de fechas.
FromDate	Sí	El inicio del intervalo, con el formato yyyy-MM-dd, o yyyy-MM-ddTHH:mm:ss para una hora. 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.

Intervalo de fechas

DateType	El intervalo se aplica a
BillDate	La fecha de la factura de proveedor, la fecha impresa en ella.
Added	Cuándo se introdujo la factura de proveedor en TrakIT, en UTC.
Validated	Cuándo se validó la factura de proveedor, en UTC. Las facturas de proveedor no validadas quedan fuera.
Finalised	Cuándo se finalizó la factura de proveedor, en UTC. Las facturas de proveedor no finalizadas quedan fuera.

Added, Validated y Finalised incluyen la hora. 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
DateType tiene un valor.	DateType is required
FromDate tiene un valor.	FromDate is required
ToDate tiene un valor.	ToDate is required
DateType es uno de los cuatro valores.	Invalid Date Type. Date Type must be one of the following: BillDate, Added, Validated, 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, de la fecha de factura más antigua a la más reciente, y RowsAffected es el número de facturas de proveedor que contiene. Cuando ninguna factura de proveedor coincide, la lista está vacía: Code sigue siendo 1 y RowsAffected es 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "ID": 109827,
      "BillNumber": "INV-2026-0042",
      "BillDate": "2026-10-01",
      "Received": "2026-10-02",
      "DueDate": "2026-10-31",
      "BillSeq": "HQ-2610-0042",
      "Status": "Validated",
      "EntID": 2214,
      "EntCode": "EXSHIP",
      "Currency": "USD",
      "Total": 1150.00,
      "BillActual": 1150.00,
      "TaxDeduct": null,
      "Disputed": false,
      "JobIDs": [31877, 31902],
      "AddedBy": "jsmith",
      "AddedOn": "2026-10-02T09:12:44.31",
      "ValidatedBy": "jsmith",
      "ValidatedOn": "2026-10-06T11:03:27.9"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
ID	El identificador de la factura de proveedor en TrakIT. Utilícelo con GetBill.
BillNumber	El número de factura del proveedor, en mayúsculas y sin espacios.
BillDate	La fecha de la factura, con el formato yyyy-MM-dd.
Received	La fecha en que se recibió la factura de proveedor, con el formato yyyy-MM-dd.
DueDate	La fecha de vencimiento del pago, con el formato yyyy-MM-dd, o null.
BillSeq	El número de secuencia de la factura de proveedor, el número que TrakIT le da cuando se valida, o null antes.
Status	Submitted, Received, Validated, Finalised, Disputed o Rejected.
EntID, EntCode	El identificador y el código de la entidad que envió la factura de proveedor. Consulte GetEntity.
Currency	La moneda de la factura de proveedor.
Total	El total de las partidas asignadas a la factura de proveedor, impuestos incluidos, en la moneda de la factura de proveedor.
BillActual	El importe que facturó el proveedor, impuestos incluidos.
TaxDeduct	La retención: el impuesto retenido del pago al proveedor, o null cuando no la hay.
Disputed	true cuando la factura de proveedor está marcada como en disputa.
JobIDs	Los identificadores de los expedientes de las partidas asignadas a la factura de proveedor. Vacío hasta que se asignan partidas. Consulte GetJob.
AddedBy, AddedOn	El identificador de usuario de quien introdujo la factura de proveedor, y cuándo, en UTC.
ValidatedBy, ValidatedOn	El identificador de usuario de quien validó la factura de proveedor, y cuándo, en UTC. null hasta que se valida.

BillActual y Total son los totales Billed y Allocated de los recuadros de Importes de la factura de proveedor.

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).