Создание отправлений через API
После расчета Landed Cost и создания заказа вы можете отправить номера отслеживания и другие детали отправления в Zonos через API.
Используйте этот рабочий процесс, когда вы создаете отправление для существующего заказа и не нужно изменять детали товара или стороны. Он поддерживает необязательные номера отслеживания, центры выполнения, выбор уровня обслуживания и страхование заявленной стоимости.
Мутация
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
}
}
}
}
Базовые переменные
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789abc"
}
}
С Центром Выполнения Заказов
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789def",
"fulfillmentCenter": "fulfillment_center_12345"
}
}
С пользовательским отслеживанием
{
"input": {
"generateLabel": false,
"orderId": "order_12345678-1234-1234-1234-123456789ghi",
"trackingNumbers": ["tracking_example_1", "tracking_example_2"]
}
}
С уровнем обслуживания
{
"input": {
"generateLabel": true,
"orderId": "order_12345678-1234-1234-1234-123456789jkl",
"serviceLevel": "dhl.express_example"
}
}
С страхованием заявленной стоимости
{
"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: Обрабатывают объявленную стоимость на уровне отправки без дополнительных ограничений.
Аннулирование отправления
Чтобы отменить созданную этикетку, используйте следующую мутацию для аннулирования отправления. Любые связанные этикетки также будут автоматически аннулированы. Обратите внимание, что после аннулирования отправления его нельзя обновить или восстановить.
Мутация
mutation {
shipmentStatusUpdate(
input: {
shipment: "shipment_12345678-1234-1234-1234-123456789stu"
status: VOIDED
note: "Voiding shipment"
}
) {
id
status
}
}
Создать отправление для существующих заказов
Создавайте отправления и ярлыки с помощью Zonos API после расчета landed costs и создания заказов.
GraphQL
Этот гид предназначен для пользователей, которые уже интегрированы с Zonos API и нуждаются в создании отправлений для существующих заказов в своей системе. Если вы платформа для доставки и хотите предложить создание отправлений Zonos своим клиентам, смотрите наш гид по API отправлений.
Если вы интегрированы с Zonos API и получили одобрение на отправку вне Dashboard, используйте мутацию
shipmentCreateWorkflowдля создания отправлений и предоставления информации для отслеживания. Эти мутации также позволяют вам информировать Zonos о внутренних отправлениях на кросс-докинговые объекты.Примечание: Если вы используете приложение Duty and Tax с платформой, которая автоматически синхронизирует номера отслеживания с Zonos, или если вы отправляете напрямую через Dashboard, эти мутации не требуются.