# Set who invoices are made out to

Change the company name, invoice address, VAT ID and invoice e-mail that future invoices carry.

The billing account was filled in at sign-up. A change applies to invoices issued from then on;
issued invoices keep what they said. Replace the example values with your company's.

## Prerequisites

- Permission for `billing:UpdateBillingAccount`. Without it, the console shows the fields and says
  "Changing the billing account needs billing:UpdateBillingAccount."
- In the console, also `billing:GetBillingAccount` to open **Billing account**; without it the page
  shows an access-denied notice.

## Change the billing account

**Console**
1. Open **Billing account**.
2. Under **Company**, change **Company name**, **Street and number**, **Address line 2**, **Postal
   code**, **City** or **Country**.
3. Under **Tax and delivery**, change **VAT ID (USt-IdNr.)** or **Invoice e-mail**.
4. Choose **Save**.

The page says "Saved. The next invoice uses these details." Next to the VAT ID it shows whether the
EU VIES service confirmed it.

**CLI**
```sh
dcloud billing account update --company-name "Example GmbH" \
  --address-line1 "Hauptstraße 1" --postal-code 80331 --city München \
  --country DE --vat-number DE123456789
```

**API**
```http
PATCH /billing/api/account
{ "companyName": "Example GmbH", "addressLine1": "Hauptstraße 1", "postalCode": "80331",
  "city": "München", "country": "DE", "vatNumber": "DE123456789", "billingEmail": "jane.doe@example.com" }
```

Send every field: a field left out of the request is stored empty. The postal code must fit the
country (in Germany, five digits), and the country is a two-letter code from the console's list.

## The VAT ID

A VAT ID is checked for its country's format, and, when it changed, against the EU VIES service:

- VIES confirms it: it counts for the reverse charge (a company in another EU country is invoiced
  without VAT).
- VIES does not recognise it: the save is refused with `400` "VIES does not recognise this VAT
  number. Leave the field empty if your company has no EU VAT ID."
- VIES cannot be reached: the ID is saved as **Not confirmed yet**, and every later save checks it
  again (in the console, **Check again**). Until a check succeeds, invoices treat it as no VAT ID.

A company in Germany pays German VAT either way. See [How you are charged](how-you-are-charged.md)
for every VAT treatment.

## The invoice e-mail

The invoice e-mail is recorded, and by default it receives the monthly cost report. Invoices are
not sent by e-mail: each appears under **Invoices** with its PDF.

## When the change is refused

- `400` with the field `vatNumber` for a VAT ID of the wrong format, for example "Greek VAT IDs
  start with EL, not GR.", or one VIES does not recognise.
- `400` for a postal code that does not fit the country, or a missing required field.

## Related

- [Read and download an invoice](read-an-invoice.md)
- `billing.account.update` · `dcloud billing account update`
