Viettel Post

Viettel Post – Shipping Integration (Botble Ecommerce)

This plugin adds Viettel Post as a shipping method for Botble Ecommerce, with an admin settings page to configure credentials and shipping address behavior for single-vendor or marketplace (multi-vendor) stores.

Features

• Adds Viettel Post shipping method to Botble Ecommerce checkout.

• Admin menu page: Ecommerce → Viettel Post (quick access).

• Settings page in Settings → Shipping to enable/disable Viettel Post.

• Login configuration: Username/Email + Password (Viettel Post partner account).

• Use Store Address (Marketplace) option:

  • ON: use each vendor/store address for shipping calculation.
  • OFF: use a fixed Viettel Post sender address configured in settings.

Requirements

• Botble CMS + Ecommerce
• PHP 8.x
• Viettel Post partner account (API activated)

Installation

1. Copy the plugin into:

platform/plugins/viettel-post

2. Go to Admin → Plugins and Activate Viettel Post.

3. Clear cache:

php artisan view:clear
php artisan cache:clear

Setup Guide (by screenshots)

Plugin menu appears

After activating the plugin, you will see Viettel Post under:

Ecommerce → Viettel Post

This is a shortcut entry to manage Viettel Post configuration.

Open Shipping settings

Go to:

Settings → Shipping

This is where Botble manages shipping rules and shipping methods.

Viettel Post shipping method is listed

In Settings → Shipping, you will see Viettel Post in the shipping methods list.

Click Settings on the Viettel Post row to open the plugin configuration.

Enable Viettel Post + enter credentials

On the Viettel Post settings screen:

1. Turn on Enable Viettel Post

2. Enter:

   • Username / Email
   • Password

3. Click Update to save.

Important: Your Viettel Post account must be registered and API-activated.

Use Store Address (Marketplace)

On the same settings page, configure:

Use Store Address (Marketplace)

• ON: Each product/vendor uses its own store address to calculate shipping.
• OFF: Use a fixed sender address configured for Viettel Post (single address for all).

Checkout shows Viettel Post option

At checkout, customers will see Viettel Post as a shipping method option (with the calculated fee displayed).

Notes / Limitations

• ✅ Vietnam market only (currently supports Vietnam addresses).
• ❌ Webhook Viettel Post not integrated yet (coming soon).
• ❌ Auto-create shipment/order to Viettel Post not available yet (coming soon).

Troubleshooting

Viettel Post doesn’t show at checkout

• Ensure plugin is Activated
• Ensure Enable Viettel Post is ON
• Clear cache and reload

Cannot load address / login error

• Re-check Username/Email + Password
• Confirm Viettel Post account has API access enabled

SupportMe: MBBank 0377977504