V tomto článku sa dozviete, ako vyhľadávať rôzne vlastnosti krajín a ako ich nájsť v RetailForce Cloud. Na konci článku nájdete vysvetlenie jednotlivých prvkov fiscalCountryProperties.
Na ilustráciu potrebných implementácií pre vašu implementáciu boli vytvorené vlastnosti krajín (fiscalCountryProperties). Tie ukazujú, ktoré časti celkového rozhrania musia byť pre každú krajinu minimálne implementované.
Vlastnosti krajín sú k dispozícii od verzie V1.2.12 (s výnimkou klienta od verzie V1.2.13).
Vyhľadávanie vlastností krajín v Cloud
K vlastnostiam krajín máte prístup v Cloud Portáli na nasledujúcom odkaze:
https://portal.retailforce.cloud/information/fiscal-country
Na prístup k fiscalCountryProperties musíte byť prihlásení do portálu.
Vyhľadávanie vlastností krajín v klientskom programe
Vlastnosti krajín je možné vyhľadávať aj prostredníctvom programu. To umožňuje reagovať na rôzne vlastnosti krajín v programe pokladne.
Príklad: určitý typ dokladu nie je v danej krajine povolený, a preto nie je podporovaný.
Vyhľadávanie prostredníctvom priamej implementácie (nuget)
Na vyžiadanie všetkých existujúcich vlastností krajín je možné použiť nasledujúcu metódu:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()Vyhľadávanie prostredníctvom klienta
REST služba
V službe REST sú k dispozícii 2 koncové body na vyhľadávanie vlastností krajín:
GET /api/v1/information/countryPropertiesTúto metódu je možné použiť na vyhľadanie vlastností krajiny pre konkrétnu krajinu.
/api/v1/information/client/{clientId}/countryPropertiesTúto metódu je možné použiť na vyhľadanie vlastností krajiny pre konkrétneho klienta.
Client služby Fiscal Service
V cliente služby Fiscal Service (.NET Standard 2.0 a .NET Framework 2) sú k dispozícii nasledujúce metódy na získanie vlastností krajiny.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)Túto metódu je možné použiť na získanie vlastností krajiny pre konkrétnu krajinu.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)Túto metódu je možné použiť na zistenie vlastností krajiny pre konkrétneho klienta.
fiscalCountryProperties – Vysvetlenie
fiscalCountryProperties obsahujú údaje, ktoré majú čisto informatívny charakter, ako aj informácie relevantné pre implementáciu.
Informatívne údaje sú v stĺpci „Type“ označené ako INFO. Údaje, ktoré by sa mali zohľadniť pri implementácii, sú označené ako „RFI“ (relevantné pre implementáciu).
| fiscalCountryProperties | Typ |
Popis |
| fiscalCountry | INFO |
označuje príslušnú krajinu. Ak sa vlastnosti fiscalCountryProperties vyžiadajú prostredníctvom GET /api/v1/information/client/{clientId}/countryProperties, určí sa krajina priradená príslušnému klientovi. |
| countryModuleVersion | INFO |
Aktuálna verzia modulu Trusted Fiscal Country v rámci middleware (relevantné pre krajiny, v ktorých musí byť certifikovaná konkrétna verzia softvéru; napr. Francúzsko). |
| certificationType | INFO |
Určuje, či je v danej krajine vyžadovaná certifikácia fiskálnej komponenty, alebo čo je potrebné certifikovať. „mandatory“ – Certifikácia nadradeného systému (napr. pokladnice) je povinná. V tomto prípade musí pokladnica prejsť certifikačným alebo schvaľovacím procesom. „miniPOS“ – Certifikácia je povinná, ale splňuje ju už certifikovaná zložka, ktorú je možné integrovať do RetailForce Middleware. „notNecessary“ – Certifikácia predchádzajúceho systému sa nevyžaduje. |
| fiscalLineInterface | RFI |
„true“ – v danej krajine sa údaje musia odosielať po riadkoch, napr. na daňovú tlačiareň.
„false“ – Rozhranie založené na dokumentoch (bez tlače riadok po riadku).
|
| fiscalisationType | INFO |
Určuje typ fiskalizácie. „fiscalPrinter“ – Fiskalizácia je založená na certifikovanej fiskálnej tlačiarni alebo certifikovanom systéme fiskálnej pokladnice.
„online“ – Fiskalizácia prostredníctvom online systémov miestnych daňových úradov.
„signature“ – Fiskalizácia prostredníctvom podpisu údajov na pokladničnom doklade pomocou digitálneho certifikátu uloženého vo fiskalizačnej službe.
„signatureWithOnline“ – Fiskalizácia vytvorením podpisov a online odoslaním údajov daňovým úradom.
|
| podporované prostredia | RFI |
Určuje, ktoré prostredie je podporované: „local“ – lokálna inštalácia fiskálneho middlewaru (lokálne v POS systéme, na serveri predajne atď.)
„cloud“ – fiškálny middleware je k dispozícii ako hostovaná cloudová služba na adrese https://fiscalisation.retailforce.cloud/.
|
| podporované typy platforiem | RFI |
Určuje, ktoré operačné systémy/platformy sú podporované. „linux“
„windows“
„ios“
„android“
|
| podporovaná legislatíva | INFO |
Určuje, ktoré právne požiadavky sú podporované a ich verzie. Napr. pre Grécko: „myDATA v1.x.x“ |
| typy daňových dokladov | RFI |
Typy dokumentov, ktoré majú byť v príslušnej krajine „fiskalizované“. Musia byť napríklad spracované predpísanou hardvérovou komponentou, podpísané atď. „documentTypes“ uvedené pod „fiscalDocumentTypes“ sú v príslušnej krajine automaticky spracované (napr. podpísané) službou fiskalizácie v súlade so zákonmi o fiskalizácii. Tieto typy dokumentov MUSIA byť odoslané do služby fiskalizácie v príslušnej krajine, za predpokladu, že ich podporuje nadradený systém („pokladňa“). |
| podporovanéTypyDokumentov | RFI |
Zoznam typov dokumentov podporovaných v jednotlivých krajinách. Okrem „fiscalDocumentTypes“ sa typy dokumentov uvedené v položke „supportedDocumentTypes“ MÔŽU odoslať do služby fiskalizácie. Tieto typy dokumentov sú tzv. „nefiškálne“ dokumenty, t. j. dokumenty, ktoré nie sú „fiškálne spracované“ (napr. podpísané). |
| nepodporované typy dokumentov | RFI |
Zoznam typov dokumentov, ktoré nie sú v danej krajine podporované. „DocumentTypes“ uvedené v položke „notSupportedDocumentTypes“ nemožno odoslať do služby fiskalizácie v príslušnej krajine. Dôvodom môže byť technická nemožnosť alebo predpisy/zákony špecifické pre danú krajinu. Ak sa „notSupportedDocumentType“ odošle do služby fiskalizácie, tá odpovie chybovou správou („documentType not supported!“). Nadriadený systém by nemal povoliť tieto typy dokumentov v príslušnej krajine. |
| podporované typy platieb | RFI |
Zoznam platobných metód podporovaných (akceptovaných) v príslušnej krajine. Tieto platobné metódy je možné používať v danej krajine. Nadriadený systém by mal používateľovi pokladne ponúkať iba platobné metódy podporované v príslušnej krajine. |
| nepodporované typy platieb | RFI |
Zoznam platobných metód, ktoré nie sú v danej krajine podporované (alebo povolené). Nadriadený systém by mal potlačiť platobné metódy, ktoré nie sú v danej krajine podporované. |
| overpaymentNotAllowed | RFI |
Zoznam platobných metód (PaymentTypes), pri ktorých nie je v danej krajine povolené preplatnenie dlžnej sumy. Príklady: Celková suma na pokladničnom bločku = 38,50 EUR
Tieto transakcie nie sú v niektorých krajinách povolené (t. j. nemôžu byť odoslané do systému fiskalizácie). To znamená, že platobné sumy („payment.amount“) musia vždy zodpovedať hrubej sume položiek („GrossValue“ všetkých „positions“) a nesmú sa prevádzať žiadne záporné platobné sumy. |
| podporované typy obchodných transakcií | RFI |
Zoznam typov obchodných prípadov podporovaných v jednotlivých krajinách. Tieto obchodné prípady je možné použiť v príslušnej krajine, na rozdiel od notSupportedBusinessTransactionTypes. |
| notSupportedBusinessTransactionTypes | RFI |
Zoznam typov obchodných prípadov, ktoré nie sú v príslušnej krajine podporované (alebo nie sú povolené). Tieto obchodné prípady sa v danej krajine nemôžu používať a zdrojový systém by ich mal potlačiť a neposielať do služby fiskalizácie. |
| supportedVatDefinitions | RFI |
Podrobné informácie o sadzbách Vat podporovaných v jednotlivých krajinách. Toto pole obsahuje nasledujúce informácie:
|
| companyIdentification | RFI |
Informácie o tom, ktoré identifikátory spoločnosti sa musia používať v príslušnej krajine. |
| zobrazenieZákazníkaPovinné | RFI |
„nie je povinné“ – Zobrazenie zákazníka nie je povinné (nie je to záväzné). „povinné (no-RF)“ – Zobrazenie zákazníka je povinné, ale nie je riadené prostredníctvom RetailForce Middleware. Riadenie sa vykonáva automaticky príslušným fiskalizačným systémom (napr. automaticky prostredníctvom fiskálnej tlačiarne). „povinné (RF)“ – Zobrazenie zákazníka je povinné a je riadené prostredníctvom RetailForce Middleware.
„neprípustné“ – Používanie zákazníckeho displeja je v tejto krajine zakázané. |
| terminalSlaveSupported | RFI |
Určuje, či musia byť vstupné zariadenia zaregistrované v príslušnej krajine („true“ / „false“). Vstupné zariadenia nie sú samostatnými záznamovými systémami. Ďalšie informácie nájdete v časti: Architektúry elektronických záznamových systémov (EAS) |
| auditLogMandatory | RFI |
„true“ – v príslušnej krajine platí povinnosť viesť technický denník (audit log) (v tomto prípade je súčasťou licencie RF).
„false“ – neexistuje požiadavka na vedenie technického denníka (nie je zahrnuté v licencii).
|
| mustRecordDocumentReprint | RFI |
„true“ – v príslušnej krajine sa dotlač dokumentu musí povinné zaznamenať.
„false“ – Opätovná tlač dokumentu nemusí byť povinná. |
| reprintAllowedDomain | RFI |
„terminal“ – Dokument sa môže opätovne vytlačiť iba na tej istej pokladni, na ktorej bol vystavený pôvodný dokument. „store“ – Opätovné vytlačenie dokumentu je možné vykonať iba v tej istej pobočke/predajni, kde bol vystavený aj pôvodný dokument.
„všetko“ – Opätovná tlač dokumentu sa môže vykonať na inej pokladni, ako aj v inej pobočke/predajni tej istej spoločnosti.
|
| mustSendClosingPerDay | RFI |
„true“ – raz denne sa musí vygenerovať denné uzávierka (Z-správa).
„false“ – denné uzávierky nie sú povinné. |
| maximumHourIntervalForClosing | RFI |
Uvádza časové obdobie od posledného denného uzávierky, v rámci ktorého musí prebehnúť ďalšia denná uzávierka (napr. do 24 hodín). Po uplynutí tohto obdobia služba fiskalizácie odmietne každý dokument okrem dennej uzávierky („documentType“: „[99] = EndOfDay“) so stavom HTTP 400, kým nebude denná uzávierka uložená. Pred prvou dennou uzávierkou neplatí žiadne obmedzenie. „-1“ – nie je nastavené. |
| returnAndSaleBehavior | RFI |
Určuje, či je možné na pokladničnom doklade (dokumente) zaznamenať predaj a vrátenie tovaru súčasne. „oneReceiptAllowed“ – povolené (predaj a vrátenie tovaru sa môžu uvádzať spolu na jednej pokladničnej stvrtenke).
„oneReceiptAllowedPerVatRate“ – predaj a vrátenie tovaru môžu byť zaznamenané na jednej (tej istej) pokladničnej stvrtenke, pokiaľ majú hrubé súčty všetkých sadzieb Vat na stvrtenke rovnaké znamienko (všetky kladné alebo všetky záporné). „multiReceipt“ – predaj a vrátenie tovaru musia byť zaznamenané na rôznych potvrdeniach.
„NoReturnAllowed“ – v danej krajine nie je možné spracovávať vrátenia tovaru prostredníctvom fiskalizačného systému. V týchto krajinách sa vrátenia tovaru často spracúvajú prostredníctvom špeciálnych formulárov alebo podobných dokumentov v účtovnom oddelení. |
| returnDomainAllowed | RFI |
Kde je možné vrátiť zakúpený tovar? „terminal“ – tovar je možné vrátiť iba na tej istej pokladni (vydanie potvrdenia), na ktorej bol pôvodný predaj realizovaný. „store“ – tovar je možné vrátiť iba v tej istej pobočke/predajni (vydanie dokladu), kde bol pôvodne predaný. „all“ – Tovar je možné vrátiť aj v iných pobočkách tej istej spoločnosti. |
| returnReferenceBehavior | RFI |
Referenčný dokument pre vrátenie tovaru „single“ – v prípade vrátenia tovaru sa môže odkazovať iba na JEDEN predchádzajúci dokument (predajný doklad o vrátených službách alebo tovare).
„multiple“ – v prípade vrátenia tovaru je možné uvádzať odkazy na viacero predchádzajúcich dokumentov (viacero predajných dokladov, ak sa vracia viacero služieb alebo tovaru z viacerých nákupov).
|
| printFiscalDocumentNumber | RFI |
Určuje, či sa má na dokladoch vytlačiť prvok „fiscalDocumentNumber“ z „fiscalResponse“ príslušnej krajiny.
|
| taxFreeVat |
|
|
| getCloudArchiveAccessLicense |
|
Vráti potrebnú licenciu na archiváciu daňových údajov v cloude. |
| surchargesPossible | RFI |
„true“ – v danej krajine sú povolené príplatky za tovary alebo služby.
„false“ – Cenové príplatky nie sú povolené. |
| trainingModeAllowed | RFI |
Uvádza, či služba fiskalizácie pre príslušnú krajinu podporuje tréningový/demo režim „true“ – povolené.
„false“ – režim školenia/ukážkový režim nie je podporovaný. Služba fiskalizácie odmietne každý doklad s „IsTraining“: true (chyba validácie „Potvrdenka v režime školenia nie je v tejto krajine povolená.“). |
| netValuePositionCalculation | RFI |
„true“ – Suma jednotlivých položiek sa vypočíta na základe čistej sumy (NetValue) (napr. Québec/Kanada). „false“ – Suma jednotlivých položiek sa vypočíta na základe hrubej sumy (GrossValue) (predvolené nastavenie). |
| mustSendCanceledPosition | RFI |
„true“ – Položky, ktoré boli zadané, ale následne neboli zahrnuté do dokumentu, musia byť odoslané v payloade (JSON). „false“ – Položky, ktoré boli zadané, ale následne neboli zahrnuté do dokumentu, sa nemusia odosielať. Poznámka: Ďalšie informácie nájdete v článku „Odosielanie pozícií vymazaných položiek“. |
| startDocumentType | RFI |
Určuje typ počiatočného dokumentu v príslušnej krajine. Je relevantné len vtedy, ak nadriadený systém počas inicializácie NEPOUŽÍVA funkciu GET /api/v1/transactions/document/{clientId}/start a príslušný počiatočný dokument generuje sám. |
| podporované typy výplat | RFI |
Zoznam typov výplat podporovaných v príslušnej krajine. Položky uvedené v „supportedPayOutTypes“ môžu/musia byť špecifikované pre výplaty („documentType“: „[10] = PayOut“ a „BusinessTransactionType“: „[10] = PayOut“). |
| notSupportedPayOutTypes | RFI |
Zoznam typov výplat, ktoré nie sú v danej krajine podporované (alebo nie sú povolené). |
| fiscalModuleCalculatesTaxRates | RFI |
Uvádza, či sadzby Vat vypočítava príslušný fiskalizačný modul danej krajiny. „true“ – Sada pre daňové účtovníctvo vypočítava sadzby DPH. „false“ – sadzby Vat musí vypočítať pokladňa. |
| regex platných znakov čísla predajne | RFI |
Povolený regulárny výraz pre číslo predajne (číslo pobočky) |
| terminalNumberValidCharsRegex | RFI |
Povolený regulárny výraz pre číslo terminálu (číslo pokladne) |
| fiscalRegions | RFI |
Uvedenie daňových regiónov, ak je to v danej krajine relevantné. |
| počet desatinných miest | RFI |
Určuje, či a koľko desatinných miest sa musí uviesť v dokumente JSON pre Fiscal Middleware pri odosielaní súm / súčtov. Platí pre všetky špecifikácie hodnôt v payload („GrossValue“, „NetValue“, „TaxValue“, „Amount“ atď.) |
| entityParameters |
|
Určuje, ktoré parametre sa musia ukladať pre ktoré entity portálu. |
| legalForms | RFI |
Zoznam právnych foriem spoločností dostupných v danej krajine. |
| mustIndicateTipCompanyTipPayment |
Táto flag označuje, či je v príslušnej krajine povinnosťou označiť platby určené ako spropitné. Ak je špecifikovaná viac ako jedna platba, tá, prostredníctvom ktorej zákazník platí spropitné, musí byť označená flagom „isTip“ nastaveným na hodnotu „true“. Príklad: Celková suma faktúry je 46,30 EUR; zákazník zaplatí
Ďalšie informácie nájdete v článku: Rozdelené platby na konkrétne účely. |
|
| itemTypeClassificationRequired | RFI |
V niektorých krajinách sa vyžaduje podrobnejšia špecifikácia určitých položiek. Ak je hodnota tejto vlastnosti „true“, pre príslušné položky v danej krajine musia byť nastavené hodnoty uvedené v `supportedItemTypeClassification` (vlastnosť ItemTypeClassification musí byť zodpovedajúcim spôsobom nastavená v objekte positions). |
| supportedItemTypeClassification | RFI |
Určuje, ktoré položky musia byť v príslušnej krajine osobitne označené (v objekte positions musí byť zodpovedajúcim spôsobom nastavená vlastnosť ItemTypeClassification). |
| documentTypeBusinessTransactionTypeSupport | RFI |
Informácie o tom, ktoré typy BusinessTransactionTypes je možné kombinovať s ktorými typmi dokumentov (documentTypes). |
Tento článok bol preložený automaticky.
Príspevky
0 komentárov
Ak chcete napísať komentár, prihlásiť sa.