Citizen ZPL Printer for Odoo

This module allows direct ZPL printing from Odoo to Citizen Label Printers (e.g., CL-S621, CL-S631) via a network connection (socket). It provides a wizard to select lots and quantities before printing.

Features

Direct Printing: Sends ZPL commands directly to the printer's IP address.
Print Wizard: Select specific lots and quantity of labels to print from a Stock Picking.
Customizable Layout: Configure label size, margins, and content size in dots.
Image Support: Print Company Logo and a Custom Image (e.g., "Fragile" icon).
Barcode Support: Prints Code128 and Datamatrix/GS1 barcodes.

Configuration

Go to Settings > Inventory > Citizen ZPL Printer.

1. Connection

IP Address: The IP address of your printer.
Port: Port number (default is 9100).

2. Label Dimensions (Dots)

Configure the physical size of your label.

Formula (203 DPI): 1 mm ≈ 8 dots
Example (60mm x 30mm):
- Width: 480 dots
- Height: 240 dots

3. Content Settings

Font Size: Height of the text in dots (30 dots ≈ 3.75mm).
Barcode Height: Height of the barcode in dots.
Module Width: Density of the barcode (Default 2).

4. Images

Print Company Logo: Prints the company logo at the bottom center.
Custom Image: Upload an additional image to print at the bottom right.

Usage

Open a Stock Picking (Transfer) in "Done" state.
Click the Print ZPL Barcode button.
A wizard will open listing all lots in the picking.
Adjust the Copies (Quantity) for each lot if needed.
Click Print.

Technical Details

DPI: This module is optimized for 203 DPI printers. For 300 DPI, multiply dot values by ~1.5.
ZPL Template: The ZPL code is generated using QWeb view citizen_zpl_printer.label_citizen_template_view.

1.9 KiB Raw Blame History