Bài viết cuối trong loạt bài về EasyCargo API của chúng tôi cung cấp một hướng dẫn toàn diện, từng bước về cách lên kế hoạch xếp hàng bằng API. Chúng tôi sẽ hướng dẫn bạn toàn bộ quy trình, từ thiết lập ban đầu cho đến việc nhận báo cáo kế hoạch xếp hàng, đồng thời minh họa các tương tác API và cách chúng được thể hiện trong giao diện EasyCargo. Hướng dẫn này được tạo ra dựa trên các khái niệm cơ bản đồng thời giới thiệu các chức năng nâng cao để tối ưu hóa việc lập kế hoạch vận chuyển hàng hóa.

Trước khi đi sâu vào các chi tiết triển khai, hãy xây dựng một nền tảng vững chắc với hai điều thiết yếu sau đây. Hướng dẫn Lý thuyết API của chúng tôi bao gồm tất cả các kiến thức cơ bản bạn cần biết về API, trong khi Hướng dẫn Thực hành về Yêu cầu và Kiểm tra API với ReqBin sẽ hướng dẫn bạn cách thiết lập một client API cũng như kiểm tra các endpoint. Cùng nhau, các bài viết này thiết lập nền tảng cần thiết và cung cấp bối cảnh quan trọng cho các chủ đề được đề cập trong bài viết này.

Quy trình lập kế hoạch xếp hàng từng bước

Để sử dụng các yêu cầu API sau đây, bạn cần thêm một token xác thực trong tiêu đề yêu cầu của mình. Bạn có thể tìm thấy các quy trình xác thực chi tiết trong bài viết trước của chúng tôi. Để nhận được token xác thực, bạn phải có một chìa khóa API được liên kết với tài khoản của bạn. Hãy liên hệ với đội ngũ hỗ trợ của chúng tôi để yêu cầu khóa API. Lưu ý rằng token xác thực chỉ có hiệu lực trong 1,5 giờ và sẽ hết hạn sau đó nhằm mục đích bảo mật.

Thiết lập quyền truy cập người dùng

Bước đầu tiên và là một trong những bước quan trọng nhất trong quy trình lập kế hoạch xếp hàng của chúng tôi là tạo một tài khoản, ví dụ như cho nhân viên kho. Bằng cách sử dụng endpoint /api/v1/users, bạn có thể tạo các tài khoản người dùng mới với các quyền cụ thể. Bạn cần cung cấp một số thông tin chi tiết về người dùng, như được hiển thị trong yêu cầu API bên dưới. Bảng điều khiển EasyCargo sẽ ngay lập tức phản ánh việc bổ sung này, xác nhận quyền truy cập của người dùng vào tài khoản công ty. Quy trình được tối ưu hóa này đảm bảo cả quản lý truy cập và kiểm soát bảo mật cho việc lập kế hoạch xếp hàng của bạn, đồng thời duy trì hiệu quả hoạt động.

Trong đoạn mã bên dưới, chúng tôi sẽ gửi một yêu cầu đến endpoint /api/v1/users với phần thân chứa thông tin chi tiết về người dùng mà chúng ta muốn tạo tài khoản. Chúng ta cần chỉ định tên, họ, địa chỉ email để đăng nhập và vai trò của người dùng. Vai trò người dùng có thể là quản trị viên (được biểu thị bằng số 1 trong phần thân yêu cầu) hoặc người dùng thông thường (được biểu thị bằng số 2).

Xem mẫu đầy đủ của yêu cầu API: https://reqbin.com/duacb1ye

Đặt tên khoang hàng hóa

Trước khi bắt đầu bất kỳ hoạt động lập kế hoạch xếp hàng nào, việc đặt tên khoang hàng hóa là rất quan trọng. Endpoint /api/v1/cargospaces cho phép bạn chỉ định kích thước của container nơi các mặt hàng sẽ được đặt. Mỗi khoang hàng hóa yêu cầu các thông số kỹ thuật quan trọng bao gồm chiều dài, chiều rộng, chiều cao và tải trọng tối đa. Hiện tại, API chỉ hỗ trợ tạo khoang hàng hóa kiểu container cho người dùng, với khả năng hỗ trợ các loại khoang hàng hóa khác trong các bản cập nhật tương lai. Hệ thống sẽ xác thực tất cả các thông số kỹ thuật để đảm bảo chúng đáp ứng các yêu cầu vận hành và tiêu chuẩn an toàn. Sau khi được đặt tên, khoang hàng hóa sẽ xuất hiện trong giao diện EasyCargo, xác nhận việc tạo thành công và cho phép sử dụng ngay lập tức để lập kế hoạch xếp hàng.

Xem mẫu đầy đủ của yêu cầu API: https://reqbin.com/8ieqp8ey

Quản lý các mặt hàng cần xếp

Sau khi đã đặt tên cho khoang hàng hóa, bước tiếp theo là tạo một lô hàng mới thông qua endpoint /api/v1/shipment-inputs. Quá trình này bao gồm việc chỉ định cả thông tin chi tiết về lô hàng và các mặt hàng riêng lẻ cần được xếp. Mỗi mặt hàng yêu cầu các thuộc tính chi tiết bao gồm kích thước chính xác, thông số trọng lượng, yêu cầu xử lý và các ràng buộc về xếp chồng. Giao diện EasyCargo cung cấp xác nhận trực quan về việc tạo lô hàng thành công, hiển thị tất cả các mặt hàng và thông số kỹ thuật của chúng. Việc nhập liệu chi tiết này đảm bảo kế hoạch xếp hàng chính xác và tối ưu hóa việc sử dụng không gian trong các bước tiếp theo, đồng thời tuân thủ các quy định an toàn và quy trình xử lý.

Trong đoạn mã bên dưới, chúng tôi sẽ tạo một lô hàng mới với 82 mặt hàng cùng loại bằng cách sử dụng endpoint /api/v1/shipment-inputs. Trong phần thân của yêu cầu, chúng tôi sẽ chỉ định tên lô hàng, hệ thống đo lường và các mặt hàng được lưu trữ. Đối với các mặt hàng, chúng tôi có thể chỉ định chi tiết của chúng như kích thước và các hạn chế về đóng gói. Trong ví dụ này, chúng tôi sẽ chia nhóm các mặt hàng vào một nhóm ưu tiên có tên là Berlin, vì đây là nơi chúng tôi muốn giao tủ lạnh. Chúng tôi sẽ cho phép chúng có thể xoay và xếp chồng khi đóng gói trong khoang hàng hóa. Lưu ý rằng hiện tại không thể chọn màu sắc hoặc kiểm soát việc hiển thị nhãn mặt hàng thông qua API.

Xem mẫu đầy đủ của yêu cầu API: https://reqbin.com/ozixloob

Quy trình tối ưu hóa kế hoạch xếp hàng

Sau khi các chi tiết lô hàng được thiết lập, công cụ tối ưu hóa của EasyCargo sẽ tiếp quản để tạo ra các kế hoạch xếp hàng hiệu quả. Mặc dù việc kích hoạt quy trình tối ưu hóa trực tiếp thông qua API hiện đang trong quá trình phát triển, người dùng có thể truy cập chức năng này thông qua giao diện EasyCargo bằng cách nhấp vào nút Chất Hàng. EasyCargo sẽ xem xét nhiều yếu tố bao gồm phân bổ trọng lượng, thứ tự xếp hàng và yêu cầu giao hàng để tạo ra các sắp xếp tối ưu. Sau khi xếp hàng một các tối ưu, người dùng vẫn có thể thực hiện các điều chỉnh thủ công hoặc thay đổi lựa chọn khoang hàng hóa, đảm bảo kế hoạch cuối cùng đáp ứng các yêu cầu và ràng buộc vận hành cụ thể đồng thời tối đa hóa hiệu quả.

Tạo báo cáo kế hoạch xếp hàng

Sau khi hoàn thiện kế hoạch xếp hàng, tài liệu toàn diện sẽ có sẵn thông qua endpoint /api/v1/shipment-reports/{id}. Các báo cáo chi tiết về kế hoạch xếp hàng này bao gồm sắp xếp hàng hoá, hình ảnh 3D và hướng dẫn xếp hàng chính xác. Mỗi báo cáo cung cấp các chỉ số quan trọng như tỷ lệ sử dụng không gian, dữ liệu phân bổ trọng lượng và hướng dẫn xử lý cụ thể cho nhân viên xếp hàng. Hệ thống tạo ra cả mô hình 3D và hướng dẫn PDF có thể tải xuống, đảm bảo khả năng tiếp cận cho tất cả các bên liên quan như nhân viên kho và khách hàng của bạn. Các báo cáo này đóng vai trò là tài liệu tham khảo thiết yếu trong quá trình xếp hàng thực tế, giúp duy trì sự nhất quán giữa kế hoạch xếp hàng và việc xếp hàng thực tế. Hãy xem báo cáo lô hàng để biết thêm chi tiết đầy đủ.

Trong đoạn mã bên dưới, chúng tôi sẽ truy xuất tất cả các chi tiết báo cáo lô hàng bằng cách sử dụng endpoint /api/v1/shipment-report/{id}. Đầu tiên, chúng ta cần lấy ID báo cáo lô hàng bằng cách gửi yêu cầu GET đến /api/v1/shipments. Lấy ID báo cáo lô hàng từ “phản hồi” này và bao gồm nó trong đường dẫn URL của yêu cầu tiếp theo (/api/v1/shipment-report/{id}). Trong “phản hồi” sẽ chứa tất cả các chi tiết mà bạn thấy trong hình ảnh bên dưới trong báo cáo PDF có thể in.

Xem mẫu đầy đủ của yêu cầu API: https://reqbin.com/ust8mrq2

Chia sẻ và hợp tác

Phần cuối cùng liên quan đến việc phân phối thông tin kế hoạch xếp hàng cho các bên liên quan thông qua endpoint /api/v1/shipments. Tính năng này cung cấp quyền truy cập vào các chi tiết lô hàng toàn diện và các báo cáo liên quan, bao gồm cả hình ảnh 3D tương tác của kế hoạch xếp hàng. Các bên liên quan có thể truy cập kế hoạch thông qua một URL công khai, cho phép hiển thị và xác minh bố trí xếp hàng trực tiếp. Cách tiếp cận hợp tác này đảm bảo tất cả những người tham gia vào quy trình xếp hàng có quyền truy cập ngay lập tức tới thông tin cần thiết, tạo điều kiện phối hợp hiệu quả và triển khai chính xác kế hoạch xếp hàng. Bạn có thể truy cập URL công khai của kế hoạch xếp hàng trong EasyCargo để tự xem vị trí đặt hàng hóa.

Trong đoạn mã bên dưới, chúng tôi sẽ truy xuất tất cả các chi tiết của lô hàng đã tạo trước đó bằng cách sử dụng endpoint /api/v1/shipments/{id}. Để lấy ID lô hàng, trước tiên hãy gửi yêu cầu GET đến /api/v1/shipments. Sau khi xác định được ID lô hàng, hãy thực hiện yêu cầu GET đến /api/v1/shipments/{id} để nhận các chi tiết toàn diện về lô hàng, bao gồm liên kết công khai, liên kết báo cáo lô hàng và các thông tin khác như hiển thị bên dưới.

Xem mẫu đầy đủ của yêu cầu API: https://reqbin.com/y5p3zysj

Để kết luận, tác động của API đối với ngành công nghiệp CNTT là không thể phủ nhận – chúng đã trở thành doanh nghiệp được xây dựng với kiến trúc phần mềm hiện đại. API của EasyCargo là một ví dụ điển hình về cách các giao diện được thiết kế tốt có thể đơn giản hóa các hoạt động logistics phức tạp trong khi vẫn duy trì độ chính xác và hiệu quả. Chúng tôi hy vọng loạt bài hướng dẫn này đã cung cấp những hiểu biết giá trị về cách tận dụng API EasyCargo cho nhu cầu logistics của bạn. Dù bạn là người mới bắt đầu với API hay một nhà phát triển có kinh nghiệm, các khả năng tích hợp đều vô đối. Để được tư vấn cá nhân về việc triển khai EasyCargo vào hoạt động của bạn, hãy liên hệ với chúng tôi qua biểu mẫu liên hệ. Đội ngũ của chúng tôi sẵn sàng giúp bạn khám phá giải pháp phù hợp với yêu cầu cụ thể của bạn.