conecto. Get started
Purchasing

Plan when to pay a bill

purchasing_set_planned_date · Changes data · Markdown

Plans the day the business will pay a bill, so the cash flow forecast takes the money out then rather than on the due date.

Free

This tool costs nothing to call.

An example

We will pay the Nordstahl bill on November 10th, after the hotel pays us. Plan it for then.

Your agent callspurchasing_set_planned_dateFree

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",
  "date": "2026-11-10"
}
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-12",
    "planned_date": "2026-11-10",
    "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": "56f129f3-2149-40f4-bb47-b34e1ded9fd5",
    "payments": [],
    "file": {
      "file_id": "5846d0cf-deef-444d-aeb3-ab3aea5e9909",
      "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/5846d0cf-deef-444d-aeb3-ab3aea5e9909?t=eyJmIjoiNTg0NmQwY2YtZGVlZi00NDRkLWFlYjMtYWIzYWVhNWU5OTA5IiwiZXhwIjoxNzkyNjkyMjY0fQ:1xJafo:ir2_frnIrzQtRXkB1zlew4JDFCZ1ZaiB4t2Kw-yydok",
      "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)"
      }
    ]
  }
}

Use it when

The business pays a bill early or late on purpose, or waits for money to come in before paying.

What it does

The day the business means to pay a bill that is not paid yet, like Xero's planned date: the cash flow forecast (books_report cash_forecast) counts the payment on that day, even for a bill already overdue, which it otherwise leaves out. null clears it.

What comes back

bill: the bill with its planned_date (null when cleared). Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
bill_idRequiredstringThe bill_id purchasing_create_bill returned. Exactly 36 characters.
dateRequiredstring or nullYYYY-MM-DD, or null. Matches ^\d{4}-\d{2}-\d{2}$.

The call

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

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

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_owed409The bill is paid or void.Give the date to a bill not paid yet.
invalid_input400The date is not valid.Send it like 2026-11-10, or null to clear it.

More Purchasing tools

All 25 tools

Give this to your agent.

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