Customs Description Validation

완전한 통관 설명이 중요한 이유 

모든 국경 간 배송에는 HS 코드가 필요하며, 그 코드의 정확도는 바탕이 되는 설명의 정확도를 넘어설 수 없습니다. HS 분류는 통관과 관세·세금 계산을 좌우하므로, 상업송장에 적는 설명은 품목이 무엇이고 무엇으로 만들어졌는지를 명확하게 밝혀야 합니다.

설명이 모호하거나 불분명하면 분류 과정에서 빈틈을 추측으로 채워야 하며, 이렇게 추측한 세부 정보가 잘못된 HS 코드로 이어질 수 있습니다. 코드가 잘못되면 관세와 세금도 잘못 계산되고, 통관 지연이나 벌금 등 컴플라이언스 문제가 발생할 위험이 커집니다.

Customs Description Validation을 사용하면 품목이 추측만으로 이미 분류된 뒤에야 문제를 발견하는 대신, 데이터 입력 시점에 미흡한 설명을 미리 걸러낼 수 있습니다. 빠진 정보가 있으면 고객에게 정확히 무엇을 요청해야 하는지 알려주므로, 분류 단계에 도달하기 전에 설명을 수정할 수 있습니다. 설명 자체를 생성하려면 통관 설명을, HS 코드를 지정하려면 Classify를 참고하세요.

작동 방식 

품목에 대해 가지고 있는 설명 필드 — name, description, material, categories — 를 제출합니다. Validation은 섬유 성분, 원단이 편직인지 직물인지, 품목의 용도처럼 명시되지 않은 사실을 추측하지 않고도 단 하나의 HS 코드로 좁혀질 만큼 이 정보가 구체적인지 판단합니다.

설명이 얼마나 준비되었는지 알려주는 status를 반환하며, 빠진 정보가 있을 때는 정확히 무엇을 물어야 하는지 알려주는 clarifications 목록도 함께 반환합니다.

Validation은 품목을 분류하지 않으며 HS 코드를 반환하지도 않습니다. status는 참고 정보일 뿐이며, 이를 바탕으로 분류를 진행할지, 경고를 표시할지, 고객에게 추가 정보를 요청할지, 품목을 거부할지는 각자의 정책에 따라 결정합니다.

세 가지 선택 입력값으로 확인 범위를 넓힐 수 있습니다:

• existingItemId — 필드를 직접 전달하는 대신, 이미 저장해 둔 품목을 참조해 검증합니다. 함께 전달한 필드가 있으면 저장된 값을 덮어씁니다.
• shipToCountry — 지정하면 6자리 HS 소호뿐 아니라 도착국의 국가별 관세율표 항목까지 정할 수 있을 만큼 설명이 구체적인지도 함께 확인합니다.
• sessionId — 같은 품목에 대한 후속 검증을 연결해 고객이 같은 질문을 두 번 받지 않도록 합니다. 세션을 참고하세요.

준비 상태 

status 필드는 다음 네 가지 값 중 하나를 반환합니다.

세부 정보 요청(Clarifications) 

status가 READY가 아닐 때는 clarifications 목록에 설명에 추가해야 할 내용을 짧고 구체적으로 설명하는 문구가 담깁니다 — 예를 들어 "state the primary fiber content"처럼요. 이 문구는 고객에게 그대로 보여줄 수 있도록 작성되어 있으므로, 데이터 입력 시점에 바로 노출해서 다음 단계로 넘어가기 전에 빠진 정보를 입력하도록 안내하는 것이 좋은 방법입니다.

status가 READY이면 clarifications는 비어 있습니다.

세션 

모든 검증은 sessionId를 반환합니다. 고객이 clarifications에 따라 품목 정보를 수정하면 다시 검증하면서 해당 sessionId를 함께 전달하고, 새로 추가된 세부 정보만이 아니라 수정된 품목 정보 전체를 전달하세요.

세션 안에서 Validation은 이미 물어본 질문을 기억합니다. 고객이 질문을 건너뛰었거나 일부만 답했더라도 같은 질문을 반복하지 않으므로, 고객이 같은 요청에 계속 답해야 하는 상황이 생기지 않습니다. 남은 질문이 모두 이미 물어본 질문이라면 품목이 다음 단계로 넘어갈 수 있도록 status가 READY로 반환됩니다.

블라우스 예시의 후속 검증인 이 예시에서 고객은 블라우스가 직물(woven)이라는 정보는 추가했지만 소재는 추가하지 않았습니다. 소재에 관한 질문은 이 세션에서 이미 물어봤으므로 다시 묻지 않으며, 품목은 READY로 진행됩니다.

다음 규칙을 기억하세요.

• 품목을 처음 검증할 때는 sessionId를 생략해 새 세션을 시작하세요.
• 세션은 호출한 조직에 속하며 하나의 도착국을 사용합니다. shipToCountry를 변경하면 새 세션이 시작되므로, 항상 가장 최근 응답의 sessionId를 사용하세요.
• 서로 다른 품목마다 새 세션을 시작하세요.

통관 설명 검증 

customsDescriptionValidate mutation을 사용하세요. 품목의 필드를 직접 전달하거나 existingItemId로 저장된 품목을 참조할 수 있습니다. 최소 한 개 이상의 설명 필드를 포함해야 합니다.

위 예시에서 품목은 블라우스임이 명확히 식별되지만, 의류는 소재와 제작 방식에 따라서도 분류가 달라지므로 올바른 HS 코드를 정하려면 추측이 필요합니다. status는 INCOMPLETE이며, clarifications가 고객에게 정확히 무엇을 물어야 하는지 알려줍니다. 해당 세부 정보를 추가하면 같은 품목이 READY로 검증됩니다.