В тази статия ще научите как да извличате различните свойства на държавите, както и как да ги откривате в RetailForce Cloud. В края на статията ще намерите обяснение на различните елементи на fiscalCountryProperties.
За да илюстрираме необходимите имплементации за вашата реализация, бяха създадени свойствата на държавите (fiscalCountryProperties). Те показват кои части от цялостния интерфейс трябва да бъдат имплементирани като минимум за всяка държава.
Свойствата на държавите са достъпни от версия V1.2.12 (с изключение на client версията от V1.2.13).
Заявка за свойствата на държавите в Cloud
Достъп до свойствата на държавите може да се получи в Cloud Portal на следния линк:
https://portal.retailforce.cloud/information/fiscal-country
За да получите достъп до fiscalCountryProperties, трябва да сте влезли в портала.
Заявка за свойствата на държавите в клиента
Свойствата на държавите могат да се търсят и чрез програмата. Това дава възможност да се реагира на различни свойства на държавите в програмата за касов апарат.
Пример: даден тип документ не е разрешен в дадена държава и следователно не се поддържа.
Заявка чрез директна имплементация (nuget)
За да се извлекат всички съществуващи свойства на всички държави, може да се извика следният метод:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()Запитване чрез client
REST услуга
В REST услугата има 2 крайни точки за търсене на свойствата на държавите:
GET /api/v1/information/countryPropertiesТози метод може да се използва за търсене на свойствата на дадена държава.
/api/v1/information/client/{clientId}/countryPropertiesТози метод може да се използва за извличане на характеристиките на държавата за даден клиент.
Client on Fiscal Service
В клиента на фискалната услуга (.NET Standard 2.0 и .NET Framework 2) има следните методи за извличане на свойствата на държавата.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)Този метод може да се използва за извличане на свойствата на дадена държава.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)Този метод може да се използва за извличане на свойствата на държавата за даден клиент.
fiscalCountryProperties – Обяснение
fiscalCountryProperties съдържа данни, които са чисто информационни по характер, както и информация, свързана с внедряването.
Информативните данни са отбелязани с INFO в колоната „Type“. Данните, които трябва да се вземат предвид при имплементирането, са отбелязани с „RFI“ (relevant for implementation).
| fiscalCountryProperties | Тип |
Описание |
| fiscalCountry | INFO |
посочва съответната държава. Ако fiscalCountryProperties се извличат чрез GET /api/v1/information/client/{clientId}/countryProperties, се посочва държавата, присвоена на съответния клиент. |
| countryModuleVersion | INFO |
Текуща версия на модула „Trusted Fiscal Country“ в middleware (от значение за държави, в които определена версия на софтуера трябва да бъде сертифицирана; например Франция). |
| certificationType | ИНФО |
Посочва дали в дадена страна се изисква сертифициране на компонент за фискализация или какво трябва да бъде сертифицирано. „mandatory“ – Сертифицирането на системата нагоре по веригата (например касов апарат) е задължително. В този случай касовият апарат трябва да премине през процес на сертифициране или одобрение. „miniPOS“ – Сертифицирането е задължително, но изискването се изпълнява чрез вече сертифициран компонент, който може да бъде интегриран в RetailForce Middleware. „notNecessary“ – Не се изисква сертифициране на предходната система. |
| fiscalLineInterface | RFI |
„true“ – в съответната държава данните трябва да се изпращат ред по ред, например към фискален принтер.
„false“ – Интерфейс на базата на документи (без печат ред по ред).
|
| fiscalisationType | INFO |
Определя типа на фискализацията. "fiscalPrinter" – Фискализацията се извършва чрез сертифициран фискален принтер или сертифицирана система за фискални касови апарати.
„online“ – Фискализация чрез онлайн системи на местните данъчни органи.
„signature“ – Фискализация чрез подписване на данните от касовите бележки с помощта на цифров сертификат, съхранен в услугата за фискализация.
„signatureWithOnline“ – фискализация чрез създаване на подписи и предаване на данни онлайн към данъчните органи.
|
| поддържани среди | RFI |
Определя коя среда се поддържа: "local" – локална инсталация на фискалното middleware (локално на POS системата, на сървъра на магазина и т.н.)
„cloud“ – фискалният middleware е достъпен като хоствана облачна услуга на https://fiscalisation.retailforce.cloud/.
|
| поддържани типове платформи | RFI |
Определя кои операционни системи/платформи се поддържат. „linux“
„windows“
"ios"
"android"
|
| поддържано законодателство | ИНФОРМАЦИЯ |
Указва кои законови изисквания се поддържат и техните версии. Например за Гърция: „myDATA v1.x.x“ |
| типове фискални документи | RFI |
Видове документи, които трябва да бъдат „фискализирани“ в съответната държава. Например, те трябва да бъдат обработени от предписания хардуерен компонент, подписани и т.н. „documentTypes“, изброени под „fiscalDocumentTypes“, се обработват автоматично (например подписват се) в съответната държава от службата за фискализация в съответствие със законите за фискализация. Тези видове документи ТРЯБВА да бъдат предадени на службата за фискализация в съответната държава, при условие че системата нагоре по веригата („касов апарат“) ги поддържа. |
| поддържаниВидовеДокументи | RFI |
Списък на видовете документи, поддържани във всяка държава. В допълнение към „fiscalDocumentTypes“ типовете документи, изброени в „supportedDocumentTypes“, МОГАТ да бъдат предадени на фискалната служба. Тези видове документи са т.нар. „нефискални“ документи, т.е. такива, които не са „фискализирани“ (например подписани). |
| неподдържани типове документи | RFI |
Списък с видовете документи, които не се поддържат в съответната държава. „DocumentTypes“, изброени в „notSupportedDocumentTypes“, не могат да бъдат предадени на услугата за фискализация в съответната държава. Причините за това могат да бъдат техническа невъзможност или специфични за страната разпоредби/закони. Ако „notSupportedDocumentType“ бъде изпратен към услугата за фискализация, тя ще отговори със съобщение за грешка („documentType не се поддържа!“). Системата на източника не трябва да допуска тези типове документи в съответната държава. |
| поддържаниВидовеПлащания | RFI |
Списък на поддържаните (приемани) начини на плащане в съответната държава. Тези начини на плащане могат да се използват в съответната държава. Системата нагоре по веригата трябва да предлага на потребителя на касовия апарат само поддържаните начини на плащане в съответната държава. |
| неподдържаниНачиниНаПлащане | RFI |
Списък с начини на плащане, които не се поддържат (или не са разрешени) в съответната държава. Системата нагоре по веригата трябва да изключва неподдържаните начини на плащане в съответната държава. |
| overpaymentNotAllowed | RFI |
Списък с начини на плащане (PaymentTypes), при които надплащането на дължимата сума не е разрешено в съответната държава. Примери: Обща сума по касовия бон = 38,50 EUR
Тези транзакции не са разрешени в някои държави (т.е. не могат да бъдат изпратени към системата за фискализация). Това означава, че сумите на плащанията („payment.amount“) трябва винаги да съответстват на брутната обща стойност на позициите („GrossValue“ на всички „positions“) и не могат да се прехвърлят отрицателни суми на плащания. |
| поддържани типове бизнес транзакции | RFI |
Списък с типовете бизнес случаи, поддържани във всяка страна. Тези бизнес случаи могат да се използват в съответната държава, за разлика от notSupportedBusinessTransactionTypes. |
| неподдържани типове бизнес транзакции | RFI |
Списък с типове бизнес случаи, които не се поддържат (или не са разрешени) в съответната държава. Тези бизнес случаи не могат да се използват в съответната държава и трябва да бъдат блокирани от изходната система и да не се предават на фискалната служба. |
| supportedVatDefinitions | RFI |
Подробна информация за ставките на Vat, поддържани във всяка държава. Този масив съдържа следната информация:
|
| companyIdentification | RFI |
Информация за това кои идентификатори на дружества трябва да се използват в съответната държава. |
| customerDisplayMandatory | RFI |
„не е задължително“ – Показването на клиента не е задължително (няма задължение). „задължително (без RF)“ – Показването на клиента е задължително, но не се контролира чрез RetailForce Middleware. Контролът се извършва автоматично от съответната система за фискализация (например автоматично от фискалния принтер). „задължително (RF)“ – Използването на дисплей за клиента е задължително и се контролира чрез RetailForce Middleware.
„не е разрешено“ – Използването на дисплей за клиента е забранено в тази държава. |
| terminalSlaveSupported | RFI |
Посочва дали устройствата за въвеждане на данни трябва да бъдат регистрирани в съответната държава („true“ / „false“). Устройствата за въвеждане на данни не са самостоятелни системи за запис. За повече информация вижте: Архитектури на електронните системи за запис (EAS) |
| auditLogMandatory | RFI |
„true“ – в съответната държава съществува изискване за водене на технически дневник (аудитен дневник) (в този случай включен в лиценза за радиочестоти).
„false“ – няма изискване за водене на технически дневник (не е включено в лиценза).
|
| mustRecordDocumentReprint | RFI |
"true" – в съответната държава препечатването на документ трябва задължително да се регистрира.
„false“ – Преиздаването на документ не е задължително да се регистрира. |
| reprintAllowedDomain | RFI |
„terminal“ – Документът може да бъде препечатан само на същата касова система, на която е бил издаден оригиналният документ. „магазин“ – Препечатването на документ може да се извършва само в същия клон/магазин, в който е издаден и оригиналният документ.
„всички“ – Препечатването на документ може да се извърши както на друга касова система, така и в друг клон/магазин на същата компания.
|
| mustSendClosingPerDay | RFI |
„true“ – ежедневното приключване (Z-отчет) трябва да се генерира веднъж на ден.
"false" – няма изискване за дневно приключване. |
| maximumHourIntervalForClosing | RFI |
Посочва периода от време от последното дневно приключване, в рамките на който трябва да се извърши следващото дневно приключване (например в рамките на 24 часа). След изтичането на този период услугата за фискализация отхвърля всеки документ, с изключение на дневното приключване („documentType”: „[99] = EndOfDay”), със статус HTTP 400, докато не бъде съхранено дневно приключване. Преди първото дневно приключване не се прилага ограничение. „-1“ – не е зададено. |
| returnAndSaleBehavior | RFI |
Посочете дали продажбите и връщанията могат да се записват едновременно на касов бон (документ). „oneReceiptAllowed“ – разрешено (продажбите и връщанията могат да се показват смесено на една касова бележка).
„oneReceiptAllowedPerVatRate“ – продажбите и връщанията могат да се записват на една (същата) разписка, стига брутните суми на всички ставки на Vat в разписката да имат един и същ знак (всички положителни или всички отрицателни). „multiReceipt“ – продажбите и връщанията трябва да се записват на различни касови бележки.
„NoReturnAllowed“ – в съответната държава обработката на връщания чрез системата за фискализация не е възможна. В тези държави връщанията често се обработват чрез специални формуляри или подобни документи в счетоводния отдел. |
| returnDomainAllowed | RFI |
Къде могат да бъдат върнати закупените артикули? „terminal“ – Стоките могат да бъдат върнати само на същата каса (издаване на ваучер), на която е била извършена първоначалната продажба. „store“ – Стоките могат да бъдат върнати само в същия филиал/магазин (място на издаване на касовия бон), където е била извършена първоначалната продажба. „all“ – Стоките могат да бъдат върнати и в различни клонове на същата компания. |
| returnReferenceBehavior | RFI |
Референтен документ за връщания „single“ — в случай на връщане може да се прави препратка само към ЕДИН предишен документ (продажбен документ за върнатите услуги или стоки).
„multiple“ – в случай на връщане на стоки или услуги може да се прави позоваване на няколко предходни документа (няколко касови бележки, ако се връщат няколко услуги или стоки от няколко покупки).
|
| printFiscalDocumentNumber | RFI |
Указва дали елементът „fiscalDocumentNumber“ от „fiscalResponse“ на съответната държава трябва да бъде отпечатан върху документите.
|
| taxFreeVat |
|
|
| getCloudArchiveAccessLicense |
|
Връща необходимия лиценз за архивиране в Cloud на фискални данни. |
| surchargesPossible | RFI |
„true“ – в съответната държава са разрешени добавки към цените на стоките или услугите.
"false" – Допълнителните такси върху цените не са разрешени. |
| trainingModeAllowed | RFI |
Показва дали режимът на обучение/демонстрация се поддържа от услугата за фискализация за съответната държава "true" – разрешено.
„false“ – режимът за обучение/демонстрация не се поддържа. Услугата за фискализация отхвърля всеки документ с „IsTraining“: true (грешка при валидиране „Разписката за обучение не е разрешена в тази държава.“). |
| netValuePositionCalculation | RFI |
"true" – Сумата на отделните позиции се изчислява въз основа на нетната стойност (NetValue) (например Québec/Канада). "false" – Сумата на отделните позиции се изчислява въз основа на брутната стойност (GrossValue) (по подразбиране). |
| mustSendCanceledPosition | RFI |
„true“ – Позициите, които са въведени, но впоследствие не са включени в документа, трябва да бъдат предадени в payload-то (JSON). „false“ – Позициите, които са въведени, но впоследствие не са включени в документа, не е необходимо да се предават. Забележка: За повече информация вижте статията „Изпращане на позиции на изтрити позиции“. |
| startDocumentType | RFI |
Определя типа на началния документ в съответната държава. Приложимо само ако системата нагоре по веригата НЕ използва функцията GET /api/v1/transactions/document/{clientId}/start по време на инициализацията и сама генерира съответния начален документ. |
| поддържани типове изплащания | RFI |
Списък с видовете изплащания, поддържани в съответната държава. Елементите, изброени под „supportedPayOutTypes“, могат/трябва да бъдат посочени за изплащания („documentType“: „[10] = PayOut“ и „BusinessTransactionType“: „[10] = PayOut“). |
| notSupportedPayOutTypes | RFI |
Списък с видове изплащания, които не се поддържат (или не са разрешени) в съответната държава. |
| fiscalModuleCalculatesTaxRates | RFI |
Показва дали ставките на Vat се изчисляват от съответния фискален модул на страната. „true“ – Модулът за фискализация изчислява ставките на Vat. „false“ – касовият апарат трябва да изчислява ставките на Vat. |
| регуларен израз за валидни символи в номера на магазина | RFI |
Допустим RegEx за номера на магазина (номера на клона) |
| terminalNumberValidCharsRegex | RFI |
Допустими RegEx за номера на терминала (номер на касовия апарат) |
| fiscalRegions | RFI |
Посочване на фискалните региони, ако това е приложимо в съответната държава. |
| десетични знаци на сумата | RFI |
Посочва дали и колко знака след десетичната запетая трябва да бъдат включени в JSON-документа, изпращан към фискалното middleware при изпращане на суми/общи суми. Прилага се за всички спецификации на стойности в payload-то („GrossValue“, „NetValue“, „TaxValue“, „Amount“ и др.) |
| entityParameters |
|
Определя кои параметри трябва да се съхраняват за кои обекти на портала. |
| legalForms | RFI |
Списък с юридическите форми на дружествата, налични в страната. |
| mustIndicateTipCompanyTipPayment |
Този флаг показва дали в съответната държава се изисква плащанията, предназначени за бакшиш, да бъдат съответно маркирани. Ако е посочено повече от едно плащане, това, чрез което клиентът плаща бакшиша, трябва да бъде маркирано с флага „isTip“, настроен на „true“. Пример: Общата сума по фактурата е 46,30 EUR; клиентът плаща
За допълнителна информация, моля, вижте статията: Разделени плащания за конкретни цели. |
|
| itemTypeClassificationRequired | RFI |
В някои държави се изисква по-подробна спецификация на определени артикули. Ако стойността на това свойство е „true“, стойностите, посочени в `supportedItemTypeClassification`, трябва да бъдат зададени за съответните артикули в съответната държава (свойството ItemTypeClassification трябва да бъде зададено съответно в обекта positions). |
| supportedItemTypeClassification | RFI |
Определя кои артикули трябва да бъдат специално маркирани в съответната държава (свойството ItemTypeClassification трябва да бъде зададено съответно в обекта positions). |
| documentTypeBusinessTransactionTypeSupport | RFI |
Информация за това кои BusinessTransactionTypes могат да се комбинират с кои documentTypes. |
Тази статия е преведена автоматично.
Коментари
0 коментара
Влезте в услугата, за да оставите коментар.