Перейти к содержанию
30 минут чтения
Тема: Практика Telegram · PHP · Отчётность

Как отправлять ежедневный отчёт о продажах и заявках в Telegram

Для примера руководитель сервисной компании каждое утро получает итоги вчерашнего дня: оплаченные заказы, поступления, возвраты и новые заявки. Напишем PHP-процесс, который собирает согласованный снимок, сравнивает его с предыдущим днём и отправляет в выбранный Telegram-чат. Ошибка выгрузки не будет выдаваться за отсутствие продаж.

Сначала договоритесь, что означают цифры

Слово «продажи» часто означает сразу созданные заказы, оплату и выручку по отгрузкам. В нашем отчёте используются денежные события: поступления по времени оплаты, возвраты по времени возврата, разность этих сумм и число разных заказов с оплатой за день. Это управленческая сводка движения денег, не бухгалтерская отчётность.

Показатель

Правило примера

Оплаченные заказы

Число разных order_id с событием payment внутри периода.

Поступления

Сумма payment в копейках; только RUB.

Возвраты

Сумма refund, произошедших в этом периоде, в том числе по старым заказам.

Чистые поступления

Поступления минус возвраты; значение может быть отрицательным.

Новые заявки

Записи leads по времени создания; не число сообщений боту.

Две частичные оплаты одного заказа дают две суммы, но один заказ в пределах дня. Если оплата была в разные дни, заказ попадёт в оба ежедневных счётчика — это ожидаемо для выбранного определения. Для конверсии заявок в продажи потребуется отдельная когорта и связь lead_id/order_id; делить сегодняшние оплаты на сегодняшние заявки автоматически неверно.

Суммы хранятся целыми копейками. В SQL нет float для денег, а форматирование рублей выполняется только перед показом. Не складывайте валюты без явного правила пересчёта. Для нескольких валют сформируйте отдельные строки или отдельные отчёты с зафиксированным курсом и датой.

Закройте день в нужном часовом поясе

Отчёт за 18 ноября — интервал от локальной полуночи 18-го включительно до локальной полуночи 19-го исключительно. В БД события записаны Unix timestamp в UTC. Полуоткрытый интервал >= start и < end не дублирует событие ровно на границе двух дней.

Следующую границу вычисляем как следующую календарную дату в IANA-зоне. Прибавить 86400 к UTC-началу недостаточно: в зоне с переходом на летнее время день бывает короче или длиннее. Для сравнения берём предыдущий локальный день тем же способом. Europe/Moscow в примере выбирается настройкой, а не часовым поясом операционной системы.

Отправка в 09:05 не меняет отчётный период на «последние 24 часа». Это только время доставки уже закрытого дня. Если выгрузка отстаёт, следует дождаться полноты данных, а не незаметно обрезать сутки текущим доступным временем. Для бизнеса с закрытием смены в 06:00 нужна другая функция границ и явная подпись периода.

Отличайте ноль от неполной выгрузки

Для воспроизводимого примера используем локальные таблицы money_events и leads. В рабочем приложении это могут быть собственные данные магазина или результат синхронизации CRM. Импортёр сохраняет устойчивые ID событий, обрабатывает все страницы и только после успешного завершения продвигает source_cursors.

У курсора два края: available_from показывает начало доступной истории, complete_before — границу, до которой данные получены полностью. Оба источника должны покрыть вчера и день сравнения. Одно пустое множество строк не доказывает полноту, а время запуска импорта не является подтверждением получения всех событий.

Состояние

Что делать

Источники полны, записей нет

Отправить честные нулевые показатели.

Ошибка SQL или недоступна БД

Завершить сборку с ошибкой, не формировать денежные итоги.

Курсор отстаёт

Отложить сборку и проверить синхронизацию.

Есть текущий день, нет истории сравнения

Не публиковать ложное сравнение с нулём; догрузить историю.

Прошлый показатель равен нулю

Показать отсутствие положительной базы для процента.

Если данные поступают напрямую в вашу БД без внешней синхронизации, критерий полноты будет другим: например, завершённая смена и проведённые оплаты. Не добавляйте фиктивный курсор, который просто ставит now() независимо от ошибок. Учебный demo.php ниже создаёт полностью известный набор и явно отмечает его покрытие.

Подготовьте файлы и таблицы

Пример использует PHP 8.3+, cURL и PDO SQLite. Один бот, один получатель и одна зона отчёта задаются через окружение. Получатель — числовой chat_id закрытого тестового чата; заранее убедитесь, что бот может туда писать. Как выбрать чат уведомлений.

Структура проекта
common.php
values.php
schema.sql
init.php
reporting.php
report.php
transport.php
worker.php
demo.php
review.php
Окружение процесса · значения-примеры
APP_DB=/private/daily-reports.sqlite
BOT_TOKEN=TOKEN_FROM_BOTFATHER
REPORT_CHAT_ID=TEST_CHAT_ID
REPORT_TIMEZONE=Europe/Moscow
PHP · values.php
<?php

declare(strict_types=1);

/**
 *
 * @return array<string,mixed>
 */
function objectValue(mixed $value): array
{
    if (!is_array($value)) {
        throw new InvalidArgumentException('Expected object');
    }
    $result = [];
    foreach ($value as $key => $item) {
        if (!is_string($key)) {
            throw new InvalidArgumentException('Expected object keys');
        }
        $result[$key] = $item;
    }
    return $result;
}

function stringValue(mixed $value): string
{
    if (!is_string($value)) {
        throw new InvalidArgumentException('Expected string');
    }
    return $value;
}

function intValue(mixed $value): int
{
    if (!is_int($value) && !is_string($value)) {
        throw new InvalidArgumentException('Expected integer');
    }
    $integer = filter_var($value, FILTER_VALIDATE_INT);
    if ($integer === false) {
        throw new InvalidArgumentException('Invalid integer');
    }
    return $integer;
}
PHP · common.php
<?php

declare(strict_types=1);
require_once __DIR__.'/values.php';

function envRequired(string $name): string
{
    $value = getenv($name);
    if ($value === false || $value === '') {
        throw new RuntimeException('Missing environment: '.$name);
    }
    return $value;
}

function database(): PDO
{
    $db = new PDO('sqlite:'.envRequired('APP_DB'), null, null, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
    $db->exec('PRAGMA busy_timeout=5000');
    return $db;
}
SQL · schema.sql
CREATE TABLE money_events (
 id TEXT PRIMARY KEY, order_id TEXT NOT NULL, kind TEXT NOT NULL CHECK(kind IN ('payment','refund')),
 amount_minor INTEGER NOT NULL CHECK(amount_minor>0), currency TEXT NOT NULL CHECK(currency='RUB'), happened_at INTEGER NOT NULL
);
CREATE INDEX money_period ON money_events(happened_at);
CREATE TABLE leads (id TEXT PRIMARY KEY, created_at INTEGER NOT NULL);
CREATE INDEX leads_period ON leads(created_at);
CREATE TABLE source_cursors (source TEXT PRIMARY KEY, available_from INTEGER NOT NULL, complete_before INTEGER NOT NULL);
CREATE TABLE reports (
 id INTEGER PRIMARY KEY AUTOINCREMENT, report_date TEXT NOT NULL, timezone TEXT NOT NULL, chat_id TEXT NOT NULL,
 period_start INTEGER NOT NULL, period_end INTEGER NOT NULL, text TEXT NOT NULL,
 state TEXT NOT NULL DEFAULT 'pending', attempts INTEGER NOT NULL DEFAULT 0,
 next_attempt_at INTEGER NOT NULL DEFAULT 0, message_id INTEGER, error_code INTEGER,
 UNIQUE(report_date,timezone,chat_id)
);
PHP · init.php
<?php

declare(strict_types=1);
require __DIR__.'/common.php';
database()->exec(stringValue(file_get_contents(__DIR__.'/schema.sql')));
echo "Database ready\n";

Уникальные ключи событий защищают импорт от повторов, а ключ даты, зоны и получателя — от создания двух одинаковых отчётов. Один отчёт привязан к одному боту этой установки; если меняете бота или правила метрик, заведите отдельную версию отчётной конфигурации и не смешивайте её со старыми записями.

Соберите и сохраните снимок

PHP · reporting.php
<?php

declare(strict_types=1);

/**
 * @return array{start:int,end:int,previous_start:int}
 */
function dayBounds(string $date, string $zone): array
{
    $start = DateTimeImmutable::createFromFormat('!Y-m-d', $date, new DateTimeZone($zone));
    if (!$start || $start->format('Y-m-d') !== $date) {
        throw new InvalidArgumentException('Use YYYY-MM-DD');
    }
    return ['start' => $start->getTimestamp(),'end' => $start->modify('+1 day')->getTimestamp(),'previous_start' => $start->modify('-1 day')->getTimestamp()];
}

/**
 * @return array{paid:int,refunds:int,orders:int,leads:int,net:int}
 */
function totals(PDO $db, int $start, int $end): array
{
    $q = $db->prepare("SELECT COALESCE(SUM(CASE WHEN kind='payment' THEN amount_minor ELSE 0 END),0) paid,
        COALESCE(SUM(CASE WHEN kind='refund' THEN amount_minor ELSE 0 END),0) refunds,
        COUNT(DISTINCT CASE WHEN kind='payment' THEN order_id END) orders FROM money_events WHERE happened_at>=? AND happened_at<?");
    $q->execute([$start,$end]);
    $r = objectValue($q->fetch(PDO::FETCH_ASSOC));
    $q = $db->prepare('SELECT COUNT(*) FROM leads WHERE created_at>=? AND created_at<?');
    $q->execute([$start,$end]);
    $paid = intValue($r['paid']);
    $refunds = intValue($r['refunds']);
    return ['paid' => $paid,'refunds' => $refunds,'orders' => intValue($r['orders']),'leads' => intValue($q->fetchColumn()),'net' => $paid - $refunds];
}
function money(int $minor): string
{
    return number_format($minor / 100, 2, ',', ' ').' ₽';
}
function change(int $current, int $previous): string
{
    if ($previous <= 0) {
        return 'процент не рассчитывается: база сравнения ≤ 0';
    }
    $percent = round(($current - $previous) * 100 / $previous, 1);
    return ($percent > 0 ? '+' : '').number_format($percent, 1, ',', ' ').'%';
}
/**
 * @param array{paid:int,refunds:int,orders:int,leads:int,net:int} $today
 *
 * @param array{paid:int,refunds:int,orders:int,leads:int,net:int} $previous
 */
function reportText(string $date, string $zone, array $today, array $previous): string
{
    return "Итоги за $date · $zone\nПериод: 00:00–00:00 следующего дня\n\n"
        .'Оплаченных заказов: '.$today['orders']."\nПоступления: ".money($today['paid'])
        ."\nВозвраты: ".money($today['refunds'])."\nЧистые поступления: ".money($today['net'])
        ."\nНовых заявок: ".$today['leads']."\n\nК предыдущему дню:\nПоступления: ".change($today['paid'], $previous['paid'])
        ."\nЗаявки: ".change($today['leads'], $previous['leads'])."\n\nДанные получены полностью. Валюта: RUB.";
}
function buildReport(PDO $db, string $date, string $zone, string $chat, int $now): int
{
    $b = dayBounds($date, $zone);
    if ($b['end'] > $now) {
        throw new InvalidArgumentException('Period is not closed');
    }
    $db->beginTransaction();
    try {
        // В SQLite транзакция даёт согласованный снимок обеих выборок.
        $q = $db->prepare('SELECT id FROM reports WHERE report_date=? AND timezone=? AND chat_id=?');
        $q->execute([$date,$zone,$chat]);
        $existing = $q->fetchColumn();
        if ($existing !== false) {
            $db->commit();
            return intValue($existing);
        }
        foreach (['money','leads'] as $source) {
            $q = $db->prepare('SELECT available_from,complete_before FROM source_cursors WHERE source=?');
            $q->execute([$source]);
            $cursor = $q->fetch(PDO::FETCH_ASSOC);
            if (!is_array($cursor) || intValue($cursor['available_from']) > $b['previous_start'] || intValue($cursor['complete_before']) < $b['end']) {
                throw new RuntimeException('Source incomplete: '.$source);
            }
        }
        $today = totals($db, $b['start'], $b['end']);
        $previous = totals($db, $b['previous_start'], $b['start']);
        $text = reportText($date, $zone, $today, $previous);
        $db->prepare('INSERT INTO reports(report_date,timezone,chat_id,period_start,period_end,text) VALUES(?,?,?,?,?,?)')
            ->execute([$date,$zone,$chat,$b['start'],$b['end'],$text]);
        $id = intValue($db->lastInsertId());
        $db->commit();
        return $id;
    } catch (Throwable $e) {
        $db->rollBack();
        throw $e;
    }
}

buildReport сначала отказывается от незакрытого периода, затем в одной транзакции проверяет курсоры и читает оба дня. Сгенерированный текст сохраняется в reports. Повторная сборка возвращает прежний ID и текст, поэтому задержка отправки не меняет цифры посреди повторов.

Функция change не делит на ноль и не рисует бесконечный рост. При нулевой или отрицательной базе она сообщает, что процент не рассчитывается. В реальном сообщении полезно показывать также абсолютную разницу; при сравнении разных дней недели можно заменить базу на тот же день прошлой недели, но это должно быть видно в подписи.

SQLite даёт этому чтению согласованный снимок. При переносе на другую СУБД проверьте уровень изоляции: две последовательные выборки под READ COMMITTED могут увидеть разные версии выгрузки. Для крупной системы удобен отдельный завершённый batch_id, по которому читаются все метрики и фиксируется источник отчёта.

PHP · report.php
<?php

declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/reporting.php';
$zone = envRequired('REPORT_TIMEZONE');
$date = $argv[1] ?? (new DateTimeImmutable('yesterday', new DateTimeZone($zone)))->format('Y-m-d');
$lock = fopen(envRequired('APP_DB').'.build.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
    exit(1);
}
try {
    $id = buildReport(database(), $date, $zone, envRequired('REPORT_CHAT_ID'), time());
    echo 'Report ready: '.$id.PHP_EOL;
} catch (Throwable) {
    fwrite(STDERR, 'Report NOT built: inspect source availability and watermark'.PHP_EOL);
    exit(1);
}

CLI-блокировка защищает от параллельной сборки на одном сервере. Ошибка источника завершает команду с ненулевым кодом; это сигнал мониторингу. В reports не появляется сообщение «всё по нулям». Сбой сборки и сбой Telegram нужно отслеживать раздельно: это разные ответственные и разные способы восстановления.

Проверьте расчёт на известных данных

PHP · demo.php
<?php

declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/reporting.php';
$db = database();
$date = $argv[1] ?? '2026-11-18';
$b = dayBounds($date, envRequired('REPORT_TIMEZONE'));
$check = $db->prepare('SELECT COUNT(*) FROM money_events');
$check->execute();
if ($check->fetchColumn() !== 0) {
    throw new RuntimeException('Use an empty demo DB');
}
$db->beginTransaction();
$q = $db->prepare('INSERT INTO money_events VALUES(?,?,?,?,?,?)');
$q->execute(['pay-old','R-1','payment',100000,'RUB',$b['previous_start'] + 3600]);
$q->execute(['pay-1','R-2','payment',150000,'RUB',$b['start'] + 3600]);
$q->execute(['refund-1','R-1','refund',20000,'RUB',$b['start'] + 7200]);
$q = $db->prepare('INSERT INTO leads VALUES(?,?)');
$q->execute(['L-1',$b['previous_start'] + 100]);
$q->execute(['L-2',$b['start'] + 100]);
$q->execute(['L-3',$b['start'] + 200]);
$q = $db->prepare('INSERT INTO source_cursors VALUES(?,?,?)');
foreach (['money','leads'] as $s) {
    $q->execute([$s,$b['previous_start'],$b['end']]);
}
$db->commit();
echo "Demo dataset ready\n";
Пример ежедневного сообщения показывает 1300 ₽ чистых поступлений; отдельно показано, что неполный источник останавливает отчёт.
Пример ежедневного сообщения показывает 1300 ₽ чистых поступлений; отдельно показано, что неполный источник останавливает отчёт.
Схема, не снимок Telegram. Текст слева сформирован reportText из статьи на её учебных данных: 1500 ₽ поступлений, 200 ₽ возвратов и две заявки.
Bash · только для отдельной пустой учебной базы
php init.php
php demo.php 2026-11-18
php report.php 2026-11-18

В примере вчера поступило 1500 ₽, возвращено 200 ₽ по старому заказу, создано две заявки. Днём раньше поступило 1000 ₽ и была одна заявка. Ожидаем один оплаченный заказ, 1300 ₽ чистых поступлений, +50,0% по поступлениям и +100,0% по заявкам. Команды пока не отправляют сообщение.

SQL · проверить готовый текст
SELECT id,report_date,period_start,period_end,state,text FROM reports;

Затем уменьшите complete_before одного источника и попробуйте собрать другую закрытую дату: команда должна отказать до создания отчёта. Для проверки настоящего нуля подготовьте полный пустой период и курсоры, покрывающие оба дня. Удаление денежных строк в рабочей БД не является тестовым приёмом; используйте отдельную базу.

Отправляйте сохранённый текст с понятным результатом

PHP · transport.php
<?php

declare(strict_types=1);

/**
 * @param array<string,mixed> $params
 *
 * @return array{state:string,retry_after:int,message_id:?int,code:?int}
 */
function sendTelegram(string $method, array $params): array
{
    $curl = curl_init('https://api.telegram.org/bot'.envRequired('BOT_TOKEN').'/'.$method);
    if ($curl === false) {
        throw new RuntimeException('HTTP init failed');
    }
    curl_setopt_array($curl, [CURLOPT_POST => true,CURLOPT_POSTFIELDS => json_encode($params, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE),
        CURLOPT_HTTPHEADER => ['Content-Type: application/json'],CURLOPT_RETURNTRANSFER => true,CURLOPT_CONNECTTIMEOUT => 5,CURLOPT_TIMEOUT => 20]);
    $raw = curl_exec($curl);
    $http = (int)curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
    return classifyTelegram($http, is_string($raw) ? $raw : null);
}

/**
 * @return array{state:string,retry_after:int,message_id:?int,code:?int}
 */
function classifyTelegram(int $http, ?string $raw): array
{
    $unknown = ['state' => 'unknown','retry_after' => 0,'message_id' => null,'code' => null];
    if ($raw === null || $http >= 500) {
        return $unknown;
    }
    $body = json_decode($raw, true);
    if (!is_array($body)) {
        return $unknown;
    }
    $result = $body['result'] ?? null;
    if ($http === 200 && ($body['ok'] ?? false) === true) {
        $id = is_array($result) && is_int($result['message_id'] ?? null) ? $result['message_id'] : null;
        return ['state' => 'sent','retry_after' => 0,'message_id' => $id,'code' => null];
    }
    if (($body['ok'] ?? null) !== false || !is_int($body['error_code'] ?? null)) {
        return $unknown;
    }
    $code = $body['error_code'];
    $parameters = $body['parameters'] ?? null;
    if ($code === 429 && is_array($parameters) && is_int($parameters['retry_after'] ?? null) && $parameters['retry_after'] > 0) {
        return ['state' => 'retry','retry_after' => $parameters['retry_after'],'message_id' => null,'code' => $code];
    }
    return ['state' => $code >= 400 && $code < 500 ? 'failed' : 'unknown','retry_after' => 0,'message_id' => null,'code' => $code];
}
PHP · worker.php
<?php

declare(strict_types=1);
require __DIR__.'/common.php';
require __DIR__.'/transport.php';
$lock = fopen(envRequired('APP_DB').'.send.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
    exit(0);
}
$db = database();
$q = $db->prepare("SELECT * FROM reports WHERE state IN ('pending','retry') AND next_attempt_at<=? ORDER BY id LIMIT 10");
$q->execute([time()]);
foreach ($q->fetchAll(PDO::FETCH_ASSOC) as $row) {
    $r = objectValue($row);
    $id = intValue($r['id']);
    $db->prepare("UPDATE reports SET state='sending',attempts=attempts+1 WHERE id=?")->execute([$id]);
    try {
        $result = sendTelegram('sendMessage', ['chat_id' => $r['chat_id'],'text' => $r['text']]);
    } catch (Throwable) {
        $result = ['state' => 'unknown','retry_after' => 0,'message_id' => null,'code' => null];
    }
    if ($result['state'] === 'sent' && $result['message_id'] === null) {
        $result['state'] = 'unknown';
    }
    if ($result['state'] === 'retry' && intValue($r['attempts']) + 1 >= 5) {
        $result['state'] = 'failed';
    }
    $db->prepare('UPDATE reports SET state=?,next_attempt_at=?,message_id=?,error_code=? WHERE id=?')
        ->execute([$result['state'],time() + $result['retry_after'],$result['message_id'],$result['code'],$id]);
}

sendTelegram работает напрямую с Bot API и не делает скрытых повторов. Подтверждённый 429 с retry_after переводит запись в retry с временем следующей попытки. Число попыток ограничено пятью. Ошибка 400/403 требует исправления параметров или доступа; сетевой сбой и 5xx оставляют unknown, потому что сообщение уже могло попасть в Telegram.

Сначала worker сохраняет sending, затем вызывает сеть и записывает результат. Авария после доставки, но до UPDATE оставит sending — её нельзя безусловно сбросить в pending. Даже уникальная строка reports не обеспечивает ровно одну доставку между двумя системами. Подробности есть в руководстве о дублях.

Bash · первая отправка в настроенный тестовый чат
php worker.php

После подтверждённой отправки ожидаются state=sent и message_id. Текст отправляется без parse_mode: названия не интерпретируются как HTML или Markdown. Сводка короткая и не содержит персональных данных покупателей. Для длинной детализации лучше дать ссылку в защищённый кабинет, а не выводить сотни строк в общий чат.

Запустите сборку и доставку по расписанию

Пример ниже — crontab одного сервера, системный часовой пояс которого заранее настроен на Europe/Moscow. REPORT_TIMEZONE всё равно задаётся явно. Если системная зона другая, пересчитайте время запуска или используйте планировщик с документированной поддержкой зон; не полагайтесь на универсальную поддержку CRON_TZ каждым cron.

Crontab · пример для сервера с системной зоной Europe/Moscow
5 9 * * * cd /srv/daily-report && /usr/bin/php report.php >> /private/report-build.log 2>&1
* * * * * cd /srv/daily-report && /usr/bin/php worker.php >> /private/report-send.log 2>&1

Переменные окружения и путь PHP должны быть доступны именно cron. Команда report.php без аргумента выбирает вчера в REPORT_TIMEZONE; worker каждую минуту берёт готовые и разрешённые повторные отправки. Закройте файлы логов от HTTP-доступа и настройте ротацию. Логи не должны содержать токен, URL запроса с токеном или полные ответы клиентов.

Если сервер был выключен утром, cron обычно не воспроизводит пропущенное выполнение автоматически. После восстановления вызовите report.php с конкретной пропущенной датой, проверьте снимок и отправьте его обычным worker. При отсутствии данных сначала восстановите импорт. Не догоняйте десятки дат без контроля: руководитель получит серию устаревших сообщений.

В Laravel тот же принцип можно реализовать командой и Scheduler: планировщик поддерживает расписания, зоны и защиту от наложений. Но блокировка планировщика не заменяет уникальный ключ отчёта и журнал доставки; поздний повтор должен читать сохранённый снимок.

Разберите неизвестную отправку и поздние данные

PHP · review.php
<?php

declare(strict_types=1);
require __DIR__.'/common.php';
$id = intValue($argv[1] ?? '');
$action = $argv[2] ?? '';
if (!in_array($action, ['retry','confirmed-sent'], true)) {
    throw new RuntimeException('Usage: php review.php ID retry|confirmed-sent');
}
$lock = fopen(envRequired('APP_DB').'.send.lock', 'c');
if ($lock === false || !flock($lock, LOCK_EX | LOCK_NB)) {
    throw new RuntimeException('Sender busy');
}
$q = database()->prepare("UPDATE reports SET state=?,attempts=0,next_attempt_at=0 WHERE id=? AND state IN ('sending','unknown','failed')");
$q->execute([$action === 'retry' ? 'pending' : 'sent',$id]);
echo 'Updated rows: '.$q->rowCount().PHP_EOL;
SQL · очередь и проблемные отчёты
SELECT id,report_date,state,attempts,next_attempt_at,message_id,error_code FROM reports ORDER BY id DESC;

review.php — ручной инструмент сотрудника. После проверки чата confirmed-sent отмечает уже найденное сообщение; retry разрешает новую попытку и может создать дубль, если первая доставка осталась незамеченной. Для sending сначала убедитесь, что прежний worker действительно завершился. Скрипт использует ту же блокировку, что и отправитель.

Bash · после ручной сверки конкретного отчёта
php review.php 1 confirmed-sent
# Или, если принято решение повторить:
# php review.php 1 retry

Поздняя корректировка CRM не должна молча переписать уже отправленные цифры. Создайте отдельную исправленную версию с понятной подписью и причиной либо реализуйте контролируемое editMessageText с сохранённым message_id. Учебный buildReport неизменяем: повтор вернёт старый снимок. Это ограничение видно, а не спрятано в расписании.

Что проверить перед ежедневной работой

  • Оплата ровно на start входит, ровно на end относится к следующему дню.

  • Два события одного заказа дают одну строку счётчика заказов, но обе денежные суммы.

  • Возврат старой покупки уменьшает чистые поступления текущего дня.

  • Пустая полная выгрузка даёт нули; неполная выгрузка не создаёт отчёт.

  • Переход летнего времени меняет длину периода, но не теряет локальную календарную дату.

  • Повтор сборки сохраняет ID и текст; 429 откладывает попытку, таймаут не повторяет её автоматически.

Для мониторинга нужны три сигнала: данные не готовы к контрольному времени, отчёт не собран и отчёт не подтверждён Telegram. Аварийное сообщение об ошибке получения данных должно прямо называться ошибкой и уходить по отдельному каналу; не выдавайте его за финансовый итог дня.

Через BotGate можно заменить исходящий Telegram-транспорт, сохранив расчёт периода и снимок у себя. При такой замене учитывайте внешний HTTP-статус и вложенную ошибку Telegram отдельно, а повторы оставьте на одном уровне. Документация BotGate описывает адрес и авторизацию; сервис не исправляет неполные исходные данные.