Documentation

Update or Delete Invoice

Table of Contents

Update a current invoice or deactivate it. The API key user needs invoice editing permission. Changes that affect paid or partially paid status can require payment permissions as well. Check allowed_statuses and can_delete on the invoice returned by Get Invoice.

POST /invoices/{invoice_id}

Path Parameters

Parameter Type Required Description
invoice_id string Yes QReserve ID of the invoice.

Update an Invoice

Send the fields you want to change. These are common fields.

Parameter Type Required Description
bill_to_user_id string or null No Set the billed user. Use null to clear the billed user.
bill_to_name, bill_to_email, bill_to_address string No Invoice recipient details.
bill_to_account_number, purchase_order_number string No Account and purchase order references.
invoice_name, invoice_address string No Issuer details displayed on the invoice.
invoice_number, invoice_number_prefix string No Invoice number and prefix.
invoice_date, due_date string No Invoice and due dates (YYYY-MM-DD).
billing_period_start, billing_period_end string No Billing period dates (YYYY-MM-DD).
memo, payment_instructions, internal_note string No Invoice text, payment instructions, or internal note.
status string No New invoice or quote status. Use an allowed transition for the current invoice.
status_detail string No Additional status information.
currency_code string No Currency code such as CAD.
per_item_tax boolean No Calculate tax per line item.
items array of objects No The complete line-item list, ordered by each item’s integer position.

If you include items, send every line item you want to retain, with its current invoice_item_id and field values. Omitted line items are removed. For a new line item, omit invoice_item_id and provide position and the applicable fields, such as item, description, sku, units, and unit_rate. Use decimal strings such as "25.00" for unit rates. Omit items entirely to leave line items as they are.

Example Update

curl -X POST 'https://api.qreserve.com/invoices/INVOICE_ID' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"due_date":"2026-11-30","purchase_order_number":"PO-1042"}'

Delete an Invoice

Send {"delete": true}. QReserve deactivates the invoice. Deleting an invoice with a successful payment requires payment void permission. Deleting an invoice marked paid or partially paid also requires payment recording permission.

curl -X POST 'https://api.qreserve.com/invoices/INVOICE_ID' \
  -H 'Authorization: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"delete":true}'

Response

An update returns the current invoice in data. A delete returns a success response without an invoice object. If the API rejects a stale invoice version, retrieve the invoice again before retrying the change.

{
  "status": "success",
  "data": {
    "invoice_id": "INVOICE_ID",
    "due_date": "2026-11-30",
    "purchase_order_number": "PO-1042"
  }
}

See the Invoices API overview for shared IDs and permissions.