COconductor-is

Void a bill

Changed on

Voids a bill by setting its amount to zero while keeping a record of it in QuickBooks. The void will fail if the bill is currently in use or has any linked transactions that are in use.

post/quickbooks-desktop/bills/{id}/void

Request

Path parameters

idstring required

The QuickBooks-assigned unique identifier of the bill to void.

Example:123ABC-1234567890

Headers

Conductor-End-User-Idstring required

The ID of the End-User to receive this request.

Example:end_usr_1234567abcdefg

Response

Returns a confirmation of the void with the ID of the voided bill.

idstring required

The QuickBooks-assigned unique identifier of the voided bill.

objectType'qbd_bill' required

The type of object. This value is always "qbd_bill".

createdAtstring nullable required

The date and time when this bill was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.

updatedAtstring nullable required

The date and time when this bill was last updated, in ISO 8601 format (YYYY-MM-DDThh:mm:ss+hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.

refNumberstring nullable required

The case-sensitive user-defined reference number of the voided bill.

voidedboolean required

Indicates whether the bill was voided.

Example response

{
  "id": "123ABC-1234567890",
  "objectType": "qbd_bill",
  "createdAt": "2025-01-01T12:34:56+00:00",
  "updatedAt": "2025-02-01T12:34:56+00:00",
  "refNumber": "BILL-1234",
  "voided": true
}

Changes