DOCS
Landed Cost•
ГлавнаяДля логистических компаний Landed Cost Расчет Landed Cost - GraphQL

Рассчитайте Landed Cost

Рассчитайте пошлины, налоги и сборы с помощью GraphQL.

GraphQL

Zonos рассчитывает общий Landed Cost для международных отправлений — включая пошлины, налоги и любые дополнительные сборы, взимаемые таможней, брокерами или перевозчиками. В большинстве случаев мы гарантируем эти расчеты: мы сами оплачиваем итоговый счет и берем с вас ровно ту сумму, которую рассчитали. В некоторых случаях вы можете использовать наш Landed Cost без гарантии — это означает, что вы принимаете на себя ответственность за любую разницу между нашим расчетом и фактическими сборами.

Подготовьте запрос 

Для расчета Landed Cost через API требуется несколько входных данных, которые мы объединили в рабочие процессы. После их заполнения вы сможете отправить один запрос и получить Landed Cost на основе пункта назначения доставки, товаров в корзине и деталей доставки.

У каждого рабочего процесса есть свои обязательные входные данные. GraphQL позволяет передавать больше данных, чем необходимо, но для получения Landed Cost требуются только определенные поля. Они четко отмечены в нашем справочнике API, где можно увидеть все возможные поля.

Обратите внимание, что некоторые поля условно требуются, если вы хотите, чтобы ваш расчет был гарантирован.

Ниже мы перечислили все поля, необходимые для расчета гарантированного Landed Cost. Убедитесь, что эта информация включена в запрос перед его отправкой.

Запросите Landed Cost через API 

После того как у вас есть необходимые входные данные, отправьте мутацию GraphQL на конечную точку API, используя выбранную клиентскую библиотеку или инструмент. Вот несколько примеров того, как вы можете структурировать мутацию.

Используйте этот запрос, когда вы позволяете Zonos рассчитать стоимость доставки как часть запроса Landed Cost. Затем мы рассчитаем пошлины и налоги на доставку, если они оцениваются пунктом назначения.

1mutation CalculateLandedCost(
2$parties: [PartyCreateWorkflowInput!]!
3$items: [ItemCreateWorkflowInput!]!
4$landedCostConfig: LandedCostWorkFlowInput!
5) {
6 partyCreateWorkflow(input: $parties) {
7 type
8 id
9 organization
10 }
11 itemCreateWorkflow(input: $items) {
12 id
13 amount
14 productId
15 }
16 cartonizeWorkflow {
17 id
18 type
19 items {
20 item {
21 id
22 }
23 }
24 }
25 shipmentRatingCalculateWorkflow {
26 id
27 amount
28 }
29 landedCostCalculateWorkflow(input: $landedCostConfig) {
30 id
31 duties {
32 amount
33 currency
34 note
35 }
36 taxes {
37 amount
38 currency
39 note
40 }
41 fees {
42 amount
43 currency
44 note
45 }
46 }
47}

Следующий шаг: Создайте заказ

После расчета Landed Cost и получения landedCostId из ответа API вам нужно создать заказ, чтобы завершить транзакцию в системе Zonos. Используйте мутацию orderCreate и передайте landedCostId из вашего предложения. Узнайте больше о создании заказов.

Запросите Landed Cost в Dashboard 

Вы также можете рассчитать Landed Cost прямо в Zonos Dashboard, не используя API. Это удобно для проверки расчетов, обучения команды или получения быстрых предложений по запросам клиентов.

Dashboard использует те же конечные точки API, что описаны выше, поэтому результаты совпадают с тем, что вы получили бы при прямых вызовах API. Это отличный способ проверить свою интеграцию с API или изучить, как разные входные данные влияют на расчеты.

Использование калькулятора Dashboard

С помощью калькулятора Landed Cost в Dashboard вы можете получить предложения с рассчитанными тарифами доставки, создавать предложения с известными стоимостями доставки или обрабатывать несколько предложений оптом.

Используйте этот процесс, когда вы знаете уровень сервиса доставки и стоимость вашей доставки.

  1. Перейдите к Dashboard → Orders → Quotes
  2. Нажмите New quote
  3. Дополнительно — Измените местоположение вашего адреса отправки
  4. Выберите Destination country из раскрывающегося списка
  5. Введите сумму доставки
    • Уровень сервиса необязателен; его добавление позволяет нам рассчитать применимые комиссии перевозчика
  6. Добавьте детали товара для доставки
    • Когда вы вводите описание, мы автоматически классифицируем продукт и создаем код HS
    • Вы можете перезаписать созданный код HS, если необходимо
    • Для нескольких товаров нажмите Save and add another. В противном случае нажмите Save
  7. Дополнительно — Нажмите More options для изменения:
    • Типа продажи на For resale
    • Режима доставки на Delivery duties unpaid
  8. Нажмите Get quote
    • Для внесения изменений нажмите Edit form и измените любые детали
    • Нажмите Get quote снова для обновления

На правой стороне появится предложение Landed Cost, включающее товары, доставку и стоимость импорта. Разверните предложение, чтобы увидеть подробные разбивки товаров, доставки, пошлин, налогов и сборов. Все предложения сохраняются на странице предложений для дальнейшего использования.

Редактирование существующих предложений: Нажмите Quote again в правом верхнем углу, чтобы изменить существующее предложение вместо начала с нуля.

Преимущества использования Dashboard

  • Кодирование не требуется — Создавайте предложения через удобный интерфейс
  • Обучение команды — Помогите нетехническим членам команды понять компоненты Landed Cost
  • Проверка API — Проверьте, что ваша интеграция API дает ожидаемые результаты
  • Поддержка клиентов — Быстро создавайте предложения для запросов клиентов
  • Массовая обработка — Эффективная обработка нескольких расчетов (скоро)

Предложения Dashboard включают те же подробные разбивки, доступные через API, что делает его отличным дополнением к вашей автоматизированной интеграции.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

ItemCreateWorkflowInput LandedCostWorkFlowInput PartyCreateWorkflowInput ShipmentRatingCreateWorkflowInput

MUTATIONS

cartonizeWorkflow itemCreateWorkflow landedCostCalculateWorkflow partyCreateWorkflow shipmentRatingCalculateWorkflow shipmentRatingCreateWorkflow

Была ли эта страница полезной?

Получить поддержку·Юридические документы·© 2026 Zonos
На этой странице:
  • Рассчитайте Landed Cost
  • Запросите Landed Cost через API
  • Запросите Landed Cost в Dashboard