README

shtrih-python

Простой Python-модуль для работы с ККТ Штрих-М через драйвер AddIn.DrvFR (COM).

Позволяет печатать чеки, произвольный текст, QR-коды, а также управлять основными функциями ККТ из Python-скриптов.

Возможности

• Печать чека с передачей ФИО кассира, системы налогообложения, списка товаров, ставок НДС, оплаты наличными/безналичными
• Печать возвратного чека (is_return=True)
• Печать произвольного текста
• Печать QR-кода
• Простая интеграция в любые Python-проекты

Требования

• Windows
• Установленный драйвер ККТ Штрих-М
• Совпадение разрядности Python и драйвера (оба x86 или оба x64)
• Python 3.7+
• pywin32 (pip install pywin32)

Установка

1. Установите драйвер ККТ Штрих-М с официального сайта производителя.
2. Убедитесь, что разрядность Python и драйвера совпадает (оба x86 или оба x64).
3. Установите pywin32:
   bashCopy

   pip install pywin32

4. Склонируйте этот репозиторий или скачайте файл shtrih_kkt.py в свой проект.

Пример использования

from shtrih_kkt import ShtrihKKT, ShtrihKKTError

if __name__ == "__main__":
    try:
        kkt = ShtrihKKT(com_port=1, baud_rate=5, password=30)
        kkt.print_text("Добро пожаловать!")
        kkt.print_qr("https://example.com")
        # Обычный чек
        kkt.print_check(
            cashier="Иванов Иван",
            tax_type=2,  # УСН доход
            items=[
                {"name": "Товар 1", "price": 10000, "qty": 2, "sum": 20000, "tax1": 1},
                {"name": "Товар 2", "price": 5000, "qty": 1, "sum": 5000, "tax1": 0},
            ]
        )
        # Возвратный чек
        kkt.print_check(
            cashier="Петров Петр",
            tax_type=2,
            items=[
                {"name": "Возврат товара", "price": 15000, "qty": 1, "sum": 15000, "tax1": 1},
            ],
            is_return=True
        )
    except ShtrihKKTError as e:
        print(f"Ошибка ККТ: {e}")
    except Exception as e:
        print(f"Другая ошибка: {e}")

Параметр is_return

• В методе print_check есть параметр is_return (по умолчанию False).
• Если is_return=True, будет напечатан чек возврата (CheckType=2).
• Если is_return=False (или не указан), будет напечатан обычный чек продажи (CheckType=0).

Таблицы ставок НДС и систем налогообложения

Лицензия

MIT