Help · Orders & Customers · Orders

Manage Orders

From receipt to invoice: how to find orders, create and edit them in the backend, set their status, generate invoices, adjust invoices, and process returns as invoice corrections. Including the most important rule of the order process: what you need to do before invoicing and what can only be handled afterward via a correction.

5 Sections in the Order Editor
10 Document Types
3 Invoicing modes
4 Steps for Returns

At a Glance

  • Orders: under Orders → Orders. The “Edit” tab displays the order, sets the status, and generates documents. The “Change Order” tab modifies line items, addresses, and totals.
  • Status: Clicking “Notify Customer” sends an email to the customer; attach documents using the buttons below. Create internal notes by clicking “Add Internal Comment.”
  • Invoice: Without a custom numbering range, the document number is the order number. With a custom numbering range, the store assigns the invoice number via a button or when a specific status is reached—and does so exactly once.
  • After Invoicing: No further changes to line items, prices, or addresses are allowed; instead, a return with an invoice correction must be processed. The store regenerates the PDF from the current data each time it is accessed.
  • Customize documents: Logo, prefixes, footer, file names, and QR code under Settings → Design → Documents; the text for each payment and shipping method is found in the “Documents” tab of an order.

In this guide


Understanding Your Order Summary

You can find all orders under Orders → Orders. Clicking on the order number opens the order.

Search

The search field finds orders by last name, first name, company, email, ZIP code, city, customer number, and order number, as well as by invoice number (the number only, without “RG”), “PO No.”, the external ID, and the payment provider’s transaction number. Searching for “Last Name, First Name” with a comma specifically searches for names; entering “@” searches only within the email field. You can search for items in the “Item No./GTIN” field, and for an order number directly in the “Order No.” field.

Filter

Above the list, you can narrow down results by time period (“Orders from/to”), order status, payment method, shipping method, shipping country, customer group, customer language, and marketplace; if needed, you can also filter by shipping label and pickup location. Under “Additional Filters” → “Order History Filters,” you can find orders that had a certain status at some point or never had one.

Multiple Orders at Once

Select the rows and open “Action for Selected Orders.” Instead of selecting individual orders, you can also enter a range of order numbers there (“or use the order numbers”).

ActionEffect
Change StatusA status change for all selected orders. It works the same as changing the status in an individual order, including an email, invoice number in “Via Status” mode, payment action, and cancellation entry.
DocumentsOrder confirmations, invoices, QR invoices, quotes, delivery notes, or packing lists as a single PDF, sorted by “Document Sort Order.” If a separate invoice number range is in use, the store skips orders without an invoice number. This also applies to label printing by connected shipping providers.
DeleteWith a prompt regarding stock reversal and bonus points.
Order overview with filters above the list; three orders are checked on the left, and the open menu “Action for Selected Orders” displays “Change Status,” “Delete,” the “Documents” section with “Sort Documents” (order number in ascending order), order confirmation, invoice, quote, delivery note, packing list, and the “Shipping Data Export” section; to the right of that, the fields “or use the order numbers” from/to

You can process selected orders collectively via “Action for Selected Orders”: change status, combine documents into a single PDF, or delete. Click to enlarge.

The tabs on an order

TabsPurpose
EditView the order, set the status, enter comments, generate and send documents. Below these are the sub-tabs “Order Details” (Start), “Item Details,” “Order Status,” “Documents,” “Shipping,” “Dates,” “Tickets,” and “Miscellaneous.”
Edit OrderActually modify line items, addresses, and totals. You can change everything listed on the document here.
Log (History)Log of changes to the order, line items, and totals, showing both the old and new values. Visible only to the main administrator account. The store deletes entries older than one year.
Tab bar for an order, with the options "Edit," "Change Order," and "Log"

The tab bar of an open order, logged in as the main administrator

The "Edit " tab displays and logs changes, while the "Modify Order " tab makes changes. This distinction applies throughout the entire ordering process.

Files Associated with the Order

In the open order, the “Files” button uploads internal documents, such as a supplier receipt or a photo. You can open existing files via “View Files.” The customer cannot see these files. To send a file to the customer, use the “Individual File” status.

Analyzing Orders

You can export items, quantities, and sales under Reports → Purchased Products using “Export” as a CSV file that opens in Excel, with or without returns. Reports → CSV Sales Export provides one row per order with net, gross, and tax. Orders → Generate Order List creates a printable list of items and addresses.


Create, copy, and assign orders to customers

Phone and email orders, orders for business customers, or reorders: You can also create orders in the backend.

Select a customer

Under Orders → Create Order or in the “New Order” tab of the order overview, search for the customer and click “Select this customer.”

Order is created

"New Order" creates the order immediately: with the account’s addresses, the default status, the default currency, the account’s language, and the payment method "Invoice," provided it is active.

Fill Out in the Editor

The store opens the order editor. There, you can add products, select shipping and payment methods, recalculate the total, and save by clicking “Update.”

Because the order is created immediately, it is assigned an order number. If you delete an order that was created by mistake, a gap will appear in the order numbers.

Different Language

The order language is specified in the order editor under “3. Shipping, Payment, Discounts, and Totals” in the “Customer Language” field. Emails, receipt text, and the labels for the total lines are based on this setting. Items you add in the backend will have the product name in your backend language. Check the names for orders in a foreign language.

Duplicate Order

In the action menu for a line in the order overview, “Duplicate Order” creates a copy with a new number and today’s date: same items, totals, and addresses, without an invoice number. Inventory is deducted for the copy. No email is sent.

Assign to Customer Account

In the action menu for a row, the option is labeled “Link to Customer Account” for guest orders; otherwise, it is “Change Assigned Customer.” After clicking “Select Customer,” confirm under “Confirm Customer Account Link.”

The assignment overwrites the addresses. The store automatically pulls the customer data, shipping address, and billing address for the order from the default address of the selected account, as well as the customer group. Therefore, assign the account before generating the invoice and then check the addresses in the order editor. If the shipping address differs, re-enter it there.
Order summary with four orders; For the top entry—a guest order placed by Erika Musterfrau without a customer number—the drop-down menu next to “Edit” is open: under “Documents,” you’ll find items ranging from the order confirmation to the packing list; below that, in the “Other” section, the options “Link to customer account,” “Duplicate Order,” and “Delete”

The arrow menu for a row leads to “Link to Customer Account” (for guest orders) and “Duplicate Order.” Click to enlarge.


Editing an Order: The Order Editor

You open the editor via the “Edit Order” tab. It is divided into expandable sections. All changes are saved together by clicking the “Update” button at the very bottom.

Important note: The order editor is intended for orders for which an invoice has not yet been created. If the customer has already received the invoice, do not make corrections here; instead, use an invoice correction. To learn why this is the case and what the correct procedure is, see the section “After the Invoice.”
The order editor with the collapsed sections: Address Information, Products, Shipping and Payment, Downloads, and Affiliate Program

The sections of the order editor, with order and invoice data above them

The Header: Data and Dates

Above the sections are the order date and time. If you’re using a custom invoice number series, “Invoice Number,” “Invoice Date,” and “Payment Terms” follow. The invoice number is locked as soon as it’s assigned. Under “Scheduling,” you can maintain the “Delivery Option,” “Delivery Date,” “Service Date,” “Shipment Date,” and the scheduled dates. You can specify which of these appear on the documents under Settings → Design → Documents (see Customizing Documents).

Without a custom number range, the header displays only the “Payment Due Date” field—and only if payment methods are selected under “Payment Due Date on the Invoice: Payment Methods.” from 4.9.34

SectionWhat you can change hereTypical Reason
1. Address InformationCustomer, shipping, and billing addresses, including those from the customer’s address bookTypos, incorrect shipping address
2. ProductsAdd items, correct quantity, price, and tax rate, remove items, initiate returnsReorder, incorrect quantity entered
3. Shipping, Payment, Discounts, and TotalsShipping and payment methods, coupons, store credit, currency, customer language, customer group, custom total linesChange shipping method, grant a discount
4. DownloadsDownload files, “Download available until,” “Remaining downloads,” serial numbers. Visible only if “Enable product downloads” is selected under Settings → Checkout → Download.Customer needs another download attempt
5. PartnersAssignment to a partner in the affiliate program. Visible only if there are partners (without downloads, listed as “4. Partners”).Assign commission to a partner

Save

The “Refresh” button at the bottom of the page updates all sections at once. The buttons in the summary section are intermediate steps; they do not replace the “Save” function.

New Order Confirmation

When you click “Send Order Confirmation ” via “Update,” the customer receives the updated order again, with the invoice attached if requested. If a recalculation is still pending, the store does not send an email and asks for confirmation first.


Add, Edit, and Delete Products

In Section 2. Products, you can edit the items in the order.

Add Item to Order

Opens the product selection. You can search by name, item number, or EAN, and select attributes directly. The selection also displays deactivated items and variants so you can replicate orders. If you add a deactivated item, the store displays a warning: “Attention! An inactive product has been added.”

Upload Product List

For larger reorders: a file in CSV, XLS, XLSX, or ODS format containing an identifier (EAN or item number) and, optionally, the quantity per line; if no quantity is specified, the default is 1. After import, the store will label unknown or empty identifiers with a line number. It rejects negative quantities and quantities exceeding one million. from 4.9.85

"Products" section with the "Add Item to Order" and "Upload Item List" buttons, as well as three items

The “Products” section with the items in the order

The fields for an item

FieldMeaning
QuantityNumber of items ordered. With “Advanced Inventory Management,” you control the quantity via the inventory lines below. The quantity may be 0 or negative; see below.
ProductThe name as it appears on the document. A change applies only to this order, not to the catalog.
Item Number / GTINAppears on the delivery note and packing slip; the item number also appears on the invoice.
Tax (%)Tax rate for this item. Must match the country of delivery.
UnitUnit of sale, such as “piece” or “m.”
Base PriceThe net price per unit, excluding any feature surcharges. Stored with high precision; do not round to two decimal places.
ActionTwo buttons: Create Return and Delete Item. These are two different processes; see below. The Return button disappears as soon as the entire quantity has been returned.
An order line item with quantity, product name, item number, tax rate, base price, and the "Promotion" column

Top right: the Action column: Create Return and Delete Item

Deleting is not a substitute for a return. When you delete an item, it disappears from the order as if it had never existed: no receipt, no reason, no trace for the customer. The store will adjust the inventory accordingly. To record merchandise that has actually been returned, use the “Create Return” icon next to it. This is the only way to generate an invoice correction that you can provide to the customer and your accounting department.

Negative Quantity as a Credit Line

Before the invoice is issued, you can also record a return directly in the order: Reduce the quantity of the item—to -1 for a credit line—save by clicking “Update,” and answer “Yes” when prompted to recalculate. The store adjusts inventory by the difference. This does not generate an invoice correction. If the invoice has already been sent to the customer, process the return. Between versions 4.7.11 and 4.9.117, the browser rejected a negative quantity when clicking “Update”; in those versions, save by clicking “Recalculate Order.”

Set up variants and additional options for an item in the catalog; see the Product Attributes Guide.


Shipping, Payment, Discounts, and Totals

Section 3—Delivery, Payment, Discounts, and Totals— includes the shipping and payment methods, coupons and credit balances, currency, customer language, customer group, and all total lines for the order.

Section on Shipping, Payment, Discounts, and Totals, featuring the total rows and the three buttons in the footer

Total lines and the three buttons at the bottom of the section

Shipping Costs

Under “Shipping Method,” select a configured shipping method; “Recalculate Order” applies its price. With “Custom,” you enter the “Shipping Name,” “Shipping Price (net),” and “Shipping Tax Rate” yourself.

Pickup Location

If there are multiple stores, change the pickup store in the “Pickup Store” field. Confirm the prompt “Change pickup address as well?” by clicking OK; the store will then enter the address of the new store as the shipping address.

Customer Group

The “Customer Group” here applies only to the calculation of this order—for example, for tax, net or gross display, and discounts. The group in the customer account remains unchanged.

The Total Lines

Each line has a “Description,” “Tax Rate,” “Value,” and “Sort Order.” You can only change the tax rate for empty lines.

WhatHere’s how
Discount or surchargeClick “Add Row,” then enter the “Description,” “Tax Rate,” and “Value”—enter a negative value for a discount. If no description is provided, the row is labeled “Credit” (negative) or “Fee” (positive). The value is gross if the customer group sees gross prices; otherwise, it is net. The empty row is retained with every recalculation and appears on the receipts.
Lock ValueFor minimum-quantity surcharges, discounts, coupons, payment method fees, and voluntary contributions, the lock icon “Keep value (recalculation always results in this amount)” locks the entered amount.
Remove rowCheck the box on the left side of the line and recalculate. The module remains disabled for this order and appears under “Manually Blocked Modules.” Clicking its button re-enables it.

The three buttons

ButtonFunctionWhen to use
Add RowDisplays an empty total row.A surcharge or discount not supported by any module
Recalculate orderRecalculates shipping, tax, and total modules completely.The standard procedure after every change
Apply order as isSaves the entered amounts unchanged.Only if you have intentionally set totals manually—but then also recalculate the subtotal, tax, and total yourself

The prompt “Perform recalculation”

If you change anything that affects the calculation, the store will ask you to confirm before saving. This applies to: delivery country, zone or state, currency, customer language, payment method, shipping method, total weight, coupon, store credit, and customer group, as well as any change to an item.

“Yes” recalculates shipping, taxes, and totals. “No” leaves the entered amounts as they are. Select “No” only if you have intentionally set the totals yourself.

The confirmation prompt before recalculating, with the "Yes" and "No" buttons

The confirmation prompt appears automatically as soon as a change relevant to the calculation is made

Set up shipping methods and pricing models in the Shipping & Delivery guide, coupons and gift cards in the Gift Cards & Coupons guide, and cash discounts and payment method fees in the Payment Methods guide.


Change Status and Notify Customer

The status reflects the order’s processing stage. In the “Edit” tab, under the “Order Status” sub-tab, select the new status and decide what notification to send to the customer. Click “Update” to save the changes.

Order 18503 from Erika Musterfrau, “Order Status” subheading: History showing “Pending,” “Payment Received,” a gray, italicized internal entry “Goods inspected in warehouse” with a crossed-out eye icon, and “Shipped”; below that, the “Add internal comment” button, the comment field with text blocks, on the right the “Shipped” status selection and the toggles ranging from “Notify customer” to “Custom file,” and “Update” at the bottom

In the “Order Status” sub-tab, the history is displayed above the form; internal entries appear in gray with a crossed-out eye icon and remain invisible to the customer. Click to enlarge.

ButtonEffect
Notify CustomerSends the status email regarding the new status.
Attach CommentsIncludes your comment text in the email.
Attach order confirmationAttaches the order confirmation as a PDF.
Attach invoiceAttaches the invoice. If using a custom number range, this will only happen if an invoice number already exists.
Attach electronic invoice (XRechnung) / (ZUGFeRD)Attaches the e-invoice. If there is a return, the buttons for electronic invoice correction are added.
Attach invoice correctionAttaches the invoice correction; see “Return.”
Attach quoteAttaches the quote as a PDF.
Attach Terms and Conditions / Right of Withdrawal / Privacy PolicyAttach the legal documents as a PDF.
Custom fileAttach a separate file, such as a data sheet.
Execute payment actionVisible only if “Skip Payment Action” is enabled under Settings → General → Module Options, the payment method supports actions with the provider, and the new status is a cancellation or shipping status. If this option is disabled, the provider will not process the refund or direct debit. If “Payment Action Can Be Skipped” is turned off, the store will always execute the action.

Additional toggles appear only when needed, such as “QR Invoice” and “Attach Donation Receipt.” If you change the toggles, “Save” appears: This allows the store to save this combination as the default.

What the Customer Sees

Every status change appears in the customer’s account under the order. The customer sees the comment text there only if “Notify customer” was enabled. If this option is unchecked, no email is sent, but the new status is visible in the account.

Purely Internal Note

“Add internal comment” above the comment field creates an entry that the customer never sees—no email and no receipts. The eye icon next to a history entry hides or shows it to the customer. The order always shows the customer the most recent status visible to them.

Status and Invoice

In “Via Status” mode, the store automatically assigns the invoice number as soon as the order reaches a specified status; see Create Invoice.

Cancellation via Status

Changing the status to “Canceled” reverses the inventory adjustment, creates an invoice correction for invoiced orders, and triggers a refund for many payment methods; see “Complete Cancellation.”

Status Change via xoScan: A status change via barcode scanner does not trigger a payment action, does not assign an invoice number, and does not adjust inventory in the event of a cancellation. If you need these processes, change the status in the order or via “Change Status” in the order overview (see xoScan).

What Each Status Means

Under Orders → Order Status, you can create statuses and assign them when editing: “Set as Default” (status for new orders), “Cancellation” (reversal and invoice correction; excluded from reports), “Shipped” (notification to payment providers and marketplaces), “Payment Received,” and “Partial Payment.” You can customize the text of status emails in the CMS Manager & Emails guide; refunds by payment method are described in the Payment Methods guide.


Quotes

In XONIC, a quote is an order with a quote status. It appears in the “Quotes” tab of the order overview; it is hidden from the regular order list.

Prerequisite: Under Settings → Design → Product Detail View → Quote Status IDs, at least one order status must be selected as a quote status. Without this entry, neither the “Quotes” tab nor the “Request Quote” button will appear on the product page.

Quote as a Document

Each order can be printed as a “Quote” (prefix “OF”) via the “Documents” menu. Once assigned this status, you can send it via “Attach Quote.”

Creating a Quote in the Backend

Up to XONIC 4.9, you create an order and set it to a quote status. Starting with version 4.10, the “Create Quote” tab is available for this purpose. The order editor then displays “This is a quote” and does not deduct inventory when editing. from 4.10

Convert to an order

If the customer accepts, switch to a normal order status. Starting with version 4.10, the status dialog asks “Post inventory levels now”; the default setting is found under “Quote: Post inventory levels upon conversion” in the product detail view. from 4.10

Up to XONIC 4.9, the order editor also updates inventory for a quote as soon as you add items. If the quote is rejected, delete it using “Credit the quantity to inventory” or set it to a cancellation status. Both actions reverse the inventory adjustment. Without a separate invoice number range, the cancellation status creates an invoice correction.

Create Invoice

Whether a purchase order receives an invoice number is determined by “Custom Invoice Number Range: Mode” under Settings → Checkout → Number Ranges.

ModeDocument NumberWhat triggers it
false (without a separate number range) DefaultThe document number is the order number with a prefix, for example, RG10024.Generated when the order is created.
ManualCustom counter with a prefix.You can do this by clicking the " Create Invoice" button.
status (via the status)Custom counter with prefix.The store, as soon as the order reaches a status from “Custom Invoice Number Range: Activation Status for Invoice Generation,” even during checkout. The button is also available.
The green "Create Invoice" button in the header of an order

With your own number range, you can generate the invoice with a single click

The button disappears as soon as a number is assigned. It is not displayed for canceled orders. This is by design: An invoice number is assigned exactly once per order, and even a subsequent status change does not alter it. from 4.9.6

Number Range Settings

All fields under Settings → Checkout → Number Ranges:

FieldMeaning
Change Order NumberThe number of the next order. Can only be incremented.
Custom Invoice Number Range: Modefalse, manual, or status; see above.
Protect Invoiced OrdersFor information on how strictly the editor protects invoiced orders, see “After Invoicing.”
Custom invoice number range: current invoice numberCurrent value of the invoice counter.
Custom Invoice Number Range: Activation Status for Invoice GenerationThe statuses under which the “status” mode generates the invoice.
Current invoice correction numberStarting value for invoice correction numbers.
Custom Invoice Number Range: StatisticsNote: Reports only include orders with an invoice.
Custom Invoice Number Range: Order Statuses for Customer Order OverviewThe customer account displays orders with invoices as well as orders in this status.

The prefix and suffix for document numbers (“Invoice Number Prefix,” default RG; “Invoice Correction Prefix,” default ST; and the remaining document types) can be found under Settings → Design → Documents.

Settings → Checkout → Ten-line number ranges: Change customer number, order number, and contract number, “Custom Invoice Number Range: Mode” set to “Manual,” “Protect Invoiced Orders” set to “Warn,” current invoice number 2026001, activation status set to “Default,” current invoice correction number 1001, statistics set to “True,” and order statuses for the customer order overview set to “Default”

Under Settings → Checkout → Number Ranges, you can set the invoicing mode, protection for invoiced orders, and counter values. Click to enlarge.

Header section of the order editor, showing the invoice number, invoice date, and payment terms

Once assigned, the invoice number can no longer be changed; the field is locked.

Where the order number comes from

The database increments the order number sequentially. It only gains an additional digit when the counter reaches a power of ten or when someone has increased it using the “Change Order Number” option.

Why order numbers have gaps

A deleted order does not release its number; this also applies to orders accidentally created in the backend and to orders that are removed via a marketplace integration. Gaps in the order number are not a problem as long as the invoice numbers are consecutive. If you delete the highest-numbered order, the delete dialog will offer the option to “Adjust Order Number Counter.”

From this point on, the orderis considered complete in terms of content once the invoice number has been assigned. Any further corrections are made via invoice correction, not through the order editor.

Documents and Delivery Slips

You can generate all documents related to an order by clicking the “Documents” button in the header bar of the open order. The PDF opens in a new window.

The "Documents" menu, now open, showing the available document types

Which entries appear depends on your settings and the status of the order

DocumentPurposePrerequisite
Order ConfirmationConfirmation upon receipt of order–
InvoicePayment ReceiptInvoice number available*
E-invoice (XRechnung / ZUGFeRD)Structured invoice for government agencies and business customersInvoice number provided*, tax ID and bank details for the store maintained, company name and VAT ID included in the billing address
QR InvoiceSwiss invoice with payment sectionInvoice number present*, “QR Invoice IBAN” entered
QuoteBefore placing an order–
Delivery slipIncluded with the shipment, without prices (default)–
Packing listPicking in the warehouse–
Invoice CorrectionCorrection to an InvoiceReturn on file
Donation receiptDonation ConfirmationVoluntary contribution included
Supplier order formOrder placed with supplier, including customer’s shipping address, without pricesItems with supplier; dedicated “Supplier Actions” button

* If your store does not use its own numbering system, these documents are available immediately; the order number also serves as the document number.

Supplier Order

If items in the order have a supplier, the “Supplier Actions” button appears. “View Order Form for …” opens the PDF; “Send Order Form & Delivery Note via Email to …” sends both to the supplier’s email address, with a copy sent to the store. Both options are also available in the Actions menu of the order overview.

Multiple Documents at Once

You can print delivery notes for a single shipping day or all invoices for a specific period from the order overview: Select the orders, then “Action for selected orders” → Documents. You cannot filter by invoice number (from–to), but you can filter by order number.

The store generates each document anew. Every time you view the document or attach it to an email, the PDF is generated anew from the current order data. The shop does not maintain a permanently stored copy of the sent invoice. Therefore, do not create an invoice until the order is complete and has been verified, and keep a record of sent documents yourself; more on this.

Customize Documents

You can control the appearance and content of documents in three places: under Settings → Design → Documents, in the “Documents” tab of an order, and in the email settings.

GoalWhere and how
Logo"Logo" under Settings → Design → Documents, including "Logo Alignment," "Logo Width," and "Show Logo."
Footer, Company Name, Bank InformationIn Settings → Design → Documents, open the Edit Invoice Footer tab. Each column has a heading and text for each language. The document uses the language of the order. The store omits columns with “Bank” or “IBAN” in the heading or text if the order has its own payment instructions, such as when purchasing on account via a payment service provider. The sender’s line above the address is entered in the “Document Address (Horizontal)” field.
Texts by Payment and Shipping MethodIn an order under the “Documents” sub-tab: for the order confirmation, invoice, and packing slip, there is one “Payment Method Comment,” “Shipping Method Comment,” and “General Comment” each. The pencil icon opens the text modules. A module marked “Standard” applies to all orders with this payment or shipping method unless you select a different one. Each text block has one text entry per language. Below each selection, the text appears as an editable field: Clicking “Save” applies the selection and any text modified here as a custom text specific to this order. For the packing list, there is only one free text field.
Number prefixes“Invoice Number Prefix” and “… Suffix,” as well as for order confirmation, delivery note, packing list, invoice correction, quote, supplier order, and donation receipt.
PDF File Name“PDF File Name Template” for each document type with a preview. Placeholders include, for example, {date}, {prefix}, {id}, {suffix}, {lastname}, {company}, {customer_id}, {invoice_no}, and {order_id}. If left blank, {date}-{prefix}{id}{suffix}-{lastname} is used.
Payment QR Code“Receipts: EPC QR Code (BankApp Scan)” with the value RG prints a QR code for the bank transfer on the invoice; this is the default setting. It appears only for prepayment and invoices, and only if the account holder, IBAN, and BIC are configured under Settings → General → Basic Settings. Clearing the field disables it. It cannot be disabled for individual payment methods.
Payment Due Date“Payment Term on the Invoice: Payment Methods” selects the payment methods that include the “Payment Term” line. The number of days is set under Settings → Checkout → General → Payment Term in Days (default 30), with exceptions per order in the “Payment Term” field of the order editor. from 4.9.34
Prices for Product Variants“Documents: Price Display for Product Options” determines on which documents the surcharge for a feature appears as a separate amount below the item. Default: Order Confirmation, Invoice, Quote.
Prices on the Delivery Note“Hide Prices on Delivery Note,” default enabled.
Font Sizes“General Font Size” applies to line items and the totals block; separate sizes are available for the address field, header, footer, and document type. There is no separate font size option specifically for the totals block.
Additional InformationYou can toggle the customer number, payment method, customer email and phone number, comments, service and delivery dates, barcode, and “customer tax ID” in the same group. The note regarding intra-Community supply or the recipient’s tax liability for customers with a VAT ID number abroad is disabled by “Tax Note on Documents.” from 4.9.81
"Edit Invoice Footer" window with the "PDF Footer Columns" and "Edit" tabs: "Sort Order" field set to 30 and "Offset in mm" field set to 0; language tabs set to DE and EN; for German, the heading "Bank Details" and the content "Musterbank," account holder "Musterladen GmbH," IBAN DE00 0000 0000 0000 0000 00 and BIC MUSTDEXXXXX, “Update” and “Cancel” at the bottom

Each column in the footer has a heading and content for each language; the invoice uses the language of the order. Click to enlarge.

Order 18503, “Documents” sub-tab: four columns—Order Confirmation, Invoice, Delivery Note, and Packing List—each with a text field; below these, for Order Confirmation, Invoice, and Delivery Note, the options “Payment Method Comment,” “Shipping Method Comment,” and “General Comment” with a pen icon, pre-filled with entries such as “RG Prepayment 1 (Standard)” and “LS DHL 1 (Standard),” and “Save” at the bottom

In the “Documents” sub-tab, select the text modules for payment method, shipping method, and general comment for each document; “(Default)” indicates the default setting. Click to enlarge.

Net or Gross

Whether a document displays net or gross prices depends on the customer group associated with the order: “Price Output” and “Tax-Exempt Customer Group” under Customers → Customer Groups. For an existing order, change the customer group in the order editor and recalculate.

Automatic Invoice via Email

Under Settings → Interfaces → Email Marketing / CRM → Email Options, the “Email Attachment: Order Confirmation (PDF Invoice)” option attaches the invoice to every order confirmation, regardless of the payment method. If you’re using a custom number range, the order usually doesn’t have an invoice number yet at checkout. In that case, send the invoice with the status.

E-invoice in the shipping email

When changing the shipping status to “Notify Customer,” enable “Attach electronic invoice (XRechnung)” or “(ZUGFeRD),” and click “Save” to set this as the default. The e-invoice requires a billing address that includes the company name and VAT ID number. The customer enters a routing ID as the order number during checkout if “Order Number / Routing ID – Entry in Checkout” is enabled under Settings → Checkout → Shipping/Packaging, or you can enter it in the order editor under “PO No.”

Layout and Font: The layout of the documents is based on the template’s predefined layouts; there is no option to edit this in the backend. The documents use the DejaVu Sans font. Characters not included in this font—such as Chinese characters or emojis—will not appear. Custom columns, such as the EAN on the invoice, a different layout, or a different font, can be implemented using a custom document template within your template. Please contact us for assistance with this.

After the Invoice: What You Can Still Do

Once the invoice has been created, the order is complete in terms of content

Once an invoice number has been assigned to an order and the document has been sent to the customer, you can no longer make any changes to that order: neither line items nor quantities, prices, tax rates, shipping costs, or billing addresses. Any corrections needed after that must be made via an invoice correction.

XONIC supports you in this process: The store alerts you to an invoiced order and, if desired, can completely prevent any changes from being made.

Why this is the case

Section 14 of the German Value-Added Tax Act (UStG) requires a sequential invoice number that is assigned only once. If you modify an order that has already been invoiced, the newly generated document will bear the same number but show different amounts. From the perspective of your accounting department and a tax audit, this means there are two different invoices under a single number. Furthermore, the GoBD (§ 147 AO) require that documents be stored in a way that ensures they are unalterable and traceable.

The document always shows the current status

The store regenerates the invoice each time it is accessed, based on the order data. If you modify the order after it has been sent, any subsequent retrieval under the same number will show different content than the PDF your customer received. Therefore, store sent invoices outside the shop, such as by keeping a copy in the “Sent” folder of your email inbox (see CMS Manager & Emails) or in your accounting records.

The Correct Approach: Invoice Correction

Create a return for the affected item. The store will then assign a unique correction number and generate an invoice correction document. The original invoice remains unchanged. Together, the invoice and the correction total the correct amount, and both transactions can be tracked individually. For a genuine reorder, create a new order instead of amending the old one.

What Remains Unproblematic

Not every change affects the document. You can make internal comments, change statuses, update tracking numbers, and record payment receipts at any time. Correcting the shipping address is also fine, as long as it does not appear on the invoice. As a rule of thumb: Whatever appears on the PDF remains unchanged after it is sent.

Enable protection

Under Settings → Checkout → Number Ranges, use “Protect Invoiced Orders” to specify how strictly the store enforces this rule. Protection takes effect as soon as a separate invoice number range is in use and the order has an invoice number. from 4.9.6

SettingBehavior
offNo check. The order editor behaves as it did prior to version 4.9.
warn DefaultThe editor displays a clear notification, but the change is still possible. Well-suited for introducing the process to a team.
blockChanges affecting the total amount are rejected: line items, quantities, prices, tax rates, total lines, recalculation, and list uploads, as well as currency, language, billing and shipping countries, customer group, coupon, invoice number, and date fields. Status, comments, tracking numbers, document printing, email sending, downloads, and creating returns remain possible. The main administrator account can override the lock for corrections; the store logs this action.
Yellow notification in the order editor for an invoiced order

"warn" setting

Red restriction notice in the order editor with a reference to the return

"block" setting

What to do if …

SituationInvoice already createdCorrect procedure
A customer orders an item afterNoAdd the item to the Products section, recalculate, and update
Customer reorders an itemYesCreate a new order; do not extend the invoiced order
Incorrect quantity enteredNoCorrect the quantity in the Products section and recalculate
Customer returns an itemYesProcess the return via the line item, generate and send an invoice correction
Customer returns the entire shipmentYesSet status to "Cancellation"; the store creates the correction lines, including shipping costs
Price was overcharged, incorrect attributeYesReturn the item and send the same product as a replacement at the correct price; the invoice correction shows the difference
Billing address is incorrectYesGenerate an invoice correction, correct the address, issue a new invoice—do not silently overwrite it
Shipping costs omittedYesPlace a separate order; do not add it to the existing invoice
Internal comment, tracking number, payment receivedDoesn’t matterCan be changed at any time; does not appear on the receipt
Special case without a separate invoice number range: If your store is running with the default settings, the receipt number is identical to the order number. Therefore, there is no technical point in time at which an order is considered “invoiced,” and “Protect Invoiced Orders” does not apply. In this case, define internally when an order is considered complete—for example, when the status changes to “Shipped” or when the invoice is sent. From that point on, the same rule applies.

This guide describes how the store system works and is not a substitute for tax advice. For an assessment of your specific situation, please contact your tax advisor.


Processing Returns and Invoice Corrections

If merchandise is returned or an amount needs to be corrected, create a return. This generates an invoice correction document with its own document number.

Getting Started

The quickest way is via the “Return” icon in the “Action” column of the relevant item in the Order Editor. You can modify an existing return there by selecting “Modify Return or Add Exchange Item.” Alternatively, go to Orders → View Returns/Exchanges and select the “New Return/Exchange” tab.

Select an Order

Enter the order number or search by customer and email. If you’re accessing this from the order editor, this step is already complete.

Select Return Item

The relevant item from the order. Not applicable if there is only one item.

Enter details

“Quantity” (up to the ordered amount), date, “Reason” from the list or as free text, and “Notes.” Under “Summary (Special Lines),” add amounts, such as refunded shipping costs as a negative amount.

Exchange products

Optional: “Add exchange product” opens the product selection. Quantity, name, price, and tax rate can then be edited freely. “Save” creates the return.

What the return entails

AspectBehavior
Data ManagementThe return is tracked separately. The original order remains unchanged.
NumberWhen first saved, the store assigns a correction number with the prefix “ST.” All returns for an order share this number and are listed together on a corrected invoice.
DocumentInvoice correction in the “Documents” menu; if necessary, also as an electronic invoice correction. Send with the status via “Attach Invoice Correction.”
RefundSaving a return does not trigger a refund through the payment provider. You can process partial refunds in the provider’s portal or, where available, by clicking “Refund” in the order; see Payment Methods.
InventoryReturns increase inventory; exchange items decrease it; when making changes, only the difference is accounted for. Returns created before the update are not retroactively posted.from 4.9.145, in older versions, a return does not reverse the inventory; post returned goods to the item there.
Original InvoiceRemains unchanged. The original invoice and the correction invoice together total the correct amount.
Detail screen for a return related to Order 18501 with invoice number RG18501 and invoice correction number ST1001, contact information and address for Erika Musterfrau; Returned item: 1 × Organic Classic T-Shirt Navy/M for €19.90, date September 30, 2026, Reason: “Size doesn’t fit,” note, special line “Shipping costs” with −5 net, 19% tax, and −5.95 gross; exchange item: 1 × Organic T-Shirt Classic Navy/L; at the bottom, “Add exchange item” and “Save”

In the return entry, enter the quantity, reason, and notes; enter refunded amounts as a negative special line item; and, if necessary, specify an exchange item. Click to enlarge.

Complete Cancellation

If the entire order is being returned, simply change the status to “Cancelled”—either within the order itself or via “Change Status” in the order overview:

  • If “Adjust Inventory” is selected and inventory management is active, the store will adjust the inventory of the items that have not yet been returned—but only when the status is changed to“ from 4.9.145
  • If there is an invoice (or if the store operates without its own invoice number series), the store creates a return entry for each item without a previous return. Shipping costs, fees, discounts, and coupons are included as special line items so that the correction balances the entire invoice.
  • For payment methods with automatic chargebacks, the status change triggers the refund with the provider.
  • If the order uses its own numbering range and does not yet have an invoice number, no invoice correction is generated. The status change is sufficient.

The Returns List

Under Orders → View Returns/Exchanges, you’ll find all returns listed with the order number, customer, difference amount, date, and reason. You can filter by reason, search by name or email, and jump directly to a return using an ST or RG number. Open the correction document from the action menu.

Delete Return

There is no offsetting document for an invoice correction. You can delete a return created in error in the returns list or in the order editor. The invoice correction will then show the remaining returns for the order or will be removed. If the item is already with the customer, do not delete it; instead, bill the amount using a new order.

Which warehouse to post returns from 4.10

With “Advanced Inventory Management” (Settings → Checkout → Inventory), the store manages multiple warehouses. Starting with version 4.10, there are two ways to handle returns:

Without a returns warehouse

The merchandise is returned to the warehouses from which the item was sold. The warehouse that was last used is restocked first, up to a maximum of the quantity that was sold from that warehouse.

With a returns warehouse

Under Products → Inventory Management, edit a warehouse and enable “Returns Warehouse.” Then all returns go entirely to this warehouse so you can inspect them before they are resold. “No Returns Warehouse” cancels this setting. A cancellation is always posted back to the original warehouses; the merchandise never left the warehouse.

A return is not the same as a statutory cancellation. The guide “Cancellation Button” explains how customers can initiate a cancellation through the store. The store does not have a return form that customers can use to create a return themselves.

The Streamlined Workflow

  • Check the order: Review the items and addresses in the “Edit” tab.
  • Make all changes before invoicing: in the “Edit Order” tab.
  • Recalculate order: Check totals and tax rates.
  • Update: Save.
  • Create an invoice: via the button or automatically based on the status.
  • Generate and send documents: invoice, e-invoice, packing slip, and keep a copy of the sent document.
  • No further changes from this point on: Make corrections exclusively via returns and invoice corrections.

Frequently Asked Questions

When is the invoice number assigned, and can it change when the status changes?

Without a custom number range, the order number is the document number. In “Manual” mode, the store assigns the number when you click “Create Invoice”; in “Status” mode, it is assigned the first time a status from the “Activation Status for Invoice Creation” list is reached. Starting with version 4.9.6, the number is assigned exactly once; a subsequent status change no longer alters it. In older versions, a second triggering status could generate a new number.

How do I cancel an order completely, including shipping costs?

Set the status to a cancellation status. The store reverses the inventory and, for an invoiced order, creates an invoice correction covering all items, including shipping costs and fees. Whether it issues a refund through the payment provider depends on the payment method; see Payment Methods.

How do I prevent an automatic refund from being issued upon cancellation?

Go to Settings → General → Modules and enable the “Payment action can be skipped” option. Afterward, the status dialog for cancellation and shipping statuses will display the “Execute payment action” toggle, which you can disable on a per-order basis. For some payment methods, you can also disable automatic refunds in the module settings.

How do I create a credit memo retroactively and send it to the customer?

In the store, a credit memo is an invoice correction. Create a return with an exchange item or a special line item for any differences in amount. Then, in the “Order Status” sub-tab, enable “Notify Customer” and “Attach Invoice Correction,” and click “Update.”

How do I process a partial return with a refund for a paid order?

Create a return for the item with the returned quantity and send the invoice correction. Reimburse the amount separately via the payment provider’s portal or by clicking “Refund” in the order, if the payment method supports this option. The return itself does not trigger a transfer.

How do I change the total amount retroactively without canceling the order?

Before the invoice, use “Add Line” in the order editor to create a blank total line—for example, “Goodwill” with a negative value—and then “Recalculate Order.” The line will appear on all documents. After the invoice is issued, any amount change must be processed via a return with an invoice correction.

How do I add shipping costs in the order editor?

In the “3. Delivery, Payment, Discounts, and Totals” section, select the shipping method under “Shipping Method” and click “Recalculate Order.” For a different amount, select “Custom” and enter the “Shipping Name,” “Shipping Price (net),” and “Shipping Tax Rate.”

Where do I set the minimum order quantity surcharge, and how do I remove it?

Go to Settings → Checkout → Summary in the “Minimum Order Quantity Surcharge” module. In the “Minimum Order Quantity Surcharge” field, specify the minimum order value and the price surcharge (net) for each customer group—for example, only for retailers. “Minimum Order Surcharge Valid For,” “Skip for Pickup,” and “Exception for Service Products/Downloads” set restrictions, while “Show Minimum Order Surcharge” turns it off. To remove it from a single order, check the box next to the total line in the order editor and click “Recalculate Order.”

How do I link a guest order to a customer account or change the customer?

In the order overview, select “Link to customer account” or “Change assigned customer” from the action menu for the line. The store will then retrieve customer data and addresses from the account. Afterward, verify the shipping address; see Assigning a Customer Account.

Can I duplicate an order?

Yes, by selecting “Duplicate Order” from the action menu for that line. The copy will be assigned a new number, today’s date, and no invoice number. Inventory will be deducted for the copy.

Why are there gaps in the order numbers, and why does the number suddenly have one more digit?

Deleted orders do not release their numbers. An extra digit is added when skipping a power of ten or when “Change Order Number” has been set to a higher value. Only invoice numbers must be consecutive. This is ensured by a separate invoice number range; see “Numbers.”

Why does the product selection in the order editor show deactivated variants?

This is by design: In the backend, you should also be able to create orders with items that are no longer visible in the store. If you add a deactivated item, the store will issue a warning.

Why can’t I add an exchange product to a return?

A replacement product is always linked to a return. If the entire quantity of an item has already been returned, the return icon will be missing. In that case, click “Change Return or Add Replacement Product” on the return line in the order editor. If the product selection shows no results, your backend account lacks read access to the products. You must click “Save” to apply the exchange product.

Why can’t the customer see an order in their account?

If you’re using a custom invoice number range, the customer account will only display orders with an invoice number. Open orders and pre-orders without an invoice will only appear if their status is selected under Settings → Checkout → Number Ranges → Custom Invoice Number Range: Order Statuses for Customer Order Overview.

How do I change the pickup location for an order?

In the order editor, under “3. Delivery, Payment, Discounts, and Totals,” in the “Pickup Store” field. Confirm the prompt “Change pickup address as well?” by clicking OK so that the shipping address also changes to the new store.

How do I create an order and invoice in a different language?

In the order editor, change the “Customer Language” and recalculate. Emails, document text, total descriptions, and the footer will then appear in that language. Check the item names you’ve added in the backend and adjust them in the line item if necessary.

Where do I configure the invoice footer, company name, and logo, including in multiple languages?

Under Settings → Design → Documents: “Logo” for the logo, the “Edit Invoice Footer” tab for the footer columns with one text per language, and “Document Address (Horizontal)” for the sender line.

Where can I permanently customize the text on invoices, order confirmations, and packing slips?

In an order, under the “Documents” sub-tab, use the pencil icon next to “Payment Method Comment,” “Shipping Method Comment,” or “General Comment.” If you mark a module as “Default,” it applies to all orders with this payment or shipping method unless a different option is selected. You can change the text in emails by following the instructions in the CMS Manager & Emails guide.

How do I change the file name of the invoice PDF?

Under Settings → Design → Documents, in the “PDF File Name Template” field, specify a template for each document type and view a preview. For example, the template “ {prefix}{id}-{company} ” results in “RG10024-Musterladen.pdf.” If no entry is provided, the default is “ {date}-{prefix}{id}{suffix}-{lastname}.”

How do I enable or disable the QR code on the invoice?

Set “Invoices: EPC QR Code (BankApp Scan)” under Settings → Design → Invoices to “RG” or clear it. The QR code appears only for prepayment and invoices, and only if bank account information has been entered in the basic settings. It cannot be disabled for prepayment alone.

How do I print the EAN of the items on the invoice?

The delivery note, packing slip, and supplier order automatically display the GTIN as soon as the item has one. It does not appear on the invoice in the default template; a separate document template is required for this. It is included in the e-invoice.

Why is the button for the invoice missing?

If you’re using a custom number range, the “Invoice” entry in the “Documents” menu will only appear once the order has an invoice number. Click “Create Invoice” or set a triggering status. If “Create Invoice” is also missing, the order has been canceled or already has a number. If the e-invoice option is grayed out, a note next to the entry will indicate what is missing: the shop’s tax ID or bank details, company name, or VAT ID in the billing address.

How do I get an overview of the invoices?

There is no separate invoice list. If you use your own numbering range, show the “Invoice” column in the order overview (Settings → Design → General → Column Design: Order Overview), search for the invoice number, and print the invoices in bulk. For accounting purposes, Reports → CSV Sales Export provides one row per order.

Why doesn’t the sales report show cancellations?

The shop excludes orders with a status marked “Cancellation” from reports and statistics. Additionally, with “Custom Invoice Number Range: Statistics,” only orders with an invoice are counted.

Do I have to send a shipping confirmation via email for marketplace orders?

No. When the shipping status changes, the store notifies the connected marketplace of the shipment, including the tracking number if one has been entered. You can decide whether the store also sends a status email using the “Notify Customer” option.

Further Guides

Support for Ordering Processes and Documents

Whether it’s invoice number ranges, document templates, or the returns process: our team will set up the processes together with you.

Contact Support Now