Sử dụng Regulatory API để lưu trữ dữ liệu tuân thủ quy định của từng sản phẩm để bạn có thể tham khảo khi tạo lô hàng.

Regulatory API hỗ trợ dữ liệu cho các cơ quan quản lý sau:

• Ủy ban An toàn sản phẩm tiêu dùng (CPSC) của Hoa Kỳ – Dữ liệu Chứng nhận tuân thủ (CoC) được gửi ở dạng khai báo bỏ qua, tham chiếu đến Sổ đăng ký sản phẩm của CPSC hoặc chứng nhận đầy đủ.

• Ủy ban Liên minh châu Âu – bãi bỏ mức tối thiểu – theo quy định bãi bỏ mức tối thiểu €150 của EU có hiệu lực từ tháng 7 năm 2026, bắt buộc phải có mã định danh sản phẩm kèm theo các lô hàng doanh nghiệp đến người tiêu dùng có giá trị thấp (< €150) nhập khẩu vào EU.

API này không trực tiếp gửi thông tin đến Cơ quan Hải quan và Biên phòng (CBP) của Hoa Kỳ, Ủy ban Liên minh châu Âu hay bất kỳ cơ quan nào khác. 

Sau đây là quy trình làm việc tổng thể sử dụng Regulatory API:

1. Sử dụng API này để lưu trữ dữ liệu quy định của một sản phẩm thuộc thẩm quyền của một cơ quan quản lý và quốc gia cụ thể. Các thông tin chi tiết bạn cần cung cấp có thể khác. Để biết thêm chi tiết, hãy xem phần Tạo hồ sơ.
2. Tạo lô hàng bằng Ship API. Bảo đảm rằng mỗi hàng hóa có một mảng regulatoryDetails[] và mỗi phần tử đều bao gồm regulationCode, productId, productIdType.
3. FedEx hợp nhất hồ sơ hàng hóa đã lưu trữ và thông tin lô hàng.
4. FedEx đóng vai trò Nhà nhập khẩu trong hồ sơ, thay mặt bạn nộp tất cả các chứng từ cần thiết theo quy định.

Để biết thêm chi tiết, hãy xem phần Sử dụng hồ sơ quy định và Ship API.

Tính linh hoạt của Regulatory API giúp giảm thiểu phạm vi tích hợp và triển khai việc lưu trữ tập trung. Mọi hồ sơ đều sử dụng các trường cấp cao nhất như nhau. Dữ liệu riêng theo cơ quan quản lý được lưu trữ trong mảng details[] có hình dạng phần tử được xác định theo regulationCode.  

Sau đây là các trường thông tin cấp cao nhất phải có trong hồ sơ:

• regulationCode* – Cơ quan quản lý áp dụng các chi tiết này. Ví dụ: CPSC hoặc EU_DE_MINIMIS. Giá trị của trường này xác định hình dạng phần tử cho thông tin quy định chi tiết. 
• productId* – Mã định danh sản phẩm của người bán hoặc khách hàng.
• productIdType* – Loại mã định danh sản phẩm. Ví dụ: SKU, PART_NUMBER, REGISTERED_NUMBER, GTIN, UPC, EAN, MPN và OTHER. 
• countryOfImport* – Quốc gia đến của lô hàng nhập khẩu.
• details[] – Hình dạng của các phần tử trong mảng này sẽ thay đổi theo cơ quan quản lý mà bạn đã chọn cho lô hàng. Đối với lô hàng do CPSC quản lý, mục này chứa các tập hợp thông báo Bỏ qua hoặc Tham chiếu; đối với lô hàng do EU_DE_MINIMIS quản lý, mục này chứa mã định danh của nhà sản xuất. 

*Các giá trị này được dùng để so khớp với giá trị trong mảng regulatoryDetails[] của yêu cầu Ship API, để dữ liệu hồ sơ có thể được hợp nhất với dữ liệu lô hàng.

Lưu ý: Cấu trúc này phản ánh một mục nhập trong mảng commodities[].regulatoryDetails[] của Ship API. Bạn có thể điền yêu cầu Ship API bằng cách sao chép trực tiếp từ hồ sơ được lưu trữ. Tùy chọn này hữu ích khi bạn có lô hàng vận chuyển một lần mà chi tiết hồ sơ đã lỗi thời.  

Gửi POST đến điểm cuối Hồ sơ quy định để tạo hồ sơ quy định.

Để biết thông tin chi tiết theo từng cơ quan quản lý, hãy xem các phần sau. 

Regulatory API lưu trữ dữ liệu CoC mà CBP và CPSC yêu cầu, cùng với mục nhập ACE thông qua tập hợp thông báo PGA. Tạo hồ sơ có regulationCode = "CPSC" và countryOfImport = "US".  

Một trong ba tập hợp thông báo sau phải được điền vào phần tử details[].

Ngoài các trường bắt buộc regulationCode, productId, productIdType và countryOfImport, hãy sử dụng details[] để cung cấp các tập hợp thông báo:  

• disclaimMessageSet – Dữ liệu cần thiết cho khai báo bỏ qua.

  • disclaimCode – A = Sản phẩm không do CPSC quản lý; B = dữ liệu không bắt buộc theo hướng dẫn của cơ quan. 
  • intendedUseCode – Mã cơ sở + mã con. Ví dụ: "130.003". Để biết thêm thông tin, hãy xem Mã mục đích sử dụng.
  • intendedUseDescription – Nội dung tùy ý. Chỉ bắt buộc khi intendedUseCode = "980.000" (Dành cho mục đích khác). 

• referenceMessageSet – Dữ liệu cần thiết cho tham chiếu.

  • productVersion – Mã định danh phiên bản chứng nhận của sản phẩm hiện được liên kết với chứng nhận trong Sổ đăng ký sản phẩm của CPSC. 
  • certificateId – ID đơn vị cấp chứng nhận được cấp cho bạn theo Sổ đăng ký sản phẩm của CPSC.

• fullMessageSet – Dữ liệu chứng nhận đầy đủ. Tham khảo thông tin của Điểm cuối quy định để biết đầy đủ các phần mô tả đối tượng và trường, thông tin chi tiết và ví dụ. Dữ liệu chính bao gồm: 

  • productDetails
  • manufacturerDetails
  • lotDetails
  • certifierEntity
  • pointOfContact
  • citationDetails

Lưu ý: Bạn phải trực tiếp quản lý các mục nhập Sổ đăng ký sản phẩm của CPSC với CPSC. API này tham chiếu ID sổ đăng ký của CPSC để điền thông tin tham chiếu nhưng không tạo, đọc hay cập nhật hồ sơ sổ đăng ký của CPSC.

intendedUseCode là một mã gồm sáu chữ số (###.###) cho CBP và các cơ quan liên quan biết mục đích sử dụng dự kiến của sản phẩm nhập khẩu. Các mã này được CBP xác định trong Phụ lục R của ACE CATAIR. CPSC chỉ coi một số mã trong số đó là hợp lệ cho việc nộp eFiling, tùy thuộc vào tập hợp thông báo. Bạn luôn phải nhập trường này khi điền disclaimMessageSet. 

CPSC nhận biết tám mã cơ sở: 081, 090, 100, 130, 155, 940, 970 và 980.

Mã cơ sở 130 là mã thường dùng nhất cho CPSC vì phạm vi quản lý của cơ quan này là sản phẩm tiêu dùng. Các mã từ 130.000 đến 130.006 đều có thể được sử dụng cho một hồ sơ đăng ký đầy đủ. Khai báo bỏ qua A có thể sử dụng bất kỳ mã con 130 nào, ngoại trừ 130.001 – 130.005 (tức là 130.000 hoặc 130.006). Khai báo bỏ qua B chỉ có thể sử dụng 130.006.

Regulatory API hỗ trợ các nghĩa vụ dữ liệu được áp dụng theo quyết định bãi bỏ mức tối thiểu €150 của EU. Để tạo hồ sơ, hãy đặt regulationCode = EU_DE_MINIMIS, đặt countryOfImport thành bất kỳ quốc gia thành viên nào của EU27 và bao gồm các chi tiết quy định cho hàng hóa. 

Trường productId là mã định danh sản phẩm gồm cả chữ và số. EU coi giá trị này là SKU của người bán cho lô hàng.

Ngoài các trường bắt buộc regulationCode, productId, productIdType và countryOfImport, hãy sử dụng details[] để cung cấp: 

• merchantProductId – Mã định danh sản phẩm của người bán. Mã này khác với productId nếu bạn sử dụng các mã định danh riêng biệt ở cấp người bán và cấp SKU; nếu không, hãy đặt mã này giống như productId.
• nonStandardManufacturerProductId – SKU hoặc ID nội bộ của nhà sản xuất. Ví dụ: SH123456-L. 
• standardManufacturerProductId – Mã định danh tiêu chuẩn, như: GTIN, UPC hoặc EAN. Ví dụ: 01233456789012. Sử dụng chuỗi ký tự "NA" khi sản phẩm không có mã định danh tiêu chuẩn.

API sẽ phát ra cảnh báo REGP_EU_MISSING_IDENTIFIERS không chặn nếu hồ sơ EU_DE_MINIMIS được lưu trữ khi thiếu bất kỳ mã nào trong ba mã định danh này. 

Bạn có thể tham chiếu dữ liệu quy định được Regulatory API lưu trữ từ Ship API. Các thông tin chi tiết từ hồ sơ quy định được tích hợp vào quy trình xử lý tiếp theo sau khi lô hàng được tạo. 

Sau đây là các quy trình phổ biến sử dụng Ship API và/hoặc Regulatory API:

1. Cách tiếp cận ưu tiên hồ sơ. Đăng ký mỗi sản phẩm một lần bằng Regulatory API, rồi chỉ cung cấp productId + productIdType + regulationCode trong regulatoryDetails[] cho hàng hóa trong lô hàng của bạn. Thông tin chi tiết được hợp nhất vào lô hàng từ hồ sơ đã đăng ký. 

2. Cách tiếp cận chỉ nội tuyến. Mỗi hàng hóa trong lô hàng của bạn bao gồm productId + productIdType + regulationCode + details[] được điền đầy đủ. Không thể truyền nội tuyến dữ liệu CPSC đầy đủ; quy trình này chỉ được giới hạn cho các tập hợp khai báo bỏ qua và tham chiếu của CPSC và cơ quan quản lý EU_DE_MINIMIS.

3. Cách tiếp cận kết hợp. Đối với một lô hàng cụ thể, bạn có thể ghi đè dữ liệu hiện có của Regulatory API. Bao gồm productId + productIdType + regulationCode + details[] nhất định. Dữ liệu chi tiết nội tuyến sẽ ghi đè mọi dữ liệu được Regulatory API lưu trữ. Mọi dữ liệu chi tiết không có trong thông tin chi tiết nội tuyến của lô hàng nhưng xuất hiện trong hồ sơ sẽ được hợp nhất sau khi lô hàng được tạo.