DOCS
Landed Cost•
ГлавнаяДля логистических компаний Landed Cost Создать отправку

Создать отправку для существующих заказов

Создавайте отправки и метки с помощью API Zonos после расчета стоимости доставки и создания заказов.

GraphQL

Это руководство предназначено для пользователей, которые уже интегрированы с API Zonos и нуждаются в создании отправок для существующих заказов в их системе. Если вы платформа доставки и хотите предложить своим клиентам создание отправок Zonos, см. руководство Shipment API.

Если вы интегрированы с API Zonos и одобрены для отправки вне Dashboard, используйте мутацию shipmentCreateWorkflow для создания отправок и предоставления информации об отслеживании. Эти мутации также позволяют вам информировать Zonos о внутренних отправках в кроссдокинг-центры.

Примечание: Если вы используете приложение Duty and Tax с платформой, которая автоматически синхронизирует номера отслеживания с Zonos, или если вы отправляете прямо через Dashboard, эти мутации не требуются.

Создать отправки через API 

После расчета Landed Cost и создания заказа вы можете отправить номера отслеживания и другие детали отправки в Zonos через API.

Используйте этот рабочий процесс при создании отправки для существующего заказа, если вам не нужно изменять детали товара или стороны. Он поддерживает необязательные номера отслеживания, центры выполнения заказов, выбор уровня обслуживания и страховку объявленной стоимости.

1mutation CreateShipment($input: ShipmentCreateWorkflowInput!) {
2 shipmentCreateWorkflow(input: $input) {
3 id
4 status
5 trackingDetails {
6 number
7 }
8 serviceLevel {
9 id
10 name
11 carrier {
12 id
13 name
14 }
15 }
16 shipmentCartons {
17 id
18 carton {
19 id
20 width
21 length
22 height
23 weight
24 items {
25 item {
26 id
27 amount
28 description
29 }
30 }
31 }
32 label {
33 url
34 trackingNumber
35 id
36 documentFiling
37 }
38 }
39 }
40}

Параметры переменных:

  • С центром выполнения: Добавьте "fulfillmentCenter": "fulfillment_center_12345", чтобы указать исходное местоположение
  • С пользовательским отслеживанием: Установите "generateLabel": false и добавьте "trackingNumbers": ["tracking_1", "tracking_2"]
  • С уровнем обслуживания: Добавьте "serviceLevel": "dhl.express_example", чтобы выбрать определенный сервис перевозчика
  • Со страховкой объявленной стоимости: Добавьте "isDeclaredValue": true, чтобы включить покрытие объявленной стоимости

Объявленная стоимость

Установите "isDeclaredValue": true, чтобы включить покрытие объявленной стоимости для всех товаров в вашей отправке. Zonos автоматически претендует на полную стоимость всех товаров, отправленных в заказе; продавцы не могут изменить эту сумму. Это устанавливает максимальную ответственность, которую перевозчик примет в случае потери, повреждения или кражи во время доставки. Эта функция поддерживается только для отправок UPS, FedEx и DHL. Zonos автоматически обрабатывает специфическую для перевозчика реализацию при включении объявленной стоимости, включая соответствующие параметры в наши вызовы API этим перевозчикам, поэтому вам не нужно управлять различными требованиями перевозчика.

Ограничения UPS: UPS охватывает только стоимость от 100,01 до 50 000 USD и обрабатывает объявленную стоимость на уровне коробки. Для многоящичных отправок продавцы должны разделить отправку, чтобы указать покрытие на коробку. UPS также создает дополнительную форму страховки (UPS Control Log), которую необходимо распечатать с метками для объявленных стоимостей свыше 999 USD.

FedEx и DHL: Обрабатывают объявленную стоимость на уровне отправки без дополнительных ограничений.

Специальные услуги

Используйте specialServices на коробке, чтобы указать требования к специальной обработке аккумуляторов, сухого льда, опасных грузов или требования подписи. Полную информацию и примеры см. в руководстве по специальным услугам.

Отменить отправку 

Чтобы отменить созданную метку, используйте следующую мутацию для отмены отправки. Все связанные метки также будут отменены автоматически. Обратите внимание, что после отмены отправки она не может быть обновлена или восстановлена.

1mutation {
2 shipmentStatusUpdate(
3 input: {
4 shipment: "shipment_12345678-1234-1234-1234-123456789stu"
5 status: VOIDED
6 note: "Voiding shipment"
7 }
8 ) {
9 id
10 status
11 }
12}
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CartonCreateWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput ShipmentCreateWorkflowInput

MUTATIONS

cartonsCreateWorkflow itemCreateWorkflow partyCreateWorkflow shipmentCreateWorkflow shipmentStatusUpdate

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

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