Zonos Rate를 사용하면 운송사 계정이 승인된 모든 목적지를 대상으로 오가는 배송 요금을 확인할 수 있습니다. 이 정보는 운송사와의 API 연동 또는 제공된 rate sheet를 통해 가져옵니다. 계산된 배송 응답에 반환되는 배송 옵션은 Dashboard에서 shipping profile에 할당한 serviceLevels와 연결됩니다. 응답에서 특정 serviceLevel을 기대했지만 보이지 않는다면, 해당 serviceLevel이 그 목적지에 대해 활성화되어 있는지 확인하세요.
Instant Rate는 배송 이력을 활용하여 배송 비용을 즉시 예측합니다. shipmentRatingCalculateWorkflow로 배송 요금을 요청하면, 먼저 캐시된 운송사 데이터를 기반으로 instant rate를 사용할 수 있는지 확인합니다. 사용할 수 있다면 즉시 요금을 받게 되며, 이는 실시간 운송사 요금보다 일반적으로 1초 더 빠릅니다. 사용할 수 없다면 운송사로부터 최신 요금을 요청하고, 이를 AI로 캐시하여 향후 예측을 개선합니다.
이점:
더 빠른 응답 시간: 운송사 API 응답을 기다리지 않고 즉시 요금을 반환합니다(약 1초 더 빠름).
향상된 안정성: 운송사 API 가용성 및 ecommerce 플랫폼 timeout에 대한 의존도를 낮춥니다.
일관된 Checkout 경험: 고객이 신뢰할 수 있는 배송 비용을 빠르고 일관되게 받을 수 있습니다.
요금 정확도
Instant rate는 예측값이므로 실시간 운송사 요금과 가끔 차이가 있을 수 있으며, 보통 몇 센트 수준입니다. 실제로 instant rate의 96%는 실시간 운송사 요금과 10센트 이내로 일치합니다. 차이가 발생하는 일반적인 이유는 다음과 같습니다:
최근 변경된 운송사 discount rate 또는 fuel surcharge
시점에 따라 달라지는 수수료(예: 토요일 pickup fee, 휴일 surcharge 등)
아직 예측을 학습하고 있는 드문 surcharge
시간에 민감한 운송사 가격 조정
Instant rate는 discount, fuel surcharge, 적용 가능한 수수료를 포함하여 실제로 협상된 운송사 요금을 반영합니다. 최신 요금을 요청할 때마다 이를 활용하여 예측 정확도를 지속적으로 개선합니다.
정확도 임계값
정확도 임계값은 지속적인 부정확성으로부터 보호해 주는 안전장치입니다. 임계값은 전체적으로 하나만 설정하지만, 시스템은 운송사별로 이를 모니터링하고 적용합니다. 이는 instant rate와 실시간 운송사 요금 간에 허용되는 최대 평균 편차(rate 차이의 절대값을 백분율로 계산)를 정의하며, 이 값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화됩니다.
동작 방식: 시스템은 각 운송사별로 캐시된 요금과 실시간 요금 간의 평균 편차를 지속적으로 모니터링합니다. 특정 운송사의 평균 편차가 임계값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화되고 실시간 요금으로 대체됩니다. 임계값 이내로 유지되는 다른 운송사는 계속 정상적으로 Instant Rate를 사용합니다. 운송사의 정확도가 임계값 아래로 회복되면 해당 운송사에 대해 Instant Rate가 자동으로 다시 시작됩니다.
예를 들어 정확도 임계값을 5%로 설정했는데 FedEx 요금이 실시간 요금과 평균 6.2%의 편차를 보인다면, FedEx는 Instant Rate에서 자동으로 비활성화되고 UPS와 USPS는(임계값 이내라면) 계속 캐시된 요금을 사용합니다. FedEx의 정확도가 5% 이하로 개선되면 Instant Rate 사용이 자동으로 재개됩니다.
정확도 임계값 설정 방법:
기본값: 5% — 속도와 정확도 간의 균형이 잘 맞습니다.
최소값: 1% — 가장 엄격한 설정으로, 운송사가 더 자주 비활성화되지만 정밀한 가격 정확도를 보장합니다.
범위: 1%~100%
margin이 빠듯하다면 임계값을 낮추는 것을 고려하세요. Checkout 속도가 최우선이며 약간의 요금 차이를 감수할 수 있다면 임계값을 높이는 것을 고려하세요.
Instant Rate를 사용할 수 없는 경우: Instant Rate를 사용하려면 유사한 배송에 대한 충분한 과거 데이터가 필요합니다. 특정 배송 시나리오에 대한 최근 데이터가 충분하지 않으면 대신 실시간 운송사 요금을 자동으로 요청합니다. 이는 거래량이 적은 계정이나 특이한 배송 구성에서 더 흔하게 발생합니다.
UPS 계정 관련 중요 참고 사항: Instant Rate를 사용하려면 UPS REST 연동이 필요합니다. 기존 UPS SOAP 연동을 사용 중이라면 Instant Rate를 활성화하기 전에 UPS REST로 업그레이드해야 합니다. 또한 UPS 계정이 Zonos와의 연결이 끊긴 상태에서 요금이 변경되면, Dashboard에서 계정을 다시 연결하기 전까지 Instant Rate는 이전 가격을 기준으로 캐시된 요금을 계속 반환합니다.
Shopify 판매자를 위한 안내: Instant Rate는 운송사 요금 호출이 timeout될 때 Shopify의 과도한 backup rate가 표시되는 것을 방지하여 고객이 더 정확한 가격을 볼 수 있도록 합니다.
아닙니다. Instant rate는 실제로 협상된 운송사 요금을 기준으로 합니다. AI가 계속 학습하는 과정에서 실시간 quote와 몇 센트 정도 차이가 발생할 수 있습니다. 운송사의 평균 편차가 정확도 임계값을 초과하면 해당 운송사는 자동으로 비활성화되고 실시간 요금으로 대체됩니다.
운송사 요금이 변경되면 어떻게 되나요?
운송사로부터 최신 요금을 자동으로 요청하여 instant rate 모델을 업데이트합니다. 모델이 업데이트되기 전 짧은 기간 동안에는 정확도 임계값 설정이 안전장치 역할을 합니다 — 운송사의 캐시된 요금이 실시간 요금과 너무 크게 벌어지면 해당 운송사는 정확도가 회복될 때까지 자동으로 비활성화됩니다.
맞춤 배송 규칙도 계속 적용되나요?
예. Shipper buffer와 같은 맞춤 규칙은 Instant Rate에서도 정상적으로 작동합니다.
정확도 임계값이란 무엇이며 어떻게 설정해야 하나요?
정확도 임계값은 운송사가 Instant Rate에서 자동으로 비활성화되기 전까지 허용되는 최대 평균 편차를 설정합니다. 임계값은 하나만 설정하지만 시스템은 운송사별로 이를 모니터링하고 적용합니다. 기본값은 5%이며 범위는 1%~100%입니다. 값이 낮을수록 정확도 기준은 엄격해지지만 운송사가 더 자주 비활성화될 수 있습니다.
운송사가 자동으로 비활성화되면 어떻게 되나요?
운송사의 평균 편차가 정확도 임계값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화되고 대신 실시간 요금을 사용합니다. 임계값 이내인 다른 운송사는 계속 정상적으로 Instant Rate를 사용합니다. 해당 운송사의 정확도가 임계값 아래로 회복되면 Instant Rate가 자동으로 다시 시작됩니다.
요금이 instant인지 live인지 어떻게 알 수 있나요?
Dashboard에서는 instant rate에 service level 이름 옆에 lightning bolt 아이콘이 표시됩니다. API에서는 shipmentRatingCalculateWorkflow 응답의 source 필드가 instant rate의 경우 CACHE, 실시간 운송사 요금의 경우 LIVE를 반환합니다.
GraphQL API ReferenceTypes, inputs, and operations used in this guide
배송 요금 산정
배송 요금
Zonos Rate로 실시간 배송 요금을 받아보세요.Zonos Rate를 사용하면 운송사 계정이 승인된 모든 목적지를 대상으로 오가는 배송 요금을 확인할 수 있습니다. 이 정보는 운송사와의 API 연동 또는 제공된 rate sheet를 통해 가져옵니다. 계산된 배송 응답에 반환되는 배송 옵션은 Dashboard에서 shipping profile에 할당한
serviceLevels와 연결됩니다. 응답에서 특정serviceLevel을 기대했지만 보이지 않는다면, 해당serviceLevel이 그 목적지에 대해 활성화되어 있는지 확인하세요.요금 확인
특정 목적지의 배송 요금을 확인하려면 아래 안내에 따라 API 또는 Dashboard에서 진행할 수 있습니다.
Instant Rate
Instant Rate는 배송 이력을 활용하여 배송 비용을 즉시 예측합니다.
shipmentRatingCalculateWorkflow로 배송 요금을 요청하면, 먼저 캐시된 운송사 데이터를 기반으로 instant rate를 사용할 수 있는지 확인합니다. 사용할 수 있다면 즉시 요금을 받게 되며, 이는 실시간 운송사 요금보다 일반적으로 1초 더 빠릅니다. 사용할 수 없다면 운송사로부터 최신 요금을 요청하고, 이를 AI로 캐시하여 향후 예측을 개선합니다.이점:
요금 정확도
Instant rate는 예측값이므로 실시간 운송사 요금과 가끔 차이가 있을 수 있으며, 보통 몇 센트 수준입니다. 실제로 instant rate의 96%는 실시간 운송사 요금과 10센트 이내로 일치합니다. 차이가 발생하는 일반적인 이유는 다음과 같습니다:
Instant rate는 discount, fuel surcharge, 적용 가능한 수수료를 포함하여 실제로 협상된 운송사 요금을 반영합니다. 최신 요금을 요청할 때마다 이를 활용하여 예측 정확도를 지속적으로 개선합니다.
정확도 임계값
정확도 임계값은 지속적인 부정확성으로부터 보호해 주는 안전장치입니다. 임계값은 전체적으로 하나만 설정하지만, 시스템은 운송사별로 이를 모니터링하고 적용합니다. 이는 instant rate와 실시간 운송사 요금 간에 허용되는 최대 평균 편차(rate 차이의 절대값을 백분율로 계산)를 정의하며, 이 값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화됩니다.
동작 방식: 시스템은 각 운송사별로 캐시된 요금과 실시간 요금 간의 평균 편차를 지속적으로 모니터링합니다. 특정 운송사의 평균 편차가 임계값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화되고 실시간 요금으로 대체됩니다. 임계값 이내로 유지되는 다른 운송사는 계속 정상적으로 Instant Rate를 사용합니다. 운송사의 정확도가 임계값 아래로 회복되면 해당 운송사에 대해 Instant Rate가 자동으로 다시 시작됩니다.
예를 들어 정확도 임계값을 5%로 설정했는데 FedEx 요금이 실시간 요금과 평균 6.2%의 편차를 보인다면, FedEx는 Instant Rate에서 자동으로 비활성화되고 UPS와 USPS는(임계값 이내라면) 계속 캐시된 요금을 사용합니다. FedEx의 정확도가 5% 이하로 개선되면 Instant Rate 사용이 자동으로 재개됩니다.
정확도 임계값 설정 방법:
margin이 빠듯하다면 임계값을 낮추는 것을 고려하세요. Checkout 속도가 최우선이며 약간의 요금 차이를 감수할 수 있다면 임계값을 높이는 것을 고려하세요.
Instant Rate를 사용할 수 없는 경우: Instant Rate를 사용하려면 유사한 배송에 대한 충분한 과거 데이터가 필요합니다. 특정 배송 시나리오에 대한 최근 데이터가 충분하지 않으면 대신 실시간 운송사 요금을 자동으로 요청합니다. 이는 거래량이 적은 계정이나 특이한 배송 구성에서 더 흔하게 발생합니다.
UPS 계정 관련 중요 참고 사항: Instant Rate를 사용하려면 UPS REST 연동이 필요합니다. 기존 UPS SOAP 연동을 사용 중이라면 Instant Rate를 활성화하기 전에 UPS REST로 업그레이드해야 합니다. 또한 UPS 계정이 Zonos와의 연결이 끊긴 상태에서 요금이 변경되면, Dashboard에서 계정을 다시 연결하기 전까지 Instant Rate는 이전 가격을 기준으로 캐시된 요금을 계속 반환합니다.
Shopify 판매자를 위한 안내: Instant Rate는 운송사 요금 호출이 timeout될 때 Shopify의 과도한 backup rate가 표시되는 것을 방지하여 고객이 더 정확한 가격을 볼 수 있도록 합니다.
Instant Rate 활성화
지원되는 운송사: APC, DHL, FedEx, UPS, USPS(단일 패키지 배송만 해당). 참고: DHL Express 12pm도 지원되지만 다른 서비스보다 정확도가 낮습니다.
Dashboard에서 Instant Rate를 활성화하려면 아래 단계를 따르세요:
이제 완료되었습니다! 계정에서 Instant Rate가 활성화됩니다. 시스템은 운송사별로 요금 정확도를 모니터링합니다. 운송사의 평균 편차가 임계값을 초과하면 해당 운송사는 정확도가 회복될 때까지 Instant Rate에서 자동으로 비활성화됩니다.
Dashboard 사용자: quote 또는 order에 Instant Rate가 사용된 경우, 운송사 service level 이름 옆에 lightning bolt 아이콘이 표시됩니다.
예시:
API 사용자는 응답에서 요금이
LIVE인지CACHE(Instant Rate)인지를 나타내는SOURCE필드를 확인할 수 있습니다.예시:
mutation GetFullLandedCost($partyCreateWorkflowInput: [PartyCreateWorkflowInput!]!$itemCreateWorkflowInput: [ItemCreateWorkflowInput!]!) {partyCreateWorkflow(input: $partyCreateWorkflowInput) {id}itemCreateWorkflow(input: $itemCreateWorkflowInput) {idcatalogItem {id}amountamountInclusivenamereverseAmountDetail {typefeeAmountdutyRatetaxRateinclusivePriceConfigurationId}currencyCodehsCodehsCodeSourcename}cartonizeWorkflow {id}shipmentRatingCalculateWorkflow {idserviceLevelCodesource}}FAQ
배송 비용이 변경되나요?
아닙니다. Instant rate는 실제로 협상된 운송사 요금을 기준으로 합니다. AI가 계속 학습하는 과정에서 실시간 quote와 몇 센트 정도 차이가 발생할 수 있습니다. 운송사의 평균 편차가 정확도 임계값을 초과하면 해당 운송사는 자동으로 비활성화되고 실시간 요금으로 대체됩니다.
운송사 요금이 변경되면 어떻게 되나요?
운송사로부터 최신 요금을 자동으로 요청하여 instant rate 모델을 업데이트합니다. 모델이 업데이트되기 전 짧은 기간 동안에는 정확도 임계값 설정이 안전장치 역할을 합니다 — 운송사의 캐시된 요금이 실시간 요금과 너무 크게 벌어지면 해당 운송사는 정확도가 회복될 때까지 자동으로 비활성화됩니다.
맞춤 배송 규칙도 계속 적용되나요?
예. Shipper buffer와 같은 맞춤 규칙은 Instant Rate에서도 정상적으로 작동합니다.
정확도 임계값이란 무엇이며 어떻게 설정해야 하나요?
정확도 임계값은 운송사가 Instant Rate에서 자동으로 비활성화되기 전까지 허용되는 최대 평균 편차를 설정합니다. 임계값은 하나만 설정하지만 시스템은 운송사별로 이를 모니터링하고 적용합니다. 기본값은 5%이며 범위는 1%~100%입니다. 값이 낮을수록 정확도 기준은 엄격해지지만 운송사가 더 자주 비활성화될 수 있습니다.
운송사가 자동으로 비활성화되면 어떻게 되나요?
운송사의 평균 편차가 정확도 임계값을 초과하면 해당 운송사는 Instant Rate에서 자동으로 비활성화되고 대신 실시간 요금을 사용합니다. 임계값 이내인 다른 운송사는 계속 정상적으로 Instant Rate를 사용합니다. 해당 운송사의 정확도가 임계값 아래로 회복되면 Instant Rate가 자동으로 다시 시작됩니다.
요금이 instant인지 live인지 어떻게 알 수 있나요?
Dashboard에서는 instant rate에 service level 이름 옆에 lightning bolt 아이콘이 표시됩니다. API에서는
shipmentRatingCalculateWorkflow응답의source필드가 instant rate의 경우CACHE, 실시간 운송사 요금의 경우LIVE를 반환합니다.ItemCreateWorkflowInput PartyCreateWorkflowInput
cartonizeWorkflow cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow
이 페이지가 도움이 되었나요?