Создать отправки через 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 } } }}Параметры переменных:
- С центром выполнения: Добавьте
"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 на коробке, чтобы указать требования к специальной обработке аккумуляторов, сухого льда, опасных грузов или требования подписи. Полную информацию и примеры см. в руководстве по специальным услугам.
Отменить отправку
Чтобы отменить созданную метку, используйте следующую мутацию для отмены отправки. Все связанные метки также будут отменены автоматически. Обратите внимание, что после отмены отправки она не может быть обновлена или восстановлена.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_12345678-1234-1234-1234-123456789stu" status: VOIDED note: "Voiding shipment" } ) { id status }}
Создать отправку для существующих заказов
Создавайте отправки и метки с помощью API Zonos после расчета стоимости доставки и создания заказов.
GraphQL
Это руководство предназначено для пользователей, которые уже интегрированы с API Zonos и нуждаются в создании отправок для существующих заказов в их системе. Если вы платформа доставки и хотите предложить своим клиентам создание отправок Zonos, см. руководство Shipment API.
Если вы интегрированы с API Zonos и одобрены для отправки вне Dashboard, используйте мутацию
shipmentCreateWorkflowдля создания отправок и предоставления информации об отслеживании. Эти мутации также позволяют вам информировать Zonos о внутренних отправках в кроссдокинг-центры.Примечание: Если вы используете приложение Duty and Tax с платформой, которая автоматически синхронизирует номера отслеживания с Zonos, или если вы отправляете прямо через Dashboard, эти мутации не требуются.