內容簡介
HgE: Shipping Zones for FAN Courier Romania 是一款專為羅馬尼亞電商打造的 WooCommerce 物流整合外掛，可自動產生託運單（AWB）、即時計算運費、追蹤包裹狀態，並完整支援貨到付款，大幅簡化出貨流程。
【主要功能】
• 一鍵或自動產生 AWB 託運標籤
• 即時串接 FAN Courier API 計算運費
• 下載 A4 格式 PDF 託運標籤供列印
• 自動同步 FAN Courier 包裹追蹤狀態
• 完整支援貨到付款（COD）付款方式
• 批次處理多筆訂單的 AWB 產生作業
外掛標籤
開發者團隊
② 後台搜尋「HgE: Shipping Zones for FAN Courier Romania」→ 直接安裝（推薦）
原文外掛簡介
HgE: Shipping Zones for FAN Courier Romania is a professional WordPress plugin that provides seamless integration between WooCommerce and FAN Courier shipping services in Romania. Generate AWB labels automatically, calculate shipping costs in real-time, and track packages directly from your WordPress admin.
Key Features
Automatic AWB Generation – Create shipping labels with one click or automatically when orders reach “Processing” status
Real-time Shipping Rates – Calculate accurate shipping costs based on destination, weight, and package dimensions
PDF Label Download – Download A4 format shipping labels ready for printing
Package Tracking – Automatic status synchronization with FAN Courier tracking system
Bulk Operations – Generate AWBs for multiple orders at once
Cash on Delivery (COD) – Full support for COD payments with bank account integration
Flexible Pricing – Choose between dynamic API pricing or fixed rates for different regions
WooCommerce Shipping Zones – Complete integration with WooCommerce shipping zones system
Order Management – Manage AWBs directly from order edit page with action buttons
Health Check Dashboard – Diagnostic tools to monitor API connectivity and system health
HPOS Compatible – Full support for WooCommerce High-Performance Order Storage (HPOS)
Action Scheduler – Asynchronous task processing for better performance on high-traffic sites
Detailed Logging – Debug mode with comprehensive logs for troubleshooting
Shipping Methods Included
FAN Courier Standard – Classic home/office delivery service
Perfect For
Online stores shipping within Romania
E-commerce businesses using COD payment method
WooCommerce shops requiring automatic AWB generation
Businesses needing real-time shipping cost calculation
Multi-vendor marketplaces using FAN Courier services
Technical Features
REST API integration with FAN Courier eCommerce platform
JWT authentication with automatic token refresh
Rate limiting and retry logic for API stability
Idempotency keys to prevent duplicate AWB generation
Transient-based locking mechanism for concurrent operations
Complete AJAX support for seamless admin experience
WordPress coding standards compliant
Security hardened with nonce verification and capability checks
Requirements
WordPress 5.0 or higher
WooCommerce 3.0 or higher
PHP 8.1 or higher
MySQL 5.6 or higher
Active FAN Courier account with API credentials
SSL certificate recommended for secure API communication
Language Support
Romanian (primary)
English (interface elements)
Developer Friendly
Clean, well-documented code
WordPress hooks and filters
Action Scheduler integration
Extensible architecture
PSR-compliant coding style
Additional Information
Credits
Developed by Hurubaru George Emanuel
FAN Courier API integration
Built for the Romanian e-commerce community
Support
For support requests, please use the WordPress.org support forum for this plugin.
Privacy Policy
This plugin:
* Sends order data (customer name, address, phone, order value) to FAN Courier API for AWB generation
* Stores API credentials securely in WordPress database
* Does not collect or transmit data to third parties except FAN Courier
* Logs IP addresses for security purposes (can be disabled)
* Does not use cookies on the frontend
External Services
This plugin relies on external FAN Courier API services to provide shipping functionality. Data is transmitted to these third-party services as described below:
FAN Courier eCommerce API (https://ecommerce.fancourier.ro/)
Used for:
* Authentication and authorization token generation
* Real-time shipping rate calculation based on destination and package details
* Service availability checking for specific locations
Data sent:
* Authentication: /authShop – Client credentials (username, password, client ID), website domain
* Rate calculation: /get-tariff – Destination address, package weight, dimensions, declared value, website domain
* Service availability: /check-service – Destination locality, website domain
When data is sent:
* During plugin configuration (credential verification)
* When customers view cart/checkout pages (shipping rate calculation)
* When checking service availability for customer addresses
FAN Courier REST API (https://api.fancourier.ro/)
Used for:
* JWT authentication for API access
* AWB (shipping label) generation and management
* PDF label generation for printing
* Real-time package tracking and status updates
* AWB reports and history
Data sent:
* Authentication: /login – Client credentials (username, password)
* AWB generation: /intern-awb – Sender details (name, address, contact), recipient details (name, address, phone), package details (weight, dimensions, contents), payment information (COD amount, bank account), delivery instructions
* Label download: /awb/label – AWB number, client ID
* Tracking: /reports/awb/tracking – AWB number, client ID
* AWB reports: /reports/awb – Client ID, date range for reports
When data is sent:
* During plugin configuration (credential verification)
* When store admin generates AWB labels (manual or automatic)
* When downloading PDF labels for shipping
* During automated tracking synchronization (scheduled background task)
* When viewing AWB history and reports
Legal Information
By using this plugin, you acknowledge that customer and order data will be transmitted to FAN Courier’s servers for shipping purposes. You are responsible for ensuring compliance with applicable data protection regulations (GDPR, etc.) and obtaining necessary customer consent.
FAN Courier General Terms and Conditions: https://www.fancourier.ro/conditii-generale-privind-furnizarea-serviciilor-postale/
FAN Courier Privacy Policy: https://www.fancourier.ro/politica-de-confidentialitate/
FAN Courier Personal Data Processing Policy: https://www.fancourier.ro/politica-de-prelucrare-a-datelor-cu-caracter-personal/
Data Security
All API communications use HTTPS encryption
API credentials are stored securely in WordPress database
No customer data is stored on third-party servers beyond what’s necessary for shipping operations
You can enable debug logging to monitor all API communications (disable in production for security)
Roadmap
Planned features for future releases:
* Multiple sender locations
* Return AWB generation
* Pickup scheduling
* Express delivery options
* Bulk tracking updates
* Custom email notifications with tracking links
* Integration with popular page builders
Contributing
This plugin is open source. Contributions are welcome via GitHub.
License
This plugin is licensed under GPLv2 or later.
Copyright (C) 2024-2026 Hurubaru George Emanuel
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see https://www.gnu.org/licenses/gpl-2.0.html.
