GOSHIP API

API vận chuyển cho hệ thống e-commerce, OMS và WMS

Tích hợp một lần để lấy cước, tạo vận đơn, theo dõi trạng thái và nhận webhook từ nhiều đơn vị vận chuyển qua Goship API.

Xem API Docs Liên hệ tích hợp

TÍNH NĂNG API

Những gì có thể tích hợp qua Goship API

Một lớp API cho các thao tác vận chuyển chính: địa chỉ, cước, tạo đơn, tracking, webhook và carrier.

01

Location API

Lấy danh sách tỉnh/thành, quận/huyện, phường/xã để chuẩn hóa địa chỉ trước khi tính cước.

02

Rate API

Lấy và so sánh cước vận chuyển từ nhiều carrier trong một response thống nhất.

03

Shipment API

Tạo vận đơn với carrier được chọn, nhận mã vận đơn và dữ liệu phục vụ in nhãn.

04

Tracking API

Theo dõi trạng thái vận đơn và đồng bộ dữ liệu giao hàng về hệ thống nội bộ.

05

Webhook

Nhận cập nhật trạng thái giao hàng tự động khi vận đơn thay đổi trạng thái.

06

Carrier API

Quản lý danh sách đơn vị vận chuyển được hỗ trợ và cấu hình lựa chọn carrier.

API PREVIEW

Endpoint cốt lõi cho flow vận chuyển

Các endpoint trong CMS seed được đưa vào giao diện tĩnh để developer thấy nhanh phạm vi tích hợp.

Mở tài liệu
POST /api/v1/rates Get rates
POST /api/v1/shipments Create shipment
GET /api/v1/shipments/{id}/tracking Get tracking
POST /webhooks/goship/shipment-status Webhook endpoint

FLOW TÍCH HỢP

Flow tích hợp cơ bản

Từ xác thực API đến webhook trạng thái, hệ thống tích hợp đi qua một luồng rõ ràng.

Minh họa quy trình tích hợp Goship API từ xác thực, chuẩn hóa địa chỉ, lấy cước, tạo vận đơn đến tracking và webhook
  1. 01

    Xác thực API

    Lấy API key và kết nối hệ thống e-commerce, OMS hoặc WMS với Goship.

  2. 02

    Đồng bộ địa chỉ

    Dùng Location API để chuẩn hóa địa chỉ gửi và nhận trước khi gọi cước.

  3. 03

    Gọi Rate API

    Lấy phương án vận chuyển phù hợp theo tuyến giao, khối lượng, kích thước và COD.

  4. 04

    Tạo vận đơn

    Gọi Shipment API với carrier được chọn để nhận mã vận đơn và dữ liệu giao hàng.

  5. 05

    Theo dõi trạng thái

    Đọc tracking tập trung thay vì mở từng portal riêng của carrier.

  6. 06

    Nhận webhook

    Đẩy trạng thái mới về hệ thống nội bộ để giảm polling và thao tác thủ công.

DÀNH CHO AI?

Goship API phù hợp với đội nào?

Phù hợp khi hệ thống cần biến vận chuyển thành một phần của sản phẩm hoặc quy trình vận hành nội bộ.

E-commerce platform

Nền tảng bán hàng cần tích hợp vận chuyển đa hãng vào checkout hoặc seller center.

OMS

Hệ thống quản lý đơn hàng cần lấy cước, tạo vận đơn và theo dõi fulfillment tự động.

WMS

Hệ thống kho cần tạo đơn giao, in nhãn và đồng bộ trạng thái đóng gói, bàn giao.

Website bán hàng riêng

Website cần kết nối vận chuyển mà không muốn tích hợp từng carrier riêng lẻ.

Startup logistics

Đội sản phẩm cần ra mắt luồng vận chuyển nhanh hơn với một lớp API trung gian.

Internal operation system

Hệ thống nội bộ cần gom tracking, webhook và dữ liệu vận đơn về một chuẩn chung.

SO SÁNH

Tự tích hợp từng carrier API hay dùng Goship API?

So sánh hai cách tiếp cận khi hệ thống cần lấy cước, tạo vận đơn, tracking và webhook đa hãng.

Tiêu chí

Số API cần bảo trì

Tự tích hợp từng carrier

Nhiều API riêng lẻ

Dùng Goship API

Một API duy nhất

Tiêu chí

Mapping trạng thái

Tự tích hợp từng carrier

Tự map cho từng hãng

Dùng Goship API

Đã chuẩn hóa

Tiêu chí

Chuẩn hóa webhook

Tự tích hợp từng carrier

Mỗi hãng khác format

Dùng Goship API

Một format chung

Tiêu chí

Thêm carrier mới

Tự tích hợp từng carrier

Tích hợp thêm API

Dùng Goship API

Bật config

Tiêu chí

Theo dõi lỗi tích hợp

Tự tích hợp từng carrier

Nhiều nguồn

Dùng Goship API

Một nơi

Tiêu chí

Tài liệu kỹ thuật

Tự tích hợp từng carrier

Nhiều docs khác nhau

Dùng Goship API

Một docs

FAQ

Câu hỏi thường gặp về Goship API

Goship API dùng để làm gì?

Goship API giúp hệ thống e-commerce, OMS, WMS tích hợp vận chuyển đa hãng qua một API duy nhất.

Goship API có hỗ trợ tạo vận đơn không?

Có. Shipment API cho phép tạo vận đơn với nhiều đơn vị vận chuyển.

Goship API có webhook không?

Có. Goship gửi webhook khi trạng thái vận đơn thay đổi.

Một hệ thống OMS/WMS có thể dùng Goship API không?

Có. Goship API được thiết kế cho các hệ thống e-commerce, OMS và WMS.

Có cần tích hợp riêng từng hãng vận chuyển nữa không?

Không. Goship đã tích hợp sẵn, bạn chỉ cần làm việc với một API.

GOSHIP API

Tích hợp vận chuyển đa hãng vào hệ thống của bạn

Xem tài liệu kỹ thuật hoặc liên hệ Goship để được tư vấn flow tích hợp phù hợp.

Xem API Docs Liên hệ tích hợp