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.

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.