Viettel Post Sandbox là plugin chạy trên EzyPlatform, nên bạn cần một EzyPlatform đang hoạt động trên máy chủ hoặc trên máy tính cá nhân trước khi cài plugin. Hướng dẫn cài đặt đầy đủ của plugin có tại trang cài đặt Viettel Post Sandbox, tài liệu này tóm tắt các bước chính.

Bước 1: Cài EzyPlatform

Nếu bạn chưa có EzyPlatform, hãy làm theo hướng dẫn cài đặt EzyPlatform. Hướng dẫn này gồm yêu cầu hệ thống, cách chuẩn bị tên miền và cách triển khai lên máy chủ.
Yêu cầu hệ thống tóm tắt:
  • CPU: khuyến nghị 2 nhân, tối thiểu 1 nhân;
  • RAM: khuyến nghị 4 GB, tối thiểu 2 GB;
  • hệ điều hành: khuyến nghị Ubuntu, tối thiểu một bản Linux bất kỳ;
  • Java 8 trở lên;
  • cơ sở dữ liệu MySQL.
Cấu hình tối thiểu chỉ đủ để dùng thử. Khi chạy trên máy chủ, bạn cần trỏ tên miền về máy chủ và nên dùng hai địa chỉ riêng cho website (ví dụ example.com) và trang quản trị (ví dụ admin.example.com). Nếu chỉ chạy trên máy tính cá nhân để phát triển và kiểm thử thì không cần tên miền.

Bước 2: Mua plugin Viettel Post Sandbox

Tạo tài khoản trên ezyplatform.com, sau đó mua plugin Viettel Post Sandbox trên chợ EzyPlatform.

Bước 3: Cài đặt plugin Viettel Post Sandbox

Đăng nhập trang quản trị EzyPlatform và mở đường dẫn cài module với từ khóa viettel-post-sandbox:
https://admin.your-domain.com/modules/add?keyword=viettel-post-sandbox
Thay https://admin.your-domain.com bằng địa chỉ trang quản trị của bạn, hoặc dùng http://localhost:9090 nếu EzyPlatform chạy trên máy tính cá nhân:
http://localhost:9090/modules/add?keyword=viettel-post-sandbox
Cài đặt cả admin plugin và web plugin của Viettel Post Sandbox. Plugin phụ thuộc vào Ecommerce, hãy bảo đảm Ecommerce đã được cài. Sau khi cài xong, khởi động lại EzyPlatform để plugin được nạp.

Bước 4: Kiểm tra và bắt đầu sử dụng

Sau khi khởi động lại, đăng nhập trang quản trị, mở menu Viettel Post Sandbox > Cài đặt để mở tài liệu Swagger và trang quản lý vận đơn sandbox.
Tiếp theo, làm theo Hướng dẫn sử dụng Viettel Post sandbox sau khi cài đặt để đăng nhập trang web sandbox, cấu hình Ecommerce và webhook, rồi xem Các bước tạo đơn Viettel Post để tự gọi API tạo vận đơn đầu tiên.