Работа с личным кабинетом "Такском-касса" по API 1.3




Принцип обмена данными из 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='\

14 Comments

  1. luchyk

    К данной обработке хорошо бы приложить описание Api, или ссылку от куда его можно скачать

    Reply
  2. info1i

    (1) Во время написания обработки искал на сайте Такскома документацию по API и не нашел. Поэтому, наверное, скачать неоткуда; я запросил от лица организации по электронной почте, мне выслали. Соответственно, теперь самому распространять полученный документ — вопрос без ответа.

    Reply
  3. nasik90

    Александр, обработка еще рабочая? У меня выдает 404 ошибку.

    Reply
  4. info1i

    (3) проверил сам, работает. Логично, что работает, иначе бы мне еще раньше сообщили 🙂 В публикации я писал, что в модуле формы прописаны Организация, Счет, Контрагент и другие реквизиты, которые нужно исправить на свои или переписать эту часть кода по Вашему удобству с переносом, например, в поля на форме.

    Reply
  5. user926245

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

    Reply
  6. aximo

    Можно ли вопрос — есть ли возможность выгружать содержимое документов? номенклатуру — количество — сумму продажи?

    Reply
  7. info1i

    (6) Цитирую часть статьи: «Так как необходимо было загрузить только итоговые суммы кассовых смен, то загрузку чеков не писал, но такая функция в документации по API 1.3 тоже есть». Т.е. в обработке нет, но доработать возможно.

    Reply
  8. NataLisa

    Добрый день. Пытаюсь как раз автоматизировать загрузку чеков на примере этой обработки.

    Загрузка данных смен действительно работает, причем не только на БП (я в данный момент использую в РТ 2.2). Но при попытке получить данные документов возникает ошибка 404.

    Такском предоставил нам инструкцию. Не знаю одинаковые ли они у Вас и у меня. Может подскажете в какую сторону смотреть. При загрузке списка касс адрес ресурса выглядит так: Запр.АдресРесурса = Ресурс + «?id=» + ИДТочки

    А при загрузке списка смен: Ресурс = «API/GetShifts»;

    Хотя список параметров в документации описан одинаково. id точки описан как один из параметров. Аналогично при получении документов fn — номер ФН — один из параметров.

    Не могу воспользоваться методом DocumentList — не пойму как правильно описать параметры. Перепробовала все варианты — в любом случае ошибка 404. К тому же некоторые методы в документации записаны иначе, чем в тексте обработки:

    Например, в документации https://<server&gt;.taxcom.ru/API/v2/ShiftList, а в обработке Ресурс = «API/GetShifts»

    То ли у меня документация не та. Но по картинкам обработка очень похожа на Вашу.

    Буду очень благодарна за подсказку, если возможно.

    Reply
  9. info1i

    (8) Добрый день.

    По Вашему описанию у Вас в руках документация API 2.2. И пример функции Вы приводите из документации API 2.2 (функция DocumentList в API 1.3 отсутствует). У меня же документация и разработка на API 1.3. И функции этих API отличаются.

    Меня спрашивали, почему я написал обработку на API 1.3, а не на API 2.2. Я ранее сообщал, что на тот момент, когда возникла задача, у организации еще не было ID интегратора — это обязательный параметр для использования API 2.2. Поэтому пришлось писать на API 1.3. В Вашем же случае, если есть ID интегратора и новая документация, то можно и на API 2.2 написать. Либо запросить у Такскома документацию API 1.3 и доработать под себя мою обработку. Выбор за Вами.

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

    Думаю, Вы поняли, что не так делали и получили ответы на свои вопросы.

    Reply
  10. NataLisa

    Да, я поняла, что у нас резные версии документации. Будем думать в какую сторону двигаться и с какой версией лучше работать. Спасибо!

    Reply
  11. @nutka

    А есть такая же обработка для 1с 7.7 бух?

    Reply
  12. engela

    Александр, подскажите пожалуйста.

    1С БУХ редакция 3.0 (3.0.73.50). Воспользовалась вашей обработкой.

    Подключение, торговые точки, кассы и смены – всё опредилилось!

    Но при загрузке в базу 1С выходит ошибка:

    Не найдено соответствие в базе по рег номеру, смена не загружена

    Reply
  13. info1i

    (12) Здравствуйте!

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

    Reply
  14. engela

    (13) Не могу настроить, может поможете…

    Reply

Leave a Comment

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