Description
Webshop sales go straight into your accounting. Peki – Bokio Integration for WooCommerce connects the store to LedgerIntegration, which books every paid WooCommerce order in Bokio or Fiken with the right VAT and shipping. Line items and shipping use the correct VAT rate. You see what has been sent, what is waiting, and what needs a look.
Connect the store from WordPress, approve the connection, then connect Bokio or Fiken in LedgerIntegration. New paid orders are sent automatically after that. The previous Peki connection to Bokio still works if you do not connect LedgerIntegration.
Visit ledgerintegration.com for more information.
Key Features
- Paid WooCommerce orders booked automatically in Bokio or Fiken
- Correct VAT on line items and shipping
- Orders are sent when the status is Processing or Completed
- Send one order manually, or send the last 10 paid orders from the settings
- Overview of what has been transferred, what is waiting, and what needs a look
- VAT handling and immediate transfer on every plan
- 10 free transfers every month, no card required
- Data stored in the EU and processed under GDPR, over encrypted HTTPS/TLS
- API key stored in WordPress and encrypted with libsodium when available
- Disconnect at any time
- WooCommerce HPOS compatibility
- The existing Peki connection to Bokio remains available until you connect LedgerIntegration
Refunds are not sent to LedgerIntegration yet. Enter them manually in Bokio or Fiken while that connection is active.
Requirements
Before using this plugin, you need:
- WooCommerce installed and activated
- A LedgerIntegration account (the free plan does not require a card)
- A Bokio or Fiken company to book the sales in. A Bokio company needs a subscription with API access
- Outbound HTTPS from your WordPress host
Free Plan
10 transfers every month. No card is required for the free plan. Free transfers reset on the 1st of each month. Orders above the limit wait, and are sent when the month resets or immediately if you upgrade. Nothing is dropped.
Pricing (monthly, ex. VAT)
Prices are LedgerIntegration’s current plans. See ledgerintegration.com for the live list.
- Free: 0 kr/month — 10 transfers/month, 1 connection. No card
- Start: 99 kr/month — 200 transfers/month, 1 connection
- Growth: 249 kr/month — 1,000 transfers/month, 3 connections
- Pro: 499 kr/month — 5,000 transfers/month, unlimited connections
VAT handling and immediate transfer are included in every plan. You can change plan or cancel at any time. There is no lock-in.
Plan Benefits
- Free:
- 10 transfers/month
- 1 connection
- No card
- Start:
- 200 transfers/month
- 1 connection
- Growth:
- 1,000 transfers/month
- 3 connections
- Pro:
- 5,000 transfers/month
- Unlimited connections
Note: This is an independent third-party plugin. We are not affiliated with Bokio AB, Fiken, or WooCommerce/Automattic.
External Services
This plugin connects to external services to function. The legacy Peki/Bokio flow is unchanged when LedgerIntegration is not connected.
Peki and Bokio
- Peki export service (
https://peki.no) – Receives order data and forwards it to Bokio when you use the built-in connection (manual API token). Data is sent when an order is completed, when a refund is created, and when you force-export an order. Requests include the store URL. - Bokio (
https://bokio.com,https://app.bokio.se) – Accounting platform where vouchers are created. The plugin links to Bokio so you can copy the company ID and API token.
LedgerIntegration
Optional. Nothing is sent to LedgerIntegration until a shop manager clicks “Connect to LedgerIntegration” and approves the connection.
Services contacted:
- LedgerIntegration app (
https://app.ledgerintegration.com) – The browser is redirected to/connect/woocommerceto start the connection. The query contains the store URL (home_url()), store name, redirect URI back to this site, a one-timestatevalue, a PKCE code challenge (not the verifier), plugin slugpeki-bokio, plugin version and locale. The API key is never put in the URL. - LedgerIntegration API (
https://cvugrlsvuqvjopivzbff.supabase.co, Supabase Edge Functions under/functions/v1/) – After approval, the plugin exchanges the authorization code for an API key at/functions/v1/plugin-connect. Later calls go to/functions/v1/plugin-api(or an HTTPS URL the service returns). Those calls send the store URL and plugin version in the User-Agent (PekiBokio/<version>; <store URL>). Order calls send the WooCommerce REST representation of the order and the event nameorder.updated.
The Upgrade screen, when the store is connected, calls the same API with the actions status and plans to show the current plan, monthly usage and prices. That request does not include order data. Choosing a plan opens LedgerIntegration, where billing is completed. If the API does not return a price list, the screen shows LedgerIntegration’s public prices (Free 0, Start 99 kr, Growth 249 kr, Pro 499 kr per month, ex. VAT; euro prices on English locales).
Order data is sent only when:
- an order moves to Processing or Completed
- a shop manager chooses “Send to LedgerIntegration” on an order
- a shop manager chooses “Send last 10 paid orders” in the LedgerIntegration settings
The API key is stored in WordPress and encrypted with libsodium when the PHP sodium extension is available. It is not written to logs, URLs or the settings screen in full. Refunds are not sent to LedgerIntegration yet and must be entered manually.
Terms and privacy:
- Terms of service: https://ledgerintegration.com/terms
- Privacy policy: https://ledgerintegration.com/privacy
By connecting LedgerIntegration you agree to processing on these servers.
Installation
- Install the plugin through WordPress or upload it to
/wp-content/plugins/ - Activate the plugin
- In WordPress admin, open Bokio and stay on the Ledger tab
- Click “Connect to LedgerIntegration”, sign in, and approve the store
- Connect Bokio or Fiken in LedgerIntegration and choose the company that should receive the sales
- Paid orders are sent automatically when the status is Processing or Completed
The Connection tab still accepts a Bokio company ID and API token for stores that keep using the previous Peki export.
FAQ
Where do I find Company ID and API token?
Token: in Bokio go to Settings → API Tokens → Create token.
Company ID: open the “API Tokens / Private integrations” page and copy the ID from the URL: https://app.bokio.se/<companyId>/settings-r/private-integrations
Do I need a Bokio account?
You need a Bokio or Fiken company, connected from LedgerIntegration after the store is linked. A Bokio company needs a subscription with API access. The previous Peki export still requires a Bokio company ID and API token.
What does it cost?
Free for 10 transfers a month, with no card. Paid plans start at 99 kr/month ex. VAT. See the Pricing section.
What happens after 10 transfers?
New orders wait and are sent automatically when the month resets on the 1st, or immediately if you upgrade. Nothing is dropped.
Can I connect multiple stores?
Free and Start include 1 connection. Growth includes 3. Pro includes unlimited connections. Each connection is one store linked to an accounting company.
Can I cancel?
Yes. There is no lock-in. You can change plan or disconnect the store at any time.
Is the plugin compatible with HPOS?
Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage.
What data is sent to external services?
Nothing is sent to LedgerIntegration until a shop manager connects and approves it. After that, order data, the store URL and the plugin version are sent when an order is Processing or Completed. The built-in Bokio connection sends order data to peki.no and on to Bokio when an order is completed, refunded, or force-exported, and only while LedgerIntegration is not connected. See External services below, including terms and privacy links.
Is my data secure?
Data is stored in the EU and processed under GDPR. Connections use HTTPS/TLS. The LedgerIntegration API key is stored in WordPress and encrypted with libsodium when the PHP sodium extension is available. It is not written to logs, URLs, or the settings screen in full. You sign in at LedgerIntegration; this plugin does not ask for your Bokio or Fiken password.
Changelog
1.0.6
- Fix: A connected LedgerIntegration account is no longer reported as not connected.
- Languages: English, Norwegian (Bokmål) and Swedish.
1.0.5
- Ledger: Status updates on its own after Bokio or Fiken is connected. You no longer need to press Refresh status.
1.0.4
- Added: Optional LedgerIntegration connection (Bokio, Fiken and more). The existing Peki/Bokio token flow, settings tabs, status page and REST
/bokio/v1/pingendpoint are unchanged when LedgerIntegration is not connected. - Added: Orders moving to Processing or Completed are queued to LedgerIntegration. Refunds are not sent yet.
- Security: The LedgerIntegration API key is encrypted with libsodium when available. While that connection is active, the legacy Bokio auto-export and “Export to Bokio (force)” action are paused so an order is not booked twice.
- Compatibility: Tested with WordPress 7.1 and WooCommerce 11.2. Requires WordPress 6.7 and WooCommerce 9.0.
- Docs: Description and pricing now follow LedgerIntegration: 10 free transfers/month, then Start 99 kr, Growth 249 kr, and Pro 499 kr per month, ex. VAT. Removed the how-to video.
- Upgrade: The subscription screen loads plan, usage and prices from LedgerIntegration.
1.0.2
- Docs: Updated pricing, product link, and added embedded how-to video (nocookie) in readme.
- UI: Embedded “How to connect Bokio” video in the settings side panel.
- Notice: Connection banner now trusts cached status/flags to avoid false “not connected” warnings.
- Meta: Version bump to 1.0.2.
1.0.1
- Docs: Added clear steps to locate the Bokio Company ID and API token with direct URL pattern.
- Docs: Pricing section tightened with monthly ex-VAT labels.
- Meta: Version bump to 1.0.1.
1.0.18
- Rebrand: UI copy, settings menus, documentation, and notices now refer to Bokio.
- Maintenance: Version bump and documentation sync.
1.0.17
- UI: Advanced page grouped into “Export rules” and “Growth features” with larger checkboxes and clearer descriptions.
- UI: GROWTH badge with hover tooltip on gated settings; portal link shown when not eligible.
- Enforcement: Per-payment document type overrides are Growth-gated in both UI and saving logic (server continues to enforce PDF feature).
- Multi-site: Added
company_slugto portal/checkout links so upgrades apply across all sites tied to the same Bokio company. - Upgrade flow: If a subscription exists, “Choose plan” routes to the portal to upgrade instead of creating a second subscription.
- CSS: Added styles for Growth badge and larger checkboxes.
- Change: All plugin endpoints now use Bokio-specific paths for status and portal calls.
- Added: New Bokio status endpoint mirroring root behavior.
- Fix: Bokio customer portal include path corrected to load local
env.php. - Fix: Growth gating now reads the plan via the Bokio status endpoint using the current shop URL (immediate unlock after upgrade).
- UI/Docs: Plan Benefits section and plan card bullets added; removed “Priority support” mention from Pro.
1.0.16
- Enforcement: Automatic invoice PDF saving is Growth-only and gated server-side; local code edits cannot bypass the gate.
- UI: Advanced toggle for “Automatically save invoice PDFs to Media Library” is disabled unless the current plan is Growth (based on cached server status).
- UI: Order notes now show a “Download PDF” button for saved attachments.
- Dev: Added binary download helpers and 401 refresh to the legacy client; PDF endpoint added with plan check.
- Fix: Customer portal link reliability improved (includes
shop,shop_url,v=3,connection_id). - Fix: Partial credit notes refunded amounts match requested gross by scaling line quantities; fallback derives net from gross using VAT type.
1.0.15
- Fix: Prevent duplicate customers in Bokio by reusing existing contact by email when available (server-side).
- Fix: Amount scaling guard — clamp minor unit factor to 100 (SEK) to avoid 1/100 totals if decimals are misreported.
- Fix: Advanced “Document Type per Payment Method” no longer resets when saving Bank Account Mapping; BACS override persists.
- Change: Default bank account fallback aligned with UI to 1920:10001 (Operating account). Previously defaulted to 1960.
- Dev/Compat: Advanced saves keep existing per-gateway overrides when the cash map isn’t posted.
- Added: Optional automatic invoice PDF download to Media Library with order attachment and “Download PDF” button in order notes. Requires Growth subscription; enforced server-side.
- Added: Advanced setting toggle for invoice PDF saving (disabled unless on Growth based on server status cache).
- Fix: Customer portal button reliability — includes
shop,shop_url,v=3, andconnection_idto ensure correct account routing. - 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).
- Dev: Backend endpoint to fetch invoice PDF and binary client helpers; token refresh on 401 for binary requests too.
1.0.14
- Fix: Per-payment “Document Type” override is now always honored (bypasses master toggle). BACS set to Invoice now forces
cash=false. - Dev: Added filter
pekibokio_cash_flagto allow programmatic override of the cash flag. - UI: Support tab simplified to direct email link (petter@peki.no), web form removed.
- Docs: Added Screenshots section; updated links to
peki.no/bokio. - Compliance: Additional translators comments/escaping for PHPCS.
1.0.13
- Added: Per-payment “Document Type” control (Invoice vs CashSale) with Advanced-tab master toggle.
- Added: Live enable/disable of per-gateway dropdowns when master toggle changes.
- Added: Orders list column shows Bokio export status with Woo dashicons (HPOS + legacy).
- Added: Admin “Order actions” entry to force export to Bokio (overrides duplicate guard).
- Improved: Prevent auto-export on status change if already exported (idempotency).
- Improved: Amount scaling respects WooCommerce price decimals; server normalizes to öre.
- Fix: Server accepts
bankAccountCodefor both cash and invoice documents to satisfy the Bokio API. - Compliance: PHPCS fixes (translators comments, placeholder ordering, escaping, prefixed globals).
1.0.12
- Added: Order notes now show export status (success/error) with invoice IDs.
- Added: Norwegian (Bokmål) translation.
- Improved: Notifications now fetch quota from Peki server automatically.
- Improved: Dismiss notifications reset when usage values change.
- Fix: Removed unsupported API parameters causing 400 errors.
1.0.11
- Fix: Bank account mapping functionality improved.
- Fix: Admin notifications dismiss handling.
1.0.10
- Fix: Free-plan “limit reached (15)” notice now triggers only when remaining == 0 (or used >= limit if remaining is unknown). Prevents premature hard-stop banners.
- Tweak: Soft warning shows at ~10/15 only when usage can be derived (used or remaining known).
- Hardening: Safer parsing of quota options (treat empty/false as unset) to avoid misreads.
- UX: Dismiss keys are period-scoped; notices respect monthly reset.
- Internals: Prefer fresh server quota; fall back to cached status only when necessary.
1.0.9
- Added: Support for VAT code 52.
- Improved: Stability of admin notices (dismiss handling and consistent display).
1.0.8
- Fix: Refund bugs resolved for better accuracy and compatibility.
- Fix: Account mapping improvements.
1.0.7
- Improvement: Refund handling refined for better accuracy and compatibility.
- Feature: Added setting to disable VAT (MVA) when needed.
1.0.6
- Fix: PHPCS warnings resolved for OAuth callback handling and webhook signature validation.
- Improvement: Enhanced installation instructions with mandatory Bokio API activation and first invoice creation.
- Docs: Clarified that Bokio invoice counter and customer counter must be initialized before the API integration works.
- Security: Proper sanitization and unslashing of server variables in webhook endpoint.
1.0.5
- Fix: Duplicate “Connect to Bokio” notice; render guarded to run once per request.
- Improvement: Quota notices now read from cached server status (shared per
company_slug), with webhook/cron refresh. - Docs: Added Bokio API requirements and first-invoice note; clarified multi-site behavior and pricing plans.
- Meta: Bumped “Tested up to” to 6.8; updated Stable tag.
1.0.4
- Docs: English-only readme per WordPress.org requirements; improved SEO wording for WooCommerce/Bokio integration.
- Product: Clarified free tier (15 transfers/month) and option to upgrade to unlimited.
- Docs: Removed references to manual “Send to Bokio” actions and subscription support (not available).
- Link: Updated to https://peki.no/bokio in the description.
1.0.3
- Compliance: Neutralized upgrade/plan wording; “Manage Subscription” link only.
- Security: Reviewed nonce and capability checks in connect/disconnect flows.
- Prefix: Migrated internal keys to
pekibokio_with legacy fallbacks. - API: Plan/limits decided by remote service; plugin surfaces neutral errors.
- Docs: Expanded “External services.”
1.0.2
- Documentation updates and refund handling improvements.
1.0.0
- First public release.
