Skip to content

Update e-invoicing settings

PATCH/account/e_invoicing

Costs 2 rate-limit points · Rate limits

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.

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).

Also searched asturn on e-invoicingset up xrechnungenter my vat id for e-invoicesadd my ibangenerate e-invoices only on requestdisable e-invoicingzugferd settings

Request body

  • enabledboolean

    Generate e-invoices (XRechnung/ZUGFeRD) for this store.

  • generationstring

    automatic: with every invoice; manual: only for invoices you request one for.

    One of automaticmanual
  • sellerobject
    Show 6 child attributesHide child attributes
    • legal_namestring, nullable

      Legal entity name; blank uses the business name.

    • vat_idstring, nullable

      USt-IdNr: DE followed by 9 digits.

    • tax_numberstring, nullable

      Steuernummer, if there is no VAT id.

    • citystring, nullable

      Seller city; blank uses the Shopify address.

    • zipstring, nullable

      Seller postcode; blank uses the Shopify address.

    • small_businessboolean

      Kleinunternehmer (§19 UStG): no VAT shown.

  • bankobject
    Show 3 child attributesHide child attributes
    • ibanstring, nullable

      IBAN for the payment block on unpaid invoices.

    • bicstring, nullable
    • namestring, nullable

      Bank name.

Returns

  • enabledboolean
    Example: true
  • generationstring
    Example: automatic
  • sellerobject
    Show 8 child attributesHide child attributes
    • legal_namestring, nullable
      Example: Acme GmbH
    • vat_idstring, nullable
      Example: DE123456789
    • tax_numberstring, nullable
    • citystring, nullable
    • zipstring, nullable
    • small_businessboolean
      Example: false
    • country_codestring
      Example: DE
    • resolvedobject
      Show 3 child attributesHide child attributes
      • legal_namestring
        Example: Acme GmbH
      • citystring
        Example: Barwaha, khargone
      • zipstring
        Example: 451115
  • bankobject
    Show 3 child attributesHide child attributes
    • ibanstring, nullable
      Example: DE89370400440532013000
    • bicstring, nullable
    • namestring, nullable
  • availableboolean
    Example: true
  • activeboolean
    Example: true
  • manual_modeboolean
    Example: false
  • readyboolean
    Example: true
  • configuredboolean
    Example: true

Errors

401

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

403

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

422

The request failed validation. Nothing was saved.

429

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

Every error has the same shape: see Errors.

PATCH/account/e_invoicing
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"
    }
  }'
Response
{
  "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
}