Title: IDS Partner Ledger Author: IDSource Published: 2026 年 7 月 18 日 Last modified: 2026 年 7 月 20 日 --- 搜索插件 ![](https://ps.w.org/ids-partner-ledger/assets/banner-772x250.png?rev=3612233) ![](https://ps.w.org/ids-partner-ledger/assets/icon-256x256.png?rev=3612233) # IDS Partner Ledger 作者：[IDSource](https://profiles.wordpress.org/idsources/) [下载](https://downloads.wordpress.org/plugin/ids-partner-ledger.1.0.1.zip) * [详情](https://cn.wordpress.org/plugins/ids-partner-ledger/#description) * [评价](https://cn.wordpress.org/plugins/ids-partner-ledger/#reviews) * [安装](https://cn.wordpress.org/plugins/ids-partner-ledger/#installation) * [开发进展](https://cn.wordpress.org/plugins/ids-partner-ledger/#developers) [支持](https://wordpress.org/support/plugin/ids-partner-ledger/) ## 描述 IDS Partner Ledger is a WooCommerce administration tool for stores that divide order profit between a business partner and the store owner. When an eligible order reaches Completed status, the plugin stores the values used for the profit split. Reports and settlement previews use this snapshot instead of changing live data. A locked settlement period records its exact order membership, order count, currency, net profit, partner payout, and owner payout. Included snapshots and manual values become read-only, with no unlock or delete action. It is not accounting, bookkeeping, tax, payment-reconciliation, inventory-management, or currency-conversion software. **Financial calculation** Revenue is discounted WooCommerce merchandise line-item revenue excluding tax, native shipping, and native order fees. Net Profit = Revenue − Product Cost − Gateway Fee − Manual Shipping Cost Positive net profit is divided using the configured partner percentage, with the owner receiving the remainder. For zero or negative net profit, the partner share is zero and the owner receives the full result. **Purchase costs** For variations, Partner Ledger checks the variation purchase price first, then the parent product when no variation price exists. An ATUM data-table fallback is supported where available. Numeric zero is valid. A missing, invalid, negative, malformed, or non-finite price makes the calculation unresolved when the line has a remaining quantity. Unresolved orders cannot create a valid snapshot or enter reporting or settlement. **Gateway fees and Manual Shipping Cost** Gateway fees use this precedence: 1. Manual Gateway Fee. 2. A supported recorded gateway-fee value. 3. The configured Stripe or PayPal estimate when applicable. 4. Zero when no supported source applies. Invalid or negative recognised fee data makes the order unresolved unless a valid manual fee takes precedence. Fees are not reconciled against processor payouts. Manual Shipping Cost is the complete per-order shipping deduction. It is not copied from or added to WooCommerce native shipping. A notice appears when both are positive. Snapshots are bound to the normalized Manual Gateway Fee and Manual Shipping Cost states used for their calculation. Changing, adding, or clearing either override through a normal order update preserves the new override but excludes the old snapshot from reports and settlement until Save & Recalculate succeeds. Unchanged normalized values do not invalidate a snapshot. Legacy 1.0.0 snapshots without manual overrides remain compatible; an unlocked legacy snapshot with an unverifiable manual override must be recalculated before settlement. **Refund safeguards** Explicit WooCommerce product-line refunds reduce tax-exclusive merchandise revenue and product cost for explicitly refunded quantities. Shipping and tax refunds do not alter Partner Ledger merchandise revenue or Manual Shipping Cost. Ambiguous, inconsistent, or unallocated refunds cannot create or overwrite a valid snapshot and are excluded until resolved. A stored refund fingerprint makes an unlocked snapshot stale after a confirmed refund change. Unversioned 1.0.0 fingerprints remain automatically compatible for exact no-refund states. An aggregate-equal refund-bearing legacy fingerprint is reported as not identity-verifiable: unlocked orders require v2 recalculation or explicit private repair evidence, while locked historical snapshots remain immutable and visible without claiming a confirmed change. A refund recorded after locking does not alter the historical snapshot, membership, or stored settlement totals. Snapshot Report keeps the locked historical row visible and labels later refund-state changes; unlocked refunded orders are not reportable or eligible for a new settlement. Corrections must be handled outside Partner Ledger. **Single-currency settlement** Version 1.0.1 supports one settlement currency without conversion. The order currency must be valid and match the configured store currency. Currency is stored with snapshots and locked periods and shown in reports and CSV exports. A locked period retains its recorded currency if the store currency changes later. **Data and access** Partner Ledger stores separate snapshot, audit, and settlement records. It does not edit WooCommerce native order data. Access requires the `manage_ids_partner_ledger` capability, normally granted to Administrators and Shop Managers. ### Features * Stored financial snapshots for eligible completed orders. * Purchase-cost and gateway-fee resolution with supported ATUM, Stripe, and PayPal sources. * Refund-state, financial-data, and single-currency safeguards. * Snapshot and Locked Period reports with CSV exports. * Settlement previews and one-way locking of exact membership and totals. * Verification and backfill tools for missing, unresolved, or stale snapshots. * Audit history for manual overrides, recalculations, and settlement locks. * WooCommerce HPOS and legacy order-storage support. ### Requirements and Compatibility * WordPress 6.0 or later; tested up to WordPress 7.0. * PHP 8.0 or later. * WooCommerce 8.0 or later; tested up to WooCommerce 10.9.4. * WooCommerce must be installed and active before Partner Ledger is activated. * Compatible with HPOS and legacy post-based WooCommerce order storage. * ATUM Inventory Management is optional. * Remaining sold quantities require valid, non-negative purchase-price data. * Settlement orders must use the configured WooCommerce store currency. ### Getting Started 1. Configure labels, the partner percentage, gateway-fee estimates, and excluded customer IDs. 2. Confirm that applicable products and variations have valid purchase prices. 3. Backfill eligible existing completed orders from the Verification tab. 4. Review a completed order and enter manual gateway or shipping costs if required. 5. Select Save & Recalculate, then resolve any financial, refund, or currency warning. 6. Review the Snapshot Report, preview an unpaid period, and confirm the lock after checking its currency, membership, and totals. ## 屏幕截图 [⌊Snapshot Report with date presets, Paid/Unpaid filtering, payout preview totals, and per-order rows.⌉⌊Snapshot Report with date presets, Paid/Unpaid filtering, payout preview totals, and per-order rows.⌉[ Snapshot Report with date presets, Paid/Unpaid filtering, payout preview totals, and per-order rows. [⌊Settlement lock review showing the period's order membership, currency, and totals before confirmation.⌉⌊Settlement lock review showing the period's order membership, currency, and totals before confirmation.⌉[ Settlement lock review showing the period’s order membership, currency, and totals before confirmation. [⌊Locked Periods with permanently stored settlement totals and CSV export.⌉⌊Locked Periods with permanently stored settlement totals and CSV export.⌉[ Locked Periods with permanently stored settlement totals and CSV export. [⌊Partner Ledger panel on the order screen showing snapshot values and manual gateway fee and shipping cost controls.⌉⌊Partner Ledger panel on the order screen showing snapshot values and manual gateway fee and shipping cost controls.⌉[ Partner Ledger panel on the order screen showing snapshot values and manual gateway fee and shipping cost controls. [⌊Verification tab with the verification summary and the Backfill Missing Snapshots tool.⌉⌊Verification tab with the verification summary and the Backfill Missing Snapshots tool.⌉[ Verification tab with the verification summary and the Backfill Missing Snapshots tool. ## 安装 1. Install and activate WooCommerce. 2. Install IDS Partner Ledger through the Plugins screen, or upload it to `/wp-content/ plugins/ids-partner-ledger/`. 3. Activate IDS Partner Ledger. 4. Open WooCommerce Partner Ledger. ## 常见问题 ### How is net profit calculated? Partner Ledger subtracts product cost, gateway fee, and Manual Shipping Cost from discounted merchandise revenue excluding tax, native shipping, and native fees. Positive profit uses the configured partner percentage. For zero or negative profit, the partner share is zero and the owner receives the full result. ### Where do purchase costs come from? For a variation, its price is checked first, then the parent product. An ATUM data- table fallback is supported where available. ### What happens when a purchase cost is missing or invalid? A line with remaining quantity requires a finite, non-negative purchase price. Otherwise the order is unresolved and excluded until corrected. Missing is not zero; explicit numeric zero is valid. Fully refunded quantities need no price. ### What does Manual Shipping Cost mean? It is the complete per-order shipping-cost deduction used by Partner Ledger. It is not copied from or added to WooCommerce native shipping. If both are positive, the order panel displays a verification notice. ### How are gateway fees determined? Precedence is Manual Gateway Fee, supported recorded fee, applicable Stripe or PayPal estimate, then zero. Invalid recorded data blocks the order unless a valid manual fee takes precedence. ### How are refunds handled? Explicit product-line refunds reduce tax-exclusive merchandise revenue and product cost for refunded quantities. Ambiguous, inconsistent, or unallocated refunds block reporting and settlement. A later refund change makes an unlocked snapshot stale until recalculated. Refunds after locking do not change the historical snapshot, membership, or totals. ### Does Partner Ledger support multiple currencies? No. Version 1.0.1 settles only in the configured store currency without conversion. Other-currency orders cannot create valid snapshots. Currency is stored and shown in reports and exports. ### When are snapshots created and recalculated? An eligible order receives its first snapshot at Completed status. Another Completed transition does not normally overwrite a valid snapshot. Authorised users can recalculate unlocked orders, and Backfill Missing Snapshots can process eligible existing orders. Locked snapshots are never recalculated or automatically repaired. ### What happens when a payout period is locked? Exact membership, count, currency, profit, and payouts are stored. Per-order database serialization prevents snapshot recalculation or manual financial writes from racing settlement membership. Snapshots and manual values become read-only. There is no unlock or delete action. ### Does Partner Ledger support HPOS? Yes. It declares compatibility with WooCommerce High-Performance Order Storage and supports legacy WooCommerce order storage. WooCommerce order APIs are used for order access. ### Who can access Partner Ledger? Access requires `manage_ids_partner_ledger`, normally granted to Administrators and Shop Managers. Users without it cannot see Partner Ledger financial data, reports, exports, verification, or settlement controls. ### What happens on deactivation and uninstall? Deactivation preserves settings, snapshots, audit history, locked periods, and capabilities. Uninstall permanently removes Partner Ledger settings, snapshot metadata, audit history, locked periods and membership, plugin-owned records, and the dedicated capability. It does not remove WooCommerce orders, products, customers, or native order data. ## 评价 此插件暂无评价。 ## 贡献者及开发者 「IDS Partner Ledger」是开源软件。 以下人员对此插件做出了贡献。 贡献者 * [ IDSource ](https://profiles.wordpress.org/idsources/) [帮助将「IDS Partner Ledger」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/ids-partner-ledger) ### 对开发感兴趣吗? 您可以[浏览代码](https://plugins.trac.wordpress.org/browser/ids-partner-ledger/)， 查看[SVN仓库](https://plugins.svn.wordpress.org/ids-partner-ledger/)，或通过[RSS](https://plugins.trac.wordpress.org/log/ids-partner-ledger/?limit=100&mode=stop_on_copy&format=rss) 订阅[开发日志](https://plugins.trac.wordpress.org/log/ids-partner-ledger/)。 ## 更新日志 #### 1.0.1 * Added a versioned, deterministic refund-state fingerprint that is stable across PHP precision settings and WooCommerce HPOS or legacy order storage. * Preserved automatic compatibility for unchanged no-refund fingerprints created by 1.0.0; refund-bearing v1 snapshots require v2 or explicit private repair evidence. * Distinguished exact refund-bearing v1 aggregates as legacy identity-unverifiable instead of falsely reporting a confirmed refund change; locked historical values remain unchanged. * Kept locked historical snapshots visible in Snapshot Report after a later refund, without changing settled values or permitting a second settlement. * Added a clear Snapshot State label to the report and CSV export for locked historical refund changes. * Serialized snapshot recalculation, manual financial overrides, and settlement membership with a shared per-order transactional database mutex. * Bound snapshots to normalized manual gateway-fee and shipping-cost inputs so override-only saves cannot leave stale financial values eligible for reporting or settlement. #### 1.0.0 * Initial public release. ## 额外信息 * 版本 **1.0.1** * 最后更新：**3 小时前** * 活跃安装数量 **不到10** * WordPress 版本 ** 6.0 或更高版本 ** * 已测试的最高版本为 **7.0.2** * PHP 版本 ** 8.0 或更高版本 ** * 语言 * [English (US)](https://wordpress.org/plugins/ids-partner-ledger/) * 标签 * [reporting](https://cn.wordpress.org/plugins/tags/reporting/)[settlement](https://cn.wordpress.org/plugins/tags/settlement/) [woocommerce](https://cn.wordpress.org/plugins/tags/woocommerce/) * [高级视图](https://cn.wordpress.org/plugins/ids-partner-ledger/advanced/) ## 评级 尚未提交反馈。 [Your review](https://wordpress.org/support/plugin/ids-partner-ledger/reviews/#new-post) [查看全部评论](https://wordpress.org/support/plugin/ids-partner-ledger/reviews/) ## 贡献者 * [ IDSource ](https://profiles.wordpress.org/idsources/) ## 支持 有话要说吗？是否需要帮助？ [查看支持论坛](https://wordpress.org/support/plugin/ids-partner-ledger/)