SmartPay Invoices for WooCommerce -- WordPress 插件

开发者	StarNetwork SmartPay.co.il
更新时间	2026年10月25日 22:24
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

1.16.1

Fixed: sandbox mode now uses the public SmartPay sandbox API (https://sandboxapi.smartpay.co.il/v1/), and its dashboard links open the sandbox dashboard (mysandbox.smartpay.co.il). It pointed at an internal host that sandbox credentials don't work on.

1.16.0

Added: "Attach existing document" on the order screen (and "Attach existing…" in the Orders list). Enter a SmartPay document number or uid; the plugin shows the document it found next to the order's total and billing email, warns when they differ, and attaches it on confirmation. The document becomes the order's own (Download, Send, email attachments, credit on refund) and an order note records who attached it. Documents of another SmartPay account, documents already attached to another order and combinations the coexistence rules forbid are refused. Attached documents cannot be detached.
Added: no more duplicate documents after a creation that did not finish. Before Create, Retry and the bulk actions — and before an automatic creation when an earlier attempt for the order failed or never got its answer — the plugin looks for a document SmartPay already holds for the order (its description or payment names the order, same total and customer) and attaches it instead of creating a second one. An order note says so ("adopted"). If SmartPay cannot be read, creation goes ahead as before and the log records GUARD_SKIPPED.
Added: bulk "Generate" actions run in the background (Action Scheduler, one job per order) instead of inside one page request, so large selections no longer hit the host or Cloudflare time limits. The Orders list shows the progress with a link to the run's report (created / already at SmartPay / skipped / blocked / unpaid / failed, with order links). A job that fails or times out is retried once.
Added: WooCommerce > Smartpay Invoices > Missing documents — "Create documents for paid orders without one": pick a date range and statuses, preview the count, confirm; runs in the background like the bulk actions. Orders before the automation start date are included only on request. No emails are sent.
Added: WooCommerce > Smartpay Invoices > Reconcile — compares paid orders in a date range with the documents in your SmartPay account, in background steps with a progress bar (the result is kept, so the page can be reloaded). Lists every order without a document with the SmartPay documents that belong to it: exact (the document names the order and matches its total) or probable (same customer email and total, issued within a few days); orders with two or more candidates are flagged DUPLICATE?. "Adopt exact matches" attaches the unambiguous ones, ticked rows attach the rest; orders with nothing at SmartPay link to Create / the background catch-up. Also lists SmartPay documents that name an order but are attached nowhere, and imports order → document pairs from a CSV file. Nothing here creates documents, sends emails or changes order statuses; every attachment writes an order note and a RECONCILE log line.
Changed: the plugin waits up to 60 seconds (was 20) for SmartPay to create or update a document, which includes rendering the PDF; filter smartpayinvoices_create_timeout. Other calls keep 20 seconds.
Added: every new document carries a client reference (wc_order_id, wc_order_key, client = woocommerce) on its payment lines, so it can be matched to its order later.
Added: "Document footer notes" setting — text printed at the bottom of every document (including credit invoices) under the notes heading, with {order_number} and {order_date} filled in per order, e.g. "מספר הזמנה באתר: #{order_number}" prints the website order number on the document. The existing "Document notes" setting is unchanged.
Changed: the Logs page and the Sync page are now tabs of WooCommerce > Smartpay Invoices (General · Payment methods · Missing documents · Reconcile · Logs) instead of separate menu entries. Old links and bookmarks to the Logs and Sync pages open the matching tab.

1.15.3

Added: when the automation decides not to create a document for a paid order, the reason is now written to the plugin log (type SKIPPED, searchable by order number): vetoed by another plugin through the smartpayinvoices_can_sync_invoice filter (SmartPay Payments does this when it cannot confirm the charge), created before the automation start date, blocked by the order's existing documents, no items, no paid date, or another request already creating it. Until now these cases left no trace anywhere, so a store that stopped getting documents looked exactly like a store with nothing to document.

1.15.2

Fixed: the customer "Order cancelled" email now carries the credit invoice. WooCommerce builds that email before the cancellation credit was created, and it was not among the emails the plugin attaches to; the credit is now created ahead of the email and "Cancelled order" is a choice under "Attach documents as PDF to emails" (on for stores that had attachments on). The WooCommerce email itself must be enabled under WooCommerce > Settings > Emails.

1.15.1

Fixed: PDF download and email attachment failed with "Could not load invoice file" after the SmartPay API started reporting the document file as a status object (document_file) instead of a bare file_url. Both shapes are now read, and a document whose PDF could not be rendered is logged with the API's reason.

1.15.0

Added: "Send" next to each document in the Orders list and on the order screen, plus "Send SmartPay documents to customer" in the Order actions dropdown — emails the PDF to the billing address through the WooCommerce customer-invoice email and records the outcome as an order note.
Added: the "Attach documents as PDF to emails" setting now lists the customer emails — Processing order, Completed order, Customer invoice / Order details, Refunded order. Stores that had attachments on get all of them; the refund email carries the credit invoice issued for that refund (previously no credit invoice was ever emailed).
Added: an order line's meta (variation attributes, personalisation, an expiry date…) is sent as the item description, printed under the item name once the document layouts show it.
Added: the number of installments is recorded on the document transaction for orders paid through SmartPay Payments (was always 1).
Fixed: the Download buttons on the order screen and in My Account no longer disappear for paid orders left on "Processing".
Added: receipts and invoice-receipts show how the order was paid — card brand, last 4 digits, approval number and the date of payment — for orders paid through SmartPay Payments (split Multipass payments included). Only the last 4 digits and the brand are sent, never a card number or expiry date.

1.14.0

Added: partial refunds create a credit invoice for the refunded amount — one per WooCommerce refund, whether made from the WooCommerce refund screen or by a payment plugin (e.g. SmartPay Payments), listing the refunded lines when WooCommerce recorded them. Credits are capped at the order total; cancelling a partially refunded order credits the balance.
Changed: completing an order that already reached "Processing" no longer creates a document — its document belongs to the Processing step (orders completed directly, e.g. virtual products, still get one).

1.13.0

Added: "Automate orders created from" setting — automatic document creation skips orders created before the date automation was switched on (set automatically, editable). Manual "Create invoice" still works for older orders.

1.12.0

Added: "Document notes" setting (General tab) — free text printed in the notes area of every document, e.g. your website address; links are clickable.
Fixed: the customer address now prints on documents whenever the order has a street, city or postcode; it used to be dropped when the postcode was empty.

1.11.0

Changed: payment-demand documents (standalone tax invoice, proforma invoice) can now be created manually for unpaid orders — per-order button, admin link and bulk action — regardless of the automation mode. Receipt types still require a paid order.
Fixed: free-shipping lines no longer print a 0.00 item row on documents; document totals are unchanged.

1.10.1

fix Contributors list
update short description

1.10.0

Added: Proforma Invoice (חשבונית עסקה) as a selectable document type, in the settings, as a per-order "Create Proforma Invoice" button and as a "Generate Proforma Invoice" bulk action. Like the standalone tax invoice it is a payment demand: automatic creation can be set to "For created orders", and an unpaid order's proforma invoice carries no payment line. A proforma invoice may precede any of the other documents on the same order (e.g. proforma at checkout, receipt or tax-invoice/receipt on payment).

1.9.0

Added: documents now record the payment method of the order (credit card, bank transfer, cash, Bit, digital wallet, and more), printed in the payments section of receipts and invoice-receipts. Previously every document reported cash.
Added: a "Payment methods" tab in the plugin settings that maps each WooCommerce payment gateway to the SmartPay payment method recorded on the document. WooCommerce's built-in gateways and the SmartPay Payments gateways are mapped by default; other gateways default to credit card.
Developers: new smartpayinvoices_transaction_payment_method, smartpayinvoices_default_payment_methods and smartpayinvoices_payment_method_options filters; a payment_method key on smartpay_payments_order_payments entries is honoured per payment.

1.8.0

Added: credit invoice (חשבונית זיכוי) support. A credit invoice is created automatically when an order that has a tax invoice or invoice-receipt is cancelled or refunded (new setting, enabled by default), or manually via the orders-list "Create Credit Invoice" button and the "Generate Credit Invoice" bulk action — the manual actions also cancel the order. The credit invoice mirrors the original document's amounts and is linked to it as its replacement.

1.7.0

Added: newly created documents are automatically linked to the order's existing documents (e.g. a tax invoice to its earlier receipt); the link appears on the rendered PDF and in the SmartPay dashboard. Developers can adjust or disable the relations via the smartpayinvoices_related_documents filter.

1.6.1

Fixed: third-party order-item metadata is no longer copied into the document line description; document lines show the item name only. (Encoded HTML stored as item metadata could surface as a large text blob on the PDF.)
Fixed: stores whose product prices include VAT now send tax inside the amounts, so document totals are correct for every combination of the WooCommerce tax settings.
Fixed: orders that carry no VAT are no longer reported as VAT-exclusive (a document for a tax-free order showed VAT added on top of the amount paid); the document tax mode now derives from the order itself.

1.6.0

Added: an order can now carry both a receipt and a tax invoice — the orders list shows each document with its own Show button and offers a create button per document type.
Added: a combined tax invoice/receipt cannot be created alongside a separate receipt or tax invoice (and vice versa); conflicting attempts are blocked with an explanation, including in bulk.
Added: automatic document creation is trigger-aware — tax invoices can also be created when the order is created (a payment demand before payment); such documents carry no payment line until paid.
Changed: the automation setting now sits right below the document type and offers only the options valid for it.
Changed: email attachments and the My Account page include every document the order carries.
Changed: the allocation threshold row was restyled.

1.5.5

Fixed: re-activating the plugin no longer erases its settings (API credentials, mode and preferences are kept).
Changed: the document-type setting stays visible (disabled, with a hint) until API credentials are entered, instead of disappearing.
Fixed: the order screen no longer offers a PDF download before a document exists.
Fixed: order fees (surcharges, gift wrap and similar) now appear on the document; previously the document total fell short of the amount paid.
Fixed: coupon discounts were deducted twice on the document (once in the line amounts and again as the discount row); lines now show pre-discount prices and the discount is applied once.
Fixed: document lines are now linked to the synced SmartPay catalog products.
Fixed: automatic generation no longer issues an empty document for an order whose items were not yet added.
Changed: the logs screen shows the newest entries first.

1.5.4

Fixed: invoice lines were multiplied by their quantity twice (the line total was sent as the unit price); each line now carries the true per-unit price.
Fixed: every invoice line showed its name twice; the description now carries only real item details (e.g. variation attributes).

1.5.3

Changed: the per-order "Create invoice" button and the bulk "Generate" actions now apply only to paid orders; unpaid orders are marked "Not paid" and skipped with their own count in the bulk notice.

1.5.2

Changed: the allocation threshold is now synced from your SmartPay account (the dashboard setting, capped by the regulatory floor) instead of entered manually — refreshed daily, on the settings page and via a Refresh button.

1.5.1

Added: documents now carry a transaction entry per payment reported by the paying gateway (e.g. vouchers plus a credit-card remainder), with protection against duplicate documents on concurrent paid events.
Added: the allocation threshold is now configurable directly in the plugin settings; the field appears when the ID/VAT requirement is set to "Above the allocation threshold".

1.5.0

Added: Tax Invoice (חשבונית מס) as a selectable document type, in the settings and as a bulk Generate action.

1.4.4

Added: a settings note linking to where the company logo is uploaded in the SmartPay dashboard.

1.4.3

Fixed: the ID/VAT number entered on the admin order screen now stores under its own key and reliably reaches the document, instead of colliding with WooCommerce's own additional-field handling.

1.4.2

Changed: the connection test now reports why it failed — an unreachable/timed-out host (with the error detail) versus an authentication/unexpected-response failure — instead of a generic message.

1.4.1

Fixed: the connection test now accepts any valid JSON response from the API (a bad credential returns a non-JSON 401) instead of requiring a specific status value.
Fixed: production dashboard links point to my.smartpay.co.il.

1.4.0

Added: the connection test now truly authenticates against the API (lists documents) instead of only checking that credentials were entered.
Added: invoice language is a per-store setting again and is sent as an override on document creation.
Changed: the invoice template picker is now a dropdown with a live preview of the selected template.
Changed: the orders-list invoice column uses consistent text buttons (Show / Create / Retry) instead of a mixed icon + buttons.
Changed: removed the plugin tax settings; WooCommerce is now the single source of truth for tax.
Changed: renamed the ID/VAT requirement option to "Above the allocation threshold".
Fixed: Hebrew translation refinements.

1.3.1

Changed: dashboard links and the API endpoint now follow the Sandbox setting (sandbox uses the dev dashboard and API).

1.3.0

Added: editable ID / VAT number field on the admin order screen (fixes allocation on admin-created high-value Israeli orders).
Added: "Require customer ID / VAT number" setting (never / above a threshold / always).
Added: Hebrew (he_IL) translation and a translation template; the plugin now loads its text domain.
Added: links to the SmartPay dashboard for invoice language and allocation settings, plus a hint for finding API credentials.
Fixed: the invoice PDF now reliably attaches to the completed-order email.
Security: stopped logging API credentials, enabled TLS certificate verification, restricted the admin pages, and masked the stored API secret.
Changed: removed the unused "Company" setting; renamed the checkout field to "ID / VAT number".

1.2.0

Added: choose the invoice PDF template (Classic / Modern v1 / Modern v2 / Thermal) from a visual picker in the settings.

1.1.0

Added: WooCommerce High-Performance Order Storage (HPOS) compatibility.
Added: per-order "Create invoice" action and a three-state Orders column (download / create / retry).
Added: on-demand "Test connection" button on the settings page.
Fixed: bulk "Generate" now creates and stores documents and reports accurate created/skipped/failed counts.
Fixed: the invoice PDF now attaches to the "Completed order" email.
Fixed: the "Clear Log" button.
Fixed: PDF download now works on hosts without allow_url_fopen (uses the WordPress HTTP API).
Fixed: log table creation under MySQL strict mode.
Security: restricted the settings and logs pages to appropriate user capabilities.

1.0.0

Initial release.

SmartPay Invoices for WooCommerce

标签

下载

详情介绍:

安装:

常见问题:

更新日志: