Peki – Fiken Integration for WooCommerce
| 开发者 | peki |
|---|---|
| 更新时间 | 2026年5月28日 06:33 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Peki – Fiken Integration for WooCommerce automatically exports your WooCommerce orders to the Norwegian accounting platform Fiken. When orders are completed, the plugin creates vouchers in Fiken, reducing manual work and potential errors.
Visit peki.no/integration/fiken for more information.
Key Features
- Automatic order export to Fiken when orders are completed
- Advanced bank account mapping – developed with senior accountant
- Automatic customer creation in Fiken
- Separate shipping line items with proper VAT handling
- VAT export for goods and services outside Norway
- Dynamic VAT rates based on store location
- Multi-currency support
- Refund handling with credit notes
- Multi-site support with shared quota per Fiken company
- GDPR compliant – only necessary data is transmitted
- Norwegian translation included
- WordPress 5.8 or newer (compatibility verified through WordPress 7.0; keep WooCommerce current).
- An active Fiken account with API access enabled (NOK 99/month add-on)
- At least one invoice issued in Fiken to initialize counters
- WooCommerce installed and activated
- Starter: 100 transfers/month (NOK 119 ex. VAT)
- Growth: 1,000 transfers/month (NOK 319 ex. VAT)
- Pro: 5,000 transfers/month (NOK 639 ex. VAT)
安装:
- Install the plugin through WordPress or upload to
/wp-content/plugins/ - Activate the plugin
- Enable Fiken API in your Fiken account (Foretak → Tillegstjenester → API)
- Create your first invoice in Fiken if you haven't already
- Navigate to Peki → Fiken in WordPress admin and connect your account
- Configure bank account mapping for your payment methods
屏幕截图:
常见问题:
Do I need a Fiken account?
Yes, an active Fiken account with API access is required (NOK 99/month add-on).
Can I connect multiple stores?
Yes, unlimited WordPress sites can connect to the same Fiken company and share the monthly transfer quota.
Is the plugin compatible with HPOS?
Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage.
Is the plugin compatible with WordPress 7?
Yes. The plugin declares compatibility via “Tested up to” and is exercised on WordPress 7.0 with current WooCommerce releases. WordPress 7 raises the project minimum to PHP 7.4 (PHP 8.2+ recommended); keep hosting and WooCommerce updated.
Is my data secure?
Yes, all data is transmitted over secure HTTPS connections.
Update failed with “Could not create folder” on Windows (IIS)?
This is usually either (1) the web server account cannot write to wp-content/upgrade and wp-content/plugins, or (2) the update package was built with the wrong folder layout (there must be exactly one top-level folder named peki-fiken-integration-for-woocommerce). Grant the IIS application pool identity Modify on wp-content (or at least wp-content/upgrade and wp-content/plugins). If the problem persists, install manually: unzip the release so you get wp-content/plugins/peki-fiken-integration-for-woocommerce/fiken.php, or upload via FTP/SFTP.
更新日志:
1.0.27
- Compatibility: Declared compatibility with WordPress 7.x (readme and plugin headers set to tested up to 7.0). Admin live-status polling attaches inline logic to bundled
jqueryinstead of a src-less script handle. - Fix: Fiken settlement accounts that use five digits after the colon (for example Klarna Checkout / «Kustom» on
1960:10011) were incorrectly rewritten to:10001, often matching Vipps; these codes from the WooCommerce gateway map are now sent unchanged. - Fix: Bank gateway map resolution no longer uses the legacy “single unique account” shortcut when WooCommerce knows the payment gateway but that gateway lacks a mapping (prevents postings on the wrong account); missing mappings log a clearer warning (
bank_map_miss). Known gateway aliases (e.g.kco↔ Klarna) are still honoured. - Fix: Orders with redeemed gift cards or negative fee lines (
line_subtypehandling) integrate with configurable gift-card liability bookkeeping and clearer server-side posting when liability account is set in WooCommerce → Fiken → Gateways. - Fix (HPOS): Invoice meta bookkeeping runs
clean_post_cache()only for classicshop_orderposts; Fiken invoice PDF attachments use validpost_parentandWC_Ordermeta on HPOS-first orders.
- Fix: Bank account mapping (
pekifiken_bank_account_map) now applies to both cash sales and unpaid invoices, so the chosen Fiken payment account matches gateway mapping in all document modes. - Fix: Refund exports send the same resolved payment/bank account fields as order exports where applicable, with consistent
total_refund(get_total/get_amount). - Fix: Manual amount-only refunds with no WooCommerce line items build a synthetic credit line so partial refunds are represented correctly; refund lines are aggregated like order lines.
- Improvement: Growth-tier UI features (auto PDF, per-payment document type) treat Pro subscribers as eligible, same as Growth.
- Fix: Some update packages accidentally included an empty stray folder with a typo in its name, which caused “Could not create folder” errors during one-click updates on Windows/IIS. The release zip now contains only the correct plugin tree.
- Fix: Order export now preserves exact net line amounts instead of converting discounts to rounded percentages. This fixes 1-ore bookkeeping differences such as 199 -> 100 being exported as 99.50 discount/payment in Fiken.
- Fix: Credit note export now uses the same exact net-line logic, keeping refunds aligned with the original export amounts.
- Improvement: Added bulk action "Export to Fiken" in the WooCommerce order list, so merchants can select multiple orders and export them in one action.
- Improvement: Bulk export only processes orders that have not already been exported to Fiken. Already exported or currently locked orders are skipped and summarized in an admin notice.
- Fix: Orders being exported multiple times to Fiken (duplicate invoices). The auto-export duplicate guard now uses WooCommerce CRUD (HPOS-safe) to read order meta, with fallback to post_meta. Previously, the guard relied solely on
get_post_meta()which returns empty on sites with HPOS enabled and sync disabled – causing every status-change trigger to re-export the order. - Fix: Added a process lock (WordPress transient) to prevent parallel exports of the same order, e.g. from near-simultaneous payment gateway webhooks.
- Fix: Orders not marked as transferred in the WooCommerce order list after successful export. The Fiken column in the HPOS order list now checks both WooCommerce CRUD meta and post_meta, so orders exported before or after an HPOS migration are always shown correctly.
- Fix:
store_invoice_meta()now reloads the order object fresh from the database before saving invoice meta, avoiding a stale object potentially overwriting concurrent changes.
- Fix: VAT mapping for Stripe Tax and other third-party tax providers now correctly detects 25% Norwegian VAT. Previously, orders with correct VAT calculated by Stripe Tax were incorrectly exported to Fiken as "Sale without VAT" (VAT code 52). The plugin now calculates the effective VAT rate from actual amounts when tax rate IDs are not available, ensuring correct mapping to Fiken's HIGH VAT type (25%) for Norwegian domestic sales.
- Fix: Increase export service connect timeout to reduce cURL error 28 failures on slow networks.
- Logging: Export errors now automatically add an order note so merchants see failures without opening logs.
- UI: Added a Logs tab under WooCommerce → Fiken that shows the latest error entries from the WooCommerce logger (peki-fiken log).
- Compatibility: Confirmed with WordPress 6.9.
- Maintenance: Version bump and documentation sync.
- Maintenance: Version bump and documentation sync.
- UI: Advanced page grouped into “Export rules” and “Growth features”, with larger, easier-to-click checkboxes and clear 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 Fiken 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 Fiken-specific paths (
/stripe-connect/fiken/...) for status and portal. - Added: New Fiken status endpoint (
/stripe-connect/fiken/status.php) mirroring root behavior. - Fix: Fiken customer portal include path corrected to load local
env.php. - Fix: Growth gating now reads plan via the Fiken GET 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.
- 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 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 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.
- Fix: Prevent duplicate customers in Fiken by reusing existing contact by email when available (server-side).
- Fix: Amount scaling guard — clamp minor unit factor to 100 (NOK) 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 (Driftskonto). 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=3andconnection_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.
- Fix: Per-payment “Document Type” override is now always honored (bypasses master toggle). bacs set to Invoice now forces
cash=false. - Dev: Added filter
pekifiken_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/fiken. - Compliance: Additional translators comments/escaping for PHPCS.
- 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 Fiken export status with Woo dashicons (HPOS + legacy).
- Added: Admin “Order actions” entry to force export to Fiken (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 bankAccountCode also for non-cash invoices to satisfy Fiken API.
- Compliance: PHPCS fixes (translators comments, placeholder ordering, escaping, prefixed globals).
- 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
- Fix: Bank account mapping functionality improved
- Fix: Admin notifications dismiss handling
- 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.
- Added: Support for VAT code 52.
- Improved: Stability of admin notices (dismiss handling and consistent display).
- Added: Support for VAT code 52.
- Improved: Stability of admin notices (dismiss handling and consistent display).
- Fix: Fixing Refund bugs.
- Fix: Account mapping.
- Improvement: Refund handling refined for better accuracy and compatibility.
- Feature: Added setting to disable VAT (MVA) when needed.
- Fix: PHPCS warnings resolved for OAuth callback handling and webhook signature validation.
- Improvement: Enhanced installation instructions with mandatory Fiken API activation and first invoice creation.
- Docs: Clarified that Fiken invoice counter and customer counter must be initialized before API integration works.
- Security: Proper sanitization and unslashing of server variables in webhook endpoint.
- Fix: Duplicate “Connect to Fiken” 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 Fiken API add-on requirement and first-invoice note; clarified multi-site behavior and pricing plans.
- Meta: Bumped “Tested up to” to 6.8; updated Stable tag.
- Docs: English-only readme per WordPress.org requirements; improved SEO wording for WooCommerce/Fiken integration in Norway.
- Product: Clarified free tier (15 transfers/month) and option to upgrade to unlimited.
- Docs: Removed references to manual “Send to Fiken” actions and subscription support (not available).
- Link: Updated to https://peki.no/fiken in the description.
- Compliance: Neutralized upgrade/plan wording; “Manage Subscription” link only.
- Security: Reviewed nonce and capability checks in connect/disconnect flows.
- Prefix: Migrated internal keys to
pekifiken_with legacy fallbacks. - API: Plan/limits decided by remote service; plugin surfaces neutral errors.
- Docs: Expanded “External services.”
- Documentation updates and refund handling improvements.
- Fix: Dismissible admin notices; clarified docs.
- First public release.