Regulatory API를 사용하여 발송물 생성 시 참조할 수 있는 제품별 규정 준수 데이터를 저장하세요.

Regulatory API는 다음 규제 기관에 대한 데이터를 지원합니다.

• 미국 소비자 제품 안전 위원회(CPSC) — 법적 고지로 제출된 규정 준수 증명서(CoC) 데이터, CPSC 제품 레지스트리(Product Registry)에 대한 참조 또는 전체 증명서.

• 유럽 연합 집행위원회 — 소액 면세(De Minimis) 폐지 — 2026년 7월 EU의 €150 소액 면세(De Minimis) 기준 폐지에 따라 EU로 수입되는 저가(€150 미만) B2C 화물에 대해 제출이 요구되는 제품 식별 정보.

이 API는 미국 관세국경보호청(CBP), EU 집행위원회 또는 기타 기관에 직접 신고서를 제출하지 않습니다. 

Regulatory API를 사용하는 전체 워크플로는 다음과 같습니다.

1. 이 API를 사용해 특정 규제 기관 및 국가의 제품에 대한 규제 데이터를 저장할 수 있습니다. 제공해야 하는 세부정보는 다를 수 있습니다. 자세한 내용은 프로파일 만들기를 참조하세요.
2. Ship API를 사용해 발송물을 생성합니다. 각 상품에 regulatoryDetails[] 배열이 포함되고, 각 요소에 regulationCode, productId, productIdType이 포함되어야 합니다.
3. FedEx에서 저장된 상품 프로파일과 발송물 정보를 병합합니다.
4. FedEx가 고객님을 대신하는 IOR(수입자) 역할을 수행하며 필요한 모든 규제 서류를 제출합니다.

자세한 내용은 규제 프로파일 및 Ship API 사용하기를 참조하세요.

유연성을 자랑하는 Regulatory API는 통합 범위를 최소화하고 저장소를 중앙 집중화합니다. 모든 프로파일은 동일한 최상위 필드를 사용합니다. 규제 기관별 데이터는 details[] 배열에 저장되며, 해당 요소의 형태는 regulationCode에 따라 결정됩니다.  

필수 최상위 프로파일 필드에는 다음이 포함됩니다.

• regulationCode*- 세부 사항이 적용되는 규제 기관입니다. 예: CPSC 또는 EU_DE_MINIMIS. 이 필드 값은 세부 규제 정보의 요소 형태를 정의합니다. 
• productId* – 판매자 또는 고객의 제품 식별자입니다.
• productIdType* – 제품 식별자의 유형입니다. 예: SKU, PART_NUMBER, REGISTERED_NUMBER, GTIN, UPC, EAN, MPN 및 OTHER 
• countryOfImport* – 도착지 수입 국가입니다.
• details[] – 발송물에 대해 선택한 규제 기관에 따라 이 배열에 포함된 요소의 형태가 변경됩니다. CPSC 규제 발송물의 경우 면책 또는 참조 메시지 세트가 포함되며, EU_DE_MINIMIS 규제 발송물의 경우 제조자 식별자가 포함됩니다. 

*이러한 값은 Ship API 요청의 regulatoryDetails[] 배열에서 값을 일치시켜 프로파일 데이터를 발송물 데이터로 병합하는 데 사용됩니다.

팁: 이 구조는 Ship API의 commodities[].regulatoryDetails[] 배열에 있는 항목을 반영합니다. 저장된 프로필에서 직접 복사해서 Ship API 요청을 채울 수 있습니다. 이는 프로파일 세부정보가 최신 상태가 아닌 일회성 발송물의 경우 유용합니다.  

Regulatory Profiles 엔드포인트에 POST하여 규제 프로파일을 생성합니다.

규제 기관별 세부 사항은 다음 섹션을 참조하세요. 

Regulatory API는 PGA 메시지 세트를 통해 ACE 항목과 함께 CBP 및 CPSC에서 요구하는 CoC 데이터를 저장합니다. regulationCode = "CPSC"이고 countryOfImport = "US"인 프로파일을 생성하세요.  

다음 세 가지 메시지 세트 중 하나를 details[] 요소에 채워야 합니다.

필수 regulationCode, productId, productIdType, countryOfImport 외에 details[]를 사용하여 메시지 세트를 제공해 주세요.  

• disclaimMessageSet – 법적 고지에 필요한 데이터입니다.

  • disclaimCode ― A = 제품이 CPSC 규제 대상이 아닙니다. B = 기관 지침에 따라 데이터가 필요하지 않습니다. 
  • intendedUseCode – 기본 코드 + 하위 코드. 예: "130.003". 자세한 내용은 용도 코드를 참조하세요.
  • intendedUseDescription – 자유 텍스트. intendedUseCode = "980.000"인 경우에만 필요합니다 (기타 용도). 

• referenceMessageSet – 참조에 필요한 데이터입니다.

  • productVersion – 현재 CPSC 제품 레지스트리의 인증서와 연결된 제품 인증서 버전 식별자입니다. 
  • certificateId – CPSC 제품 레지스트리를 통해 발급한 인증인 ID입니다.

• fullMessageSet – 전체 인증서 데이터입니다. 전체 개체와 필드 설명, 세부정보 및 예제는 규제 엔드포인트 정보를 참조하세요. 기본 데이터에는 다음이 포함됩니다. 

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

참고: CPSC 제품 레지스트리 항목은 CPSC를 통해 직접 관리해야 합니다. 이 API는 참조 제출을 위해 CPSC 등록 ID를 참조하지만, CPSC 레지스트리 레코드를 생성하거나, 읽거나, 업데이트하지는 않습니다.

intendedUseCode는 CBP와 관련 기관에 수입된 제품이 어떤 용도로 사용되는지 알려주는 6자리 코드(###.###)입니다. CBP에서 정의한 코드는 ACE CATAIR의 부록 R에 나와 있습니다. CPSC는 메시지 세트에 따라 eFiling 제출에 유효한 코드 중 특정 일부만을 인정합니다. disclaimMessageSet가 입력된 경우 이 필드는 항상 필수입니다. 

CPSC는 081, 090, 100, 130, 155, 940, 970, 980의 8가지 기본 코드를 인식합니다.

CPSC의 범위는 소비자 제품이므로 CPSC에서 가장 많이 사용되는 기본 코드는 Base 130입니다. 전체 제출에 사용할 수 있는 코드에는 코드 130.000~130.006만 해당합니다. Disclaim A는 130.001～130.005를 제외한 모든 130 하위 코드(즉, 130.000 또는 130.006)를 사용할 수 있습니다. Disclaim B는 130.006만 사용할 수 있습니다.

Regulatory API는 EU의 €150 소액 면세(De Minimis) 기준 폐지에 따른 데이터 의무를 지원합니다. 프로파일을 생성하려면 regulationCode = EU_DE_MINIMIS, countryOfImport는 임의의 EU27 회원국으로 설정하고 상품에 대한 규제 세부정보를 기재하세요. 

productId 필드는 영숫자 제품 식별자입니다. EU에서는 이를 판매자 SKU로 간주하여 취급합니다.

필수 regulationCode, productId, productIdType, countryOfImport 외에 details[]를 사용하여 다음과 같은 항목을 제공해 주세요. 

• merchantProductId – 판매자의 제품 식별자입니다. 별도의 판매자 및 SKU 수준 식별자를 사용하는 경우에는 productId와 구분됩니다. 그렇지 않은 경우에는 이를 productId와 동일하게 설정하세요.
• nonStandardManufacturerProductId –  제조업체의 내부 SKU 또는 ID입니다. 예: SH123456-L. 
• standardManufacturerProductId – GTIN, UPC 또는 EAN과 같은 표준 식별자입니다. 예: 01233456789012. 제품에 표준 식별자가 없는 경우 리터럴 문자열 "NA"를 사용합니다.

세 가지 식별자 중 어느 것도 입력되지 않은 상태로 EU_DE_MINIMIS 프로파일이 저장되면, 이 API는 비차단 REGP_EU_MISSING_IDENTIFIERS 경고를 발생시킵니다. 

Ship API에서 Regulatory API에 저장된 규제 데이터를 참조할 수 있습니다. 규제 프로파일의 세부정보는 발송물이 생성된 후 발송물 다운스트림에 통합됩니다. 

Ship API 및/또는 Regulatory API를 활용하는 일반적인 워크플로는 다음과 같습니다.

1. 프로파일 우선 접근 방식. Regulatory API를 사용해 각 제품을 한 번 등록한 다음, 발송물의 상품에 대해 regulationDetails[]에 productId + productIdType + regulationCode만 제공합니다. 등록된 프로파일의 세부정보가 발송물에 병합됩니다. 

2. 인라인 전용 접근 방식. 발송물의 각 상품에 productId + productIdType + regulationCode와 완전하게 채워진 details[]가 포함됩니다. 전체 CPSC 데이터는 인라인으로 포함할 수 없습니다. 이 패턴은 CPSC 메시지 세트 및 EU_DE_MINIMIS 규제 기관의 면책 및 참조 용도로만 제한됩니다.

3. 하이브리드 접근 방식. 특정 발송물에 대해 기존 Regulatory API 데이터보다 우선 적용될 수 있습니다. productId + productIdType + regulationCode를 포함하고 details[]를 선택합니다. 인라인 세부정보 데이터가 Regulatory API로 저장한 모든 데이터보다 우선 적용됩니다. 발송물의 인라인 세부정보에 포함되지 않았지만 프로파일에 있는 모든 세부정보 데이터는 발송물 생성 후 병합됩니다.