Document rules

Some shipping modules never hand a label over directly; they store it as an ordinary Shopware document. A rule covers that case: the document type and the printer are selected, and every new document of that type is printed.

Stockly → Operations → Printing → Document rules.

Note

Not to be confused with Automatic printing, the entry below it. A document rule watches for a Shopware document and prints it the moment it is generated. An automatic printing rule watches for work, that is a wave being planned or an operation starting or finishing, and asks for a warehouse document such as a pick list, which no Shopware document type covers.

Columns: Document type, Sales channel, Printer, Source format, Only when the order is, Active.

Adding a rule

Add rule opens the form.

• Document type — which Shopware document triggers it.
• Sales channel — or All channels.
• Printer — where it goes.
• Source format — Detect automatically, PDF, ZPL or EPL. It is left on detection unless a module stores something the detection identifies incorrectly.
• Only when the order is — the order state condition.

Danger

Always set the order state. With Any order state the rule fires for every generated document, including a bulk run of two hundred invoices. The list warns about this on any rule that has no condition.

Documents are PDF and belong on an office printer

A label printer speaks ZPL and will not take a PDF. A job aimed at one fails in the queue and states the reason.

Carrier labels are unaffected: a shipping module that hands over ZPL goes straight to the label printer without a rule.

Deleting a rule

Documents of that type are no longer printed automatically. Nothing already printed is affected.

Next steps

• Document templates — what the documents themselves look like.
• Print queue — where a rule’s jobs land.