=== Enhanced Integration for Billingo and WooCommerce === Contributors: passatgt Tags: billingo, woocommerce, invoice, szamlazo, magyar Requires at least: 6.5 Requires PHP: 7.4 Tested up to: 7.1 Stable tag: 5.4.1 License: GPLv3 License URI: https://www.gnu.org/licenses/gpl-3.0.html Connect WooCommerce with Billingo, the Hungarian online invoicing service, and create invoices for your orders with lots of extra features. == Description == > This is not the official Billingo plugin, but it has a lot more features, so it's worth giving it a try. > **PRO version** > A PRO version of the plugin is available for €30 per year, which you can buy here: [https://visztpeter.me/woo-billingo-plus](https://visztpeter.me/woo-billingo-plus) > The license key can be activated on one website and is valid for 1 year. It includes 1 year of e-mail support for setup, customization and configuration. > Buying it also supports the development of the plugin, even if you don't need the features of the PRO version. = Features = * **Invoice generation** Create an invoice for any order with one click: * The generated invoice is saved in the order details. * The invoice PDF is also downloaded to your website and stored with a random file name in the wp-content/uploads/wc_billingo_plus folder. * You can set a payment deadline and a note for the invoices. * Works with coupons, they appear as negative line items on the invoice. * Shipping is added to the invoice too. * The PDF can be downloaded right from the Orders table, using the order actions or the optional Billingo column. * **Proforma, deposit and reverse invoices** You can create every document type supported by Billingo for your orders. * **Bulk actions** Use the bulk actions on the Orders page to create invoices and to download or print them all at once. * **VAT number field** A new VAT number field is added to the billing details. The VAT number is validated, saved, and shown in the e-mail sent to the customer and in the order details. * **Logging** The order notes show exactly when and which document was created. * **Mark as paid automatically** Choose the payment methods for which the invoice should be created as already paid. * **International invoices** If you sell abroad, for example in euros, you can change the language of the invoice and show the current exchange rate of the Hungarian National Bank (MNB) on it. Compatible with WPML, TranslatePress and Polylang. * **And much more** Paper and electronic invoices, VAT rate settings, invoice number prefix, invoices downloadable from the customer's account, e-mail notification about failed invoice generation and more. = Available in the PRO version = * **Automatic invoice generation** Create invoices and other documents (proforma, deposit and reverse invoices) automatically based on the order status, with custom conditions. * **Invoice notification** In the free version, Billingo sends the invoice notification to the customer. In the PRO version, the PDF invoice can be attached to the e-mails sent by WooCommerce, so you don't need to use Billingo's invoice notification and your customer gets one less e-mail. * **Automatic handling of bank transfers** With Billingo's bank sync feature, your store can be notified when a proforma invoice is paid, and the invoice can be marked as paid automatically. * **Special VAT rates** Set special VAT rates (EUKT, EUT, EUFADE, etc.) for certain products on the invoice, based on custom conditions. * **Bulk actions** With the bulk document generation action you can create not just invoices, but proforma, deposit and reverse invoices too. * **Override invoice data** Use conditions to change the invoice block, language and bank account details shown on the invoice. * **E-Receipt** If you sell electronic products, tickets or downloadable content, you don't need to ask for the customer's billing address, just the e-mail address, and the plugin creates an electronic receipt. * **Fill in company details automatically** The VAT number field is validated with the NAV API (Hungarian Tax Authority) and the billing details are filled in automatically. * **EU VAT number** The VAT number field accepts EU VAT numbers too, and removes VAT from the order automatically if the number is valid (validated with the VIES API). = Usage = You can find the detailed documentation [here](https://visztpeter.me/dokumentacio/). After installation, enter your API V3 key on the WooCommerce / Settings / Woo Billingo Plus page. A new box appears on the right side of every order, where you can create the invoice with one click. With the Options button, you can override the values from the settings for a single invoice. If automatic invoice generation is turned on, the invoice is created automatically when the order status changes. Invoice generation can be turned off for a single order in the Options dropdown. The finished invoice can be downloaded on the order page, or by clicking the PDF icon in the last column of the Orders table. **IMPORTANT:** Always check that the invoices are created correctly, and ask your accountant whether the generated invoices are right for them too. I can't test every possible case (different VAT rates, product variations, coupons, etc.), so make sure to test it before using it on a live store. If something is wrong, let me know and I'll try to fix it. = For developers = The plugin sends the data to the Billingo API, which creates the invoice. Before the API call, the data can be modified with the `wc_billingo_plus_partner` and `wc_billingo_plus_invoice` filters. Always add your changes to the functions.php file of your active theme, so a plugin update won't remove them. You can find more developer documentation [here](https://visztpeter.me/dokumentacio/). == Installation == 1. Download the plugin 2. Upload it in WordPress under Plugins / Add New 3. You'll find the settings under WooCommerce / Settings / Woo Billingo Plus. At least the API key field must be filled in. 4. Done == Frequently Asked Questions == = I used the other Billingo plugin before. Will this plugin work too? = * If you used the official plugin before, you can migrate the settings and the previously created invoices to this plugin. = What is the difference between the PRO and the free version? = The PRO version has a lot of useful features, which you can read about [here](https://visztpeter.me/woo-billingo-plus/). The most important one is automatic invoice generation. It also includes 1 year of e-mail support. = How can I test invoice generation? = Turn on Sandbox mode in your Billingo settings. Then the system creates test invoices. Note that only paper invoices can be created in Sandbox mode. = Invoice generation doesn't work for some reason. What should I do? = If the error message doesn't tell you what's wrong when you create an invoice manually, check the full message in the error log under WooCommerce / Status / Logs. If that doesn't help either, feel free to contact me. == Screenshots == 1. General settings 2. VAT rates and tax settings 3. Invoice line item settings 4. VAT number field settings 5. Automation settings 6. Invoice notification settings 7. E-Receipt settings 8. Invoice box on the order page == Changelog == 5.4.1 * Security fix: the VAT number field is validated and cleaned on the block checkout, and a validation result saved in the session is only used for the same VAT number * Security fix: all data shown in the invoice preview is escaped * Security hardening: input handling, output escaping and nonce checks improved across the plugin * Marked compatible with the latest WP version 5.4 * More secure PDF storage and access * Warning if the documents folder is directly accessible (e.g. on nginx servers) 5.3.4 * Fixed special VAT rate setting 5.3.3 * WP 7.0 compatibility fixes 5.3.2 * Improved check for duplicate invoice generation * Fixed currency condition * Fixed VAT number field setting 5.3.1 * Fixed product category condition for multiple accounts * Compatibility with the Extra Shipping Methods plugin * Fixed conditional mode in advanced settings * Marked compatible with the latest WP and WooCommerce versions * Reverse invoice notification sending 5.3 * Improved WooCommerce Product Bundles compatibility (there's an extra setting for it in the line item settings) * Name change * Polylang compatibility * Percentage VAT rates can also be selected for fixed overrides = 5.2.10 = * Compatibility fix with WooCommerce versions before 10.3 = 5.2.9 = * Compatibility fix with the latest Woo version = 5.2.8 = * PDF download fixes = 5.2.7 = * Final invoice condition * Final invoice preview * Fixed e-mail preview * HU set as the default country code * Deposit invoices can be deleted/reversed too * All types are shown in the document type condition = 5.2.6 = * Radio button version of the VAT number field on the classic checkout = 5.2.5 = * Automation fixes * Marked compatible with the latest WP/WC versions = 5.2.4 = * Fixed address autofill based on the VAT number on the checkout block = 5.2.3 = * Fixed PHP warning * User role condition * Shipping class condition = 5.2.2 = * Increased HTTP request timeout = 5.2.1 = * VAT number fix on the block checkout * Marked compatible with the latest WP/WC versions = 5.2.0.1 = * Invoice bug fix = 5.2 = * Offer and waybill generation * Deposit invoice fix * VAT number validation with the Billingo API instead of NAV (so you don't need to enter technical user details in the settings) * Quantity of 0 works too * Fixed invoice forwarding e-mail = 5.1.1 = * Support for the 5.5% VAT rate = 5.1 = * OSS support: you can set conditions for when the invoice should not be reported to NAV = 5.0.4 = * Fixed saving the rounding setting * Fixed the mark as paid button in the Orders table = 5.0.3 = * Fixed the paper invoice setting for company orders * Default payment method setting = 5.0.2 = * Setting to show the order number in the invoice note = 5.0.1 = * Fixed PRO version activation = 5.0 = * New interface for bulk document generation: the page doesn't reload, you can follow the whole process in a window * New bulk print and download feature: all documents can be downloaded or printed at once without reloading the page * Improved migration from the official plugin (new UI, works with HPOS, faster) * The PDF file is downloaded right away during document generation, so there's no need to wait for the scheduled action (invoice generation is a bit slower, but the invoice can be printed immediately). This can be turned off. * KATA compatibility switch: shows an error if there's a VAT number or company name on the invoice * Option to hide free line items on the invoice * Updated bank sync feature: more efficient, faster, and the paid status can also be checked manually on the order page * E-Receipt improvement: you can select the payment methods that can't be used with a receipt (e.g. bank transfer, cash on delivery) * Completely new settings page: a Woo Billingo Plus main menu split into submenus for better clarity * You can set the order status to change to after invoice generation (and during bulk generation you see the change without reloading the page) * The custom automation option is now the default (new installs only show this one) * Smaller size (JS-based PDF printing instead of PHP) * WooCommerce marked as a required plugin, so this plugin can only be activated when WooCommerce is active * Removed all admin notice messages * The {current_date} placeholder can be used in the note to show the current date (useful for warranty cards, for example) * VAT number field on the block checkout too * EU VAT number field and validation * More VAT number field display modes: always visible, visible after ticking a checkbox, or shown when a company name is entered * The VAT number field can be made required for B2B orders * Grouped invoice generation is visible with HPOS too * Removed old compatibility code * Set minimum PHP (7.4) and WP (6.0) versions * Marked compatible with the latest WP/WC versions