Token: in Bokio go to Settings \u2192 API Tokens \u2192 Create token.
\nCompany ID: open the \u201cAPI Tokens \/ Private integrations\u201d page and copy the ID from the URL: https:\/\/app.bokio.se\/<companyId>\/settings-r\/private-integrations<\/code><\/p><\/dd>\nDo I need a Bokio account?<\/h3><\/dt>\nYes, an active Bokio account with rights to create invoices or cash sales is required. The plugin relies on Bokio\u2019s API via the Peki service.<\/p><\/dd>\n
Can I connect multiple stores?<\/h3><\/dt>\nYes, unlimited WordPress sites can connect to the same Bokio company. All sites share the monthly transfer quota tied to that company.<\/p><\/dd>\n
Is the plugin compatible with HPOS?<\/h3><\/dt>\nYes, the plugin is fully compatible with WooCommerce High-Performance Order Storage.<\/p><\/dd>\n
What data is sent to external services?<\/h3><\/dt>\nThe plugin sends order data to peki.no<\/code> (the export service) and bokio.com<\/code> (the accounting platform) to create vouchers. Only the data needed to build the accounting document is transmitted. See the privacy policies on both domains for details.<\/p><\/dd>\nIs my data secure?<\/h3><\/dt>\nYes. All communication happens over HTTPS, tokens are stored outside your WordPress database, and logs mask sensitive values.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.0.2<\/h4>\n\n\n- Docs: Updated pricing, product link, and added embedded how-to video (nocookie) in readme.<\/li>\n
- UI: Embedded \u201cHow to connect Bokio\u201d video in the settings side panel.<\/li>\n
- Notice: Connection banner now trusts cached status\/flags to avoid false \u201cnot connected\u201d warnings.<\/li>\n
- Meta: Version bump to 1.0.2.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Docs: Added clear steps to locate the Bokio Company ID and API token with direct URL pattern.<\/li>\n
- Docs: Pricing section tightened with monthly ex-VAT labels.<\/li>\n
- Meta: Version bump to 1.0.1.<\/li>\n<\/ul>\n\n
1.0.18<\/h4>\n\n\n- Rebrand: UI copy, settings menus, documentation, and notices now refer to Bokio.<\/li>\n
- Maintenance: Version bump and documentation sync.<\/li>\n<\/ul>\n\n
1.0.17<\/h4>\n\n\n- UI: Advanced page grouped into \u201cExport rules\u201d and \u201cGrowth features\u201d with larger checkboxes and clearer descriptions.<\/li>\n
- UI: GROWTH badge with hover tooltip on gated settings; portal link shown when not eligible.<\/li>\n
- Enforcement: Per-payment document type overrides are Growth-gated in both UI and saving logic (server continues to enforce PDF feature).<\/li>\n
- Multi-site: Added
company_slug<\/code> to portal\/checkout links so upgrades apply across all sites tied to the same Bokio company.<\/li>\n- Upgrade flow: If a subscription exists, \u201cChoose plan\u201d routes to the portal to upgrade instead of creating a second subscription.<\/li>\n
- CSS: Added styles for Growth badge and larger checkboxes.<\/li>\n
- Change: All plugin endpoints now use Bokio-specific paths for status and portal calls.<\/li>\n
- Added: New Bokio status endpoint mirroring root behavior.<\/li>\n
- Fix: Bokio customer portal include path corrected to load local
env.php<\/code>.<\/li>\n- Fix: Growth gating now reads the plan via the Bokio status endpoint using the current shop URL (immediate unlock after upgrade).<\/li>\n
- UI\/Docs: Plan Benefits section and plan card bullets added; removed \u201cPriority support\u201d mention from Pro.<\/li>\n<\/ul>\n\n
1.0.16<\/h4>\n\n\n- Enforcement: Automatic invoice PDF saving is Growth-only and gated server-side; local code edits cannot bypass the gate.<\/li>\n
- UI: Advanced toggle for \u201cAutomatically save invoice PDFs to Media Library\u201d is disabled unless the current plan is Growth (based on cached server status).<\/li>\n
- UI: Order notes now show a \u201cDownload PDF\u201d button for saved attachments.<\/li>\n
- Dev: Added binary download helpers and 401 refresh to the legacy client; PDF endpoint added with plan check.<\/li>\n
- Fix: Customer portal link reliability improved (includes
shop<\/code>, shop_url<\/code>, v=3<\/code>, connection_id<\/code>).<\/li>\n- Fix: Partial credit notes refunded amounts match requested gross by scaling line quantities; fallback derives net from gross using VAT type.<\/li>\n<\/ul>\n\n
1.0.15<\/h4>\n\n\n- Fix: Prevent duplicate customers in Bokio by reusing existing contact by email when available (server-side).<\/li>\n
- Fix: Amount scaling guard \u2014 clamp minor unit factor to 100 (SEK) to avoid 1\/100 totals if decimals are misreported.<\/li>\n
- Fix: Advanced \u201cDocument Type per Payment Method\u201d no longer resets when saving Bank Account Mapping; BACS override persists.<\/li>\n
- Change: Default bank account fallback aligned with UI to 1920:10001 (Operating account). Previously defaulted to 1960.<\/li>\n
- Dev\/Compat: Advanced saves keep existing per-gateway overrides when the cash map isn\u2019t posted.<\/li>\n
- Added: Optional automatic invoice PDF download to Media Library with order attachment and \u201cDownload PDF\u201d button in order notes. Requires Growth subscription; enforced server-side.<\/li>\n
- Added: Advanced setting toggle for invoice PDF saving (disabled unless on Growth based on server status cache).<\/li>\n
- Fix: Customer portal button reliability \u2014 includes
shop<\/code>, shop_url<\/code>, v=3<\/code>, and connection_id<\/code> to ensure correct account routing.<\/li>\n- Fix: Partial credit notes now match requested refund gross by proportionally scaling line quantity; fallback derives net from gross by VAT type (prevents over-crediting full line).<\/li>\n
- Dev: Backend endpoint to fetch invoice PDF and binary client helpers; token refresh on 401 for binary requests too.<\/li>\n<\/ul>\n\n
1.0.14<\/h4>\n\n\n- Fix: Per-payment \u201cDocument Type\u201d override is now always honored (bypasses master toggle). BACS set to Invoice now forces
cash=false<\/code>.<\/li>\n- Dev: Added filter
pekibokio_cash_flag<\/code> to allow programmatic override of the cash flag.<\/li>\n- UI: Support tab simplified to direct email link (petter@peki.no), web form removed.<\/li>\n
- Docs: Added Screenshots section; updated links to
peki.no\/bokio<\/code>.<\/li>\n- Compliance: Additional translators comments\/escaping for PHPCS.<\/li>\n<\/ul>\n\n
1.0.13<\/h4>\n\n\n- Added: Per-payment \u201cDocument Type\u201d control (Invoice vs CashSale) with Advanced-tab master toggle.<\/li>\n
- Added: Live enable\/disable of per-gateway dropdowns when master toggle changes.<\/li>\n
- Added: Orders list column shows Bokio export status with Woo dashicons (HPOS + legacy).<\/li>\n
- Added: Admin \u201cOrder actions\u201d entry to force export to Bokio (overrides duplicate guard).<\/li>\n
- Improved: Prevent auto-export on status change if already exported (idempotency).<\/li>\n
- Improved: Amount scaling respects WooCommerce price decimals; server normalizes to \u00f6re.<\/li>\n
- Fix: Server accepts
bankAccountCode<\/code> for both cash and invoice documents to satisfy the Bokio API.<\/li>\n- Compliance: PHPCS fixes (translators comments, placeholder ordering, escaping, prefixed globals).<\/li>\n<\/ul>\n\n
1.0.12<\/h4>\n\n\n- Added: Order notes now show export status (success\/error) with invoice IDs.<\/li>\n
- Added: Norwegian (Bokm\u00e5l) translation.<\/li>\n
- Improved: Notifications now fetch quota from Peki server automatically.<\/li>\n
- Improved: Dismiss notifications reset when usage values change.<\/li>\n
- Fix: Removed unsupported API parameters causing 400 errors.<\/li>\n<\/ul>\n\n
1.0.11<\/h4>\n\n\n- Fix: Bank account mapping functionality improved.<\/li>\n
- Fix: Admin notifications dismiss handling.<\/li>\n<\/ul>\n\n
1.0.10<\/h4>\n\n\n- Fix: Free-plan \u201climit reached (15)\u201d notice now triggers only when remaining == 0 (or used >= limit if remaining is unknown). Prevents premature hard-stop banners.<\/li>\n
- Tweak: Soft warning shows at ~10\/15 only when usage can be derived (used or remaining known).<\/li>\n
- Hardening: Safer parsing of quota options (treat empty\/false as unset) to avoid misreads.<\/li>\n
- UX: Dismiss keys are period-scoped; notices respect monthly reset.<\/li>\n
- Internals: Prefer fresh server quota; fall back to cached status only when necessary.<\/li>\n<\/ul>\n\n
1.0.9<\/h4>\n\n\n- Added: Support for VAT code 52.<\/li>\n
- Improved: Stability of admin notices (dismiss handling and consistent display).<\/li>\n<\/ul>\n\n
1.0.8<\/h4>\n\n\n- Fix: Refund bugs resolved for better accuracy and compatibility.<\/li>\n
- Fix: Account mapping improvements.<\/li>\n<\/ul>\n\n
1.0.7<\/h4>\n\n\n- Improvement: Refund handling refined for better accuracy and compatibility.<\/li>\n
- Feature: Added setting to disable VAT (MVA) when needed.<\/li>\n<\/ul>\n\n
1.0.6<\/h4>\n\n\n- Fix: PHPCS warnings resolved for OAuth callback handling and webhook signature validation.<\/li>\n
- Improvement: Enhanced installation instructions with mandatory Bokio API activation and first invoice creation.<\/li>\n
- Docs: Clarified that Bokio invoice counter and customer counter must be initialized before the API integration works.<\/li>\n
- Security: Proper sanitization and unslashing of server variables in webhook endpoint.<\/li>\n<\/ul>\n\n
1.0.5<\/h4>\n\n\n- Fix: Duplicate \u201cConnect to Bokio\u201d notice; render guarded to run once per request.<\/li>\n
- Improvement: Quota notices now read from cached server status (shared per
company_slug<\/code>), with webhook\/cron refresh.<\/li>\n- Docs: Added Bokio API requirements and first-invoice note; clarified multi-site behavior and pricing plans.<\/li>\n
- Meta: Bumped \u201cTested up to\u201d to 6.8; updated Stable tag.<\/li>\n<\/ul>\n\n
1.0.4<\/h4>\n\n\n- Docs: English-only readme per WordPress.org requirements; improved SEO wording for WooCommerce\/Bokio integration.<\/li>\n
- Product: Clarified free tier (15 transfers\/month) and option to upgrade to unlimited.<\/li>\n
- Docs: Removed references to manual \u201cSend to Bokio\u201d actions and subscription support (not available).<\/li>\n
- Link: Updated to https:\/\/peki.no\/bokio in the description.<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Compliance: Neutralized upgrade\/plan wording; \u201cManage Subscription\u201d link only.<\/li>\n
- Security: Reviewed nonce and capability checks in connect\/disconnect flows.<\/li>\n
- Prefix: Migrated internal keys to
pekibokio_<\/code> with legacy fallbacks.<\/li>\n- API: Plan\/limits decided by remote service; plugin surfaces neutral errors.<\/li>\n
- Docs: Expanded \u201cExternal services.\u201d<\/li>\n<\/ul>\n\n
1.0.2<\/h4>\n\n\n- Documentation updates and refund handling improvements.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- First public release.<\/li>\n<\/ul>","raw_excerpt":"Connect WooCommerce to Bokio to export orders automatically and keep ledgers, VAT, and documentation in sync.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/265578","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=265578"}],"author":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/peki"}],"wp:attachment":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=265578"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=265578"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=265578"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=265578"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=265578"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=265578"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}