> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.solvimon.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.solvimon.com/_mcp/server.

# write_billing_entity

**Live server:** test server (`test.mcp.solvimon.com`) only.

Creates and updates a billing entity and manages its tax registrations (for example a branch office in another country).

**Actions:** `create`, `update`, `add_tax_registration`, `remove_tax_registration`

* `create` is confirm-first. Without `confirmed: true` it checks the input and returns a proposal: a summary, what is missing (and why it is hard to change later), and existing entities that look similar. A similar entity keeps blocking the create until its id is listed in `not_duplicate_of`.
* `add_tax_registration` appends to the existing registrations, so it is safe to call repeatedly. `remove_tax_registration` takes the `tax_registration_id` returned by `get_billing_entities`.

**`Add a tax registration`**

```json Add a tax registration
{
  "action": "add_tax_registration",
  "id": "bile_Kq2mVx8RnT4uLpWe9AhZ3",
  "body": {
    "description": "Amsterdam office",
    "tax_id": "NL000099998B57",
    "registration_number": "86385879",
    "registered_address": {
      "line1": "Frederiksplein 61",
      "city": "Amsterdam",
      "postal_code": "1017 XL",
      "country": "NL"
    }
  }
}
```