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 version requirements and installation details, see IonCube Loader.
• 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.

Courier and Georgian Post International can be active together. No compatibility setting is required, but each shipping destination must be assigned to only one of the two methods through WooCommerce shipping zones.

“Standalone” means that only one of the two Georgian Post plugins is active and API-key activated. It does not remove WooCommerce's shipping-zone requirement.

• International only: Add Georgian Post to every zone where it should provide rates. This can include a Georgia zone if you intend to use the International service domestically.
• Courier only: Add Georgian Post Courier to a Georgia-only zone. Courier cannot provide international rates and requires the store currency to be GEL.

If an activated plugin is not added to the shipping zone that matches the customer's destination, WooCommerce will not show its rate. The plugin may still change the checkout city field, but that alone does not make the shipping method available.

Configure the zones under WooCommerce > Settings > Shipping > Shipping zones as follows:

Do not add both Georgian Post methods to the same zone. The Courier and International APIs provide separate city lists, and their city IDs are provider-specific. Even when two cities have the same name, their IDs must not be assumed to match. If both methods are available for the same destination, checkout can collect an ID for one provider and later submit it to the other provider.

With the recommended setup:

• Georgia (GE) uses the Courier city search and Courier rates.
• All other configured countries use the International city list and International rates.
• Billing and shipping countries are handled independently. For example, a Georgian billing address and an international shipping address use the appropriate city source for each field.
• Changing a country clears the previous provider's city ID. The customer must select a city valid for the newly selected country.

Courier requires the store currency to be GEL. For a non-GEL store, do not enable Courier in a shipping zone; use the International plugin for the required destinations instead.

If either plugin or its API-key activation is disabled, the remaining plugin returns to its standalone checkout behavior.

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.

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.

For Georgian billing and shipping addresses, the plugin supplies the Georgian Post Courier city search used to resolve the destination city ID required for rate calculation. When Georgian Post International is also active, the shipping-zone configuration described above determines which plugin supplies the city data for each destination.

Store administrators can manually register shipments 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.

When configuring or troubleshooting rates, enable WooCommerce shipping debug mode so cached rates do not hide settings changes:

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

Disable WooCommerce shipping debug mode again after testing because it can affect checkout performance.

Enable Debug Log in the Georgian Post Courier global or shipping-zone instance settings, then review entries under WooCommerce > Status > Logs using the gpost_courier_shipping_method source.

Type: filter

When: Before registering an order with Georgian Post Courier — controls the sender details sent to the API.

The $sender array supports:

// Change sender details on order registration.
add_filter(
    'plugandpay_gpost_courier_register_order_sender',
    function( $sender, $item_id ) {
        $sender['addressNote'] = '1 Warehouse Street, Tbilisi';
        $sender['CityID']      = 123; // Use a valid Georgian Post city ID.

        return $sender;
    },
    10,
    2
);

Changing the sender city or address does not recalculate the amount already shown in WooCommerce. Georgian Post can charge a different amount for the modified route.

Type: filter

When: Before registering an order with Georgian Post Courier — controls receiver details sent to the API.

The $receiver array contains:

add_filter(
    'plugandpay_gpost_courier_register_order_receiver',
    function( $receiver, $order ) {
        $receiver['addressNote'] .= ' — Call before delivery';

        return $receiver;
    },
    10,
    2
);

Changing the receiver city or address does not recalculate the amount already shown in WooCommerce.

Type: actions

When: Immediately before or after the generated admin shipping-label contents.

Neither action receives parameters. Use them to add static merchant information or label markup:

add_action(
    'plugandpay_gpost_courier_label_after',
    function() {
        echo '<p>' . esc_html__( 'Handle with care', 'your-text-domain' ) . '</p>';
    }
);

The WooCommerce method ID is gpost_courier_shipping_method.

Use the standard woocommerce_package_rates filter to change the Georgian Post Courier checkout cost or label. See General Shipping Hooks for examples based on cart total, destination city, or products.