Ищите пропавший заказ по его ID, а не по итоговому числу строк. Сначала запросите официальный API маркетплейса с тем же магазином, схемой работы, статусом и временным окном. Если ID есть в ответе, источник исправен; дальше проверяются pagination cursor, staging и ответ Google Sheets или Excel API.
Прямая схема «получили страницу — сразу добавили строки — сдвинули дату» теряет данные при частичном сбое. Сначала сохраните нормализованные заказы во внутренней таблице с уникальным ключом marketplace + seller + order ID. Экспорт в spreadsheet становится отдельной повторяемой задачей.
След заказа заканчивается на первом отсутствующем слое
| Где ищем order ID | Если его нет | Следующая проверка |
|---|---|---|
| Ответ Marketplace API | Неверный token scope, статус, кабинет или окно | Сверить метод и параметры с актуальной документацией |
| Все страницы текущего запуска | Потеряна пагинация | cursor, has_next, limit и условие завершения |
| Staging/outbox | Ошибка нормализации или commit | Журнал exception и уникальный ключ |
| Ответ Sheets/Excel API | Запись не подтверждена | HTTP-код, updatedRange или workbook response |
| Видимая таблица | Пишется другой лист или range | Spreadsheet ID, sheet/table name и фильтры интерфейса |
Маркетплейсы могут разделять методы по моделям выполнения заказов, кабинетам и категориям токенов. Откройте документацию именно своей схемы и сохраните версию контракта рядом с интеграцией. Один успешный ping подтверждает доступность адреса и токен, но не доказывает, что выбран правильный метод получения заказов.
Окно времени перекрывает границу checkpoint
Храните checkpoint по полю обновления, которое обещает конкретный API, и запрашивайте небольшой overlap с предыдущим окном. Повторные объекты поглотит upsert по order ID, зато заказ с задержавшимся обновлением не окажется между двумя запусками. Продвигайте checkpoint по максимальному подтверждённому значению, а не по текущим часам сервера.
Staging делает повтор безопасным
for page in marketplace.listOrders(updatedAfter = checkpoint - overlap):
for order in page.items:
upsert staging by (marketplace, seller, orderId)
for order in staging where exportedAt is null:
write spreadsheet row using exportKey
mark exportedAt only after sink acknowledgement
advance checkpoint after all pages are committedexportKey сохраните отдельной колонкой, даже если её скрывают от менеджеров. Google Sheets append добавляет значения после найденной таблицы, но сам по себе не обеспечивает дедупликацию бизнес-заказов. Для Excel через Microsoft Graph также записывайте несколько строк одним запросом и проверяйте ответ сессии.
Запись в таблицу защищаем от повторов и формул
- Не используйте номер строки как идентификатор: сортировка и ручная вставка его меняют.
- Передавайте текст как значения и не позволяйте внешним строкам становиться формулами.
- Храните технические ID отдельно от отображаемого номера заказа.
- Группируйте записи небольшими batch и повторяйте только неподтверждённый batch.
- Ограничьте права сервисного аккаунта конкретным документом и не пишите токен в лог.
Backfill заполняет дыру без нового документа
- Зафиксировать период и seller ID с пропусками.
- Скачать все страницы API в staging без записи в рабочий лист.
- Сравнить уникальные order ID со значениями exportKey.
- Экспортировать только отсутствующие строки и подтвердить диапазон ответа.
- Запустить обычную синхронизацию с прежним checkpoint и проверить отсутствие дублей.
Для расследования нужны площадка и схема выполнения, временное окно с timezone, отсутствующий order ID, параметры пагинации, состояние checkpoint, обезличенная staging-запись и ответ табличного API. По этому набору видно, требуется backfill источника, починка cursor или повтор неподтверждённого экспорта.