При пакетной покупке ярлыков EasyPost проверяйте состояние каждого Shipment. Общая задача выполняется асинхронно, а отдельные отправления могут завершиться ошибкой.

Для массовой покупки документация требует передать данные всех отправлений одновременно с созданием Batch. У каждого должны быть from_address, to_address, parcel, service, carrier и carrier_accounts с единственным подходящим ID аккаунта. Возможность позднее добавить отправление в пакет не отменяет этих условий покупки.

Соберите пакет под понятную операцию склада

Материал предназначен для зарубежного склада с действующим доступом к EasyPost. Условия перевозчика и страны проверяют до запуска. Документация проверена 19 октября 2026 года; изложенный процесс не объявляется новым сервисом.

Batch объединяет операции над несколькими Shipment: покупку, консолидацию ярлыков и другие действия. Он не заменяет заказ покупателя. Редакционная рекомендация — сохранять связь каждого Shipment с исходным заказом магазина и физической коробкой. Иначе после массовой печати сотрудник увидит аккуратный файл, но не поймёт, какому заданию принадлежит отдельная страница.

Разберите общий статус и результаты строк

У Batch есть состояние всей операции и список отправлений с batch_status и batch_message. Документация различает успешную покупку, ошибку покупки, ожидание и ошибку создания. Общая асинхронная операция требует наблюдения до результата; получение её идентификатора ещё не означает готовность всех ярлыков.

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

Печатайте после подтверждения всего состава

Объединение ярлыков в один файл допускается, когда все Shipment имеют postage_purchased. По документации консолидацию выполняют один раз для Batch; доступны PDF, ZPL и EPL2. Перед генерацией согласуйте формат с принтером и складской программой, а не выбирайте его по привычке другого склада.

Редакционная рекомендация — проверить контрольную страницу на реальном оборудовании. Сканер должен находить нужное отправление, поля не должны обрезаться, а размер бумаги должен соответствовать выбранному формату. Переход к автоматической покупке этикеток в Shopify не отменяет эту физическую проверку печати.

Учитывайте изменения после формирования файла

Удаление Shipment из Batch не удаляет его из уже объединённого файла ярлыков или ScanForm. Поэтому старый PDF нельзя считать автоматически исправленным после изменения состава в API. Пометьте устаревшую распечатку и организуйте актуальный комплект по процедуре склада.

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

Закрывайте партию после сверки трёх вещей: каждое отправление имеет понятный результат, файл относится к согласованному составу, каждая страница закреплена за правильной коробкой. Тогда массовая операция экономит время без потери индивидуальной прослеживаемости заказа и без необходимости разбирать неопознанные расходы после выезда машины.