Victor Eliot Invoice Sync for Doklad.ai

By victoreliot

0+ active installationsVersion 1.0.2

Invoices, proformas, credit notes, payments, secure PDFs, and reliable Doklad.ai automation for WooCommerce.

Description

Victor Eliot Invoice Sync connects WooCommerce orders to the Doklad.ai API. It covers the complete order-to-document workflow while keeping API credentials on the WordPress server.

Document automation:

  • Create invoices, proformas, and simplified tax documents automatically or manually.
  • Configure document type, trigger states, Doklad.ai payment method, and paid behavior for every WooCommerce payment gateway.
  • Create a final invoice after a paid proforma.
  • Create full or partial credit notes from WooCommerce refunds.
  • Record WooCommerce payments in Doklad.ai.
  • Mark zero-tax EU B2B orders with a VAT ID as reverse charge while preserving WooCommerce VAT rates for OSS and domestic sales.
  • Ask Doklad.ai to email invoices, proformas, credit notes, or simplified documents with optional subject and message placeholders.
  • Receive signed payment and invoice status webhooks and optionally update the WooCommerce order state.

Store management:

  • Create documents from the order action menu.
  • Cancel the latest linked document without deleting its accounting audit trail.
  • Create invoices and proformas with WooCommerce bulk actions.
  • See linked documents in the order list and order sidebar.
  • Include products, variation attributes, shipping, fees, discounts reflected in line totals, VAT rates, currencies, company identifiers, and delivery addresses.
  • Use the order number or order ID as a Czech variable symbol.

Reliability and customer access:

  • Use deterministic idempotency keys to prevent duplicate documents.
  • Process synchronization in the background with Action Scheduler and exponential retries.
  • Honor Doklad.ai rate-limit retry headers.
  • Send a final failure notification to a configured email address.
  • Write optional diagnostic events to the WooCommerce logger.
  • Offer secure server-proxied PDF downloads in customer emails, My Account, and the thank-you page without exposing the API key.
  • Customize the customer document heading and PDF link text.
  • Register the signed webhook endpoint from the settings page.
  • Use dry-run mode before enabling production automation.

Doklad.ai is a service of vinireto s.r.o. This plugin is maintained by Victor Eliot, the creator and operator of Doklad.ai. WooCommerce is a trademark of its owner; this plugin is not affiliated with or endorsed by WooCommerce.

Česky (Czech localization included)

Plugin obsahuje kompletní českou lokalizaci (cs_CZ) přímo v balíčku: administrace WooCommerce → Doklad.ai Sync, akce objednávek, hromadné akce, stavové poznámky, e-maily i bezpečné PDF odkazy v sekci Můj účet a na děkovné stránce se v českém WordPressu zobrazují automaticky česky. Propojuje objednávky WooCommerce s účetním a fakturačním systémem Doklad.ai (faktury, zálohové faktury, zjednodušené daňové doklady, dobropisy k vratkám, párování plateb, přenesená daňová povinnost EU B2B, IČO/DIČ, variabilní symboly a podepsané webhooky).

External services

This plugin connects to Doklad.ai, a cloud invoicing service operated by vinireto s.r.o. Doklad.ai is used to create, update, email, and retrieve invoices, proformas, simplified tax documents, credit notes, and payments. The connection is used only after a site administrator enters a Doklad.ai API key and enables synchronization or starts a manual Doklad.ai action.

For document creation and updates, the plugin sends the WooCommerce order number and dates; billing name or company, company ID, VAT ID, email, phone, billing address, and delivery address; product and variation descriptions, quantities, prices, shipping, fees, discounts reflected in line totals, VAT rates, tax classification, currency, payment method, payment status, and refund details. The saved API key is sent to Doklad.ai as an authorization credential with API requests.

If Doklad.ai document email delivery is enabled, the plugin sends the recipient email address and any configured subject and message. When a customer or administrator opens a secure document link, the plugin sends the linked document ID to Doklad.ai and retrieves the PDF through the WordPress server. If webhook registration is requested, the plugin sends the site’s webhook URL and a generated signing secret to Doklad.ai; Doklad.ai can then send document and payment status events back to that URL.

  • Doklad.ai Terms of Service: https://doklad.ai/terms
  • Doklad.ai Privacy Policy: https://doklad.ai/privacy
  • Doklad.ai Data Processing Agreement: https://doklad.ai/dpa

Installation

  1. Install the plugin in Plugins > Add New Plugin by searching for “Victor Eliot Invoice Sync for Doklad.ai” (or upload the plugin ZIP) and activate it.
  2. In Doklad.ai, open Settings > Integrations > API keys and webhooks and create an API key with invoice, customer, payment, and webhook access.
  3. Go to WooCommerce > Doklad.ai Sync.
  4. Keep the API base URL at https://doklad.ai/api, enter the key, save, and use Test connection.
  5. Configure the default workflow and any payment-gateway overrides.
  6. Use Register webhook in Doklad.ai, then enable automatic sync.
  7. Use dry-run mode first on a staging site or test order.

FAQ

Which Doklad.ai endpoints does the plugin use?

It uses the current Doklad.ai /api endpoints for invoices, PDF files, invoice email, payments, credit notes, and webhook registration. The base URL remains configurable for sandbox or self-hosted testing.

How are duplicate documents prevented?

The plugin stores every Doklad.ai document ID on the WooCommerce order and sends a deterministic Idempotency-Key for each order, document type, payment, and refund. Pending background jobs are also de-duplicated.

How do partial refunds work?

WooCommerce refund line items are mapped back to the original invoice item indexes. The plugin sends only refunded quantities and unit prices to the Doklad.ai credit-note endpoint. A full refund creates a full credit note.

Does a PDF link expose my API key?

No. Customer links are signed with the WooCommerce order key. WordPress verifies that signature and retrieves the PDF server-side using the saved API key.

Can I change the document payload?

Yes. Developers can use the vedais_document_payload filter. It receives the payload, WooCommerce order, and document type.

Does it synchronize warehouse stock?

No. The current documented Doklad.ai API does not expose warehouse quantity endpoints. The plugin does not simulate stock synchronization against undocumented fields. WooCommerce remains the source of truth for stock.

Where are errors logged?

The latest error is stored on the order and added as an order note. Optional detailed logs are available under WooCommerce > Status > Logs with source vedais. After retries are exhausted, the plugin can email the configured failure address.

Does the plugin send tracking data?

No. It sends only data required for configured Doklad.ai API actions. It does not include analytics or telemetry.

Changelog

1.0.2

  • Added complete bundled Czech (cs_CZ) localization (.po, .mo, and WordPress 6.5+ .l10n.php) for admin settings, order actions, notices, emails, My Account, and the thank-you page.
  • Added localized document status labels in the WooCommerce order metabox.

1.0.1

  • Escaped plain-text customer document download URLs with esc_url().
  • Expanded external service disclosure in readme.txt with direct links to Doklad.ai Terms of Service, Privacy Policy, and Data Processing Agreement.
  • Verified PDF header signature in server-side PDF proxy before streaming.

1.0.0

  • Initial release with invoices, proformas, credit notes, payment and webhook synchronization, bulk actions, secure PDF links, HPOS support, background retries, dry-run mode, and diagnostics.