Update e-invoicing settings
/account/e_invoicingCosts 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
enabledbooleanGenerate e-invoices (XRechnung/ZUGFeRD) for this store.
generationstringautomatic: with every invoice; manual: only for invoices you request one for.
One ofautomaticmanualsellerobjectShow 6 child attributesHide child attributes
legal_namestring, nullableLegal entity name; blank uses the business name.
vat_idstring, nullableUSt-IdNr: DE followed by 9 digits.
tax_numberstring, nullableSteuernummer, if there is no VAT id.
citystring, nullableSeller city; blank uses the Shopify address.
zipstring, nullableSeller postcode; blank uses the Shopify address.
small_businessbooleanKleinunternehmer (§19 UStG): no VAT shown.
bankobjectShow 3 child attributesHide child attributes
ibanstring, nullableIBAN for the payment block on unpaid invoices.
bicstring, nullablenamestring, nullableBank name.
Returns
enabledbooleanExample:truegenerationstringExample:automaticsellerobjectShow 8 child attributesHide child attributes
legal_namestring, nullableExample:Acme GmbHvat_idstring, nullableExample:DE123456789tax_numberstring, nullablecitystring, nullablezipstring, nullablesmall_businessbooleanExample:falsecountry_codestringExample:DEresolvedobjectShow 3 child attributesHide child attributes
legal_namestringExample:Acme GmbHcitystringExample:Barwaha, khargonezipstringExample:451115
bankobjectShow 3 child attributesHide child attributes
ibanstring, nullableExample:DE89370400440532013000bicstring, nullablenamestring, nullable
availablebooleanExample:trueactivebooleanExample:truemanual_modebooleanExample:falsereadybooleanExample:trueconfiguredbooleanExample:true
Errors
Missing or unknown X-Auth-Token, or the shop uninstalled the app.
v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.
The request failed validation. Nothing was saved.
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.
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"
}
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/account/e_invoicing", {
method: "PATCH",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"enabled": true,
"generation": "automatic",
"seller": {
"legal_name": "Acme GmbH",
"vat_id": "DE123456789"
},
"bank": {
"iban": "DE89370400440532013000"
}
}),
});
const data = await res.json();import os
import requests
res = requests.patch(
"https://app.invoicefalcon.com/api/v3/external/account/e_invoicing",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"enabled": True,
"generation": "automatic",
"seller": {
"legal_name": "Acme GmbH",
"vat_id": "DE123456789"
},
"bank": {
"iban": "DE89370400440532013000"
}
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/account/e_invoicing")
req = Net::HTTP::Patch.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
enabled: true,
generation: "automatic",
seller: {
legal_name: "Acme GmbH",
vat_id: "DE123456789"
},
bank: {
iban: "DE89370400440532013000"
}
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"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
}{
"errors": [
"Invalid API key"
],
"code": "unauthorized"
}{
"errors": [
"API access requires a paid plan"
],
"code": "paid_plan_required"
}{
"errors": [
"id is missing"
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited"
}