DOCS

Создать отправление

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

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

GraphQL

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

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

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

Создание отправлений через API 

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

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

Мутация

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

Базовые переменные

1
2
3
4
5
6
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789abc"
  }
}

С Центром Выполнения Заказов

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789def",
    "fulfillmentCenter": "fulfillment_center_12345"
  }
}

С пользовательским отслеживанием

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": false,
    "orderId": "order_12345678-1234-1234-1234-123456789ghi",
    "trackingNumbers": ["tracking_example_1", "tracking_example_2"]
  }
}

С уровнем обслуживания

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789jkl",
    "serviceLevel": "dhl.express_example"
  }
}

С страхованием заявленной стоимости

1
2
3
4
5
6
7
{
  "input": {
    "generateLabel": true,
    "orderId": "order_12345678-1234-1234-1234-123456789mno",
    "isDeclaredValue": true
  }
}

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

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

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

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

Аннулирование отправления 

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

Мутация

1
2
3
4
5
6
7
8
9
10
11
12
mutation {
  shipmentStatusUpdate(
    input: {
      shipment: "shipment_12345678-1234-1234-1234-123456789stu"
      status: VOIDED
      note: "Voiding shipment"
    }
  ) {
    id
    status
  }
}

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