Большое обновление kkmserver/unitserver/kkmfactory
Добавлено: 14 авг 2017, 22:01
Большое обновление kkmserver/unitserver/kkmfactory:
Добавленна поддержка ФФД 1.05.
Для использования ФФД 1.05 необходимо:
- Согласовать с вашим ОФД переход на ФФД 1.05 (не все ОФД пока поддерживают ФФД 1.05)
- ККТ Штрих-М обновить прошивку до версии не ниже 12.07.2017
- ККТ Атол - официальных прошивок пока нет, когда появятся - не ниже 4393
- Изменить в вашей учетной системе вызовы kkmserver/unitserver/kkmfactory до нового API 1.05.
- Сделать перерегистрацию ККТ (кроме стар-русов) с командой "Смена настроек ККТ", в данных выбрать формат ФФД 1.05
Изменения в новом API 1.05 по сравнению с API 1.0:
1. команда "RegisterCheck" - чек прихода-расхода-возврата:
- добавлено обязательное поле "CashierVATIN" - ИНН продавца
- добавлено не обязательное поле "SenderEmail" - Aдрес электронной почты отправителя чека
- убран массив "CheckProps" - теги из этого разделе перемещены в поле "AgentData" фискальной строки
- убраны поля "CashLessType1", "CashLessType2", "CashLessType3"
- Добавлены поле "ElectronicPayment" - Сумма электронной оплаты
- Добавлены поле "AdvancePayment" - Сумма из предоплаты (зачетом аванса)
- Добавлены поле "Credit" - Сумма постоплатой(в кредит)
- Добавлены поле "CashProvision" - Сумма оплаты встречным предоставлением (сертификаты, тара, др. мат. ценности)
- в фискальной строке добавлены поля:
- "SignMethodCalculation" - Признак способа расчета, обязательно!
- "SignCalculationObject" - Признак предмета расчета, обязательно!
- "MeasurementUnit" - Единица измерения предмета расчета
- "NomenclatureCode" - Код товарной номенклатуры (Новый классификатор товаров и услуг. Пока не утвержден налоговой.)
- "AgentSign" - Признак агента
- "AgentData" - Данные агента (если указан AgentSign)
- "PurveyorData" - Признак поставщика (если указан AgentSign)
В возвращаемых данных:
- в поле "URL" будет возвращаться ссылка на чек в ОФД (для тех ОФД для которых можно сформировать такую ссылку)
- в поле "QRCode" будет возвращаться данные, которые закодированы в QR коде на чеке (ранее это возвращалось в поле "URL")
3. команда "RegisterCheck" - чек коррекции:
- добавлено обязательное поле "CorrectionBaseName" - Наименование основания для коррекции
- добавлено обязательное поле "CorrectionBaseDate" - Дата документа основания для коррекции
- добавлено обязательное поле "CorrectionBaseNumber" - Номер документа основания для коррекции
- добавлено поле "Amount" - Сумма расчета
- добавлено поле "Cash" - Сумма коррекции Наличной оплаты
- добавлено поле "ElectronicPayment" - Сумма коррекции электронной оплаты
- добавлено поле "AdvancePayment" - Сумма коррекции предоплаты (зачетом аванса)
- добавлено поле "Credit" - Сумма коррекции постоплатой(в кредит)
- добавлено поле "CashProvision" - Сумма коррекции встречным предоставлением
- добавлено поле "SumTaxNone" - Сумма коррекции НДС чека по ставке Без НДС
- добавлено поле "SumTax18" - Сумма коррекции НДС чека по ставке 18%
- добавлено поле "SumTax10" - Сумма коррекции НДС чека по ставке 10%
- добавлено поле "SumTax0" - Сумма коррекции НДС чека по ставке 0%
- добавлено поле "SumTax118" - Сумма коррекции НДС чека по ставке 18/118%
- добавлено поле "SumTax110" - Сумма коррекции НДС чека по ставке 10/110%
4. Команда "ZReport" заменена на "CloseShift" (налоговая на меня с эти наехала блин)
5. В командах "OpenShift", "CloseShift", "DepositingCash", "PaymentCash"
- необходимо обязательно указывать кассира и его ИНН, поля "CashierName" и "CashierVATIN"
6. В регистрации ККТ
- добавлены поля "CashierName" и "CashierVATIN"
- добавлено поле "PlaceSettle" - место установки ККТ
- добавлено поле "SenderEmail" - - Aдрес электронной почты отправителя чека
- добавлено поле "PrinterAutomatic" - признак установки в автомате
- добавлено поле "AutomaticNumber" - номер автомата
- добавлено поле "SaleExcisableGoods"- признак Продажа подакцизного товара
- добавлено поле "SignOfGambling" - признак проведения азартных игр
- добавлено поле "SignOfLottery" - признак проведения лотереи
- добавлено поле "SignOfAgent" - признаки агета
7. В API расширения браузеров:
- данные для чека надо получать: "KkmServer.GetDataCheck()" (ранее было KkmServer.GetDataCheck_1_0() )
- поменялись некоторые параметры функция (смотрите примеры)
В версиях серверов 2.1.ХХ.ХХ работать будут сразу два API: и 1.0 и 1.05 одновременно.
- При работе по API 1.0 Вы сможете работать только с ККТ поддерживающие только ФФД 1.0
- При работе по API 1.05 Вы сможете работать с ККТ ФФД 1.0 и ФФД 1.05.
- При работе по API 1.05 и ККТ 1.0 все новые (лишние для ФФД 1.0) будут просто отбрасывается.
Добавилась поддержка ККТ PayOnline-01-ФА (http://paykiosk.ru/netpay)
Для Штрих-М поле "NotPrint" можно использовать во всех командах
ВНИМАНИЕ!
Теоритически переход на ФФД 1.05 можно отложить еще на год.
Но есть маленькая засада: пока и производители ККТ и ОФД дают откатываться назад с 1.05 на 1.0.
Но через некоторое время откат назад запретят.
Из этой маленькой засады вырастает большая: Сейчас как правило ККТ отдают клиенту уже зарегистрированными.
И может так получится что клиенту дадут ККТ 1.05 а Ваша система может работать только по 1.0.
И тогда если откатить ККТ на 1.0 у клиента не получится он вообще не сможет работать с ККТ.
Поэтому особо на затягивайте с переходом на API 1.05 - уже через месяц начнется переход на 1.05
Для отладки можете использовать эмулятор ККТ.
Я в нем реализовал регистрацию и работу по разным версиям ФФД.
Примеры нового API
- на сайте описания: https://kkmserver.ru/KkmServer#Primer, https://kkmserver.ru/AddIn#Primer
- на сайте автономная страничка примеров: https://kkmserver.ru/KkmServer/SamplesAjax.html, https://kkmserver.ru/AddIn/SamplesAddIn.html
- в каталоге установки файлы: html\unittest.js и html\Samples.html
Добавленна поддержка ФФД 1.05.
Для использования ФФД 1.05 необходимо:
- Согласовать с вашим ОФД переход на ФФД 1.05 (не все ОФД пока поддерживают ФФД 1.05)
- ККТ Штрих-М обновить прошивку до версии не ниже 12.07.2017
- ККТ Атол - официальных прошивок пока нет, когда появятся - не ниже 4393
- Изменить в вашей учетной системе вызовы kkmserver/unitserver/kkmfactory до нового API 1.05.
- Сделать перерегистрацию ККТ (кроме стар-русов) с командой "Смена настроек ККТ", в данных выбрать формат ФФД 1.05
Изменения в новом API 1.05 по сравнению с API 1.0:
1. команда "RegisterCheck" - чек прихода-расхода-возврата:
- добавлено обязательное поле "CashierVATIN" - ИНН продавца
- добавлено не обязательное поле "SenderEmail" - Aдрес электронной почты отправителя чека
- убран массив "CheckProps" - теги из этого разделе перемещены в поле "AgentData" фискальной строки
- убраны поля "CashLessType1", "CashLessType2", "CashLessType3"
- Добавлены поле "ElectronicPayment" - Сумма электронной оплаты
- Добавлены поле "AdvancePayment" - Сумма из предоплаты (зачетом аванса)
- Добавлены поле "Credit" - Сумма постоплатой(в кредит)
- Добавлены поле "CashProvision" - Сумма оплаты встречным предоставлением (сертификаты, тара, др. мат. ценности)
- в фискальной строке добавлены поля:
- "SignMethodCalculation" - Признак способа расчета, обязательно!
- "SignCalculationObject" - Признак предмета расчета, обязательно!
- "MeasurementUnit" - Единица измерения предмета расчета
- "NomenclatureCode" - Код товарной номенклатуры (Новый классификатор товаров и услуг. Пока не утвержден налоговой.)
- "AgentSign" - Признак агента
- "AgentData" - Данные агента (если указан AgentSign)
- "PurveyorData" - Признак поставщика (если указан AgentSign)
В возвращаемых данных:
- в поле "URL" будет возвращаться ссылка на чек в ОФД (для тех ОФД для которых можно сформировать такую ссылку)
- в поле "QRCode" будет возвращаться данные, которые закодированы в QR коде на чеке (ранее это возвращалось в поле "URL")
3. команда "RegisterCheck" - чек коррекции:
- добавлено обязательное поле "CorrectionBaseName" - Наименование основания для коррекции
- добавлено обязательное поле "CorrectionBaseDate" - Дата документа основания для коррекции
- добавлено обязательное поле "CorrectionBaseNumber" - Номер документа основания для коррекции
- добавлено поле "Amount" - Сумма расчета
- добавлено поле "Cash" - Сумма коррекции Наличной оплаты
- добавлено поле "ElectronicPayment" - Сумма коррекции электронной оплаты
- добавлено поле "AdvancePayment" - Сумма коррекции предоплаты (зачетом аванса)
- добавлено поле "Credit" - Сумма коррекции постоплатой(в кредит)
- добавлено поле "CashProvision" - Сумма коррекции встречным предоставлением
- добавлено поле "SumTaxNone" - Сумма коррекции НДС чека по ставке Без НДС
- добавлено поле "SumTax18" - Сумма коррекции НДС чека по ставке 18%
- добавлено поле "SumTax10" - Сумма коррекции НДС чека по ставке 10%
- добавлено поле "SumTax0" - Сумма коррекции НДС чека по ставке 0%
- добавлено поле "SumTax118" - Сумма коррекции НДС чека по ставке 18/118%
- добавлено поле "SumTax110" - Сумма коррекции НДС чека по ставке 10/110%
4. Команда "ZReport" заменена на "CloseShift" (налоговая на меня с эти наехала блин)
5. В командах "OpenShift", "CloseShift", "DepositingCash", "PaymentCash"
- необходимо обязательно указывать кассира и его ИНН, поля "CashierName" и "CashierVATIN"
6. В регистрации ККТ
- добавлены поля "CashierName" и "CashierVATIN"
- добавлено поле "PlaceSettle" - место установки ККТ
- добавлено поле "SenderEmail" - - Aдрес электронной почты отправителя чека
- добавлено поле "PrinterAutomatic" - признак установки в автомате
- добавлено поле "AutomaticNumber" - номер автомата
- добавлено поле "SaleExcisableGoods"- признак Продажа подакцизного товара
- добавлено поле "SignOfGambling" - признак проведения азартных игр
- добавлено поле "SignOfLottery" - признак проведения лотереи
- добавлено поле "SignOfAgent" - признаки агета
7. В API расширения браузеров:
- данные для чека надо получать: "KkmServer.GetDataCheck()" (ранее было KkmServer.GetDataCheck_1_0() )
- поменялись некоторые параметры функция (смотрите примеры)
В версиях серверов 2.1.ХХ.ХХ работать будут сразу два API: и 1.0 и 1.05 одновременно.
- При работе по API 1.0 Вы сможете работать только с ККТ поддерживающие только ФФД 1.0
- При работе по API 1.05 Вы сможете работать с ККТ ФФД 1.0 и ФФД 1.05.
- При работе по API 1.05 и ККТ 1.0 все новые (лишние для ФФД 1.0) будут просто отбрасывается.
Добавилась поддержка ККТ PayOnline-01-ФА (http://paykiosk.ru/netpay)
Для Штрих-М поле "NotPrint" можно использовать во всех командах
ВНИМАНИЕ!
Теоритически переход на ФФД 1.05 можно отложить еще на год.
Но есть маленькая засада: пока и производители ККТ и ОФД дают откатываться назад с 1.05 на 1.0.
Но через некоторое время откат назад запретят.
Из этой маленькой засады вырастает большая: Сейчас как правило ККТ отдают клиенту уже зарегистрированными.
И может так получится что клиенту дадут ККТ 1.05 а Ваша система может работать только по 1.0.
И тогда если откатить ККТ на 1.0 у клиента не получится он вообще не сможет работать с ККТ.
Поэтому особо на затягивайте с переходом на API 1.05 - уже через месяц начнется переход на 1.05
Для отладки можете использовать эмулятор ККТ.
Я в нем реализовал регистрацию и работу по разным версиям ФФД.
Примеры нового API
- на сайте описания: https://kkmserver.ru/KkmServer#Primer, https://kkmserver.ru/AddIn#Primer
- на сайте автономная страничка примеров: https://kkmserver.ru/KkmServer/SamplesAjax.html, https://kkmserver.ru/AddIn/SamplesAddIn.html
- в каталоге установки файлы: html\unittest.js и html\Samples.html