GetBill

Devuelve una factura de proveedor: su cabecera, los expedientes y las órdenes de trabajo que cubre, las partidas asignadas a ella con sus impuestos, y su registro de acciones. Utilícelo después de GetBillList para leer cada factura de proveedor completa, por ejemplo para contabilizarla en su sistema contable una vez validada. Los campos son los de la página Factura de proveedor. Para crear una factura de proveedor, utilice SaveBill.

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

GET /api/v1/GetBill?ID=109827
Token: your-token

Parámetro	Obligatorio	Significado
ID	Sí	El identificador de la factura de proveedor, un número entero, como ID en GetBillList. Puede ser una factura de proveedor de cualquier empresa.

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
Una factura de proveedor tiene ese identificador.	Not found

Respuesta

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

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "ID": 109827,
    "BillNumber": "INV-2026-0042",
    "BillDate": "2026-10-01",
    "Received": "2026-10-02",
    "Status": "Validated",
    "EntID": 2214,
    "EntCode": "EXSHIP",
    "DueDate": "2026-10-31",
    "TaxDeduct": 0.0,
    "Currency": "USD",
    "Total": 1150.00,
    "Actual": 1150.00,
    "JobIDs": [31877, 31902],
    "WorkOrders": [205114, 205131],
    "AddedBy": "jsmith",
    "AddedOn": "2026-10-02T09:12:44.31",
    "ValidatedBy": "jsmith",
    "ValidatedOn": "2026-10-06T11:03:27.9",
    "Accounts": [
      {
        "AccID": 772318,
        "Name": "Trucking Mombasa to Nairobi",
        "LocalName": null,
        "Code": "TRK",
        "JobID": 31877,
        "Rate": 500.0000,
        "Qty": 2.0000,
        "Total": 1000.00,
        "Taxes": [
          { "TaxCode": "VAT", "FinCode": "VAT15", "Rate": 15.00 }
        ],
        "IntRemarks": null,
        "ExtRemarks": null,
        "Updated": "2026-10-03T10:21:05.6"
      }
    ],
    "Actions": [
      { "LogTime": "2026-10-02T09:12:44.47", "Action": "Bill Created", "Data": "...", "UserID": "jsmith" }
    ]
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
ID	El identificador de la factura de proveedor en TrakIT.
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.
Status	Submitted, Received, Validated, Finalised, Disputed o Rejected: consulte Cómo avanza una factura de proveedor en TrakIT.
EntID, EntCode	El identificador y el código de la entidad que envió la factura de proveedor. Consulte GetEntity.
DueDate	La fecha de vencimiento del pago, con el formato yyyy-MM-dd, o null.
TaxDeduct	La retención: el impuesto retenido del pago al proveedor. 0 cuando no la hay.
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: el total Allocated de los Importes de la factura de proveedor.
Actual	El importe que facturó el proveedor, impuestos incluidos: el total Billed.
JobIDs	Los identificadores de los expedientes de las partidas asignadas. Consulte GetJob.
WorkOrders	Los identificadores de las órdenes de trabajo de esos expedientes, salvo las canceladas. Consulte GetWO.
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.
Accounts	Las partidas asignadas a la factura de proveedor, en orden: consulte Partidas.
Actions	El registro de acciones de la factura de proveedor, empezando por la entrada más antigua: LogTime (UTC), Action, Data y el UserID de quien la realizó.

Partidas

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

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 de proveedor 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.
IntRemarks, ExtRemarks	Las observaciones internas y externas, o null.
Updated	Cuándo se modificó la partida por última vez, en UTC.

Notas

• El número de secuencia, el centro de beneficio, las observaciones, los ajustes y los pagos de la factura de proveedor no forman parte de la respuesta. El número de secuencia está en GetBillList. GetPaymentsByStatusDate lista los pagos, y GetTransaction muestra las facturas de proveedor que paga cada pago.