{"id":85993,"date":"2018-06-14T11:52:22","date_gmt":"2018-06-14T11:52:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/woocommerce-billomat\/"},"modified":"2022-09-26T12:11:13","modified_gmt":"2022-09-26T12:11:13","slug":"woo-billomat","status":"publish","type":"plugin","link":"https:\/\/ga.wordpress.org\/plugins\/woo-billomat\/","author":16156662,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.4.8","stable_tag":"V2.4.8","tested":"6.0.11","requires":"4.8","requires_php":"","requires_plugins":"","header_name":"WooCommerce Billomat","header_author":"Billomat","header_description":"Connect WooCommerce to Billomat and generate clients, articles and invoices automatically.","assets_banners_color":"e7e7e7","last_updated":"2022-09-26 12:11:13","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/www.billomat.com\/","rating":5,"author_block_rating":0,"active_installs":100,"downloads":80429,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":{"V2.1.1":{"tag":"V2.1.1","author":"billomatcom","date":"2018-06-14 14:57:32"},"V2.1.2":{"tag":"V2.1.2","author":"billomatcom","date":"2018-07-11 07:27:30"},"V2.2.0":{"tag":"V2.2.0","author":"billomatcom","date":"2018-08-23 08:50:30"},"V2.2.1":{"tag":"V2.2.1","author":"billomatcom","date":"2019-01-29 13:56:27"},"V2.3.0":{"tag":"V2.3.0","author":"billomatcom","date":"2019-01-29 13:56:27"},"V2.3.1":{"tag":"V2.3.1","author":"billomatcom","date":"2019-01-09 10:02:03"},"V2.3.2":{"tag":"V2.3.2","author":"billomatcom","date":"2019-01-29 13:56:27"},"V2.3.3":{"tag":"V2.3.3","author":"billomatcom","date":"2019-03-27 12:16:55"},"V2.3.4":{"tag":"V2.3.4","author":"billomatcom","date":"2019-04-25 11:29:18"},"V2.3.5":{"tag":"V2.3.5","author":"billomatcom","date":"2019-05-06 11:57:28"},"V2.3.6":{"tag":"V2.3.6","author":"billomatcom","date":"2019-07-12 13:08:03"},"V2.3.7":{"tag":"V2.3.7","author":"billomatcom","date":"2019-07-18 13:06:02"},"V2.3.8":{"tag":"V2.3.8","author":"billomatcom","date":"2020-02-12 07:27:26"},"V2.4.0":{"tag":"V2.4.0","author":"billomatcom","date":"2020-12-16 12:26:33"},"V2.4.1":{"tag":"V2.4.1","author":"billomatcom","date":"2021-03-09 13:15:11"},"V2.4.2":{"tag":"V2.4.2","author":"billomatcom","date":"2021-04-14 09:15:17"},"V2.4.3":{"tag":"V2.4.3","author":"billomatcom","date":"2021-05-19 14:23:55"},"V2.4.4":{"tag":"V2.4.4","author":"billomatcom","date":"2021-06-03 10:07:27"},"V2.4.5":{"tag":"V2.4.5","author":"billomatcom","date":"2022-03-15 16:09:33"},"V2.4.6":{"tag":"V2.4.6","author":"billomatcom","date":"2022-07-27 10:31:29"},"V2.4.7":{"tag":"V2.4.7","author":"billomatcom","date":"2022-09-02 13:50:48"},"V2.4.8":{"tag":"V2.4.8","author":"billomatcom","date":"2022-09-26 12:11:13"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-256x256.jpg":{"filename":"icon-256x256.jpg","revision":1892802,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":1907479,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":1907479,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["V2.1.1","V2.1.2","V2.2.0","V2.2.1","V2.3.0","V2.3.1","V2.3.2","V2.3.3","V2.3.4","V2.3.5","V2.3.6","V2.3.7","V2.3.8","V2.4.0","V2.4.1","V2.4.2","V2.4.3","V2.4.4","V2.4.5","V2.4.6","V2.4.7","V2.4.8"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":1907481,"resolution":"1","location":"assets","locale":""},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":1907481,"resolution":"2","location":"assets","locale":""},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":1907481,"resolution":"3","location":"assets","locale":""},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":1907481,"resolution":"4","location":"assets","locale":""},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":1892802,"resolution":"5","location":"assets","locale":""}},"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[158006,12480,26218,286],"plugin_category":[45],"plugin_contributors":[158007],"plugin_business_model":[],"class_list":["post-85993","plugin","type-plugin","status-publish","hentry","plugin_tags-billomat","plugin_tags-invoice","plugin_tags-invoicing","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-billomat","plugin_committers-billomatcom"],"banners":{"banner":"https:\/\/ps.w.org\/woo-billomat\/assets\/banner-772x250.jpg?rev=1907479","banner_2x":"https:\/\/ps.w.org\/woo-billomat\/assets\/banner-1544x500.jpg?rev=1907479","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/woo-billomat\/assets\/icon-256x256.jpg?rev=1892802","icon_2x":"https:\/\/ps.w.org\/woo-billomat\/assets\/icon-256x256.jpg?rev=1892802","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/woo-billomat\/assets\/screenshot-1.jpg?rev=1907481","caption":""},{"src":"https:\/\/ps.w.org\/woo-billomat\/assets\/screenshot-2.jpg?rev=1907481","caption":""},{"src":"https:\/\/ps.w.org\/woo-billomat\/assets\/screenshot-3.jpg?rev=1907481","caption":""},{"src":"https:\/\/ps.w.org\/woo-billomat\/assets\/screenshot-4.jpg?rev=1907481","caption":""},{"src":"https:\/\/ps.w.org\/woo-billomat\/assets\/screenshot-5.jpg?rev=1892802","caption":""}],"raw_content":"<!--section=description-->\n<p>Connect WooCommerce to your exiting Billomat account with ease and save time and money.\nClients and articles will be automatically created and updated and invoices are generated when a WooCommerce order completes.<\/p>\n\n<h3>Billomat webhooks<\/h3>\n\n<p>This plugin uses Billomat webhooks to synchronize data from Billomat to WooCommerce.\nPlease register the following 3 webhooks in Billomat under \u201cSettings &gt; Webhooks\u201d with the secret key shown under the Billomat tab in WoCommerce -&gt; Settings.<\/p>\n\n<p>Event: Customer \/ change\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_update_customer&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Customer \/ delete\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_delete_customer&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Articles \/ change\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_update_product&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Articles \/ delete\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_delete_product&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Delivery note \/ Change of status\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_add_delivery_note&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Delivery note \/ delete\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_delete_delivery_note&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Invoice \/ Change of status (since 1.1.0 - 2017-11-02)\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_change_invoice_status&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<p>Event: Invoice \/ delete (since 1.1.0 - 2017-11-02)\nURL: https:\/\/yourdomain.com\/wp-admin\/admin-post.php?action=wcb_delete_invoice&amp;secret_key=YOUR_SECRET_KEY<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Move plugin files to the directory <code>\/wp-content\/plugins\/woocommerce-billomat<\/code> or install it via WordPress plugin management.<\/li>\n<li>Activate WooCommerce Billomat from your Plugins page.<\/li>\n<li>Visit WoCommerce -&gt; Settings and click on the Billomat tab to enter your billomatID and API key (you must activate the API access for a user under \u201cSettings &gt; employees\u201c in Billomat).<\/li>\n<li>Set the other options to your requirements.<\/li>\n<\/ol>\n\n<p>Warning: please insert net prices, otherwise rounding errors can occur.<\/p>\n\n<!--section=changelog-->\n<h4>2.4.8 - 2022-09-26<\/h4>\n\n<ul>\n<li>Dev - Add <code>User-Agent<\/code> header to Billomat API requests.<\/li>\n<\/ul>\n\n<h4>2.4.7 - 2022-09-02<\/h4>\n\n<ul>\n<li>Dev - Change invoice correction to new API endpoint.<\/li>\n<\/ul>\n\n<h4>2.4.6 - 2022-07-27<\/h4>\n\n<ul>\n<li>Fix - Fix condition for checking correction invoice creation.<\/li>\n<\/ul>\n\n<h4>2.4.5 - 2022-03-15<\/h4>\n\n<ul>\n<li>Fix - Swap join() parameters since glue right is deprecated in PHP 7.4.<\/li>\n<\/ul>\n\n<h4>2.4.4 - 2021-06-01<\/h4>\n\n<ul>\n<li>Fix - Separate shipping calculation for carts with 0 total value. Fixes double-creation of shipping billing position under certain conditions (introduced by 2.4.3)<\/li>\n<li>Fix - Change selectors for order actions to correctly display invoice \/ delivery note icons<\/li>\n<\/ul>\n\n<h4>2.4.3 - 2021-05-19<\/h4>\n\n<ul>\n<li>Fix - Fix missing shipping tax rate if tax total is 0<\/li>\n<\/ul>\n\n<h4>2.4.2 - 2021-04-12<\/h4>\n\n<ul>\n<li>Fix - Remove JavaScript confirm when deleting references, which prevented the form from being submitted correctly<\/li>\n<\/ul>\n\n<h4>2.4.1 - 2021-03-09<\/h4>\n\n<ul>\n<li>Fix - Ignore cancelled orders on invoice update webhook<\/li>\n<\/ul>\n\n<h4>2.4.0 - 2020-11-30<\/h4>\n\n<ul>\n<li>Fix - Add discount tax if Billomat tax setting is gross<\/li>\n<li>Dev - Guzzlehttp upgrade (version 6.3 to 7.2)<\/li>\n<li>Dev - Add header to Billomat API calls (WooBillomat [version])<\/li>\n<\/ul>\n\n<h4>2.3.8 - 2020-02-11<\/h4>\n\n<ul>\n<li>Fix - Add shipping items for <code>shipping<\/code> tax status: consider order items for products with tax_status shipping while creating shipping items<\/li>\n<\/ul>\n\n<h4>2.3.7 - 2019-07-18<\/h4>\n\n<ul>\n<li>Fix - Find tax rate if tax has total (fixed no passed tax rate if default WC tax class is used)<\/li>\n<\/ul>\n\n<h4>2.3.6 - 2019-07-12<\/h4>\n\n<ul>\n<li>Fix - Removed addition of discount tax<\/li>\n<li>Fix - Check invoice item tax class instead of tax total (fixed empty tax name \/ rate for items with 0% tax)<\/li>\n<\/ul>\n\n<h4>2.3.5 - 2019-05-06<\/h4>\n\n<p>Added missing $payment_method variable to map_data().<\/p>\n\n<h4>2.3.4 - 2019-04-17<\/h4>\n\n<ul>\n<li>Fix - Moved template_id parameter from invoice 'complete' to 'create'. Fixes a bug where no default invoice template is set in Billomat and WCB order status setting is 'draft' (results in unset template_id).<\/li>\n<\/ul>\n\n<h4>2.3.3 - 2019-03-27<\/h4>\n\n<ul>\n<li>Fix - Changed shipping item calculation values to avoid rounding errors.<\/li>\n<li>Fix - Removed user_email update on customer update webhook (only update billing email, not WP user email).<\/li>\n<\/ul>\n\n<h4>2.3.2 - 2019-01-29<\/h4>\n\n<ul>\n<li>Dev - Added default option to payment gateway based settings.<\/li>\n<li>Tweak - Pass order discount as invoice <code>reduction<\/code> parameter instead of own invoice item (fixes tax problems).<\/li>\n<li>Tweak - Show the order ID as context for order related error messages.<\/li>\n<li>Fix - Added fallback shipping item if new tax rate based calculation fails (if sum of tax items is 0.00).<\/li>\n<li>Fix - Find valid WC_Tax in product updater (fixes passing inactive tax classes).<\/li>\n<li>Fix - Check if get_shipping_total() is greater than 0.00 before creating shipping invoice item.<\/li>\n<\/ul>\n\n<h4>2.3.1 - 2019-01-09<\/h4>\n\n<ul>\n<li>Fix - Added separate shipping invoice items based on order items tax rates.<\/li>\n<li>Fix - Fixed typo in communication error message.<\/li>\n<\/ul>\n\n<h4>2.3.0 - 2018-11-21<\/h4>\n\n<ul>\n<li>Dev - Added option to create an invoice correction for cancelled orders.<\/li>\n<li>Dev - Separated options for creating\/delivering invoices: added new option to choose the order status for sending\/attaching invoices.<\/li>\n<li>Dev - Replaced invoice payment checkbox with a dropdown to choose the new order status.<\/li>\n<li>Fix - Avoid adding a shipping invoice item if the shipping total is 0,00.<\/li>\n<\/ul>\n\n<h4>2.2.1 - 2018-11-03<\/h4>\n\n<ul>\n<li>Fix - Discount gross\/net calculation - add get_discount_tax() to discount invoice item if Billomat tax setting is gross and WooCommerce is net.<\/li>\n<li>Fix - Removed action for deleting Billomat user due to a bug with falsely called user_delete hook.<\/li>\n<li>Fix - Added static keyword to invoice account actions to get rid of strict PHP warning.<\/li>\n<\/ul>\n\n<h4>2.2.0 - 2018-08-16<\/h4>\n\n<ul>\n<li>Dev - Added reset function for articles, clients and invoices to WooBillomat settings to delete all references to Billomat entities.<\/li>\n<li>Dev - Added Billomat ID fields to articles, variations, users and orders to allow admins to manually reset references to Billomat entities.<\/li>\n<li>Tweak - Improved error handling: display admin errors when something couldn\u00b4t be synced\/created due to deleted Billomat entities.<\/li>\n<li>Tweak - Write to error_log (aka wp-content\/debug.log) in case of an Billomat API exception (https:\/\/codex.wordpress.org\/Debugging_in_WordPress#WP_DEBUG_LOG).<\/li>\n<li>Dev - Display rating notice after 10, 30, 50 created invoices.. Give us 5 stars! :-)<\/li>\n<li>Fix - Use subtotal_tax instead of total_tax to find invoice item tax rate. This fixes a bug where free items (total 0,00) are passed without tax rate.<\/li>\n<\/ul>\n\n<h4>2.1.2 - 2018-06-25<\/h4>\n\n<ul>\n<li>Fix - Avoid generating empty WooCommerce order when a Billomat invoice is created manually.<\/li>\n<\/ul>\n\n<h4>2.1.1 - 2018-06-05<\/h4>\n\n<ul>\n<li>Fix - Fixed wrong connection failure message when adding Billomat API credentials.<\/li>\n<\/ul>\n\n<h4>2.1.0 - 2018-05-29<\/h4>\n\n<ul>\n<li>Dev - Added WooCommerce -&gt; Billomat payment mapping in order to complete invoice payments with the Billomat payment method.<\/li>\n<li>Dev - Optimized error message: added last Billomat API error to the WooCommerce Billomat backend tab.<\/li>\n<li>Fix - Fixed wrong tax calculation on invoice items in case a coupon is used (use total_tax instead of subtotal_tax).<\/li>\n<li>Fix - Added check of email type to email_attachments to avoid triggering invoice attachment for emails which are not an order confirmation.<\/li>\n<\/ul>\n\n<h4>2.0.0 - 2018-03-16<\/h4>\n\n<ul>\n<li>Dev - Added setting \"Invoice status\" to define the Billomat invoice status per payment gateway.<\/li>\n<li>Dev - Added setting \"Update orders\" to update WooCommerce orders automatically based on Billomat invoice status change webhooks.<\/li>\n<li>Dev - Added setting \"Invoice templates\" to set an invoice template per payment gateway.<\/li>\n<li>Dev - Added setting \"Sync article numbers\" to synchronize articles numbers between WooCommerceBillomat.<\/li>\n<li>Dev - Added option \"Disable description sync\" to ignore the article descriprion in export and import.<\/li>\n<li>Dev - Added setting \"Order summary\" to add an order actions invoice button \/ Order detail invoice link in customer fronted.<\/li>\n<li>Dev - Added several export\/import WordPress filters to modify the data passed from WooCommerceBillomat.<\/li>\n<li>Fix - Consider article description source in import webhook handler. This avoids overwriting the default WooCommerce description instead of the short description.<\/li>\n<li>Fix - Consider tax for coupons.<\/li>\n<li>Fix - Added netgross conversion of sales price in import.<\/li>\n<li>Fix - Consider WooCommerce sale price on import update. If a WooCommerce sale_price is set, update it instead of regular_price.<\/li>\n<li>Fix - Include empty tax_class in WC_Tax::find_rates() in build_invoice_item().<\/li>\n<li>Fix - Only add tax_name\/tax_rate if order item has tax.<\/li>\n<li>Fix - Add order shipping tax if Billomat tax setting is set to 'GROSS'.<\/li>\n<li>Dev - Added admin errors for reaching Billomat quotas. Show which quotas are reached instead of a generic error message.<\/li>\n<li>Fix - Fixed rounding errors in net  gross calculation (too less decimals).<\/li>\n<li>Fix - Added fallback for tax country for invoice items.<\/li>\n<\/ul>\n\n<h4>1.1.0 - 2017-11-02<\/h4>\n\n<ul>\n<li>Dev - Added setting \"Article description source\" to define which WooCommerce product field (description or short description) is used as Billomat article description. Defaults to short description.<\/li>\n<li>Dev - Added setting to disable invoice creation per payment gateway (or completely as until now).<\/li>\n<li>Dev - \"Draft\" added to invoice status selection. Draft-invoices can be completed at a later point in time via the order metabox. IMPORTANT: a new webhook has to be installed in Billomat (Event: Invoice \/ Change of status - see \"Billomat webhooks\").<\/li>\n<li>Fix - Implemented webhook handler for removing Billomat reference (<code>billomat_id<\/code> postmeta) from an order when an invoice is deleted in Billomat. IMPORTANT: a new webhook has to be installed in Billomat (Event: Invoice \/ delete - see \"Billomat webhooks\").<\/li>\n<\/ul>\n\n<h4>1.1.1 - 2017-11-29<\/h4>\n\n<ul>\n<li>Fix - Consider Billomat tax setting (net\/gross) when creating invoice items - add tax price to total if Billomat tax is set to gross.<\/li>\n<li>Fix - Wrap free texts single-resource response in array as Billomat API returns an one-dimensional array.<\/li>\n<li>Fix - Moved autoload include to WCB_Client due to an autoload error in certain environments.<\/li>\n<li>Tweak - Don\u00b4t cache Billomat tax setting (net\/gross) - request directly via API when needed. This avoids problems when Billomat settings change.<\/li>\n<li>Tweak - Added error handling to all WCB_Client API call methods. An admin error notice will be added in case there are any Guzzle exceptions.<\/li>\n<li>Fix - Empty return replaced with <code>return $attachments<\/code> in <code>email_attachments<\/code> callback.<\/li>\n<\/ul>","raw_excerpt":"Connect WooCommerce to Billomat and generate clients, articles and invoices automatically.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/85993","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=85993"}],"author":[{"embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/billomatcom"}],"wp:attachment":[{"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=85993"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=85993"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=85993"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=85993"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=85993"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ga.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=85993"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}