GetInvoiceList

Lista las facturas, notas de cargo y facturas rectificativas de un intervalo de fechas, con su número, su estado, su cliente, su total y sus expedientes. Utilícelo para recoger las facturas que se han creado, aprobado o finalizado desde su última llamada y, después, lea cada una completa con GetInvoice. Para saber qué significa cada estado, consulte Estados en la página de la factura.

La lista contiene las facturas 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/GetInvoiceList?DateType=Approved&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: InvDate, Created, Approved 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
InvDate	La fecha de la factura.
Created	Cuándo se creó la factura, en UTC.
Approved	Cuándo se aprobó la factura, en UTC. Las facturas que todavía no están aprobadas quedan fuera.
Finalised	Cuándo se finalizó la factura, en UTC. Las facturas que todavía no están finalizadas quedan fuera.

Created, Approved 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: InvDate, Created, 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, de la fecha de factura más antigua a la más reciente, y RowsAffected es el número de facturas que contiene. Cuando ninguna factura coincide, la lista está vacía: Code sigue siendo 1 y RowsAffected es 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "ID": 48211,
      "InvNum": "INV-2026-0042",
      "InvDate": "2026-10-05",
      "Type": "I",
      "Status": "Approved",
      "EntID": 1187,
      "EntCode": "EXTRADE",
      "Currency": "USD",
      "Total": 2360.00,
      "JobIDs": [31877],
      "DocID": 90412,
      "CreatedBy": "jsmith",
      "CreatedOn": "2026-10-02T08:41:12.5",
      "ApprovedBy": "jsmith",
      "ApprovedOn": "2026-10-05T07:15:03.18"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
ID	El identificador de la factura en TrakIT. Utilícelo con GetInvoice.
InvNum	El número de la factura. Un borrador tiene un número de proforma, como PF00123-1, hasta que se aprueba.
InvDate	La fecha de la factura, con el formato yyyy-MM-dd.
Type	I para una factura, D para una nota de cargo, C para una factura rectificativa.
Status	Draft, Approved, Finalised, Cancelled o Written Off. Una factura que TrakIT muestra como Reversed, porque se ha emitido una factura rectificativa contra ella, conserva aquí su estado Approved o Finalised.
EntID, EntCode	El identificador y el código de la entidad facturada, normalmente el cliente. Consulte GetEntity.
Currency	La moneda de la factura.
Total	El total de la factura, impuestos incluidos.
JobIDs	Los identificadores de los expedientes facturados: su expediente o, en una factura que no es de un solo expediente, los expedientes de sus partidas. Consulte GetJob.
DocID	El identificador del PDF de la factura entre los documentos financieros, o null cuando no tiene.
CreatedBy, CreatedOn	El identificador de usuario de quien creó la factura, y cuándo, en UTC.
ApprovedBy, ApprovedOn	El identificador de usuario de quien aprobó la factura, y cuándo, en UTC. null hasta que se aprueba.

Notas

• El número y la fecha de un borrador todavía pueden cambiar: su fecha pasa a la de hoy cada vez que se abre, y recibe su número definitivo cuando se aprueba. Vuelva a leer la factura una vez aprobada.
• Las facturas canceladas también se listan. Filtre por Status si no las quiere.
• 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).