CreateBill

Crea una factura de proveedor con el estado Draft para el proveedor y la empresa de la clave de API. Adjunte la factura escaneada con uploadbillfile y, a continuación, envíela a la empresa con submitbill. El funcionamiento de las claves, las respuestas y los estados se describe en API de facturas de proveedor.

POST /api/public/createbill
APIKey: your-api-key
Content-Type: application/json

{
  "BillNumber": "INV-2026-0042",
  "BillDate": "2026-10-20",
  "CurrCode": "USD",
  "Amount": 1000.00,
  "Tax": 150.00
}

Campo	Obligatorio	Significado
`BillNumber`	Sí	El número de factura del proveedor. TrakIT lo guarda en mayúsculas, sin espacios.
`BillDate`	Sí	La fecha de la factura, con el formato `yyyy-MM-dd`.
`CurrCode`	Sí	La moneda de la factura, por ejemplo `USD`.
`Amount`	Sí	El importe sin impuestos.
`Tax`	No	El impuesto. El total de la factura es `Amount` + `Tax`.

El proveedor y la empresa proceden de la clave, por lo que la solicitud no los indica.

Reglas

Regla	`Info` si no se cumple
El número de factura es obligatorio y tiene 30 caracteres como máximo.	`Bill Number is required`, `Bill Number cannot exceed 30 characters`
Un número de factura solo se puede usar una vez por proveedor.	`Bill Number specified already exists for this entity and office`
La fecha de la factura es una fecha con el formato `yyyy-MM-dd`.	`BillDate must be a date as yyyy-MM-dd`
La fecha de la factura no es futura.	`Bill Date cannot be in the future`
La fecha de la factura no tiene más de 30 días.	`Bill Date cannot be older than 30 days`
La moneda es una de las monedas en las que factura la empresa.	`Select a currency that company bills in`
El importe es mayor que cero.	`Total Amount must be positive`
El impuesto no es negativo.	`Tax Amount cannot be negative`
El impuesto es como máximo una cuarta parte del total.	`Tax Amount cannot exceed 25% of Billed Amount`

La empresa puede tener sus propias comprobaciones adicionales para las nuevas facturas de proveedor. Sus mensajes llegan de la misma forma en Info.

Respuesta

Si tiene éxito, Identity es el identificador de la nueva factura de proveedor y RetInfo es la factura de proveedor, con el estado Draft.

{
  "Code": 1,
  "Info": "",
  "RetInfo": {
    "BillID": 109827,
    "BillNumber": "INV-2026-0042",
    "BillDate": "2026-10-20",
    "DueDate": null,
    "CurrCode": "USD",
    "Amount": 1000.00,
    "TaxAmount": 150.00,
    "Total": 1150.00,
    "AdjTotal": 0.00,
    "PaidAmount": 0.00,
    "Outstanding": 1150.00,
    "Status": "Draft",
    "Remarks": "",
    "FileCount": 0,
    "Company": "Example Logistics SL"
  },
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 109827
}

Si una solicitud agota el tiempo de espera, compruebe si se ha creado la factura de proveedor antes de volver a enviarla: véase Reintentos.