Faktura1 for OpenCart 3
Version: 0.1.0

Package type:
- OpenCart 3 .ocmod.zip package.
- The archive contains an upload/ directory with admin module files.
- No API token or store-specific settings are included in the package.

Installation:
1. In OpenCart admin, open Extensions > Installer.
2. Upload faktura1-opencart-0.1.0.ocmod.zip.
3. Open Extensions > Extensions.
4. Choose Modules.
5. Find Faktura1 and click Install.
6. Open the module settings, enable it, confirm the Faktura1 API base URL https://api.faktura1.com/api/v1 and enter the API token.
7. Configure mappings/defaults inside the OpenCart module for currency, payment method, customer/company fields, VAT, unit, warehouse, invoice book and other values loaded from Faktura1 /meta.

Customer/company fields:
- The extension does not create checkout custom fields.
- Map existing OpenCart order fields or custom fields to the Faktura1 customer fields.
- For company invoices, company name and Bulstat/reg number are required.
- VAT number and MOL/accountable person are optional.

Order admin:
- The extension adds a Faktura1 tab to the order info page.
- Invoice/proforma creation and deletion are manual actions.
- When an invoice is created, oc_order.invoice_no is updated with the Faktura1 invoice number.
- If the Faktura1 invoice PDF URL is available, the order invoice_no value links to that PDF.
- When that invoice is deleted, oc_order.invoice_no is cleared only if it still matches the deleted Faktura1 invoice number.
