WooCommerce Georgian Post International Shipping Method

Documentation for the Plug and Pay WooCommerce Georgian Post International 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: The plugin fetches rates from Gpost in GEL (Georgian Lari). It includes a currency converter (NBG or BOG) to automatically convert these rates into your store's base currency if you are not using GEL.
• Weights & Dimensions: All products must have weight and dimensions (length, width, height) defined to calculate box packing.
• Package Boxes: At least one package box must be defined in settings for the shipping calculator to work.
• Product Settings: Each product must have a Declaration Item assigned in the product shipping settings for customs purposes.

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

1. API username: Provided by Georgian Post.
2. API password: Your Georgian Post API password.
3. Currency converter: Choose between National Bank of Georgia, Bank of Georgia, or Disabled. Gpost returns shipping rates in GEL. If your store uses a different currency, this setting will automatically convert those GEL rates into your store's currency.
4. Debug Log: Enable this to log API events for troubleshooting.

Since this is an international shipping method, it requires pre-defined package boxes to calculate rates accurately.

1. Go to WooCommerce > Settings > Shipping > Package boxes.
2. Add your available shipping boxes with the following details:
   • Ref. name: A descriptive name for the box.
   • Outer Dimensions: Width, Length, and Height (cm).
   • Inner Dimensions: Width, Length, and Height (cm).
   • Empty weight: The weight of the box itself (kg).
   • Max weight: The maximum weight the box can carry (kg).

For international shipping, customs declarations are mandatory.

1. Edit a product (or variation).
2. Go to the Shipping tab.
3. Select the appropriate Declaration item from the dropdown. These items are fetched directly from the Georgian Post API.
4. Ensure Weight and Dimensions are correctly set.

After configuring the global settings and package boxes, add the Georgian Post 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 uses a box-packing algorithm to determine which of your defined package boxes can fit the items in the cart. It then fetches real-time rates from the Georgian Post API based on the destination country, city, and packed box dimensions/weight.

To ensure accurate shipping rates, the plugin dynamically fetches the official list of destination cities from the Georgian Post API based on the selected country during checkout. This ensures that customers select valid delivery locations and that the API returns correct pricing.

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

After successful registration, a Print Label button becomes available to generate the shipping labels required for international post.

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.

Type: filter When: After rates are fetched from Gpost API — controls the rates shown to the customer.

// Free shipping for rate type 55.
add_filter(
    'plugandpay_gpost_shipping_method_rates',
    function( $rates ) {
        if ( isset( $rates[55] ) ) {
            $rates              = [ $rates[55] ];
            $rates[55]['Price'] = 0; // GEL !
        }

        return $rates;
    },
    100
);

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