conecto. Get started
Invoices

Get the business details

invoices_get_profile · Reads only · Markdown

The business details on quotes and invoices, the next numbers, and what is missing before documents can be sent.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What details are printed on our invoices, and what number does the next one get?

Your agent callsinvoices_get_profileFree*

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
{}
What comes back
{
  "profile": {
    "legal_name": "Hansen & Voss GmbH",
    "address": "Billbrookdeich 112\n22113 Hamburg\nGermany",
    "tax_id": "DE123456789",
    "email": "billing@hansenvoss.example",
    "phone": "+49 40 66969 100",
    "logo": null,
    "currency": "EUR",
    "payment_terms_days": 14,
    "quote_valid_days": 30,
    "invoice_prefix": "INV-",
    "quote_prefix": "Q-",
    "credit_note_prefix": "CN-",
    "next_invoice_number": 42,
    "next_quote_number": 1,
    "next_credit_note_number": 1,
    "next_invoice": "INV-0042",
    "next_quote": "Q-0001",
    "next_credit_note": "CN-0001",
    "tax_rate": "19",
    "tax_label": "VAT",
    "footer": "Please pay by bank transfer to Hansen & Voss GmbH\nIBAN DE89 3704 0044 0532 0130 00, BIC COBADEFFXXX",
    "payment_link": null,
    "pay_online": false,
    "timezone": "Europe/Berlin",
    "paper": "a4",
    "country": "DE",
    "legal_notes": "Hansen & Voss GmbH, Amtsgericht Hamburg HRB 123456\nManaging directors: Clara Hansen, Henrik Voss",
    "tax_exemption": null,
    "tax_exemption_note": null,
    "e_invoice": null,
    "document_language": null,
    "documents_in": "de",
    "national_currency": "EUR",
    "national_system": null,
    "ready_to_send": true,
    "missing": []
  }
}

Use it when

Before sending the first document, or to check the numbering.

What it does

The business details used on quotes and invoices, the next numbers, and what is still missing before documents can be sent.

What comes back

The profile with its business details, defaults and next numbers, and what is still missing. Every reply also carries cost_usd and balance_usd.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/invoices_get_profile \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

More Invoices tools

All 24 tools

Give this to your agent.

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