conecto. Get started
Invoices

Void a quote or invoice

invoices_void · Deletes data · Markdown

Voids a document: a sent one keeps its number but can no longer be paid or accepted; a draft is discarded.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

An example

Void the invoice for Café Lotte. They cancelled the order.

Your agent callsinvoices_void$0.01 a call

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "invoice_id": "2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f",
  "reason": "Order cancelled by the customer"
}
What comes back
{
  "invoice": {
    "invoice_id": "2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f",
    "kind": "invoice",
    "number": "INV-0042",
    "status": "void",
    "currency": "EUR",
    "issue_date": "2026-10-14",
    "due_date": "2026-10-28",
    "overdue": false,
    "days_overdue": 0,
    "customer": {
      "contact_id": null,
      "company_id": null,
      "name": "Hotel Elbblick GmbH",
      "email": "lukas.meyer@hotel-elbblick.example",
      "address": "Elbchaussee 120\n22763 Hamburg",
      "tax_id": "",
      "country": null
    },
    "total": "13887.30",
    "total_formatted": "€13,887.30",
    "amount_paid": "0.00",
    "balance": "13887.30",
    "balance_formatted": "€13,887.30",
    "public_url": null,
    "created_at": "2026-10-14T08:00:00+00:00",
    "sent_at": "2026-10-14T08:00:00+00:00",
    "credited": "0.00"
  },
  "note": "INV-0042 stays used, so the numbers have no gap."
}

Use it when

A quote or a draft is no longer wanted, or an invoice was numbered by mistake and never reached the customer.

What it does

Void a document. A sent one keeps its number (numbers stay gapless) but can no longer be paid, accepted or viewed; a draft is simply discarded. Refused while payments are recorded on it, on an invoice with credit notes and on a credit note (correct those with another credit note or a new invoice), and on an invoice that may be in the customer's hands (emailed, opened, or its PDF downloaded through a link): that one is cancelled with a credit note for all of it, as the law asks. An invoice posted to the books is reversed there.

What comes back

The document, now void. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
invoice_idRequiredstringThe invoice_id invoices_create returned (quotes and credit notes have one too). Exactly 36 characters.
reasonstringUp to 500 characters.

The call

Over MCP, call invoices_void on https://api.conecto.chat/mcp/invoices. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/invoices_void \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"invoice_id":"2d9c4e7b-1a3f-4c5d-8e6f-0b1a2c3d4e5f","reason":"Order cancelled by the customer"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No quote or invoice of the business has that invoice_id.Find it with invoices_list and use its invoice_id.
already_void409It is void already.Nothing to do.
has_payments409Payments are recorded on it.Record a refund (a negative payment) first if the money went back.
already_converted409The quote became an invoice.Void that invoice instead.
not_voidable409It is a credit note, which stays once issued.To charge the customer again, send a new invoice.
has_credit_notes409The invoice has credit notes.Credit what is left of it with invoices_create_credit_note.
reached_customer409The invoice was emailed to the customer, opened on its page or its PDF downloaded through a link, so voiding it could leave them an invoice whose VAT is still owed.Cancel it with invoices_create_credit_note (no lines or amount: all of it), which they get too.
before_start409The date is before the books start.Use a later date, or set an earlier start with books_setup.
period_locked409The books are locked for that date.Use a later date, or unlock the period with books_lock.
no_role409The books have no account for a role the posting needs.Give an account that role with books_save_accounts.

More Invoices tools

All 24 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md