Международный WB API: как отделить готовность поставки от печати QR-кода
Как организовать контроль перед закрытием поставки FBS в международном WB API: согласование состава, маркировка, получение QR и защита от старых файлов.
Содержание статьи
В международной документации WB API перевод поставки в доставку закрывает её для добавления заданий. QR становится доступен после этого перехода. Для закрытия нужны непустой состав и успешно проверенная обязательная маркировка. В интеграции это следует оформить отдельной точкой подтверждения готовности, а не побочным действием кнопки печати.
Согласуйте окончательный состав
Перед подтверждением покажите оператору список заданий и физически подготовленные упаковки. Сверяйте идентификаторы и количество, а не только общее число коробок. Если последняя позиция ещё собирается, удобство печати документов не является основанием считать всю отправку готовой.
Определите, кто может подтвердить окончание сборки. Несколько независимых процессов не должны принимать это решение по разным признакам: один — по числу строк в файле, другой — по завершению печати, третий — по времени суток. Проверка совместимости состава проводится раньше; после неё остаётся удостовериться, что подготовлены именно выбранные задания.
Разделите наличие маркировки и её проверку
Непустая строка в локальной базе ещё не подтверждает готовность обязательных данных. В рабочем интерфейсе показывайте результат проверки отдельно от факта ввода. Если остаётся вопрос по конкретному товару, назначьте ответственного и сохраните причину, по которой отправка ждёт решения.
Не подменяйте проверку площадки успешным считыванием сканером. Технический тест устройства решает другую задачу, что подробно разобрано в материале о разделителях кода и тестировании сканера. Для склада полезен единый список незавершённых пунктов, чтобы сотрудник не перебирал несколько экранов и не считал молчание программы положительным результатом.
Свяжите печать с актуальной поставкой
После подтверждённого перехода полученный файл нужно связать с конкретным объектом в локальном реестре. Не храните разные файлы под одним названием «последний QR»: повторная печать на другом рабочем месте может незаметно использовать вчерашнее изображение. В задании принтера должны быть понятны поставка и причина печати.
Проверьте читаемость пробного отпечатка и соответствие выбранной упаковке. Повторная печать того же документа не равна созданию новой отправки. Если сотрудник просит другую копию из-за испорченного листа, интерфейс должен объяснять, какой файл будет напечатан. Это организационная рекомендация, а не изменение форматов, предусмотренных API.
Обработайте прерванное подтверждение
Если связь пропала во время операции, сначала установите состояние объекта. Не запускайте альтернативный процесс сборки на основании одного отсутствующего ответа. Отдельно отметьте, что уже подтверждено, а что требует проверки: состав, результат перехода, получение файла или его печать.
Для проверки реализации воспроизведите прерывание на каждом из этих шагов и убедитесь, что сотрудник видит понятный следующий шаг. Не следует сообщать об отправке только потому, что принтер выдал лист. Материал относится к международному контуру .cn; условия другого подключения проверяют отдельно. Итоговый контроль должен связывать готовый товар, подтверждённое состояние поставки и правильный документ без догадок по внешнему виду файла.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы