---
title: "Update document settings"
description: "Change the document defaults every template inherits: invoice numbering, which dates are printed, language and currency, the PDF file name, the business name, address and contact, the tax registration, invoice locking, E"
url: https://docs.invoicefalcon.com/v3-reference/account/update-document-settings/
api: "API v3 reference"
method: PATCH
path: "/account/documents"
---

# Update document settings

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

Change the document defaults every template inherits: invoice numbering, which dates are printed, language and currency, the PDF file name, the business name, address and contact, the tax registration, invoice locking, EU VAT footer notes and the Invoice Falcon brand line. Deep partial. Returns the documents section as the read shows it.

**Note:** Applies to every document generated from now on; existing PDFs are unchanged. Multicurrency and removing the brand line need a paid plan.

## Request body

- `numbering` (object)
  - `invoice_prefix` (string, nullable): Prefix of invoice numbers, e.g. INV.
  - `next_invoice_number` (string, nullable): The number the next invoice takes (digits only).
  - `use_order_number` (boolean): Number invoices after the Shopify order number instead of a counter.
  - `credit_notes_use_invoice_number` (boolean): Credit notes take the invoice's number.
- `dates` (object)
  - `use_order_created_date` (boolean): Print the order date as the invoice date.
  - `use_paid_date` (boolean): Print the payment date as the invoice date.
  - `delivery_date_attribute` (string, nullable): Name of the order attribute holding the delivery date the buyer chose at checkout, e.g. Liefertermin. It becomes the fulfillment date; blank uses the Shopify fulfillment.
  - `delivery_date_from_tags` (boolean): Also read the delivery date from a date-shaped order tag (11-02-2026) when the attribute is absent.
  - `invoicing_start_date` (string, nullable): Orders placed before this date (YYYY-MM-DD, in the shop timezone) are never invoiced: not automatically, not from the customer account or order status page, and the order page asks before creating one. Null invoices any order.
- `language` (object)
  - `document_locale` (string): Language documents are printed in. One of: `az`, `bg`, `cs`, `da`, `de`, `el`, `en`, `es`, `es-MX`, `et`, `fi`, `fr`, `it`, `ja`, `ko`, `lt`, `lv`, `nl`, `nn`, `pl`, `pt`, `ro`, `sk`, `sl`, `sv`, `zh`.
  - `auto_detect_customer_language` (boolean): Use the customer's checkout language when known.
  - `translate_product_names` (boolean): Print translated product names where Shopify has them.
- `currency` (object)
  - `multicurrency` (boolean): Print in the currency the customer paid in.
  - `show_currency_code` (boolean): Print the currency code next to amounts.
- `pdf` (object)
  - `file_name` (string, nullable): PDF file name pattern, e.g. invoice-{{ invoice_number }}.
- `business` (object)
  - `name` (string, nullable): Business name printed on documents.
  - `address_line_1` (string, nullable)
  - `address_line_2` (string, nullable)
  - `city_line` (string, nullable): City and region line.
  - `country_line` (string, nullable): Country and postcode line.
  - `email` (string, nullable)
  - `phone` (string, nullable)
- `tax` (object)
  - `registration_number` (string, nullable): VAT / GST / ABN number.
  - `shown_as` (string, nullable): Label printed before it, e.g. VAT No.
- `compliance` (object)
  - `lock_invoices_after_issue` (boolean): Shopify order updates (refunds, cancellations, edits) no longer change an issued invoice; corrections go on a credit note. Manual edits and regenerate still work.
- `eu_vat_footer_notes` (object)
  - `outside_eu` (string, nullable): Footer note for customers outside the EU (migrated stores only).
  - `inside_eu` (string, nullable): Footer note for customers inside the EU (migrated stores only).
- `branding` (object)
  - `show_invoice_falcon_brand` (boolean): Print &quot;Created with Invoice Falcon&quot;; turning it off needs a paid plan.

## Returns

- `numbering` (object)
  - `invoice_prefix` (string): e.g. `INV`
  - `next_invoice_number` (string, nullable): e.g. `1200`
  - `use_order_number` (boolean): e.g. `false`
  - `credit_notes_use_invoice_number` (boolean): e.g. `false`
  - `per_template_numbering_available` (boolean): e.g. `true`
- `dates` (object)
  - `use_order_created_date` (boolean): e.g. `false`
  - `use_paid_date` (boolean): e.g. `false`
- `language` (object)
  - `document_locale` (string): e.g. `en`
  - `auto_detect_customer_language` (boolean): e.g. `false`
  - `translate_product_names` (boolean): e.g. `false`
  - `available_locales` (array of strings)
- `currency` (object)
  - `multicurrency` (boolean): e.g. `true`
  - `show_currency_code` (boolean): e.g. `true`
- `pdf` (object)
  - `file_name` (string, nullable)
- `business` (object)
  - `name` (string): e.g. `Acme GmbH`
  - `address_line_1` (string, nullable)
  - `address_line_2` (string, nullable)
  - `city_line` (string, nullable)
  - `country_line` (string, nullable)
  - `email` (string, nullable)
  - `phone` (string, nullable)
- `tax` (object)
  - `registration_number` (string, nullable)
  - `shown_as` (string, nullable)
- `compliance` (object)
  - `lock_invoices_after_issue` (boolean): e.g. `false`
- `eu_vat_footer_notes` (object)
  - `outside_eu` (string, nullable)
  - `inside_eu` (string, nullable)
  - `available` (boolean): e.g. `false`
- `branding` (object)
  - `show_invoice_falcon_brand` (boolean): e.g. `true`
  - `removal_available` (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/documents" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business": {
      "name": "Acme GmbH"
    },
    "numbering": {
      "next_invoice_number": "1200"
    }
  }'
```

## 200

The updated resource.

```json
{
  "numbering": {
    "invoice_prefix": "INV",
    "next_invoice_number": "1200",
    "use_order_number": false,
    "credit_notes_use_invoice_number": false,
    "per_template_numbering_available": true
  },
  "dates": {
    "use_order_created_date": false,
    "use_paid_date": false
  },
  "language": {
    "document_locale": "en",
    "auto_detect_customer_language": false,
    "translate_product_names": false,
    "available_locales": [
      "az",
      "bg",
      "cs"
    ]
  },
  "currency": {
    "multicurrency": true,
    "show_currency_code": true
  },
  "pdf": {
    "file_name": null
  },
  "business": {
    "name": "Acme GmbH",
    "address_line_1": null,
    "address_line_2": null,
    "city_line": null,
    "country_line": null,
    "email": null,
    "phone": null
  },
  "tax": {
    "registration_number": null,
    "shown_as": null
  },
  "compliance": {
    "lock_invoices_after_issue": false
  },
  "eu_vat_footer_notes": {
    "outside_eu": null,
    "inside_eu": null,
    "available": false
  },
  "branding": {
    "show_invoice_falcon_brand": true,
    "removal_available": 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"
}
```

