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 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.