не знаю, можт кому пригодится, я для наших внутренних нужд написал программку на java, она генерит csv файлы отчетности по МГ/МН/зоновой связи в совинтел.
Программа состоит из 2 частей - серверной и клиентской. На сервере ставится php скрипт. На клиенте программа на java.
ниже немножко описания:
При запуске генератора отчетов открывается простое окно, в котором необходимо выбрать год и месяц, за которые нужно генерирвать отчет в совинтел
Вложение:
2010-05-19-125505_622x168_scrot.png [ 8.6 КБ | Просмотров: 5555 ]
Здесь все предельно просто и понятно. Выбрали дату, за которую требуется сгенерировать отчет, нажли кнопку "Создать отчет", и файл отчета будет сгенерирован. Если требуется поменять порядковый номер создаваемых документов, можно нажать кнопку "Продолжить нумерацию с:", появится поле ввода, в котором нужно будет ввести номер, с которого будет продолжена нумерация создаваемых документов.
Далее разберем окно настроек.
Вложение:
2010-05-19-125515_583x368_scrot.png [ 33.5 КБ | Просмотров: 5554 ]
- BGB Exporter URL: url до скрипта экспортера документов из биллинга
- Имя файла BIL: имя файла отчетности, в котором будут записаны данные по трафику договоров
- Сохранить в: дректория, в которую будут сохраняться сгенерированные файлы
- Нумерация с: если необходимо продолжить нумерацию с определенного номера, ввеите сюда требуемый номер, с него нумерация документов будет продолжена
- Срок оплаты: срок оплаты, до которого клиенты должны погасить выставленную задолженность
- № агента: номер агента, присовенный компании совинтелом
- Код оператора: код оператора, присовенный компании совинтелом
- НДС: цена указана с учетом НДС или без
- Код НДС: НДС включен в стоимость или нет
- Код валюты: рубли или у.е.
- Регион: Регион по классификатору совинтел
- Привязки: привязки услуг из биллинга к услугам совинтел по их кодам. формат привязок такой: код_услги_в_биллинге*:*код_услуги_совинтел пробел код_услги_в_биллинге*:*код_услуги_совинтел
Все эти данные находятся в документации, которую Вашей компании выдает совинтел. BGB exporter URL выдолжны указать тот, куда залили пхп скрипт.
Как можно было заметить, в некоторых полях введены символы {Y}, {M}, {D}. эти символы будут заменены соовтетственно на текущий год, текущий месяц, текущий день. Кроме того, имеются алиасы на предыдущий год, месяц, день: {PY}, {PM}, {PD}, и следующий год, месяц, день: {NY}, {NM}, {ND} соответственно. Эти алиасы можно подставлять в любое поле в окне настроек.
Но тут есть небольшая тонкость. Если у вас уже интегрирован биллинг с 1с, то для того чтобы в документах 1с, и в сгенеренных файлах этой проги номера совпадали, нужно сделать так, чтобы 1ска забирала счетфактуры от php скрипта, который и является BGB экспортером.
Далее функционал BGB экспортера:
Скрипту может возвращать сгенерированные биллингом счета или счет-фактуры, их количество за определенный год или месяц, или год и месяц.
все запросы необходимо передавать методом GET.
ответы приходят в виде xml.
В зависимости от результата запроса, значение атрибута state ветк result может принимать значение ok(запрос успешно выполнен), или error(произошла ошибка). при значении error так же появляется еще один атрибут - msg, в котором описан код ошибки
значения которые может принимать параметр act:
lsContract - Возвращает список всех договоров в биллинге. Формат ответа:
Код:
<response><result state="ok" />
<client id="7" title="Номер договора" comment="Название компании" />
<client id="8" title="Номер договора" comment="Название компании" />
</response>
- getContractInvoiceXml - Возвращает сгенерированную биллингом счетфактуру. Обязательный параметр при этом - cid(id клиента в биллинге). Узнать этот id можно выполнив запрос getDocumentsCount, передав в качестве дополнительного параметра type=invoice
- getContractBillXml - Возвращает сгенерированный биллингом счет. Обязательный параметр при этом - cid(id клиента в биллинге). Узнать этот id можно выполнив запрос getDocumentsCount, передав в качестве дополнительного параметра type=bill
- getInvoiceDocumentsCount - Вовзращает количество созданных счетфактур из биллинга
- getBillDocumentsCount - Вовзращает количество созданных счетов из биллинга
- getVersion - отображает текущую версию экспортера
Во всех перечисленных выше ситуациях будет возвращен результат за текущий год и месяц. Чтобы получить за другой год, или месяц, необходимо передать соответствующие параметры: year=ГГГГ, и month=M
генератор отчетов (xlsger_0.5.6.jar) рекомендуется запускать из консоли так: java -jar путь/к/файлу/xlsgen_0.5.6.jar, в таком случае в консоли будут выводиться все сообщения программы во время рабты
_________________
using billingClient.BGB 4.6;
using server.Ubuntu server 9.10;
using server.Java "1.6.0_15";
using client.Ubuntu 10.04;