# 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

1.  Open a **Stock Picking** (Transfer) in "Done" state.
2.  Click the **Print ZPL Barcode** button.
3.  A wizard will open listing all lots in the picking.
4.  Adjust the **Copies** (Quantity) for each lot if needed.
5.  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`.