FBS Отгрузка: вопросы по API методам
21 июня 2023
28713
7 мин
12
В данной статье ответим на вопросы по API методам, используемым при работе с отгрузкой по схеме FBS. Если у вас будут еще вопросы, на которые вы не нашли ответы в данной статье, приглашаем вас в комментарии к топику. Задавайте ваши вопросы, и мы будем на них отвечать и обновлять данную статью!
Описание методов:
/v2/posting/fbs/act/create - для подтверждения отгрузки
/v2/posting/fbs/act/check-status - отдает статус перевозки
/v2/posting/fbs/digital/act/check-status - отдает статус эл. актов приема-передачи
/v2/posting/fbs/digital/act/get-pdf - отдает электронные акты
/v2/posting/fbs/act/get-barcode - для получения штрихкода для отгрузки
/v2/posting/fbs/act/get-pdf - для получения транспортной накладной (при необходимости)
Процесс по формированию эл. актов:
- Создайте акт приёма-передачи и транспортную накладную: /v2/posting/fbs/act/create. В результате работы метода вы получите идентификатор задания на формирование документов.
- Получите список перевозок, для которых нужно распечатать акт приёма-передачи и транспортную накладную: /v1/posting/carriage-available/list.
- Проверьте, что перевозка/отгрузка создана: /v2/posting/fbs/act/check-status.
- Получите штрихкод для отгрузки v2/posting/fbs/act/get-barcode
- Проверьте статус формирования электронного документа: /v2/posting/fbs/digital/act/check-status. Когда статус документа перейдёт в
FORMED, получите файл накладной и акта: /v2/posting/fbs/act/get-pdf и /v2/posting/fbs/digital/act/get-pdf.
Часто задаваемые вопросы от селлеров, если есть еще новые, оставляйте через комменты:
| Категория | Вопросы | Ответ |
|---|---|---|
| Общее: что изменится | Как переход на новые методы API повлияют на работу по FBS схеме? Что изменится в процессах? | Если вкратце: в рамках проекта по отказу от бумаги у селлеров будут формироваться эл. акты и шк для отгрузки. После 26 июня: Что остается: селлеру также нужно подтверждать отгрузку через метод /v2/posting/fbs/act/create и проверять статус отгрузки через /v2/posting/fbs/act/check-status. Что изменится: для получения акта и штрихкода для отгрузки селлеру нужно перейти на новые методы /v2/posting/fbs/digital/act/get- pdf и /v2/posting/fbs/act/get-barcode. Старый метод /v2/posting/fbs/act/get-pdf будет возвращать только транспортную накладную или ошибку, если в настройках метода склада опция печати ТрН выключена (для drop off). |
| Что будет, если селлер не перейдет на новые методы API | Что будет, если селлер не успевает перейти на новые методы? У него заблокируется продажа по FBS? | Продажи не заблокируются. Для продолжения работы по FBS нужно будет также формировать отгрузку: - вызывать метод /v2/posting/fbs/act/create для подтверждения отгрузки. - проверить статус отгрузки с помощью метода /v2/posting/fbs/act/chec-status - получить ТрН при необходимости через метод /v2/posting/fbs/act/get-pdf. Сам акт можно будет скачать в лк после подтверждения отгрузки, пока селлер не настроит новый метод /v2/posting/fbs/digital/act/get-pdf. |
| Тестирование новых методов | Можно ли тестить эл. акты, а параллельно формировать бумажные? | Нет, такой возможности нет. Если возникают проблемы/ошибки при переходе на новые методы, необходимо писать в поддержку API. |
| ПЭП | Что такое ПЭП? Когда и как будет подписываться? | Простая электронная подпись (ПЭП) – это электронная подпись, которая посредством использования кодов, паролей или иных средств подтверждает факт формирования электронного документа Продавцом или Ozon, совершающим действия в ЛК.Подписывается селлером при нажатии кнопки Подтвердить в ЛК. Сотрудником точки приема - после завершения приемки. Ссылка на оферту: https://seller-edu.ozon.ru/contract-for-sellers/contract-goods/contract-for-sell-goods-on-ozon |
| Транспортные накладные (ТрН) | Прошу подтвердить, что мы сможем забирать и передавать партнеру Транспортные накладные в бумажном виде? | Сейчас по схеме pick up есть проект по отказу от транспортных накладных, при отгрузке достаточно будет пропикивание шк из лк и всех постингов. Водители не будут требовать ТрН. Сроки по проекту: tbd По схеме drop off транспортные накладные - необязательный документ. |
| АПП/ТрН | Будут ли нам приходить электронные акты с электронной подписью вместе с Транспортными накладными? | В конце июня (сроки уточняются) эл. акты и транспортные накладные будут приходить вместе, но сейчас пока нужно будет пользоваться старым методом act/get-pdf для получения ТрН. |
| ШК (штрихкод) | Что такое штрихкод и зачем он нужен? Для нас достаточно сложно осуществить загрузку документов в личный телефон приезжающего водителя, можно ли данные ШК продолжить показывать в распечатанном виде с акта? | На fbs перешли на отгрузку по шк для упрощения и ускорения процессов отгрузки. ШК формируется сразу же после подтверждения отгрузки. Его можно скачать/отправить курьеру и показать на приемке ПВЗ/СЦ. Штрихкод совпадает с шк, который есть в электронном акте. Водитель может сделать фото шк, но если и это не вариант, то можно будет приезжать с бумажным шк, но только для сканирования на отгрузке (на СЦ перестанут подписывать данные документы) |
| Другие | Вопросы | Ответы |
|---|---|---|
| Сотрудник склада должен понять, что с электронным Актом все хорошо, и можно везти заказы в пункт приемки. Как он может это понять, не заходя в Личный кабинет Озон? В каком статусе должен быть Акт, чтобы его можно было скачать и везти на приемку (Сформирован или Подписан Озон)? | Когда сотрудник подтверждает отгрузку в лк (обязательное действие), то формируется шк, нужно его скачать и показать на приемке (этого достаточно для отгрузки). | |
| Сотрудник склада должен понять, что с электронным Актом все хорошо, и можно везти заказы в пункт приемки. Как он может это понять, не заходя в Личный кабинет Озон? В каком статусе должен быть Акт, чтобы его можно было скачать и везти на приемку (Сформирован или Подписан Озон)? | /v2/posting/fbs/act/get-barcode | |
| Будет ли действовать метод /v2/posting/fbs/act/check-status? Если будет, будет ли действовать для обоих документов? В чем разница работы с методом /v2/posting/fbs/digital/act/check-status? Каким методом в итоге нужно будет проверять статус Акта и ТН? | Будет. /v2/posting/fbs/digital/act/check-status - отдает статус эл. акта /v2/posting/fbs/act/check-status - отдает статус перевозки | |
| Метод /v2/posting/fbs/act/create после 15 июня будет инициировать формирование Накладной и Акта, и дополнительно Акт будет автоматически подписываться электронно-цифровой подписью с нашей стороны? | После 26 июня метод получения файла /v2/posting/fbs/act/get-pdf будет возвращать только Накладную в формате PDF, без Акта приема-передачи. |