Ir al contenido

GetInvoice

Devuelve una factura, una nota de cargo o una factura rectificativa: su cabecera, las partidas que factura con sus impuestos, y su registro de acciones. Utilícelo después de GetInvoiceList para leer cada factura completa, por ejemplo para contabilizarla en su sistema contable una vez aprobada. Los campos son los de la página Factura.

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

GET /api/v1/GetInvoice?ID=48211
Token: your-token
Parámetro Obligatorio Significado
ID Sí El identificador de la factura, un número entero, como ID en GetInvoiceList. Puede ser una factura de cualquier empresa.
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
Una factura, una nota de cargo o una factura rectificativa tiene ese identificador. Not found

Si tiene éxito, Code es 1 y RetInfo es la factura. RowsAffected y Identity son 0.

{
"Code": 1,
"Info": "",
"RetInfo": {
"ID": 48211,
"InvNum": "INV-2026-0042",
"InvDate": "2026-10-05T00:00:00",
"Type": "I",
"Status": "Approved",
"EntID": 1187,
"EntCode": "EXTRADE",
"CreditDays": 30,
"PFCount": 2,
"TaxExempt": null,
"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",
"RefInvID": 0,
"Accounts": [
{
"AccID": 772305,
"Name": "Ocean Freight 40HC",
"LocalName": null,
"Code": "OFRT",
"JobID": 31877,
"Rate": 2000.0000,
"Qty": 1.0000,
"Total": 2000.00,
"Taxes": [
{ "TaxCode": "VAT", "FinCode": "VAT18", "Rate": 18.00 }
],
"WOID": 205114,
"IntRemarks": null,
"ExtRemarks": "Shanghai to Mombasa",
"Updated": "2026-10-02T08:40:51.27"
}
],
"Actions": [
{ "LogTime": "2026-10-04T14:02:10.43", "Action": "Proforma Generated", "Data": "...", "UserID": "jsmith" }
]
},
"RowsAffected": 0,
"Scalar": null,
"Identity": 0
}
Campo Significado
ID El identificador de la factura en TrakIT.
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, como fecha y hora a medianoche.
Type I para una factura, D para una nota de cargo, C para una factura rectificativa.
Status Draft, Approved, Finalised, Cancelled o Written Off: consulte Estados. Una factura que TrakIT muestra como Reversed conserva aquí su estado Approved o Finalised.
EntID, EntCode El identificador y el código de la entidad facturada. Consulte GetEntity.
CreditDays El número de días que tiene el cliente para pagar, el Credit Period de la factura, o null.
PFCount Cuántas facturas proforma se han generado.
TaxExempt Los códigos financieros de los impuestos de los que está exenta la factura, separados por comas, o null.
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 0 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.
RefInvID En una factura rectificativa emitida contra una factura, el identificador de esa factura. Si no, 0.
Accounts Las partidas facturadas, en el orden en que aparecen en la factura: consulte Partidas.
Actions El registro de acciones de la factura, empezando por la entrada más antigua: LogTime (UTC), Action, Data y el UserID de quien la realizó.

Cada elemento de Accounts es una línea de la pestaña Accounts de la factura:

Campo Significado
AccID El identificador de la partida.
Name El nombre de la partida, seguido del detalle de la línea.
LocalName El Local Name de la partida, o null.
Code El Account Code de la partida.
JobID El identificador del expediente de la partida, o 0.
Rate El importe por unidad. Está en la moneda de la factura cuando la partida tiene un importe en esa moneda; si no, es el importe de la partida en la moneda de su expediente.
Qty La cantidad.
Total Qty por Rate, redondeado a 2 decimales, antes de impuestos.
Taxes Los impuestos de la partida, cada uno con su TaxCode, su FinCode (código financiero) y su Rate en porcentaje. Consulte Country Taxes.
WOID El identificador de la orden de trabajo de la partida, o null. Consulte GetWO.
IntRemarks, ExtRemarks Las observaciones internas y externas, o null.
Updated Cuándo se modificó la partida por última vez, en UTC.
  • 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.
  • Los ajustes y los cobros recibidos no forman parte de la respuesta.