посочва съответната държава.

Ако fiscalCountryProperties се извличат чрез GET /api/v1/information/client/{clientId}/countryProperties, се посочва държавата, присвоена на съответния клиент.

Посочва дали в дадена страна се изисква сертифициране на компонент за фискализация или какво трябва да бъде сертифицирано.

„mandatory“ – Сертифицирането на системата нагоре по веригата (например касов апарат) е задължително. В този случай касовият апарат трябва да премине през процес на сертифициране или одобрение.

„miniPOS“ – Сертифицирането е задължително, но изискването се изпълнява чрез вече сертифициран компонент, който може да бъде интегриран в RetailForce Middleware.

„notNecessary“ – Не се изисква сертифициране на предходната система.

„true“ – в съответната държава данните трябва да се изпращат ред по ред, например към фискален принтер.

• понастоящем не се поддържа

„false“ – Интерфейс на базата на документи (без печат ред по ред).

• Връзката между системата нагоре по веригата и услугата за фискализация се осъществява чрез стандартни api крайни точки.

Определя типа на фискализацията.

"fiscalPrinter" – Фискализацията се извършва чрез сертифициран фискален принтер или сертифицирана фискална касова система.

• Това означава, че освен RetailForce system е необходим и фискален принтер. Възможно е той да трябва да бъде закупен от местен доставчик.

„online“ – Фискализация чрез онлайн системи на местните данъчни органи.

• Не се изисква допълнителен хардуер.

„signature“ – Фискализация чрез подписване на данните от касовите бележки с помощта на цифров сертификат, съхраняван в услугата за фискализация.

• В някои държави може да се наложи да се придобие квалифициран цифров сертификат, издаден от сертификационен орган (CA).

„signatureWithOnline“ – фискализация чрез създаване на подписи и предаване на данните онлайн към данъчните органи.

• Комбинация от двата гореспоменати вида.

Определя коя среда се поддържа:

"local" – локална инсталация на фискалното middleware (локално на POS системата, на сървъра на магазина и т.н.)

• Могат да се извършват api-извиквания към локално инсталираната фискална услуга:
  • http://localhost:7678/ в случай на REST имплементация, или
  • извикване на метод в случай на nuget имплементация.

„cloud“ – фискалният middleware е достъпен като хоствана облачна услуга на https://fiscalisation.retailforce.cloud/.

• Могат да се извършват api-извиквания към Cloud фискалната услуга.

Определя кои операционни системи/платформи се поддържат.

"linux"

• чрез Docker контейнер (REST реализация)

„windows“

• чрез Windows Service (REST имплементация) или
• чрез nuget имплементацию

"ios"

• чрез nuget реализация

"android"

• чрез nuget реализация, или
• Android Service (REST имплементация)

Посочва кои законови изисквания се поддържат и техните версии.

Например за Гърция: „myDATA v1.x.x“

Видове документи, които трябва да бъдат „фискализирани“ в съответната държава. Например, те трябва да бъдат обработени от предписания хардуерен компонент, подписани и т.н.

„documentTypes“, изброени под „fiscalDocumentTypes“, се обработват автоматично (например подписват се) в съответната държава от услугата за фискализация в съответствие със законите за фискализация.

Тези видове документи ТРЯБВА да бъдат предадени на службата за фискализация в съответната държава, при условие че системата нагоре по веригата („касов апарат“) ги поддържа.

Списък на видовете документи, поддържани във всяка държава.

В допълнение към „fiscalDocumentTypes“ типовете документи, изброени в „supportedDocumentTypes“, МОГАТ да бъдат предадени на фискалната служба.

Тези видове документи са т.нар. „нефискални“ документи, т.е. такива, които не са „фискализирани“ (например подписани).

Списък с видовете документи, които не се поддържат в съответната държава.

„DocumentTypes“, изброени в „notSupportedDocumentTypes“, не могат да бъдат предадени на услугата за фискализация в съответната държава.

Причините за това могат да бъдат техническа невъзможност или специфични за страната разпоредби/закони.

Ако „notSupportedDocumentType“ бъде изпратен към услугата за фискализация, тя ще отговори със съобщение за грешка („documentType not supported!“).

Системата на източника не трябва да допуска тези типове документи в съответната държава.

Списък на поддържаните (приемани) начини на плащане в съответната държава.

Тези начини на плащане могат да се използват в съответната държава.

Системата нагоре по веригата трябва да предлага на потребителя на касовия апарат само поддържаните начини на плащане в съответната държава.

Списък с начини на плащане, които не се поддържат (или не са разрешени) в съответната държава.

Системата нагоре по веригата трябва да изключва неподдържаните начини на плащане в съответната държава.

Списък с начини на плащане (PaymentTypes), при които надплащането на дължимата сума не е разрешено в съответната държава.

Примери:

Обща сума по касовия бон = 38,50 EUR

• Клиентът плаща 50 EUR с дебитна карта, защото иска рестото в брой.
• Клиентът плаща 50 EUR в брой и получава 11,50 EUR ресто (връчена ресто).

Тези транзакции не са разрешени в някои държави (т.е. не могат да бъдат изпратени към системата за фискализация).

Това означава, че сумите на плащанията („payment.amount“) трябва винаги да съответстват на брутната обща стойност на позициите („GrossValue“ на всички „positions“) и не могат да се прехвърлят отрицателни суми на плащания.

Списък с типовете бизнес случаи, поддържани във всяка страна.

Тези бизнес случаи могат да се използват в съответната държава, за разлика от notSupportedBusinessTransactionTypes.

Списък с типове бизнес случаи, които не се поддържат (или не са разрешени) в съответната държава.

Тези бизнес случаи не могат да се използват в съответната държава и трябва да бъдат премахнати от изходната система и да не се предават на фискалната служба.

Подробна информация за ставките на Vat, поддържани във всяка държава.

Този масив съдържа следната информация:

• Ставка на ДДС: „VatPercent“ / „VatPercent2“
• Вътрешен ID, използван за съпоставяне на съответната ставка на ДДС: „VatIdentification“
• Наименование на ставката на Vat: „caption“ / „Caption_EN“
• Исторически ставки на Vat с подробности за валидността („ValidFrom“ – „ValidTo“)

„не е задължително“ – Показването на клиента не е задължително (няма задължение).

„задължително (no-RF)“ – Показването на клиента е задължително, но не се контролира чрез RetailForce Middleware. Контролът се извършва автоматично от съответната система за фискализация (например автоматично от фискалния принтер).

„задължително (RF)“ – Използването на дисплей за клиента е задължително и се контролира чрез RetailForce Middleware.

• Дисплеят за клиента се контролира чрез функцията: POST /api/v1/transactions/display/{clientId}

„не е разрешено“ – Използването на дисплей за клиента е забранено в тази държава.

Посочва дали устройствата за въвеждане на данни трябва да бъдат регистрирани в съответната държава („true“ / „false“).

Устройствата за въвеждане на данни не са самостоятелни системи за регистриране. За повече информация вижте: Архитектури на електронните системи за регистриране (EAS)

„true“ – в съответната държава съществува изискване за водене на технически дневник (аудитен дневник) (в този случай включен в лиценза за радиочестоти).

• В този случай записите за техническите събития трябва да се изпращат към фискалната служба чрез
  • POST /api/v1/transactions/AuditLog , или
  • POST /api/v1/transactions/storeDocument („documentType“: „[1002] = AuditLog“)

„false“ – няма изискване за водене на технически дневник (не е включено в лиценза).

• Техническите събития МОГАТ да се записват, но това не е задължително.

"true" – в съответната държава препечатването на документ трябва задължително да се регистрира.

• Извикайте едно от следните:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, или

  • PUT /api/v1/transactions/reprintDocument

    задължително.

„false“ – Преиздаването на документ не е задължително да се регистрира.

„terminal“ – Документът може да бъде препечатан само на същия касов апарат, на който е бил издаден оригиналният документ.

„магазин“ – Препечатването на документ може да се извършва само в същия клон/магазин, в който е издаден и оригиналният документ.

• Функцията за препечатване в различни клонове трябва да бъде реализирана от системата нагоре по веригата.

„всички“ – Препечатването на документ може да се извърши както на друга касова система, така и в друг клон/магазин на същата компания.

• Функцията за препечатване в различни клонове трябва да бъде реализирана от системата нагоре по веригата.

„true“ – ежедневното приключване (Z-отчет) трябва да се генерира веднъж на ден.

• дневно приключване
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

"false" – няма изискване за дневно приключване.

Посочва периода от време от началото на дневния работен цикъл на касовия апарат, в рамките на който трябва да се извърши дневното приключване (например в рамките на 24 часа).

"-1" – не е зададено.

Посочете дали продажбите и връщанията могат да се записват едновременно на касов бон (документ).

„oneReceiptAllowed“ – разрешено (продажбите и връщанията могат да се показват смесено на една касова бележка).

• Продажби:
  • „позиции“ (тип 0 или 1) с положителни стойности,
• Връщания:
  • „positions“ (тип 0 или 1) с отрицателни стойности и
  • зададен „documentReference“.

„oneReceiptAllowedVat“ – докато сумата на Vat остава положителна, продажбите и връщанията могат да се записват на един (същия) касов бон.

„multiReceipt“ – продажбите и връщанията трябва да се записват на различни касови бележки.

• Преди предаването на данните към фискалната система, системата нагоре по веригата трябва автоматично да раздели продажбите и връщанията на различни транзакции.

„NoReturnAllowed“ – в съответната държава обработката на връщания чрез системата за фискализация не е възможна. В тези държави връщанията често се обработват чрез специални формуляри или подобни документи в счетоводния отдел.

Къде могат да бъдат върнати закупените артикули?

„terminal“ – Стоките могат да бъдат върнати само на същата каса (издаване на ваучер), на която е била извършена първоначалната продажба.

„store“ – Стоките могат да бъдат върнати само в същия филиал/магазин (място на издаване на касовия бон), където е била извършена първоначалната продажба.

„all“ – Стоките могат да бъдат върнати и в различни клонове на същата компания.

Референтен документ за връщания

„single“ — в случай на връщане може да се прави препратка само към ЕДИН предишен документ (продажбен документ за върнатите услуги или стоки).

• „documentReference“ се допуска само за един предварителен документ, или
• позоваване на ниво позиция („positionReference“) е допустимо само за един предварителен документ.

„multiple“ – в случай на връщане на стоки или услуги може да се прави позоваване на няколко предходни документа (няколко касови бележки, ако се връщат няколко услуги или стоки от няколко покупки). 

• „documentReference“ към няколко предишни документа, или
• позоваване към съответния предходен документ чрез „positionReference“ за отделната позиция от връщането.

Указва дали елементът „fiscalDocumentNumber“ от „fiscalResponse“ на съответната държава трябва да бъде отпечатан върху документите.

• Номерата на документите, прехвърлени от предходната система, се игнорират. Фискалната система (например принтерът) присвоява съответния номер на документа/ID-то на документа самостоятелно.

"true" – в съответната държава са разрешени добавки към цените на стоките или услугите.

• допълнителни такси:
  • „positions.discounts“ с ОТРИЦАТЕЛНИ стойности

"false" – Допълнителните такси върху цените не са разрешени.

Показва дали режимът за обучение/демонстрация на касовия апарат е разрешен в съответната държава

"true" – разрешено.

• Режим на обучение:
  • "IsTraining": true

„false“ – Касовият апарат не трябва да разполага с режим за обучение/демонстрация.

"true" – Сумата на отделните артикули се изчислява въз основа на нетната стойност (NetValue) (например в Québec/Канада).

"false" – Сумата на отделните артикули се изчислява въз основа на брутната стойност (GrossValue) (по подразбиране).

„true“ – Позициите, които са въведени, но впоследствие не са включени в документа, трябва да бъдат предадени в payload-то (JSON).

„false“ – Позициите, които са въведени, но впоследствие не са включени в документа, не е необходимо да се предават.

Определя типа на началния документ в съответната държава.

Приложимо само ако системата нагоре по веригата НЕ използва функцията GET /api/v1/transactions/document/{clientId}/start по време на инициализацията и сама генерира съответния начален документ.

Списък с видовете изплащания, поддържани в съответната държава.

Елементите, изброени под „supportedPayOutTypes“, могат/трябва да бъдат посочени за изплащания („documentType“: „[10] = PayOut“ и „BusinessTransactionType“: „[10] = PayOut“).

Показва дали ставките на Vat се изчисляват от съответния фискален модул на страната.

„true“ – Модулът за фискализация изчислява ставките на Vat.

„false“ – касовият апарат трябва да изчислява ставките на Vat.

Посочва дали и колко знака след десетичната запетая трябва да бъдат включени в JSON-документа, изпращан към фискалното middleware при изпращане на суми/общи суми.

Прилага се за всички спецификации на стойности в payload-а („GrossValue“, „NetValue“, „TaxValue“, „Amount“ и др.)