atol-online
Node-клиент для Атол.Онлайн
Установка
Используя npm
:
npm install atol-online
Используя yarn
:
yarn add atol-online
Примеры
Инициализация клиента:
const Atol = const atol = email: 'support@domain.ru' url: 'https://domain.ru' callback_url: 'https://domain.ru/callback' vat: 10
Отправляем запрос для чека «Прихода»:
atolsell
Передаем данные об агенте:
const atol = ... agent: type: 'paying_agent' operation: 'Комиссия за использование сервиса' phones: '+79627772299' supplier: name: 'ООО «Ромашка»' phones: '+79627772233' '+79627772200' inn: '424242424242' atolsell
Отправляем запрос для чека «Возврат прихода»:
atolsell
Отправляем запрос для чека «Коррекция прихода»:
atolsell
Получаем данные о статусе:
atolreport
Можно использовать async/await
(для всех методов):
{ try const data = await atolsell console catch error console }
Конфигурация
Доступы к тестовой среде можно найти ниже в описании.
const atol = // Логин для авторизации login: 'user' // Пароль для авторизации password: 'pass' // Идентификатор группы ККТ group: 'group-code' // ИНН организации. // Используется для предотвращения ошибочных регистраций чеков на ККТ inn: '12341234' // Возможные варианты: // `osn` // `usn_income` // `usn_income_outcome` // `envd` // `esn` // `patent` sno: null // Возможные варианты: // 10 // 18 (временно присутствует) // 20 // `10/110` // `18/118` // по-молчанию `none` vat: 'none' // Электронная почта отправителя чека email: 'support@domain.ru' // Адрес сайта на котором была сделана покупка url: 'https://domain.ru' // адрес на который будут отправляться уведомления // об изменении статуса callback_url: 'https://domain.ru/callback' // Передаем данные агента agent: // Тип агента. Возможные варианты: // bank_paying_agent // bank_paying_subagent // paying_agent // paying_subagent // attorney // comission_agent // another type: null // Массив или строка с `,` в качестве разделителя, например: // [ '+79627772211', '+79627772233' ] // `+79627772211,+79627772233` phones: //... // другие параметры из документации Атола // Передаем данные поставщика supplier: // Название компании поставшика name: 'ООО «Ромашка»' // Телефоны поставщика phones: '+79627772211, +79627772200' // ИНН поставщика inn: '454545454545' // Если указать true, то данные будут // отправляться в тестовую среду Атол.Онлайн. // Используется лишь для написания тестов livemode: false
process.env
Все конфигурации так же могут (и должны) быть указаны в файле .env
или передаваться динамически. Ниже приведены названия переменных и данные тестовой среды Атола (ребята из тех. поддержки любезно поделились ими)
ATOL_VAT=
ATOL_AGENT_TYPE=
ATOL_AGENT_PHONES=
ATOL_COMPANY_SNO=
ATOL_LOGIN=v4-online-atol-ru
ATOL_PASSWORD=iGFFuihss
ATOL_GROUP=v4-online-atol-ru_4179
ATOL_COMPANY_URL=https://v4.online.atol.ru
ATOL_COMPANY_EMAIL=email@atol.ru
ATOL_COMPANY_INN=5544332219