Tính toán giá đích đến

partyCreateWorkflowInput xác định các bên liên quan và vị trí của họ. Xem toàn bộ lược đồ trong tài liệu tham khảo API GraphQL của chúng tôi. Các trường bắt buộc là:

• location
  • administrativeAreaCode: Mã bang hoặc tỉnh, hai chữ cái. Chỉ bắt buộc cho CA và BR.
  • countryCode: Mã ISO hai chữ cái của quốc gia.
  • line1: Dòng địa chỉ đầu tiên.
  • postalCode: Mã bưu điện hoặc mã zip của địa chỉ.
• person
  • email: Địa chỉ email của người đó.
  • firstName: Tên đầu tiên của người đó.
  • lastName: Họ của người đó.
  • phone: Số điện thoại của người đó.
• type
  • DESTINATION: Thông tin location & person cho đích đến vận chuyển.
  • ORIGIN: Thông tin location cho nguồn gốc vận chuyển. person được liên kết với nguồn gốc vận chuyển không bắt buộc.

itemCreateWorkflowInput liệt kê các mục trong giỏ hàng. Có nhiều trường tùy chọn (xem tất cả các khả năng trong tài liệu tham khảo API của chúng tôi), nhưng các trường dưới đây là bắt buộc.

• amount: Giá trị của một đơn vị sản phẩm được vận chuyển, trước khi được nhân với số lượng. Lưu ý rằng điều này khác với định nghĩa bưu chính của một mục bưu chính. Nếu quantity của mục là 1, đây là tổng chi phí của mục. Nếu quantity của mục là >1, API sẽ nhân amount của mục với quantity của mục để có được tổng cho mục dòng. Không đặt tổng giá của tất cả các đơn vị của mục vào amount.
• currencyCode: Mã tiền tệ cho số tiền mục.
• quantity: Số lượng mục. API sẽ nhân amount của mục với quantity của mục để có được tổng cho mục dòng.
• countryOfOrigin: Quốc gia nơi mục được sản xuất.
• Một trong những điều sau (cái nào được đặt làm tùy chọn khóa mục của bạn. Khóa mục của bạn kết nối thông tin được lưu trữ trong Catalog với mục trong giỏ hàng và được sử dụng trong quá trình tạo nhãn.)
  • productId: ID sản phẩm của mục.
  • sku: SKU của mục.

measurements (WEIGHT, LENGTH, WIDTH, HEIGHT) chỉ bắt buộc nếu bạn muốn cartonize các mục của mình khi nhận được xếp hạng vận chuyển.

cartonsCreateWorkflowInput chỉ yêu cầu chính bản thân đầu vào. Xem toàn bộ lược đồ trong tài liệu tham khảo API GraphQL của chúng tôi để xem tất cả các giá trị có thể được chuyển. Điều quan trọng là phải chuyển các kích thước và trọng lượng của hộp nếu Zonos đang tính toán chi phí vận chuyển.

Quy trình làm việc này được sử dụng khi bạn đã biết dịch vụ vận chuyển và chi phí; nếu bạn muốn Zonos tính toán những chi phí này cho các dịch vụ mà bạn đã bật, hãy hoán đổi quy trình làm việc này và sử dụng shipmentRatingCalculateWorkflow thay thế.

shipmentRatingCreateWorkflowInput truyền tải chi phí vận chuyển. Xem toàn bộ lược đồ trong tài liệu tham khảo API GraphQL của chúng tôi. Các trường bắt buộc là:

• amount: Chi phí vận chuyển.
• currencyCode: Mã tiền tệ của chi phí vận chuyển.
• serviceLevelCode: Mã chỉ định mức dịch vụ vận chuyển được sử dụng trong xếp hạng vận chuyển.

landedCostWorkFlowInput chỉ định các tùy chọn cho tính toán giá đích đến. Xem toàn bộ lược đồ trong tài liệu tham khảo API GraphQL của chúng tôi. Các trường bắt buộc là:

• calculationMethod: Chỉ ra tùy chọn của bạn về cách bạn dự định vận chuyển: DDP (thuế và lệ phí thanh toán trước) hoặc DAP (thuế và lệ phí được thanh toán khi giao hàng, hoặc nếu áp dụng cơ chế nộp thuế, chúng được nộp thông qua mã số thuế).
  • Nếu bạn sử dụng đảm bảo giá đích đến của chúng tôi, giá trị này phải luôn là DDP_PREFERRED, sẽ cung cấp báo giá DDP khi có thể và báo giá DAP là báo giá DDP không được phép. Sử dụng DAP thay vào đó có thể dẫn đến giá đích đến không còn được đảm bảo, vì điều này thường dẫn đến thuế và lệ phí được thanh toán khi giao hàng.
• endUse: Chỉ ra nếu hàng hóa được bán cho một doanh nghiệp khác (FOR_RESALE) hoặc để sử dụng cuối cùng với người tiêu dùng (NOT_FOR_RESALE).
• tariffRate: Chỉ ra phương pháp mà Zonos nên sử dụng để tính toán tỷ lệ thuế quan cho báo giá này, trong trường hợp có một loạt tỷ lệ thuế quan có thể được áp dụng. *Khi sử dụng đảm bảo giá đích đến của chúng tôi, điều này phải luôn là ZONOS_PREFERRED.

Zonos khuyến nghị cao sử dụng mã HS dành riêng cho sản phẩm vì nó dẫn đến báo giá giá đích đến chính xác hơn. Nếu bạn biết mã HS của mình, hãy chuyển hsCode cho mỗi item trong quá trình itemCreateWorkflow.

Nếu bạn chuyển một mã HS, Zonos sẽ xác thực nó khi nhận được báo giá giá đích đến. Nếu mã HS mà bạn cung cấp không hợp lệ (có nghĩa là nó không tồn tại), Zonos sẽ phân loại lại mục của bạn một cách nhanh chóng và sử dụng mã HS mới, hợp lệ thay vì mã do bạn cung cấp.

Nếu bạn cần trợ giúp tạo mã HS cho sản phẩm của mình, hãy tìm hiểu về Zonos Classify và cách yêu cầu phân loại.

Nếu bạn không chuyển Zonos hsCode, chúng tôi sẽ trước tiên kiểm tra Zonos Catalog để xem bạn có mã HS được lưu trữ cho mục của bạn không. Nếu bạn không có, chúng tôi sẽ gọi Classify để tạo phân loại để cung cấp sức mạnh cho tính toán giá đích đến của bạn dựa trên các trường chi tiết sản phẩm itemCreateWorkflow sau: description, category và material. Nếu các trường chi tiết sản phẩm của bạn không đủ chi tiết để tạo phân loại dựa trên tính điểm độ tin cậy của Classify, mã HS mặc định được gán cho cửa hàng của bạn sẽ được sử dụng.

Để Zonos tính toán chi phí vận chuyển, hãy sử dụng shipmentRatingCalculateWorkflow. Tùy chọn vận chuyển được trả về trong phản hồi vận chuyển được tính toán sẽ tương ứng với serviceLevels bạn đã gán cho các hồ sơ vận chuyển trong Dashboard.

Khắc phục sự cố: Nếu bạn mong đợi serviceLevel trong phản hồi nhưng nó không xuất hiện, vui lòng đảm bảo rằng serviceLevel được bật và được hỗ trợ bởi method bạn đã chọn.

Thêm cartonizeWorkflow (không có đầu vào) nếu bạn muốn Zonos sắp xếp các mục của bạn vào hộp trước khi tìm chi phí vận chuyển (được sử dụng cho trọng lượng kích thước.

Nếu bạn biết serviceLevel và amount cho lô hàng, bạn có thể chuyển những giá trị đó trong phần shipmentRatingCreateWorkflow của yêu cầu. Chúng tôi sẽ sử dụng những giá trị đó để tính toán bất kỳ phí vận chuyển được liên kết nào và trả về những giá trị đó trong phản hồi.