內容簡介
**總結：**這個 WordPress 外掛能夠無縫連接您的 FluentCart 商店與 Billingo，當訂單支付時會自動生成專業的發票。
1. **外部服務**
- 這個外掛依賴於 Billingo 的發票生成服務，來為 FluentCart 訂單生成和管理發票。
2. **服務信息**
- 服務提供方：Billingo (billingo.hu)
- 服務目的：外掛連接到 Billingo 的 API，自動生成發票，從匈牙利稅務機構 (NAV) 獲取納稅人信息，並檢索生成的發票 PDF 檔案。
3. **數據傳輸**
- 外掛將以下數據發送到 https://api.billingo.hu/v3：
- 生成發票時：
- 調用以下端點，例如驗證納稅人數據、搜索現有合作夥伴或創建新合作夥伴。
- 獲取納稅人數據時：
- 調用特定端點，例如驗證匈牙利稅務識別號碼。
- 下載發票 PDF 時：
- 調用特定端點，例如通過訂單 ID 檢索文檔。
4. **法律信息**
- Billingo 服務條款和隱私政策的連結提供。
5. **關鍵功能**
- 自動生成發票、下載發票、多語言支持、自定義設置、運輸增值稅管理等功能的支持。
6. **要求**
- 使用前需確認 WordPress、FluentCart 外掛、Billingo 帳戶和 PHP 版本等相應條件皆滿足。
7. **重要警告**
- 启用測試模式、确保所有功能正常運作、與會計師協商、檢查所有生成的發票等注意事項。
這個外掛生成何種類型的文件？
- 發票文件。
如何可以告訴合作夥伴的存在？
- 透過調用GET / partners? query = {tax_number} 端點搜索現有合作夥伴。
哪些信息在生成發票時被傳輸？
- Billingo API 金鑰、訂單信息、買家信息、產品細節、運輸信息和發票設置等。
在使用此外掛前應該注意的事項？
- 啟用測試模式、生成測試發票、與會計師協商和檢查生成的發票等等。
外掛標籤
開發者團隊
② 後台搜尋「Integration for Billingo and FluentCart」→ 直接安裝（推薦）
原文外掛簡介
Integration for Billingo and FluentCart is a WordPress plugin that seamlessly connects your FluentCart store with Billingo, automatically generating professional invoices when orders are paid.
External Services
This plugin relies on the Billingo invoice generation service to create and manage invoices for FluentCart orders.
Service Information
Service Provider: Billingo (billingo.hu)
Service Purpose: The plugin connects to Billingo’s API to automatically generate invoices, fetch taxpayer information from the Hungarian Tax Authority (NAV), and retrieve generated invoice PDFs.
Data Transmission
The plugin sends the following data to https://api.billingo.hu/v3:
Generating Invoices (when an order is marked as paid):
Calls these endpoints:
* GET /utils/check-tax-number/{tax_number} – Validates taxpayer data
* GET /partners?query={tax_number} – Searches for existing partners by tax number
* POST /partners – Creates new partner if not found
* GET /document-blocks?type=invoice – Retrieves available invoice pads
* POST /documents – Creates the invoice document
Data transmitted:
* Your Billingo API Key
* Order information: order number, dates, amounts, currency
* Buyer information: name, email, address, postal code, city, country
* Buyer’s VAT/tax number (if provided)
* Product details: names, quantities, prices, VAT rates
* Shipping information: title, amount, VAT rate
* Invoice settings: language, type (paper/electronic), payment method
Fetching Taxpayer Data (when a Hungarian VAT number is provided):
Calls these endpoints:
* GET /utils/check-tax-number/{tax_number} – Validates Hungarian tax identification number
Data transmitted:
* Your Billingo API Key
* The taxpayer’s tax identification number (in format 12345678-1-23)
Downloading Invoice PDFs (when users click to download invoices):
Calls these endpoints:
* GET /documents/vendor/{order_id} – Retrieves document by order ID
* GET /documents/{document_id}/download – Downloads the invoice PDF
Data transmitted:
* Your Billingo API Key
* The order ID and document ID
Legal Information
Billingo Terms of Service: https://www.billingo.hu/felhasznalasi-feltetelek
Billingo Privacy Policy: https://www.billingo.hu/adatkezelesi-tajekoztato
Important: By using this plugin, you agree to transmit your store and customer data to Billingo. Ensure you have proper consent from your customers and comply with applicable data protection regulations (GDPR, etc.).
Key Features
Automatic Invoice Generation – Invoices are automatically created when orders are marked as paid
Download Invoices – Every receipt download button is overriden with Billingo invoice download.
Multi-language Support – Generate invoices in 11 languages: Hungarian, English, German, Italian, Romanian, Slovak, Croatian, French, Spanish, Czech, Polish
Invoice Types – Choose between Paper Invoice and E-Invoice formats
VAT Number Validation – Automatically fetches company data from NAV (Hungarian Tax Authority) when VAT number is provided
Customizable Settings – Configure invoice language, type, quantity units, and shipping details
Shipping VAT Management – Easily set and apply VAT rates for shipping
Cache Management – Built-in cache system with easy cleanup
Bilingual Admin Interface – Full support for English and Hungarian languages
Subscription Support – Automatically generates invoices for subscription renewals
Requirements
WordPress 5.0 or higher
FluentCart plugin installed and activated
Active Billingo account with Agent API Key
PHP 7.4 or higher
Important Warnings
Before using this plugin in production:
Enable Test Mode in both FluentCart and Billingo
Generate test invoices to verify everything works correctly
Consult with your accountant to ensure the plugin meets your accounting requirements
Review all generated invoices for accuracy
Test all edge cases relevant to your business
This plugin generates official accounting documents. Incorrect invoices can have legal and tax implications.
API Usage Costs
Billingo charges for API usage. This plugin uses the Billingo Agent API to generate invoices automatically, which is a paid service. Review the Billingo pricing before enabling automatic invoice generation.
Limitations
VAT Rates: Only explicit rates supported (0%, 5%, 18%, 27%). Named VAT keys (AAM, TAM, TEHK) are not supported.
Document Types: Only Invoices can be generated. Receipts and Pro forma invoices are not supported.
IPN: Instant Payment Notification is not yet supported.
Lag: Customers might need to wait a few seconds on the order conrifmation page before being able to download the invoice.
Shipping VAT: FluentCart shipping VAT may contain minor rounding errors. This is a known bug in FluentCart, which will be corrected in the following releases. The shipping VAT on the invoice is calculated correctly according to Hungarian legal regulations. This may cause a small difference (fraction of a Forint) between what the customer pays, and what appears on the invoice.
Language Support
The admin interface is available in:
* English (Default)
* Hungarian (Magyar)
The interface language follows your WordPress language settings.
Configuration
Navigate to Settings > Billingo
Enter your Billingo Agent API Key (How to get API key)
Configure invoice settings:
Invoice Language (default: Hungarian)
Invoice Type (Paper Invoice or E-Invoice)
Quantity Unit (default: “db”)
Shipping Title (default: “Szállítás”)
Shipping VAT Rate (default: 27%)
Save settings
Additional Information
Troubleshooting for advanced users
Enable WP_DEBUG to see debug information on each orders activity log.
Support
For general questions, please visit the plugin website.
Bug reports and feature requests can be submitted on the project’s GitHub page.
Contributing
This plugin is open source. Contributions are welcome!
Credits
Author: Gábor Angyal
Website: webshop.tech
