ErpNet.FP Fiscal Printer for Odoo 18

Full integration with Bulgarian fiscal printers through ErpNet.FP server for Odoo 18 Point of Sale.

📋 Features

POS Frontend (JavaScript)

• Fiscal receipt printing - Direct communication from browser to ErpNet.FP server
• Automatic fallback - Falls back to standard printing on error
• Tax group mapping - Automatic mapping of Bulgarian tax groups (А=0%, Б=20%, В=20%, Г=9%)
• Payment type detection - Automatic cash/card detection
• Receipt number tracking - Saves fiscal receipt number and fiscal memory serial

Backend Operations (Python)

• X Reports - Intermediate reports without resetting
• Z Reports - Daily reports with reset (mandatory before closing)
• Automatic Z reports - Scheduled Z reports via cron (configurable time)
• Cash operations - Служебно въведени (Deposit) and Служебно изведени (Withdraw)
• Additional operations - Duplicate receipts, journal info, status monitoring, cash drawer

POS Session Integration

• Session-level operations - X/Z reports and cash operations directly from POS session
• Automatic Z on close - Optional automatic Z report when closing session
• Session validation - Prevents closing without Z report (if configured)
• History tracking - Tracks all fiscal operations in session chatter

⚙️ Configuration

Step 1: ErpNet.FP Server Setup

Install and configure ErpNet.FP server using Docker:

docker run -d \
  --name erpnetfp \
  -p 8001:8001 \
  -v /dev/usb:/dev/usb \
  --privileged \
  rosenvladimirov/erpnetfp:latest

Or download from: https://github.com/erpnet/ErpNet.FP

Step 2: Configure Fiscal Printer Device

Step 3: Configure Automatic Z Reports (Optional)

Step 4: Configure POS Terminal

Step 5: Configure Tax Groups

🚀 Usage

1. Fiscal Receipt Printing

When completing a sale in POS:

1. Add products to cart
2. Click Payment
3. Select payment method (cash/card)
4. Click Validate
5. System automatically prints fiscal receipt

2. X Report (Intermediate Report)

During session (no reset):

1. Go to: Point of Sale → Dashboard → Sessions
2. Open your active session
3. Click X Report button
4. Report is printed on fiscal printer

3. Z Report (Daily Report with Reset)

Manual Z Report:

1. Go to: Point of Sale → Dashboard → Sessions
2. Open your session
3. Click Z Report button (confirm the dialog)
4. Session can now be closed

4. Cash Operations

Служебно въведени (Deposit):

1. Open session
2. Click Служебно въведени button
3. Enter amount and reason
4. Click Execute

Служебно изведени (Withdraw):

1. Open session
2. Click Служебно изведени button
3. Enter amount and reason
4. Click Execute

🏗️ Technical Details

Architecture - Hybrid Approach

• Receipts → JavaScript → ErpNet.FP (direct, no backend)
• Reports → Python → ErpNet.FP (backend operations)

Why?

• Receipts are high-frequency → Direct communication avoids backend bottleneck
• Reports are low-frequency → Backend provides better error handling and logging

Data Flow - Fiscal Receipt

1. POS Frontend prepares receipt data (items, payments, taxes)
2. JavaScript sends POST to: http://erpnetfp:8001/printers/{printerId}/receipt
3. ErpNet.FP prints on fiscal device
4. Returns receipt number and fiscal memory serial
5. JavaScript saves to order
6. Backend persists on sync

⚠️ Known Issues

• CORS may block requests if ErpNet.FP not on same domain (use HTTPS)
• Self-signed SSL certificates require ssl_verify=False
• Browser console shows fetch errors on printer offline (expected behavior)

🗺️ Roadmap

• Add support for refund receipts (сторно)
• Implement duplicate receipt from POS UI
• Add printer status widget in POS interface
• Support for multiple printers per POS
• Fiscal memory download functionality
• KLEN (journal) report viewer

🐛 Bug Tracker

Bugs are tracked on GitHub Issues.

In case of trouble, please check there if your issue has already been reported.

🔗 Additional Links

• ErpNet.FP Documentation: Wiki
• Dockerized ErpNet.FP: GitHub
• Bulgarian Fiscal Regulations: NAP.bg

👥 Credits

Authors

• Rosen Vladimirov
• Terraros Commerce Ltd.

Contributors

• Rosen Vladimirov <vladimirov.rosen@gmail.com>

Maintainers

This module is maintained by the OCA.

This module is part of the OCA/l10n-bulgaria project on GitHub.