Сървърът Tanzania VFD REST API позволява на други програми и на други работни места с IncoPOS да издават фискални бележки в Танзания чрез Tanzania VFD на това работно място. Програмата изпраща фактурата към API, а сървърът я записва като продажба, подписва я при данъчната служба на Танзания (TRA) чрез системата за управление на електронни фискални устройства (EFDMS), печата бележката и връща фискалните данни. Списъкът със сървъри е в Сървъри, а полетата, които има всеки сървър, са в Добавяне, редакция и изтриване на сървъри.
Какво ви трябва
- Устройство Tanzania VFD, регистрирано в TRA, в Устройства на това работно място, и принтерът му за бележки.
- Лиценз на това работно място. Прозорецът показва „Изисква Basic или по-добър лиценз“.
- Свободен порт на това работно място, отворен в защитната му стена.
Настройте сървъра
- Отворете Редакция → Администриране → Сървъри… и натиснете Нов.
- Изберете Tanzania VFD REST API в Тип на сървъра:. Порт: получава 9030, а Базов път: получава /api/v1.
- Въведете Потребител: и Парола:, както и Администраторска парола: за отчетите.
- Изберете Използвайте HTTPS за криптирани връзки, вижте HTTPS.
- Натиснете Запис. Разрешете порта в защитната стена, когато IncoPOS попита.
| Поле | Какво прави |
|---|---|
| Порт: | Портът на API. Не може да го използва друг разрешен сървър на работното място. |
| Базов път: | Началото на всеки адрес на API, например http://192.168.1.10:9030/api/v1/invoices. Описанието на API се отваря на базовия път, последван от /swagger. |
| Потребител:, Парола: | Входът, който програмите изпращат с всяка заявка. Потребител: е задължително. С празна Парола: API приема заявки без вход. |
| Администраторска парола: | Когато е попълнена, списъкът с фактури, отчетите и генерирането на фактури изискват тази парола със същия потребител. |
| Използвайте HTTPS | API приема само криптирани връзки. Сертификат: показва сертификата на сървъра. |
Какво прави API
| Заявка | Какво прави |
|---|---|
| POST invoices | Записва фактурата като продажба и връща фискалните ѝ данни. Номер на фактура, изпратен преди, връща вече записаната продажба, без втора бележка. |
| GET invoices/{number} | Връща фискалните данни на записана фактура. |
| GET invoices, GET periodic-reports, GET zreports | Списъкът с фактури и отчетите за период. Изискват администраторската парола, когато е зададена. |
| POST zreports | Печата Z отчета и го изпраща в TRA. |
| POST generate-invoices | Издава фактура за обща сума. Изисква администраторската парола, когато е зададена. |
| GET registration | Връща регистрацията на устройството в TRA. |
Продажба от API отива в обекта по подразбиране. Клиентът се намира по име, телефон и документ или се добавя като партньор. Стоката се намира по име или код или се добавя като стока с Такса или услуга. ДДС групата идва от данъчния код на реда. Бележката се печата без прозорец на екрана. Когато устройството първо поиска дневния Z отчет, сървърът го печата и след това бележката. Фактура с дата преди днес се отказва с „Previous Date Provided“.
Други работни места
Друго работно място с IncoPOS може да подписва продажбите си през този сървър с устройство Tanzania VFD (via REST API Server) в Устройства: адресът на това работно място, портът и потребителят, паролата и базовият път на сървъра.
HTTPS
Когато запишете сървър с Използвайте HTTPS и без сертификат, IncoPOS използва сертификат, създаден по-рано на този компютър, или създава нов. Когато сървърът стартира, може да покаже „Сървър ‘…’ се нуждае от еднократна настройка на HTTPS. Това изисква администраторски права. Желаете ли да го направите сега?“. Натиснете Настрой сега и потвърдете въпроса на Windows. Ако откажете, сървърът не стартира. За друг сертификат натиснете бутона до Сертификат: и изберете сертификат.
Отстраняване на проблеми
| Проблем | Решение |
|---|---|
| „Потребителското име не може да бъде празно!“ | Въведете Потребител:. |
| „Сървърът ‘…’ не успя да стартира поради отказан достъп.“ | Windows не позволява на IncoPOS да слуша на порта. Натиснете Копиране на команда (Копиране на команди с HTTPS), изпълнете командите в Command Prompt, отворен като администратор, след това запишете сървъра отново или рестартирайте IncoPOS. |
| „Сървърът ‘…’ работи, но защитната стена може да блокира входящите връзки на порт …“ | Другите компютри не достигат до API. Натиснете Копиране на команда и изпълнете командата като администратор или разрешете порта в Windows Defender Firewall. |
| „HTTPS сертификатът на сървър ‘…’ не беше намерен. Моля, редактирайте сървъра и изберете сертификат.“ | Сертификатът е премахнат от Windows. Отворете сървъра и изберете сертификат или натиснете Изчистване и запишете, за да получите нов. |
| „Настройката на HTTPS за сървър ‘…’ не завърши.“ | Натиснете Копиране на команди и ги изпълнете като администратор, както казва съобщението. |
| API отговаря с 403 и LICENSE_ERROR | Работното място няма валиден лиценз за продажбата. Добавете лиценза. |