WooCommerce Georgian Post Courier Shipping Method

Documentation for the Plug and Pay WooCommerce Georgian Post Courier Shipping Method plugin.

• PHP: 7.4, 8.1, 8.2, or 8.3
• ionCube Loader: Required. For more details, check the ionCube Manual.
• WooCommerce: 3.6 or higher

• Currency: Store must use GEL (Georgian Lari).
• Weights: All products must have weight units and values assigned to calculate shipping rates correctly.
• Shipping Destination: Supports shipping within Georgia only.

Go to WooCommerce > Settings > Shipping > Georgian Post Courier to configure the global API settings:

1. API username: Provided by Georgian Post.
2. API password: Your Georgian Post API password.
3. Barcode type: Select the preferred barcode format for labels.
4. Sender city: Select the city from which you will be sending packages.
5. Sender address: Your physical warehouse or store address.
6. Debug Log: Enable this to log API events for troubleshooting.

After configuring the global settings, add the Georgian Post Courier method to your desired shipping zones under WooCommerce > Settings > Shipping > Shipping zones.

When setting up or troubleshooting shipping rates, it is highly recommended to enable WooCommerce Shipping Debug Mode. This prevents WooCommerce from caching shipping rates, ensuring that every change you make to settings is reflected immediately.

To enable it:

1. Go to WooCommerce > Settings > Shipping > Shipping options.
2. Check the Enable debug mode box.
3. Save changes.

Note: Remember to disable this once your store is live, as it can impact performance.

The plugin automatically calculates shipping weights and fetches real-time rates from the Georgian Post API during checkout. It ensures accurate pricing based on the destination and package weight.

Note: Since shipping rates depend on weight, every product in the cart must have a weight set in its WooCommerce settings. If a product is missing weight data, the shipping method will not be available.

Store administrators can manually register parcels directly from the WooCommerce order details page. Once a shipping item is associated with the Georgian Post Courier method, a Register button appears in the order items section.

After successful registration, you can generate and print:

• Shipping Labels: Standard labels for your packages.
• Return Labels: Labels to facilitate customer returns.

Customers can view the real-time status of their shipment directly on the "View Order" page. The plugin fetches the latest routing information and status updates from Georgian Post, displaying a detailed history of the package's journey.

Type: filter When: Before registering an order with Gpost Courier — controls the sender details sent to the API.

// Change sender details on order registration.
add_filter(
    'plugandpay_gpost_courier_register_order_sender',
    function( $sender, $item_id ) {
        $sender['addressNote'] = 'sender_address';
        $sender['CityID']      = 'sender_city_id'; // Take this ID from city dropdown select in plugin settings.

        return $sender;
    },
    10
);

See General Shipping Hooks for standard filters like woocommerce_package_rates with examples (e.g., for free shipping based on cart total, city, or product ID).