Ищите пропавший заказ по его 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
Видимая таблицаПишется другой лист или rangeSpreadsheet 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 committed

exportKey сохраните отдельной колонкой, даже если её скрывают от менеджеров. Google Sheets append добавляет значения после найденной таблицы, но сам по себе не обеспечивает дедупликацию бизнес-заказов. Для Excel через Microsoft Graph также записывайте несколько строк одним запросом и проверяйте ответ сессии.

Запись в таблицу защищаем от повторов и формул

  • Не используйте номер строки как идентификатор: сортировка и ручная вставка его меняют.
  • Передавайте текст как значения и не позволяйте внешним строкам становиться формулами.
  • Храните технические ID отдельно от отображаемого номера заказа.
  • Группируйте записи небольшими batch и повторяйте только неподтверждённый batch.
  • Ограничьте права сервисного аккаунта конкретным документом и не пишите токен в лог.

Backfill заполняет дыру без нового документа

  1. Зафиксировать период и seller ID с пропусками.
  2. Скачать все страницы API в staging без записи в рабочий лист.
  3. Сравнить уникальные order ID со значениями exportKey.
  4. Экспортировать только отсутствующие строки и подтвердить диапазон ответа.
  5. Запустить обычную синхронизацию с прежним checkpoint и проверить отсутствие дублей.

Для расследования нужны площадка и схема выполнения, временное окно с timezone, отсутствующий order ID, параметры пагинации, состояние checkpoint, обезличенная staging-запись и ответ табличного API. По этому набору видно, требуется backfill источника, починка cursor или повтор неподтверждённого экспорта.

Проверенные источники