Skip to main content
POST
/
quickbooks-desktop
/
invoices
/
{id}
/
void
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});

const response = await conductor.qbd.invoices.void('123ABC-1234567890', {
  conductorEndUserId: 'end_usr_1234567abcdefg',
});

console.log(response.id);
{
  "id": "123ABC-1234567890",
  "objectType": "qbd_invoice",
  "createdAt": "2025-01-01T12:34:56.000Z",
  "updatedAt": "2025-02-01T12:34:56.000Z",
  "refNumber": "INV-1234",
  "voided": true
}

Authorizations

​
Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

​
Conductor-End-User-Id
string
required

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

Example:

"end_usr_1234567abcdefg"

Path Parameters

​
id
string
required

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

Example:

"123ABC-1234567890"

Body

application/json

The body is of type object.

Response

200 - application/json

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

​
id
string
required

The QuickBooks-assigned unique identifier of the voided invoice.

Example:

"123ABC-1234567890"

​
objectType
string
required

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

Allowed value: "qbd_invoice"
Example:

"qbd_invoice"

​
createdAt
string | null
required

The date and time when this invoice 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.

Example:

"2025-01-01T12:34:56.000Z"

​
updatedAt
string | null
required

The date and time when this invoice 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.

Example:

"2025-02-01T12:34:56.000Z"

​
refNumber
string | null
required

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

Example:

"INV-1234"

​
voided
boolean
required

Indicates whether the invoice was voided.

Example:

true