Add or change a supplier

purchasing_save_supplier · Changes data · Markdown

Adds a supplier or changes one: contact, email for orders, address, currency, payment terms and the book account their bills go to.

$0.01 a call

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

Add Kühlmann in Bremen as a supplier. They bill in euros with 30 days to pay, and their bills are cost of goods.

Your agent callspurchasing_save_supplier$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

{
  "name": "Kühlmann Kältetechnik",
  "contact_name": "Birte Albers",
  "email": "orders@kuehlmann-kaelte.example",
  "address": "Am Speicher 12\n28217 Bremen\nGermany",
  "currency": "EUR",
  "terms_days": 30,
  "account": "5000"
}

What comes back

{
  "supplier": {
    "supplier_id": 4101,
    "name": "Kühlmann Kältetechnik",
    "contact_name": "Birte Albers",
    "email": "orders@kuehlmann-kaelte.example",
    "phone": null,
    "address": "Am Speicher 12\n28217 Bremen\nGermany",
    "tax_id": null,
    "currency": "EUR",
    "terms_days": 30,
    "account": "5000",
    "notes": null,
    "iban": null,
    "bic": null,
    "country": null,
    "archived": false
  },
  "created": true
}

Use it when

The business buys from someone new, or a supplier's details change.

What it does

Add a supplier, matched by name (any case), or change one by supplier_id (name then renames it): contact name, email (purchase orders are emailed there), phone, address, tax ID, the currency they bill in (default: the books' or the invoice profile's), payment terms in days (their bills fall due that long after their date; default 30), and account: the book account code their bills' lines go to by default (an expense or asset account, e.g. "6600"). iban and bic are where the business pays them: new or changed bank details always wait for a person other than the one asking (approval_required), because a changed account is how invoice fraud takes payments. Give only what changes. Archived suppliers take no new orders or bills.

What comes back

supplier: its supplier_id, name, contact, email, phone, address, tax ID, currency, terms, account, notes, IBAN and BIC, and archived; and created. New or changed bank details first answer approval_required: a person other than the one asking approves them. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`name`	string	1 to 200 characters.
`supplier_id`	integer	At least 1.
`contact_name`	string	Up to 120 characters.
`email`	string	Up to 254 characters.
`phone`	string	Up to 60 characters.
`address`	string	Postal address, one line per row. Up to 1,000 characters.
`tax_id`	string	Up to 60 characters.
`currency`	string	ISO 4217, e.g. "EUR". Matches ^[A-Za-z]{3}$.
`terms_days`	integer	0 to 365.
`account`	string	A book account code, e.g. "6600"; "" clears it. Up to 20 characters.
`notes`	string	Up to 5,000 characters.
`iban`	string	Their IBAN; spaces are fine. Up to 42 characters.
`bic`	string	Up to 11 characters.
`country`	string	Where they are, ISO 3166-1 like "FR": tells reverse-charge bills apart. Up to 2 characters.
`archived`	boolean

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/purchasing_save_supplier \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Kühlmann Kältetechnik","contact_name":"Birte Albers","email":"orders@kuehlmann-kaelte.example","address":"Am Speicher 12\n28217 Bremen\nGermany","currency":"EUR","terms_days":30,"account":"5000"}'

When it refuses

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

Code	When	What to do
`not_found`404	No supplier of the business has that supplier_id or name.	Call purchasing_list_suppliers, or add the supplier with purchasing_save_supplier.
`invalid_input`400	A date or currency is not valid.	Send dates like 2026-11-02 and currencies like EUR.
`not_found`404	The account is not an open expense or asset account of the books.	Pick a code from books_list_accounts.
`name_taken`409	A supplier has that name already.	Change that supplier by its supplier_id instead.

More Purchasing tools

All 25 tools

Give this to your agent.

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

Add or change a supplier

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Purchasing tools

Give this to your agent.