conecto. Get started
Purchasing

Change a bill's file, notes or due date

purchasing_update_bill · Changes data · Markdown

Adds a recorded bill's PDF if it has none, or changes its notes or due date; amounts and the PDF it has never change.

$0.01 a call

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

An example

Nordstahl agreed we can pay their bill two weeks later, on November 27.

Your agent callspurchasing_update_bill$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
{
  "bill_id": "3c5e7a9b-1d2f-4a6c-8e0b-4d6f8a1c3e5b",
  "due_date": "2026-11-27"
}
What comes back
{
  "bill": {
    "bill_id": "3c5e7a9b-1d2f-4a6c-8e0b-4d6f8a1c3e5b",
    "supplier": {
      "supplier_id": 4101,
      "name": "Nordstahl Küchentechnik GmbH"
    },
    "reference": "NS-2026-1188",
    "status": "open",
    "overdue": false,
    "days_overdue": 0,
    "currency": "EUR",
    "issue_date": "2026-10-13",
    "due_date": "2026-11-27",
    "total": "462.50",
    "amount_paid": "0.00",
    "balance": "462.50",
    "order": "PO-0001",
    "lines": [
      {
        "description": "GN 1/1 pan, steel, 65 mm",
        "sku": "GN-PAN-11",
        "account": null,
        "quantity": "25",
        "unit_cost": "18.5",
        "tax_rate": "0",
        "amount": "462.50",
        "tax": "0.00",
        "order_line": 1
      }
    ],
    "subtotal": "462.50",
    "tax": "0.00",
    "tax_treatment": null,
    "order_id": "6b68a965-26fd-4556-bd2e-8e0e5218d217",
    "payments": [],
    "file": {
      "file_id": "1d21719f-e8df-43c2-bd3a-2f034c85d680",
      "name": "NS-2026-1188.pdf",
      "content_type": "application/pdf",
      "size": "1.1 KB",
      "size_bytes": 1147,
      "sha256": "24cfafaca922f96f27862a78624077499c6933a1caf04ba986e83cc228a836c3",
      "created_at": "2026-10-14T08:00:00+00:00",
      "download_url": "https://cncto.co/d/1d21719f-e8df-43c2-bd3a-2f034c85d680?t=eyJmIjoiMWQyMTcxOWYtZThkZi00M2MyLWJkM2EtMmYwMzRjODVkNjgwIiwiZXhwIjoxNzkyNDgxMDUzfQ:1xIhjB:NUqWs9ocVKFE_NUxH5sXXLGHi7odm5jhe5uOt0TtR7Y",
      "link_expires_in_hours": 24
    },
    "notes": null,
    "books_entry": 1,
    "void_reason": null,
    "history": [
      {
        "at": "2026-10-14T08:00:00+00:00",
        "event": "recorded",
        "detail": "Pip",
        "by": "key 4101 (Pip)"
      },
      {
        "at": "2026-10-14T08:00:00+00:00",
        "event": "changed",
        "detail": "due_date",
        "by": "key 4101 (Pip)"
      }
    ]
  }
}

Use it when

The supplier agreed to a later due date, or the PDF arrived later.

What it does

What can change on a recorded bill: its PDF while it has none (file_id), its notes, and its due date while it is owed. The PDF it has stays, as a received invoice is kept as it came, and its amounts never change: for either, void it and record it again.

What comes back

bill: the bill as it now is. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
bill_idRequiredstringThe bill_id purchasing_create_bill returned. Exactly 36 characters.
file_idstring or nullExactly 36 characters.
notesstringUp to 5,000 characters.
due_datestringYYYY-MM-DD. Matches ^\d{4}-\d{2}-\d{2}$.

The call

Over MCP, call purchasing_update_bill on https://api.conecto.chat/mcp/purchasing. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/purchasing_update_bill \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bill_id":"3c5e7a9b-1d2f-4a6c-8e0b-4d6f8a1c3e5b","due_date":"2026-11-27"}'

When it refuses

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

CodeWhenWhat to do
not_found404No bill of the business has that bill_id.Find it with purchasing_list_bills.
not_found404The file is not in the store.Upload it with files_upload first.
invalid_input400Nothing to change was given, or the date is not valid.Send file_id, notes or due_date.
bill_paid409The bill is paid, so its due date no longer matters.Nothing to change.
bill_void409The bill is void.Nothing to change.
file_kept409The bill has a PDF, which stays: a received invoice is kept as it came.If it is the wrong file, void the bill and record it again with the right one.

More Purchasing tools

All 25 tools

Give this to your agent.

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