---
title: "Update e-invoicing settings"
description: "Change the e-invoicing setup of a German store: switch it on or off, choose automatic or on-request generation, and edit the seller profile (legal name, VAT id or tax number, city, postcode, small-business status) and ba"
url: https://docs.invoicefalcon.com/v3-reference/account/update-e-invoicing-settings/
api: "API v3 reference"
method: PATCH
path: "/account/e_invoicing"
---

# Update e-invoicing settings

`PATCH https://app.invoicefalcon.com/api/v3/external/account/e_invoicing`

Change the e-invoicing setup of a German store: switch it on or off, choose automatic or on-request generation, and edit the seller profile (legal name, VAT id or tax number, city, postcode, small-business status) and bank details. Deep partial. Returns the e_invoicing section, including whether it is now active.

**Note:** Applies to invoices created from now on. E-invoicing is only available to stores in Germany and needs a paid plan; `active` in the response says whether e-invoices will actually be generated (enabled, paid plan and a profile with a legal name and a VAT id or tax number).

## Request body

- `enabled` (boolean): Generate e-invoices (XRechnung/ZUGFeRD) for this store.
- `generation` (string): automatic: with every invoice; manual: only for invoices you request one for. One of: `automatic`, `manual`.
- `seller` (object)
  - `legal_name` (string, nullable): Legal entity name; blank uses the business name.
  - `vat_id` (string, nullable): USt-IdNr: DE followed by 9 digits.
  - `tax_number` (string, nullable): Steuernummer, if there is no VAT id.
  - `city` (string, nullable): Seller city; blank uses the Shopify address.
  - `zip` (string, nullable): Seller postcode; blank uses the Shopify address.
  - `small_business` (boolean): Kleinunternehmer (§19 UStG): no VAT shown.
- `bank` (object)
  - `iban` (string, nullable): IBAN for the payment block on unpaid invoices.
  - `bic` (string, nullable)
  - `name` (string, nullable): Bank name.

## Returns

- `enabled` (boolean): e.g. `true`
- `generation` (string): e.g. `automatic`
- `seller` (object)
  - `legal_name` (string, nullable): e.g. `Acme GmbH`
  - `vat_id` (string, nullable): e.g. `DE123456789`
  - `tax_number` (string, nullable)
  - `city` (string, nullable)
  - `zip` (string, nullable)
  - `small_business` (boolean): e.g. `false`
  - `country_code` (string): e.g. `DE`
  - `resolved` (object)
    - `legal_name` (string): e.g. `Acme GmbH`
    - `city` (string): e.g. `Barwaha, khargone`
    - `zip` (string): e.g. `451115`
- `bank` (object)
  - `iban` (string, nullable): e.g. `DE89370400440532013000`
  - `bic` (string, nullable)
  - `name` (string, nullable)
- `available` (boolean): e.g. `true`
- `active` (boolean): e.g. `true`
- `manual_mode` (boolean): e.g. `false`
- `ready` (boolean): e.g. `true`
- `configured` (boolean): e.g. `true`

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl -X PATCH "https://app.invoicefalcon.com/api/v3/external/account/e_invoicing" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "generation": "automatic",
    "seller": {
      "legal_name": "Acme GmbH",
      "vat_id": "DE123456789"
    },
    "bank": {
      "iban": "DE89370400440532013000"
    }
  }'
```

## 200

The updated resource.

```json
{
  "enabled": true,
  "generation": "automatic",
  "seller": {
    "legal_name": "Acme GmbH",
    "vat_id": "DE123456789",
    "tax_number": null,
    "city": null,
    "zip": null,
    "small_business": false,
    "country_code": "DE",
    "resolved": {
      "legal_name": "Acme GmbH",
      "city": "Barwaha, khargone",
      "zip": "451115"
    }
  },
  "bank": {
    "iban": "DE89370400440532013000",
    "bic": null,
    "name": null
  },
  "available": true,
  "active": true,
  "manual_mode": false,
  "ready": true,
  "configured": true
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

