Включите печать этикеток
Выполните следующие шаги, чтобы позволить вашим клиентам получать этикетки Zonos с вашей платформы.
Разрешить учетные данные API
Zonos API доступен через credentialToken. Ваша платформа должна дать клиентам возможность ввести свой credentialToken из Zonos Dashboard на вашу платформу. Отсюда вы сможете делать запросы к Zonos от их имени.
Создайте отправление
Чтобы получить label, вы должны создать shipment, с которым будет связан label. Zonos управляет этим процессом с помощью рабочего процесса, который создает shipments и labels в одном запросе. При выполнении этого мутирования вам не нужно передавать serviceLevel, так как мы будем использовать serviceLevel, используемый из landedCost, который привязан к order. Для orderId вы можете использовать ID заказа Zonos или accountOrderNumber, который, вероятно, уже находится в вашей системе.
Когда отправление и этикетки успешно созданы, мы вернем этикетки как labelImage, которая является BASE64_ENCODED_IMAGE, или как url, откуда можно получить этикету.
Используйте этот рабочий процесс при создании отправления для существующего заказа и когда вам не нужно изменять детали товаров или сторон. Он поддерживает дополнительные номера отслеживания, центры выполнения, выбор уровня обслуживания и страховку объявленной стоимости.
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 до 50 000 USD и обрабатывает объявленную стоимость на уровне коробки. Для многокоробковых отправлений продавцы должны разделить отправление, чтобы указать покрытие для каждой коробки. UPS также генерирует дополнительную форму страховки, которая должна быть напечатана вместе с этикетками.
FedEx и DHL: Обработка объявленной стоимости на уровне отправления без дополнительных ограничений.
Специальные услуги
Используйте specialServices на коробке для указания требований специальной обработки для батарей, сухого льда, опасных грузов или требований подписания. Смотрите руководство по специальным услугам для полных деталей и примеров.
Разблокировка ShipStation UPS: Многокусковые отправления не поддерживаются. Когда заказ отправляется в несколько коробок, поле reference дублируется, что вызывает сбой сопоставления номера заказа на бэкенде. Продавцам, нуждающимся в многокусковых отправлениях, следует создавать этикетку в Zonos Dashboard. На однокусковые отправления это не влияет.
Отмените отправление
В случае, если клиент хочет отменить shipment, вы можете использовать следующее мутирование, которое отменит все labels, привязанные к shipment.
mutation { shipmentStatusUpdate( input: { shipment: "shipment_f1fe4dbd-e471-49fa-94e7-84e369083223" status: VOIDED note: "Voiding shipment" } ) { id status }}
Создавайте отправления с вашей платформы
Предоставьте клиентам возможность создавать отправления и этикетки Zonos с вашей платформы.
Это руководство предназначено для разработчиков платформ доставки, которые хотят интегрировать возможности создания отправлений Zonos в свою платформу для своих клиентов. Если вы уже используете Zonos API и вам просто нужно создавать отправления для существующих заказов, см. наше руководство по созданию отправлений.
Если вы платформа доставки, которая поддерживает клиентов Zonos, отправляющих товары международно, интеграция с Zonos для создания отправлений должна быть главным приоритетом. Это позволит вам предложить наиболее беспрепятственный опыт для ваших продавцов и их клиентов, используя существующие функции вашей платформы, позволяя Zonos управлять созданием отправления, этикетки и вспомогательной таможенной документацией.
Преимущества использования Zonos для создания отправлений:
Это руководство проведет вас через этапы реализации полной сквозной интеграции, которая позволит вам вызывать Zonos для отправлений с вашей платформы.