Как нумеровать счета-фактуры в течение дня и для чего это нужно




Принцип обмена данными из 1С с сайтом (на MySQL) и выдачи (публикации) этих данных по запросу.
PHP-Скрипт автоматической загрузки данных из файла данных в формате CSV в базу данных сайта работающего на WordPress.

В продолжение моей темы: 1С:Альфа-Авто Автосалон Автосервис: обмен с сайтом.
С помощью данного скрипта можно загружать в автоматическом режиме, по расписанию, данные сервисных книжек (ремонтов авто) из 1С:Альфа-Авто Автосалон Автосервис.
Также можно загружать данные в ручном режиме: для этого делается скрытая страница, где размещается специальная кнопка.
Комментарии размещенные внутри скрипта разъяснят логику и порядок действия.
Комментарии с "/////    echo" использовались для отладки.
Дополнительно создана таблица для журналирования результатов загрузки данных.
Скрипт включает в себя защиту от SQL инъекций (думаю безопасность соблюдена в полной мере).
В кратце:
1. Пишется скрипт, который запускает этот.
2. Создается регламентное задание в WordPress, по которому запускается скрипт из п.1. 
3. Этот скрипт осуществляет проверку на существование файла обмена в папке.
4. Если данные не новые, загрузка не производится.
5. Если данные новые, очищается таблица сервисных книжек.
6. Загружаются новые данные.

Собственно сам скрипт:

<?php // Полная загрузка сервисных книжек, создан 2024-01-05 12:44:55

global $wpdb2;
global $failure;
global $file_hist;

/////  echo '<H2><b>Старт загрузки</b></H2><br>';

$failure=FALSE;
//подключаемся к базе
$wpdb2 = include_once 'connection.php'; ; // подключаемся к MySQL
// если не удалось подключиться, и нужно оборвать PHP с сообщением об этой ошибке
if (!empty($wpdb2->error))
{
/////   echo '<H2><b>Ошибка подключения к БД, завершение.</b></H2><br>';
$failure=TRUE;
wp_die( $wpdb2->error );
}

$m_size_file=0;
$m_mtime_file=0;
$m_comment='';
/////проверка существования файлов выгрузки из 1С
////файл выгрузки сервисных книжек
$file_hist = ABSPATH.'/_1c_alfa_exchange/AA_hist.csv';
if (!file_exists($file_hist))
{
/////   echo '<H2><b>Файл обмена с сервисными книжками не существует.</b></H2><br>';
$m_comment='Файл обмена с сервисными книжками не существует';
$failure=TRUE;
}

/////инициируем таблицу лога
/////если не существует файла то возврат и ничего не делаем
if ($failure){
///включает защиту от SQL инъекций и данные можно передавать как есть, например: $_GET['foo']
/////   echo '<H2><b>Попытка вставить запись в лог таблицу</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>$m_mtime_file,'last_size_upload'=>$m_size_file,'comment'=>$m_comment));
wp_die();
/////    echo '<H2><b>Возврат в начало.</b></H2><br>';
return $failure;
}
/////проверка лога загрузки, что бы не загружать тоже самое
$masiv_data_file=stat($file_hist);   ////передаем в массив свойство файла
$m_size_file=$masiv_data_file[7];    ////получаем размер файла
$m_mtime_file=$masiv_data_file[9];   ////получаем дату модификации файла
////создаем запрос на получение последней удачной загрузки
////выбираем по штампу времени создания (редактирования) файла загрузки AA_hist.csv, $m_mtime_file

/////   echo '<H2><b>Размер файла: '.$m_size_file.'</b></H2><br>';
/////   echo '<H2><b>Штамп времени файла: '.$m_mtime_file.'</b></H2><br>';
/////   echo '<H2><b>Формирование запроса на выборку из лога</b></H2><br>';
////препарируем запрос
$text_zaprosa=$wpdb2->prepare("SELECT * FROM `vin_logs` WHERE `last_mtime_upload` = %s", $m_mtime_file);
$results=$wpdb2->get_results($text_zaprosa);

if ($results)
{   foreach ( $results as $r)
{
////если штамп времени и размер файла совпадают, возврат
if (($r->last_mtime_upload==$m_mtime_file) && ($r->last_size_upload==$m_size_file))
{////echo '<H2><b>Возврат в начало, т.к. найдена запись в логе.</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>$m_mtime_file,'last_size_upload'=>$m_size_file,'comment'=>'Загрузка отменена, новых данных нет, т.к. найдена запись в логе.'));
wp_die();
return $failure;
}
}
}
////если данные новые, пишем в лог запись о начале загрузки
/////echo '<H2><b>Попытка вставить запись о начале загрузки в лог таблицу</b></H2><br>';
$insert_fail_zapros=$wpdb2->insert('vin_logs', array('time_stamp'=>time(),'last_mtime_upload'=>0, 'last_size_upload'=>$m_size_file, 'comment'=>'Начало загрузки'));

////очищаем таблицу
$clear_tbl_zap=$wpdb2->prepare("TRUNCATE TABLE %s", 'vin_history');
$clear_tbl_zap_repl=str_replace("'","`",$clear_tbl_zap);
$results=$wpdb2->query($clear_tbl_zap_repl);
/////   echo '<H2><b>Очистка таблицы сервисных книжек</b></H2><br>';
if (empty($results))
{
/////   echo '<H2><b>Ошибка очистки таблицы книжек, завершение.</b></H2><br>';
//// если очистка не удалась, возврат
$failure=TRUE;
wp_die();
return $failure;
}

////загружаем данные
$table='vin_history';         // Имя таблицы для импорта
//$file_hist Имя CSV файла, откуда берется информация     // (путь от корня web-сервера)
$delim=';';          // Разделитель полей в CSV файле
$enclosed='"';      // Кавычки для содержимого полей
$escaped='\

9 Comments

  1. @Sonya

    Надобность в такой нумерации бывает, хотя очень удивило в свое время, реализовали подобным способом.

    Reply
  2. apatyukov

    ППП – основной префикс, строящийся по правилам типовой конфигурации,

    ГГ – две последние цифры года выставления документа,

    ММ – две цифры месяца выставления,

    ДД – две цифры дня в месяце из даты документа.

    ГГ-Излишний , так как контроль уникальности проходит в течении года.

    Reply
  3. rav_

    (2) apatyukov, согласен.

    Плюс в том, что по номеру можно легко восстановить дату :), вдруг кому надо.

    Reply
  4. apatyukov

    (3) дата и так указывается в первичке 🙂

    Reply
  5. Diego_Iv

    (4) apatyukov,

    Наверно, чтобы быстро отследить случаи, когда дата с/ф изменялась задним числом.

    Reply
  6. Zhilyakovdr

    //Номер дня в году в номере документа

    Префикс = Строка(ДеньГода(Источник.Дата));

    Префикс = СтроковыеФункцииКлиентСервер.ДополнитьСтроку(Префикс, 3, «0», «Слева»);

    УстановитьПрефиксИнформационнойБазыИОрганизации(Источник, СтандартнаяОбработка, Префикс);

    Reply
  7. rav_

    (6) Zhilyakovdr, вполне можно и так.

    Цель была указать подход к решению, а не описать шаблон префикса.

    Если же обсуждать какой вариант шаблона лучше,

    то уловить глазом ошибку в нумерации или поправить номер вручную внутри дня проще,

    когда префикс именно такой, как в примере (или в посте 2), чем в Вашем случае,

    но это только моё сугубо личное мнение.

    Reply
  8. mip128

    А что если поменяют дату у записанного документа? Или сначала запишут, потом ставят дату?

    Reply
  9. rav_

    (8) mip128,

    «А что если поменяют дату у записанного документа?»

    В конфигурации БУ 2.0 (именно для нее делалась реализация) при изменении даты интерактивно срабатывает механизм:

    Процедура ДатаПриИзменении(Элемент)
    
    РаботаСДиалогами.ПроверитьНомерДокумента(ЭтотОбъект, мТекущаяДатаДокумента);
    …
    

    ,

    который проверяет периодичность документа и при выходе даты из этого периода очищает номер. Поскольку тут делать ничего не пришлось (все уже было), то этот момент описан не был.

    Сразу скажу, что если записывать документ программно, то при заполненной дате и пустом номере

    система построит последний правильно, а если программно заполнить номер чем-нибудь «левым», то номер «правильным» не станет. Программно можно делать многое, главное — делать правильно (иначе зачем)!

    «Или сначала запишут, потом ставят дату?»

    Насколько я понимаю, система сама контролирует наличие даты у документа при его записи (по крайней мере в типовых конфигурациях).

    Если всё хочется контролировать самому, то можно заставить систему проверять наличие корректной даты и корректного номера документа в обработчике события модуля документа «ПередЗаписью(Отказ, РежимЗаписи, РежимПроведения)» или в подписке на событие «ПередЗаписью» с параметрами обработчика (Источник, Отказ, РежимЗаписи, РежимПроведения) и отказаться от выполняемого действия в случае ошибки. Тогда даже поиски программиста-багоискателя не приведут к ошибке.

    Reply

Leave a Comment

Ваш адрес email не будет опубликован. Обязательные поля помечены *