{"id":391477,"date":"2026-10-26T11:05:52","date_gmt":"2026-10-26T11:05:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/faktura1-for-woocommerce\/"},"modified":"2026-10-26T16:18:31","modified_gmt":"2026-10-26T16:18:31","slug":"faktura1-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/faktura1-for-woocommerce\/","author":23591221,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.2.1","stable_tag":"0.2.1","tested":"7.1.4","requires":"6.8","requires_php":"7.4","requires_plugins":null,"header_name":"Faktura1 for WooCommerce","header_author":"Faktura1","header_description":"Creates Faktura1 invoices, proformas, credit notes and payment status updates from WooCommerce orders.","assets_banners_color":"","last_updated":"2026-10-26 16:18:31","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/api.faktura1.com\/docs\/","header_author_uri":"https:\/\/www2.faktura1.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":78,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"0.2.0":{"tag":"0.2.0","author":"faktura1","date":"2026-10-26 11:05:22","revision":3766213},"0.2.1":{"tag":"0.2.1","author":"faktura1","date":"2026-10-26 16:18:31","revision":3766890}},"upgrade_notice":{"0.2.1":"<p>Fix repeated refund handling. Existing settings, document references and historical duplicates are retained; no financial documents are deleted.<\/p>","0.2.0":"<p>Authorize the external service in WooCommerce &gt; Faktura1 before requests resume. Review mappings and automatic statuses. Deactivate the old faktura1-woocommerce copy before activating this version; settings and order references are retained.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3766931,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3766931,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.2.0","0.2.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2526,16236,26218,41755,286],"plugin_category":[45],"plugin_contributors":[288679],"plugin_business_model":[],"class_list":["post-391477","plugin","type-plugin","status-publish","hentry","plugin_tags-accounting","plugin_tags-invoices","plugin_tags-invoicing","plugin_tags-proforma","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-faktura1","plugin_committers-faktura1"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/faktura1-for-woocommerce\/assets\/icon-128x128.png?rev=3766931","icon_2x":"https:\/\/ps.w.org\/faktura1-for-woocommerce\/assets\/icon-256x256.png?rev=3766931","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Faktura1 for WooCommerce connects your store to the Faktura1 invoicing service.\nA Faktura1 account and an API token with WooCommerce source are required.\nThe plugin is free. Service availability and charges depend on your Faktura1 plan.<\/p>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Create invoices and proformas manually from the order administration screen, with confirmation.<\/li>\n<li>Optionally create documents when configured WooCommerce order statuses change.<\/li>\n<li>Optionally create credit notes when orders are refunded.<\/li>\n<li>Map payment methods, payment statuses, VAT rates, units and languages using company-specific API lists.<\/li>\n<li>Map existing billing and order metadata fields for company name, registration number, VAT number and responsible person.<\/li>\n<li>Block company document creation when company name or registration number is missing.<\/li>\n<li>Display document numbers, dates and PDF links with orders.<\/li>\n<li>Delete eligible remote documents with confirmation, then remove their local references.<\/li>\n<li>Use WooCommerce order CRUD for both HPOS and legacy order storage.<\/li>\n<\/ul>\n\n<p>The plugin does not add checkout fields. Configure existing fields or another checkout-field plugin to collect company details.\nCustom metadata must be saved with the WooCommerce order. Checkout Blocks and classic checkout may save custom fields differently.<\/p>\n\n<p>Documentation: https:\/\/api.faktura1.com\/docs\/\nService: https:\/\/www2.faktura1.com\/<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin uses the Faktura1 API, by default at https:\/\/api.faktura1.com\/api\/v1.\nIt sends no integration requests until a store administrator explicitly authorizes the service in WooCommerce &gt; Faktura1.<\/p>\n\n<p>When you save credentials and authorize the connection, opening the settings page or testing the connection sends the API token and requested language to retrieve your company's nomenclatures and defaults. These settings are cached locally for five minutes.<\/p>\n\n<p>Creating an invoice or proforma sends order identifiers, document dates, billing name and address, billing email, mapped company registration\/VAT numbers and responsible-person details (when provided), products, shipping, fees, quantities, prices, taxes, totals, currency, payment method\/status and document language to Faktura1. Creation is triggered manually or by configured order statuses when the integration is enabled.<\/p>\n\n<p>Refund processing sends invoice\/order\/refund identifiers, refunded items and amounts. Payment updates send order identifiers and the mapped payment status. Deleting a document sends its Faktura1 document ID. Faktura1 may email the document to the billing email when the corresponding option is enabled.<\/p>\n\n<p>API tokens are stored in WordPress options and transmitted as Bearer authentication over HTTPS. A custom public HTTPS API address can be configured; it receives the same data and must be trusted by the administrator. HTTP redirects are not followed. There is no telemetry, remote executable code or separate update service.<\/p>\n\n<p>Faktura1 Terms of Service: https:\/\/www2.faktura1.com\/en\/rules-details\/L1UwbEtqd1lJZ29mVktiSnNaMURUUT09\nFaktura1 Privacy Policy: https:\/\/www2.faktura1.com\/en\/rules-details\/a1RiVHB5Um15cStnRWdKN0lUSEtwQT09<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce 10.0 or newer on WordPress 6.8 or newer with PHP 7.4 or newer.<\/li>\n<li>Install the plugin ZIP through Plugins &gt; Add New &gt; Upload Plugin, then activate it.<\/li>\n<li>Sign in to Faktura1 and create an API integration with source WooCommerce. Give it the document scopes required by your workflow.<\/li>\n<li>As a WordPress administrator, open WooCommerce &gt; Faktura1. Enter the API token, review the external-service disclosure and authorize the connection. Save the settings.<\/li>\n<li>Test the API connection. Company lists and mapping controls appear after a successful connection.<\/li>\n<li>Choose the default invoice book, warehouse, unit, currency, bank account, VAT rate and language, and configure mappings for your store.<\/li>\n<li>Configure company fields and the document workflow. Clear the automatic status lists to use manual creation only. Enable the integration and save.<\/li>\n<li>Test an order and check its document number, date, totals, company details and PDF before using the integration for live orders.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20a%20faktura1%20account%3F\"><h3>Do I need a Faktura1 account?<\/h3><\/dt>\n<dd><p>Yes. An account and a valid company API token are required. This is a connector to the external service, not a standalone invoice generator.<\/p><\/dd>\n<dt id=\"who%20can%20configure%20the%20plugin%3F\"><h3>Who can configure the plugin?<\/h3><\/dt>\n<dd><p>WordPress administrators with manage_options can configure credentials and mappings. Users with manage_woocommerce can use the order document actions.<\/p><\/dd>\n<dt id=\"can%20i%20create%20documents%20manually%20only%3F\"><h3>Can I create documents manually only?<\/h3><\/dt>\n<dd><p>Yes. Clear both automatic creation status fields and disable automatic credit notes and payment updates. Document buttons remain available when the integration is enabled and authorized.<\/p><\/dd>\n<dt id=\"does%20it%20support%20company%20invoices%3F\"><h3>Does it support company invoices?<\/h3><\/dt>\n<dd><p>Yes. Map existing fields for company name and registration number; both are required for company invoices. VAT number and responsible person are optional. The plugin does not create new checkout inputs.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20hpos%3F\"><h3>Does it work with HPOS?<\/h3><\/dt>\n<dd><p>The integration uses WC_Order CRUD and declares compatibility with WooCommerce High-Performance Order Storage. It also supports legacy order storage.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20i%20delete%20a%20document%3F\"><h3>What happens when I delete a document?<\/h3><\/dt>\n<dd><p>After confirmation the plugin requests deletion in Faktura1. The local order reference is removed only after a successful response. Faktura1 business rules may refuse deletion, for example for an accounted document.<\/p><\/dd>\n<dt id=\"what%20data%20remains%20after%20uninstall%3F\"><h3>What data remains after uninstall?<\/h3><\/dt>\n<dd><p>Uninstall removes plugin settings, the stored API token and nomenclature caches for the current site. Order document references and financial documents in Faktura1 are retained. Optional technical logs follow WooCommerce's log retention. Multisite installations must remove per-site settings individually; network-wide activation is not supported.<\/p><\/dd>\n<dt id=\"are%20logs%20enabled%20by%20default%3F\"><h3>Are logs enabled by default?<\/h3><\/dt>\n<dd><p>No. Optional WooCommerce diagnostics contain technical identifiers and error codes, not API tokens, complete billing payloads or complete API responses. Orders retain document references and sanitized integration errors.<\/p><\/dd>\n<dt id=\"how%20do%20i%20upgrade%20from%20the%20original%20plugin%20folder%3F\"><h3>How do I upgrade from the original plugin folder?<\/h3><\/dt>\n<dd><p>Deactivate the copy in faktura1-woocommerce before activating the WordPress.org copy in faktura1-for-woocommerce. Do not activate both. Existing settings and order references use the same keys. Review and authorize the external service after upgrade.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.2.1<\/h4>\n\n<ul>\n<li>Add Bulgarian interface translations, including settings, confirmations and order messages.<\/li>\n<li>Skip already recorded successful refunds without duplicate credit-note requests, local references or order notes.<\/li>\n<li>Keep separate partial refunds and explicit retries after failed attempts working; preserve existing order history.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Add WordPress.org readme, GPL license and external-service\/privacy disclosures.<\/li>\n<li>Require explicit administrator authorization for the Faktura1 service.<\/li>\n<li>Use safe HTTPS requests without redirects and validate API responses.<\/li>\n<li>Keep billing payloads and API response bodies out of technical logs.<\/li>\n<li>Restrict credentials and mappings to administrators; disable document actions when the integration is disabled.<\/li>\n<li>Preserve mappings while disconnected, isolate the metadata cache per token\/language and use mapped payment statuses for updates and refunds.<\/li>\n<li>Add HPOS compatibility declaration, enqueued confirmation script and uninstall cleanup.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial WooCommerce integration.<\/li>\n<\/ul>","raw_excerpt":"Connect WooCommerce orders to Faktura1 to create invoices, proformas and credit notes with configurable field and payment mappings.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/391477","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=391477"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/faktura1"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=391477"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=391477"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=391477"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=391477"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=391477"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=391477"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}