API Đơn hàng

Tự động xử lý đơn hàng của bạn với Mouser

Tổng quan

Bạn cần trợ giúp?

Không tìm thấy những thông tin bạn cần? Hãy liên hệ với chúng tôi ngay bây giờ và chúng tôi sẽ giúp thực hiện yêu cầu của bạn.

Liên hệ ngay với Mouser

Mô tả

API Đơn hàng cho phép bạn đặt hàng với Mouser trong khi vẫn đang mở ứng dụng của mình. Do chúng tôi yêu cầu bạn sử dụng mã sản phẩm của Mouser, chúng tôi đề xuất bạn xây dựng danh sách đơn hàng của mình với công cụ Mouser API Tìm kiếm. Bạn sẽ tìm thấy thông tin bên dưới về cách giải thích và tài liệu liên quan tới API Đơn hàng.

Tạo khóa API

Trong tài khoản My Mouser, sẽ có mục mới gọi là API, tại đây bạn sẽ có thể đăng ký và xem khóa API.

Tạo khóa

Sử dụng API Đơn hàng

API Đơn hàng cho phép bạn có thể xem chi tiết của một đơn hàng, nhận danh sách các quốc gia, tiểu bang, loại tiền tệ được hỗ trợ, và tính năng quan trọng nhất là gửi đơn hàng.

Giống như API Giỏ hàng, giá và quy tắc đơn hàng được xác định theo địa chỉ thanh toán liên kết với tài khoản của bạn và địa chỉ giao hàng mặc định hoặc địa chỉ giao hàng nêu trong yêu cầu API.

Dưới đây là các bước gợi ý để thực hiện khi sử dụng một trong các API của Mouser:

  1. Tạo tài khoản My Mouser nếu bạn chưa có.

  2. Tạo khóa API nếu bạn chưa có. Bạn có thể thực hiện bước này bằng cách truy cập trang quản lý API trong tài khoản My Mouser.

  3. Tìm hiểu cách sử dụng API của Mouser và nhận mã ví dụ bằng cách truy cập Hướng dẫn từng bước về API.

    Đọc Hướng dẫn
  4. Truy cập trang API Khám phá, tại đây sẽ liệt kê toàn bộ API hiện có, điểm cuối của API, và cung cấp cho bạn khu vực kiểm tra để dễ dàng sử dụng nhằm tạo yêu cầu API.

    Truy cập API Khám phá
  5. Tạo yêu cầu

  6. Gửi đơn hàng

Điểm cuối

API Đơn hàng cung cấp các điểm cuối liệt kê bên dưới.

Điểm cuối /tùy chọn/truy vấn sẽ trả lại địa chỉ thanh toán và địa chỉ giao hàng, mã tiền tệ, danh sách các phương thức giao hàng và tỷ giá, phương thức thanh toán, tài khoản hãng vận chuyển, chứng nhận thuế, tài khoản VAT và các thẻ tín dụng đã lưu trong tài khoản của bạn.

Bắt buộc phải có địa chỉ thanh toán và địa chỉ giao hàng để sử dụng điểm cuối tùy chọn/truy vấn.

Thẻ tín dụng chỉ được hỗ trợ thông qua API Đơn hàng nếu bạn đã lưu thẻ tín dụng trong tài khoản của mình. Để quản lý các thẻ đã lưu, hãy truy cập ở đây.

Trả lại các loại tiền tệ hiện có theo địa chỉ thanh toán/địa chỉ giao hàng của bạn. Bắt buộc phải có địa chỉ thanh toán và địa chỉ giao hàng để sử dụng điểm cuối tiền tệ.

Có thể dán mã quốc gia giao hàng để ghi đè địa chỉ giao hàng mặc định trong tài khoản của bạn

Để gửi đơn hàng, bạn sẽ cần gửi một mã tiền tệ cho đơn hàng. Như được thấy ở ảnh bên dưới, nếu tôi muốn chọn tiền tệ là Đô la Mỹ cho đơn hàng của mình, tôi cần gửi mã ISO có 3 chữ số là USD.

Trả lại toàn bộ quốc gia hiện có và tiểu bang/tỉnh của quốc gia đó. Cho phép người dùng lọc quốc gia theo mã quốc gia. Có thể sử dụng giá trị được trả lại từ điểm cuối này khi bạn gửi đơn hàng và bạn muốn ghi đè địa chỉ giao hàng mặc định trong tài khoản của mình.

Vi dụ, nếu tôi muốn giao hàng tới Arizona, tôi cần gửi “AZ” là mã ISO tiểu bang và “US” là mã ISO quốc gia để gửi một đơn hàng.

Sử dụng điểm cuối này để gửi một đơn hàng mới. Như được đề cập trước đây, các đơn hàng được tạo tại đây sẽ xuất hiện trong tài khoản của bạn, bạn cần tạo giỏ hàng trước khi gửi một đơn hàng.

Nếu có lỗi ở địa chỉ thanh toán/địa chỉ giao hàng/phương thức giao hàng/thanh toán/quốc gia hoặc tiền tệ/giao hàng theo lịch, bạn sẽ không thể gửi một đơn hàng. Nếu bạn không chắc chắn có lỗi hay không, hãy xem mục Bỏ qua lỗi.

Nếu có lỗi ở các mục trong giỏ hàng, bạn sẽ phải sửa lỗi hoặc xóa mục trong giỏ hàng trước khi gửi một đơn hàng.

Số đơn hàng sẽ được trả lại nếu đặt hàng thành công.

Gửi một đơn hàng mới từ một đơn hàng cũ và nếu thuộc tính "SubmitOrder" được đặt là đúng. Nếu thuộc tính "SubmitOrder" được đặt là sai, tóm tắt đơn hàng sẽ được trả lại.

Sử dụng điểm cuối này để xem chi tiết đơn hàng bạn đã tạo. Để sử dụng truy vấn, bạn phải cung cấp số đơn hàng được trả lại trong nội dung trả lời của điểm cuối được sử dụng để tạo đơn hàng, /api/v{version}/đơn hàng.