referenceNumber는 귀사의 모든 소포에서 고유해야 합니다. 이미 사용한 번호를 다시 사용하면 기존 레코드가 반환되고 새 운송 수단으로 이동되며, 품목과 당사자 정보는 업데이트되지 않습니다. 소포를 수정하려면 같은 참조 번호로 다시 전송하지 말고 Zonos에 문의하세요.
가액
품목마다 amount 또는 totalAmount 중 정확히 하나만 전송하세요. 둘 다 보내거나 둘 다 보내지 않으면 견적 산출이 실패합니다.
currencyCode는 소포마다 한 번 설정합니다. 소포의 모든 품목 가액에 이 통화가 사용됩니다.
우편 화물 API
Zonos에 우편 화물 정보 전달하기
미국 및 유럽연합행 화물의 소포 및 운송 수단 데이터를 전송합니다.
목적지와 관계없이 동일한 두 가지 호출을 사용합니다.
brokerageManifestLinesCreatebrokerageManifestCreate두 호출은 서로를 차단하지 않습니다. 운송 수단이 생성된 후 접수된 소포에는
manifestLinesLink를 사용하세요.1번 호출에서 반환된
id를 보관하세요. 2번 호출에 필요합니다.Landed cost는 비동기적으로 계산됩니다. 성공 응답은 접수를 확인할 뿐, 견적 산출을 의미하지 않습니다. 품목 및 당사자 데이터는 계산 중에 검증되므로, API가 해당 필드 없이도 요청을 수락하더라도 아래 필드를 전송하세요.
일부 목적지는 PDDP 할증료를 추가합니다. 목적지별 PDDP 할증료를 참조하세요.
미국 이외의 목적지에는 한 번의 호출로 처리하는 대안이 있습니다.
필드 범례
1단계: 소포 정보 전달하기
소포 필드
trackingNumbercurrencyCodeendUseDOCUMENTS,GIFT,FOR_RESALE,NOT_FOR_RESALE또는RETURN.itemspartiesORIGIN당사자 하나와DESTINATION당사자 하나. 당사자 필드를 참조하세요.shippingCostshippingCostCurrencyshippingCost의 통화. 생략하면 기본값은USD입니다.taxIdNumberconsignmentWeightreferenceNumbershipperAccountIdpostalOperatorCodedeclarationId품목 필드
물품 라인당 하나의 항목입니다. 세 가지 분류의 물품이 담긴 소포는 세 개의 항목을 가진 하나의 소포입니다.
quantitycountryOfOriginamountamount또는totalAmount중 정확히 하나만 전송하세요.totalAmountamount대신 전송하면 단가는totalAmount / quantity가 됩니다.descriptionmeasurementsWEIGHT또는 전체 수량에 대한TOTAL_WEIGHT중 하나만). 아래를 참조하세요.hsCodecustomsDescriptiondescription과 다른 경우의 통관용 설명.provinceOfOriginskuproductIdgtinupcgtin을 전송하지 않으면gtin으로 사용됩니다.namedocumentIdproductCompositionmaterial과percentage가 필요합니다.marketplacename및url).HS 코드와 원산지는 물품 라인별로 지정합니다. 서로 다른 분류의 물품이 담긴 소포는 각 물품에 대한 코드와 원산지가 필요합니다. 혼합 소포에 하나의 코드만 사용하면 미국에 신고할 수 없습니다.
측정값. 각 항목에는
type,unitOfMeasure,value가 필요합니다. 중량은 순중량이며 해당 라인의 전체 수량을 포괄하므로 수량을 곱하지 마세요. 이 중량을 기준으로 관세가 산정됩니다.type:WEIGHT,TOTAL_WEIGHT,VOLUME,LENGTH,WIDTH,HEIGHT또는ALCOHOL_BY_VOLUMEunitOfMeasure:GRAM,KILOGRAM,OUNCE,POUND,LITER,MILLILITER,CENTIMETER,METER,MILLIMETER,INCH,FOOT,YARD또는PERCENTAGE제품 구성. 각 항목은
material과percentage를 받으며, 선택적으로countryOfMeltAndPour,countryOfCast,primaryCountryOfSmelt,secondaryCountryOfSmelt를 받습니다.당사자 필드
각 당사자에는
type(발송인은ORIGIN, 수취인은DESTINATION),person,location이 있습니다.location.countryCodelocation.line1location.locality(도시)location.postalCodelocation.administrativeAreaCodeperson.firstNameperson.lastNameperson.emailperson.companyNameperson.phone두 당사자 모두 세관 신고서에 기재됩니다. 불완전한 당사자 정보는 통관 실패의 가장 흔한 원인입니다.
출발지 우편번호는 필수가 아닌 권장 사항입니다. 홍콩, 아랍에미리트, 카타르에는 우편번호가 없습니다. EU 수취인 우편번호는 아일랜드를 제외하고 필수입니다.
administrativeAreaCode는 두 글자 코드를 받습니다.TEXAS가 아닌TX를 사용하세요.예시
mutation BrokerageManifestLinesCreate($input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(input: $input) {idtrackingNumberreferenceNumbertaxIdNumber}}응답
json
{ "data": { "brokerageManifestLinesCreate": [ { "id": "line_abc123def456", "trackingNumber": "RB123456799GB", "referenceNumber": "ITM-00184413", "taxIdNumber": "IM5281234567" } ] } }제품 식별자
각 물품 라인에 있는 네 가지 필드입니다.
productIdskugtinmanufacturerProductId유럽에서의 활용 방식
EU PDDP에는 일곱 개의 제품 식별자 필드가 있습니다. 그중 세 개는 품목에 전송한 값으로 직접 채워지므로, 여기에서 더 많이 전송할수록 신고서가 더 많이 채워집니다.
merchantProductIdentifier(MPID)productId, 없으면skumanufacturerStandardizedProductIdentifier(S PID)gtinmanufacturerNonStandardizedProductIdentifier(NS PID)manufacturerProductIdlccProviderProductIdentifier는 Zonos의 품목 id로 설정됩니다.manufacturerIdentifier는 전송되지 않습니다.제약 조건:
gtin은 숫자만 사용합니다.0-50123-45678-9가 아닌05012345678900을 사용하세요.gtin또는upc중 하나만 전송하세요. UPC는 GTIN-12이며,upc는gtin으로 정규화됩니다.manufacturerProductId는 70자까지 허용됩니다. 다른 모든 식별자 필드는 50자에서 잘립니다.2단계: 운송 수단 정보 전달하기
운송사 인계 시 1단계에서 받은 소포 id를 지정하여 전송합니다.
postalOperatorCodecarrierCodeserviceNumberarrivalDatedestinationCodetransportationModeAIR,SEA,ROAD또는RAIL. 기본값은AIR입니다.vesselNameoriginCodeawbPrefixawbNumberweightweightUnitweight의 단위.amount항공 화물 운송장은 선택 사항입니다. 운송 수단 키는
carrierCode,serviceNumber, 날짜에서 도출됩니다.destinationCode와originCode는 기존 형식 그대로 전송하세요. 세관 항구 목록과의 매핑은 Zonos가 관리합니다.mutation BrokerageManifestCreate($input: ManifestInput!, $lineIds: [ID!]!) {brokerageManifestCreate(input: $input, lineIds: $lineIds) {idcarrierCodeserviceNumberdestinationCodearrivalDate}}해상 발송도 같은 호출을 사용하며,
transportationMode: SEA,carrierCode에 SCAC,serviceNumber에 항차 번호,vesselName을 지정하고, 도착 날짜는 몇 시간이 아닌 몇 주 후가 됩니다.나중에 접수된 소포
운송 수단이 생성된 후 접수된 소포는
manifestLinesLink로 연결합니다.뮤테이션
graphql
mutation ManifestLinesLink($manifestId: ID!, $lineIds: [ID!]!) { manifestLinesLink(manifestId: $manifestId, lineIds: $lineIds) { id } }유럽행 간소화 경로
미국 이외 지역행 소포는 운송 수단 단계를 건너뛸 수 있습니다. 배열과 함께 사업자 코드를 전달하세요.
mutation BrokerageManifestLinesCreate($postalOperatorCode: PostalOperatorCode$input: [ManifestLineInput!]!) {brokerageManifestLinesCreate(postalOperatorCode: $postalOperatorCodeinput: $input) {idtrackingNumber}}postalOperatorCode는 운송 수단이 담았을 정보를 대신 제공합니다. 소포는 자체 값으로 요청 수준의 기본값을 재정의할 수 있습니다.미국행 소포에는 항상 운송 수단이 필요합니다. 통관 신고서에 운송사, 운항편, 도착 항구가 기재되기 때문입니다.
EU 데이터 참고 사항
IOSS
IOSS에 따라 판매된 경우
taxIdNumber에 IOSS 번호를 전송하세요.형식:
IM, 3자리 EU 회원국 코드, 그다음 7자리 숫자. 예:IM5281234567.CIF 가액
EU 관세와 부가가치세는 CIF 가액(물품 가액과 배송비의 합)을 기준으로 부과됩니다. 모든 EU 소포에
shippingCost와shippingCostCurrency를 전송하세요. 이를 생략하면 배송비가 0으로 처리되어 견적이 과소 산정됩니다.목적지 당사자
수취인의 국가 코드가 포함된
DESTINATION당사자가 필요합니다. 이 정보에 따라 적용되는 규정이 결정됩니다.미국 데이터 참고 사항
완전한 당사자 정보
두 당사자 모두 이름, 거리 주소, 지역, 우편번호, 주, 국가를 포함한 전체 주소가 필요합니다.
administrativeAreaCode는 두 글자 주 코드를 받습니다.품목 분류
물품 라인마다 관세 코드가 필요합니다. 10자리를 권장하며 최소 6자리입니다. 6자리 코드는 확장되어 검증됩니다. 코드가 없는 라인은 신고할 수 없습니다.
Zonos가 처리하는 항목
귀사의 계정 구성과 소포에 담긴 물품을 바탕으로 Zonos가 결정합니다.
일반 참고 사항
중복 소포
referenceNumber는 귀사의 모든 소포에서 고유해야 합니다. 이미 사용한 번호를 다시 사용하면 기존 레코드가 반환되고 새 운송 수단으로 이동되며, 품목과 당사자 정보는 업데이트되지 않습니다. 소포를 수정하려면 같은 참조 번호로 다시 전송하지 말고 Zonos에 문의하세요.가액
amount또는totalAmount중 정확히 하나만 전송하세요. 둘 다 보내거나 둘 다 보내지 않으면 견적 산출이 실패합니다.currencyCode는 소포마다 한 번 설정합니다. 소포의 모든 품목 가액에 이 통화가 사용됩니다.gtin없이upc를 전송하면 UPC가 GTIN으로 사용됩니다."KILOGRAM").이 페이지가 도움이 되었나요?