указује на одговарајућу земљу.

Ако се преко GET /api/v1/information/client/{clientId}/countryProperties упитују fiscalCountryProperties, наведена је земља додељена одговарајућем клијенту.

Одређује да ли је у некој земљи потребна сертификација компоненте фискализације, или шта треба сертификовати.

"mandatory" - Сертификација надређеног система (нпр. касе) је обавезна. У овом случају, каса мора проћи процес сертификације или одобрења.

"miniPOS" - Сертификација је обавезна, али се испуњава већ сертификованом компонентом која се може интегрисати у RetailForce middleware.

"notNecessary" - Сертификација претходног система није потребна.

"true" - у одговарајућој земљи, подаци се морају слати ред по ред, нпр. на фискални штампач.

• тренутно није подржано

"false" - интерфејс заснован на документима (без штампања по редовима).

• Имплементација између изворног система и услуге фискализације заснована је на стандардним API ендпоинтима.

Одређује тип фискализације.

"fiscalPrinter" - Фискализација се заснива на сертификованом фискалном штампачу или сертификованом систему фискалне касе.

• То значи да је, поред система RetailForce, потребан фискални штампач. Можда ће бити потребно да се набави од локалног добављача.

"online" - Фискализација преко онлајн система локалних пореских органа.

• није потребна додатна хардверска компонента.

"signature" - Фискализација потписивањем података о потврди о куповини коришћењем дигиталног сертификата који се налази у сервису за фискализацију.

• У неким земљама може бити потребно да се обезбеди квалификовани дигитални сертификат који издаје CA (издавач сертификата).

"signatureWithOnline" - Фискализација креирањем потписа и слањем података онлајн пореским органима.

• Комбинација два претходно поменута типа.

Наводи које окружење је подржано:

"local" - локална инсталација фискалног мидлвера (локално на ПОС систему, на серверу продавнице итд.)

• Позиви API-ја могу се упутити локално инсталираној служби за фискализацију:
  • http://localhost:7678/ у случају REST имплементације, или
  • позив методе у случају nuget имплементације.

"cloud" - фискални мидлвејр је доступан као хостована облачна услуга на https://fiscalisation.retailforce.cloud/.

• API позиви се могу упутити ка облачном сервису за фискализацију.

Наводи које оперативне системе/платформе подржава.

"linux"

• преко Docker контејнера (REST имплементација)

"windows"

• преко Windows сервиса (REST имплементација), или
• преко nuget имплементације

"ios"

• преко nuget имплементације

"android"

• преко нугет имплементације, или
• android сервис (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.

Листа типова пословних случајева који нису подржани (или нису дозвољени) у одговарајућој земљи.

Ови пословни случајеви не могу да се користе у одговарајућој земљи и требало би да их изворни систем заташка, а не пренесе на услугу фискализације.

Детаљне информације о стопама ПДВ-а које су подржане у свакој земљи.

Ова низа садржи следеће информације:

• Ставка ПДВ: "vatPercent" / "vatPercent2"
• Унутрашњи ИД који се користи за повезивање одговарајуће стопе ПДВ-а: "vatIdentification"
• Назив стопе ПДВ-а: "caption" / "caption_EN"
• Историјске стопе ПДВ-а са детаљима важења ("validFrom" - "validTo")

"није обавезно" - Приказ купца није потребан (нема обавезе).

"обавезно (без-RF)" - Приказ купца је обавезан, али се не контролише преко RetailForce Middleware. Контрола се врши аутоматски одговарајућим фискализационим системом (нпр. аутоматски фискалним штампачем).

"mandatory (RF)" - Обавезно је користити дисплеј купца и он се контролише преко RetailForce middleware-а.

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

"not allowed" - Коришћење дисплеја за купца је забрањено у овој земљи.

Наводи да ли улазни уређаји морају бити регистровани у одговарајућој земљи ("true" / "false").

Улазни уређаји нису самостални системи за снимање. За више информација погледајте: Архитектуре електронских система за снимање (EAS)

"true" - у одговарајућој земљи постоји обавеза вођења техничког дневника (лог ревизије) (у овом случају укључен у RF лиценцу).

• У овом случају, уноси техничких догађаја морају бити послати сервису за фискализацију преко
  • 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" - Документ се може поново штампати само на истом терминалу на којем је издат оригинални документ.

"store" - Поновна штампа документа може се вршити само у истој филијали/продавници у којој је и издаван оригинални документ.

• Функцију поновног штампања преко више филијала мора да имплементира изворни систем.

"all" - Поновно штампање документа може се извршити на другом благајном, као и у другој филијали/продавници исте компаније.

• Функција поновног штампања кроз више филијала мора бити имплементирана у надређеном систему.

"true" - дневно затварање (Z-извештај) мора да се генерише једном дневно.

• дневна завршна обрада
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = Крај дана"

"false" - нема захтева за дневно затварање.

Указује временски период од дневног отварања касе у којем мора да се изврши дневно затварање (нпр. у року од 24 сата).

"-1" - није подешено.

Наведите да ли се продаје и поврати могу евидентирати истовремено на једном рачуну (документу).

"oneReceiptAllowed" - дозвољено (продаја и повраћај могу бити приказани помешани на једном рачуну).

• Продаја:
  • "positions" (тип 0 или 1) са позитивним вредностима,
• Враћања:
  • "positions" (тип 0 или 1) са негативним вредностима и
  • подешено "documentReference".

"oneReceiptAllowedVat" - све док износ ПДВ-а остаје позитиван, продаја и повраћај могу бити евидентирани на једном (истом) рачуну.

"multiReceipt" - Продаја и повраћај морају бити евидентирани на различитим потврдама о плаћању.

• Пре него што се подаци пренесу сервису за фискализацију, надређени систем мора аутоматски раздвојити продају и повраћај у различите трансакције.

"NoReturnAllowed" - у одговарајућој земљи обрада повраћаја преко система фискализације није могућа. У тим земљама повраћаји се често обрађују путем посебних образаца или слично у одељењу рачуноводства.

Где се могу вратити купљени артикли?

"terminal" - артикле се могу вратити само на истом благајном месту (издавање ваучера) на којем је извршена оригинална продаја.

"store" - артикли се могу вратити само у истој филијали/продавници (издавање ваучера) у којој је извршена оригинална продаја.

"all" - Предмети се такође могу вратити у друге филијале исте компаније.

Референца документа за повраћај

"single" - у случају повраћаја, референца може бити направљена само на ЈЕДАН претходни документ (продајни документ враћених услуга или робе).

• "documentReference" је дозвољено само за један припремни документ, или
• референца на нивоу ставке ("positionReference") дозвољена је само за један припремни документ.

"multiple" - у случају повраћаја, могуће је навести више претходних докумената (више потврда о продаји ако се враћа више услуга или робе из више куповина). 

• "documentReference" на више претходних докумената, или
• референца на одговарајући претходни документ путем "positionReference" на појединачном артиклу повраћаја.

Наводи да ли елемент "fiscalDocumentNumber" у "fiscalResonse" одговарајуће земље мора да се штампа на документима.

• Бројеви докумената пренети из горњег система се игноришу. Фискални систем (нпр. штампач) самостално додељује одговарајући број документа/ID документа.

"true" - у одговарајућој земљи дозвољене су доплате на робу или услуге.

• додатне накнаде:
  • "positions.discounts" са НЕГАТИВНИМ вредностима

"false" - Додатна увећања цене нису дозвољена.

Указује да ли је у одговарајућој земљи дозвољен режим обуке/демонстрације на каси

"true" - дозвољено.

• Режим обуке:
  • "isTraining": true

"false" - Каса не сме да има режим обуке/демо.

"true" - Збир појединачних ставки се израчунава на основу нето износа (netValue) (нпр. Квебек/Канада).

"false" - Збир појединачних ставки се израчунава на основу бруто износа (grossValue) (подразумјевано).

"true" - Ставке које су унете, а које накнадно нису укључене у документ, морају бити пренете у корисном терету (JSON).

"false" - Ставке које су унете, а које потом нису укључене у документ, не морају бити пренете.

Наводи тип почетног документа у одговарајућој земљи.

Релевантно само ако горњи систем НЕ користи функцију GET /api/v1/transactions/document/{clientId}/start током иницијализације и сам генерише одговарајући почетни документ.

Листа типова исплата подржаних у одговарајућој земљи.

Ставке наведене под "supportedPayOutTypes" могу/морају бити наведене за исплате ("documentType": "[10] = PayOut" и "businessTransactionType": "[10] = PayOut").

Указује да ли стопе ПДВ-а израчунава одговарајући модул фискализације те земље.

"true" - Модул фискализације израчунава стопе ПДВ-а.

"false" - фискална каса мора да израчунава стопе ПДВ-а.

Наводи да ли и колико децималних места треба укључити у JSON документ упућен фискалном мидлверу приликом слања износа/укупних вредности.

Примењује се на све спецификације вредности у корисном терету ("GrossValue", "NetValue", "TaxValue", "Amount" итд.)