Перейти к содержанию

Импорт продаж Checkbox

Служба забирает фискальные чеки из Checkbox и делает из них документы учёта. Пока она не отработала, продажи есть в фискальном сервисе, но их нет в системе: ни выручки, ни списанного товара.

Где искать: Модули → Чекбокс → Обслуживание → Импорт продаж Checkbox

Разбор на примере

Импорт чеков Checkbox

Окно короткое: период, «Выполнить» — разовый запуск за указанный период, «По расписанию» — постановка на автоматический запуск.

Надпись вверху — «Импорт по расписанию будет за последние 2 дня» — так и работает: запуск по расписанию каждый раз берёт чеки за позавчера, вчера и сегодня, а период из окна не учитывает. Период — для ручного запуска, когда нужно подтянуть что-то старее.

Что происходит во время импорта

Для каждого чека, который ещё не загружен, система создаёт две записи:

  • фискальный чек — с фискальными реквизитами и итогом чека; в строках — товар, количество, цена и сумма без учёта скидки (скидка — в счёте);
  • счёт — документ учёта. Если все товары чека есть в справочнике товаров, счёт создаётся проведённым: товар списывается со склада и проводки появляются сразу — так же, как у службы «Импорт чеков Вчасно.Каса». Товара нет в справочнике, проведение отказало или его держит правило утверждения — счёт остаётся черновиком, а итог службы называет его номер и причину. Чек возврата импорт оформляет счётом с минусом — количества, суммы и оплата отрицательные, так же как импорт чеков Вчасно.Кассы, — и проводит по тому же правилу, что и продажу: товар возвращается на склад, выручка уменьшается. Черновиком остаются только два случая, которые нужно разобрать вручную: чек, где признак возврата хотя бы у одного товара не совпадает с типом чека, и возврат со скидкой; итог службы называет номер такого черновика и причину.

Кассу система узнаёт по фискальному номеру из учётной записи Checkbox, оттуда же берёт способ оплаты POS — именно он говорит, на какие счета ложится наличность и безнал. По номеру кассу ищут только в первый раз: найденное записывается в колонку «ID кассы» строки, и дальше импорт берёт кассу именно по нему, а номер не читает.

Берутся два типа чеков: продажа и возврат — только со статусом DONE и только те, где первый платёж — наличные или безнал (карта). Остальные чеки служба пропускает молча: строки о них в итоге нет.

Границы периода ручного запуска

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

Повторный запуск ничего не испортит

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

Типичные ситуации

Чеки не появились. Сначала прочитайте итог службы: он говорит, сколько чеков импортировано, и называет пропущенные кассы и учётные записи — «не вошёл ни один кассир», «нет открытого кассира с логином и паролем — чеки не импортированы», «нет открытой кассы с фискальным номером — чеки не импортированы», «способ оплаты … не найден — касса пропущена», «пользователь … точки продажи не найден — касса пропущена» (в поле «Точка продажи» способа оплаты POS кассы стоит пользователь, которого уже нет), «в Checkbox нет кассы с таким фискальным номером — касса пропущена» (у новой кассы «ID кассы» ещё пуст, а номер — с опечаткой или кассы из другой учётной записи Checkbox: исправьте номер или отметьте строку кассы «Закрыто»). Если открытой учётной записи Checkbox нет совсем, итог так и говорит: «Нет открытой учётной записи Checkbox — чеки не импортированы». Если таких строк нет, а чеков меньше, чем в Checkbox: касса в учётной записи отмечена «Закрыто» или без фискального номера; чек не имеет статуса DONE или оплачен не наличными и не картой; это ночной чек первого дня ручного периода (см. выше).

Служба остановилась с ошибкой, и не загрузилось ничего. Весь запуск — одна операция: непредвиденная ошибка отменяет чеки всех учётных записей и касс этого запуска, а запуск по расписанию будет падать каждый раз, пока причину не устранят. Чаще всего причина — Checkbox не отвечает: запрос, на который сервис молчит 60 секунд (или который длится дольше 5 минут), обрывается, и запуск тоже отменяется; повторите позже.

Сменили фискальный номер кассы, а чеки идут со старой. «ID кассы» после смены номера не сбрасывается, и стереть его в строке нельзя: импорт и дальше тянет чеки старой кассы, а оплаты разносит по способу оплаты этой строки. Новую кассу добавляйте отдельной строкой, а старую строку отмечайте «Закрыто».

«Счёт 501 оставлен черновиком: товаров чека нет в справочнике товаров: 4820001234567» — в итоге службы. Продажа загружена, но код товара из Checkbox не нашёлся среди товаров: заведите товар (или поправьте код в кассе), исправьте строку счёта и проведите его. Вместо кодов может стоять текст отказа проведения: устраните причину и проведите счёт. Причина «проведение держит правило утверждения» значит, что счёт подпадает под правило утверждения: запрос на утверждение отправлен или отклонён.

«Чек … не импортирован: …» — в итоге службы. Счёт и фискальный чек создаются вместе, и по этому чеку не сохранился даже черновик счёта — например, у пользователя из поля «Точка продажи» способа оплаты POS не заполнен «Клиент по умолчанию» (без него у счёта нет клиента) или там стоит клиент, которого уже нет среди контактов («Клиент '…' не найден»); точную причину называет текст после двоеточия. Пропущен только этот чек, остальные чеки запуска загружены. Исправьте карточку или справочник и запустите службу снова: пропущенный чек подтянется, а загруженные раньше второй раз не создаются.

Нужно подтянуть старый период. Укажите его вручную и нажмите «Выполнить» — расписание смотрит только на два дня назад.

Куда смотреть дальше