Kết nối đơn vị vận chuyển

Kết nối AllinGo bằng khóa ứng dụng của chính bạn để khách thấy phí giao hàng do hãng vận chuyển báo, tính theo địa chỉ giao và khối lượng đơn.

Bạn tạo ứng dụng trên AllinGo, thêm địa chỉ webhook của cửa hàng, rồi dán App ID, App Secret và Webhook signing secret vào EcomWeb.

Bạn cần chuẩn bị gì

• Một tài khoản doanh nghiệp AllinGo, có tiền trong ví (hoặc dùng trả sau nếu AllinGo cho phép).
• Một địa chỉ lấy hàng đã lưu trong EcomWeb, ở thẻ Địa chỉ lấy hàng và hộp mặc định của trang Cài đặt › Vận chuyển. Xem Đặt địa chỉ lấy hàng và hộp mặc định.
• Khoảng 15 phút. Nếu muốn chạy thật, thời gian chờ AllinGo duyệt ứng dụng tính thêm.

Quy trình gồm bốn việc theo thứ tự: tạo ứng dụng trên AllinGo, lấy địa chỉ webhook từ EcomWeb và lưu vào AllinGo, lấy signing secret, rồi dán ba giá trị vào EcomWeb.

Tạo ứng dụng trên AllinGo

1. Đăng nhập cổng dành cho nhà phát triển của AllinGo bằng tài khoản doanh nghiệp của bạn.
2. Tạo một ứng dụng mới.
3. Mở tab Keys, sao chép App ID và App Secret. AllinGo chỉ hiện App Secret một lần, hãy lưu lại ở nơi an toàn.

Mỗi ứng dụng có hai cặp khóa:

App ID và App Secret phải cùng loại. Chỉ dán khóa vào form trong EcomWeb, không gửi cho ai khác, kể cả bộ phận hỗ trợ.

Gửi duyệt chạy thật

Khóa chạy thật chỉ hoạt động sau khi AllinGo duyệt ứng dụng của bạn. Khóa thử nghiệm dùng được ngay, kể cả khi đang chờ duyệt.

1. Trong ứng dụng, mở tab Go live.
2. Điền mô tả ứng dụng (ít nhất 30 ký tự) và email liên hệ kỹ thuật. Website, số điện thoại và số đơn dự kiến mỗi tháng là tùy chọn.
3. Gửi duyệt và chờ AllinGo trả lời. Nếu bị từ chối, sửa theo góp ý rồi gửi lại.

Thêm webhook

AllinGo dùng webhook để báo trạng thái vận đơn về EcomWeb. Địa chỉ webhook của cửa hàng đã có sẵn trước khi bạn kết nối và không bao giờ thay đổi.

1. Vào Cài đặt › Vận chuyển. Ở thẻ Tài khoản AllinGo, bấm Sao chép cạnh Địa chỉ webhook.
2. Trong cổng AllinGo, mở tab Webhooks của ứng dụng.
3. Dán địa chỉ vào endpoint Sandbox nếu bạn dùng khóa thử nghiệm, hoặc endpoint Live nếu dùng khóa chạy thật.
4. Chỉ chọn sự kiện delivery.status_changed, bật endpoint và lưu.
5. Sao chép signing secret của endpoint đó (bắt đầu bằng whsec_). AllinGo chỉ hiện signing secret một lần, ngay khi bạn lưu địa chỉ, nên hãy lưu lại ở nơi an toàn, như App Secret.

Endpoint Sandbox và Live có signing secret riêng. Hãy lấy secret của endpoint khớp với loại khóa bạn sắp dán.

Dán khóa vào EcomWeb

1. Vào Cài đặt › Vận chuyển.
2. Ở thẻ Tài khoản AllinGo, bấm Kết nối AllinGo.
3. Dán App ID, App Secret và Webhook signing secret.
4. Bấm Kết nối.

EcomWeb kiểm tra khóa với AllinGo rồi hiện thẻ đã kết nối, gồm nhãn Thử nghiệm hoặc Chính thức, App ID rút gọn và số dư ví AllinGo.

Kiểm tra kết nối

1. Trong cổng AllinGo, ở tab Webhooks, bấm Send test event trên endpoint bạn vừa thêm.
2. Quay lại Cài đặt › Vận chuyển và bấm Kiểm tra lại ở dòng webhook của thẻ Tài khoản AllinGo.
3. Khi thấy “Đã nhận webhook lúc …” kèm giờ, kết nối đã hoạt động.

Nếu vẫn thấy “Chưa nhận webhook nào”, xem mục Sự cố thường gặp bên dưới.

Với khóa thử nghiệm, khách ở trang thanh toán không thấy phí theo hãng. Để xem giá hãng báo, dùng công cụ thử phí vận chuyển trong dashboard.

Thêm mức phí theo hãng vận chuyển

1. Vào Cài đặt › Vận chuyển.
2. Trong khu vực muốn dùng, ví dụ Toàn quốc, bấm Thêm mức phí.
3. Ở Cách tính phí, chọn Theo hãng vận chuyển.
4. Chọn Loại giao hàng và nhập Tên hiển thị.
5. Ở Dịch vụ được phép, chọn các dịch vụ khách được chọn.
6. Nếu muốn, nhập Điều chỉnh giá. Số dương cộng thêm vào giá của hãng, số âm giảm bớt.
7. Bấm Lưu.

Khi thanh toán, khách thấy từng dịch vụ đã chọn với giá hãng báo. Giá tính theo địa chỉ giao, khối lượng sản phẩm trong đơn và hộp mặc định. Giá khách trả không thấp hơn 0.

Đổi khóa hoặc ngắt kết nối

Đổi khóa:

1. Vào Cài đặt › Vận chuyển.
2. Ở thẻ Tài khoản AllinGo, bấm Đổi khóa.
3. Nhập lại cả App ID, App Secret và signing secret rồi lưu. Nếu bạn đã mất signing secret, xem mục Chưa nhận webhook bên dưới.

Địa chỉ webhook giữ nguyên nên bạn không cần sửa gì trong AllinGo. Ngoại lệ: khi đổi giữa khóa thử nghiệm và khóa chạy thật, hãy dán địa chỉ vào endpoint còn lại (Sandbox hoặc Live) và dùng signing secret của endpoint đó. Nếu khóa mới thuộc một ứng dụng AllinGo khác, vận đơn đang giao sẽ không còn được cập nhật.

Ngắt kết nối:

1. Vào Cài đặt › Vận chuyển.
2. Ở thẻ Tài khoản AllinGo, bấm Ngắt kết nối.
3. Bấm Ngắt kết nối để xác nhận.

EcomWeb chỉ xóa khóa của bạn khỏi EcomWeb, ứng dụng trong AllinGo không bị thay đổi. Nếu nghĩ khóa đã lộ, hãy đổi App Secret trong AllinGo. Phí theo hãng ngừng hiện khi thanh toán, và vận đơn đang giao sẽ không còn được cập nhật.

Sự cố thường gặp

App ID hoặc App Secret không đúng. Dán lại từ tab Keys của AllinGo, không để thừa dấu cách. App ID và App Secret phải cùng loại (app_test_ đi với sk_test_, app_live_ đi với sk_live_). Nếu bạn đã đổi hoặc xóa khóa trong AllinGo, thẻ báo khóa không còn dùng được; bấm Kết nối lại và dán khóa mới.

Ứng dụng chưa được duyệt. Khóa chạy thật chỉ hoạt động sau khi AllinGo duyệt. Xem lại tab Go live, và dùng khóa thử nghiệm trong lúc chờ.

Chưa nhận webhook. Kiểm tra lần lượt:

• Địa chỉ trong AllinGo trùng với Địa chỉ webhook trên thẻ.
• Bạn lưu địa chỉ ở đúng endpoint: Sandbox cho khóa thử nghiệm, Live cho khóa chạy thật. Nếu lỡ lưu nhầm endpoint, dán cùng địa chỉ đó vào endpoint đúng, sao chép signing secret của endpoint này, rồi cập nhật bằng Đổi khóa.
• Endpoint đang bật và đã chọn sự kiện delivery.status_changed.
• Signing secret là của đúng endpoint đó. Nếu đã mất secret, đổi secret trong tab Keys của AllinGo rồi dán lại bằng Đổi khóa (hoặc Kết nối AllinGo nếu chưa kết nối).

Sau đó bấm Send test event trong AllinGo và Kiểm tra lại trong EcomWeb.

Đổi từ khóa thử nghiệm sang chạy thật. Khi ứng dụng đã được duyệt, bấm Đổi khóa. Dán địa chỉ webhook vào endpoint Live trong AllinGo, lấy signing secret của endpoint đó, rồi dán App ID app_live_…, App Secret sk_live_… và secret mới.

Khách không thấy phí theo hãng khi dùng khóa thử nghiệm. Đây là hành vi bình thường: với khóa thử nghiệm, chỉ công cụ thử phí trong dashboard hiện giá hãng báo. Muốn khách thấy phí theo hãng, chuyển sang khóa chạy thật.