I den här artikeln lär du dig hur du hämtar information om ländernas olika egenskaper och hur du hittar dem i RetailForce Cloud. I slutet av artikeln finns en förklaring av de olika elementen i fiscalCountryProperties.
För att illustrera de nödvändiga implementeringarna för din implementering har landsegenskaperna (fiscalCountryProperties) skapats. Dessa visar vilka delar av det övergripande gränssnittet som åtminstone måste implementeras för varje land.
Landeegenskaperna finns tillgängliga från version V1.2.12 (med undantag för clienten från V1.2.13).
Hämta landsegenskaperna i Cloud
Du kan komma åt landsegenskaperna i Cloud-portalen via följande länk:
https://portal.retailforce.cloud/information/fiscal-country
För att komma åt fiscalCountryProperties måste du vara inloggad på portalen.
Sök efter landsegenskaperna i klienten
Landsinställningarna kan även hämtas via programmet. Detta gör det möjligt att reagera på olika landsinställningar i kassaprogrammet.
Exempel: en dokumenttyp är inte tillåten i ett land och stöds därför inte.
Hämta via direkt implementering (nuget)
För att hämta alla befintliga landsegenskaper för alla länder kan följande metod anropas:
List<IFiscalCountryProperties> TrustedFiscalModul.GetFiscalCountryPropertiesList()Hämta via client
REST-tjänst
I REST-tjänsten finns det två slutpunkter för att söka efter landsegenskaperna:
GET /api/v1/information/countryPropertiesDenna metod kan användas för att söka efter egenskaper för ett visst land.
/api/v1/information/client/{clientId}/countryPropertiesDenna metod kan användas för att hämta landegenskaperna för en client.
Fiscal Service-client
I Fiscal Service-klienten (.NET Standard 2.0 och .NET Framework 2) finns följande metoder för att hämta landsegenskaperna.
FiscalCountryProperties GetFiscalCountryProperties(FiscalCountry fiscalCountry)Denna metod kan användas för att hämta landsegenskaperna för ett land.
FiscalCountryProperties GetFiscalCountryProperties(Guid clientId)Denna metod kan användas för att hämta landsegenskaperna för en client.
fiscalCountryProperties – Förklaring
fiscalCountryProperties innehåller data som är rent informativa till sin natur, samt information som är relevant för implementeringen.
Informativ data är markerad med INFO i kolumnen ”Typ”. Data som bör beaktas vid implementering är markerad med ”RFI” (relevant för implementering).
| fiscalCountryProperties | Typ |
Beskrivning |
| fiscalCountry | INFO |
anger motsvarande land. Om fiscalCountryProperties hämtas via GET /api/v1/information/client/{clientId}/countryProperties, anges det land som tilldelats respektive klient. |
| countryModuleVersion | INFO |
Aktuell version av Trusted Fiscal Country Module inom middleware (relevant för länder där en specifik programvaruversion måste certifieras; t.ex. Frankrike). |
| certificationType | INFO |
Anger om certifiering av en skattehanteringskomponent krävs i ett land, eller vad som måste certifieras. ”mandatory” – Certifiering av det uppströms liggande systemet (t.ex. kassasystemet) är obligatorisk. I detta fall måste kassasystemet genomgå en certifierings- eller godkännandeprocess. "miniPOS" – Certifiering är obligatorisk, men uppfylls av en redan certifierad komponent som kan integreras i RetailForce Middleware. "notNecessary" – Ingen certifiering av det föregående systemet krävs. |
| fiscalLineInterface | RFI |
"true" – I det aktuella landet måste data skickas rad för rad, t.ex. till en skatteskrivare.
"false" – Dokumentbaserat gränssnitt (ingen utskrift rad för rad).
|
| fiscalisationType | INFO |
Anger typen av fiscalisation. "fiscalPrinter" – Fiscalisationen baseras på en certifierad fiscalprinter eller ett certifierat fiscalregistreringssystem.
"online" – Registrering via de lokala skattemyndigheternas onlinesystem.
"signature" – Fiscalisation genom att signera kvittodata med ett digitalt certifikat som lagras i fiscalisationstjänsten.
”signatureWithOnline” – Fiscalisation genom att skapa signaturer och överföra data online till skattemyndigheterna.
|
| stödda miljöer | RFI |
Anger vilken miljö som stöds: "local" – lokal installation av den skattemässiga middlewaren (lokalt på kassasystemet, på butiksservern osv.)
"cloud" – fiscal middleware finns tillgängligt som en molntjänst på https://fiscalisation.retailforce.cloud/.
|
| supportedPlatformTypes | RFI |
Anger vilka operativsystem/plattformar som stöds. "linux"
"windows"
"ios"
"android"
|
| lagstiftning som stöds | INFO |
Anger vilka lagkrav som stöds och deras versioner. T.ex. för Grekland: ”myDATA v1.x.x” |
| typer av skattedokument | RFI |
Dokumenttyper som ska ”fiskaliseras” i respektive land. De måste till exempel behandlas av den föreskrivna hårdvarukomponenten, signeras osv. ”documentTypes” som anges under ”fiscalDocumentTypes” behandlas automatiskt (t.ex. signeras) i respektive land av fiscaliseringstjänsten i enlighet med fiscaliseringslagstiftningen. Dessa dokumenttyper MÅSTE överföras till skattehanteringstjänsten i respektive land, förutsatt att det uppströms liggande systemet (”kassaregistret”) stöder dem. |
| supportedDocumentTypes | RFI |
Förteckning över dokumenttyper som stöds i varje land. Utöver "fiscalDocumentTypes" KAN de dokumenttyper som anges under "supportedDocumentTypes" överföras till fiscalisationstjänsten. Dessa dokumenttyper är så kallade ”icke-fiskala” dokument, dvs. sådana som inte är ”fiskaliserade” (t.ex. undertecknade). |
| notSupportedDocumentTypes | RFI |
Lista över dokumenttyper som inte stöds i respektive land. "DocumentTypes" som anges under "notSupportedDocumentTypes" kan inte överföras till skattehanteringstjänsten i respektive land. Orsakerna till detta kan vara tekniska hinder eller landspecifika bestämmelser/lagar. Om en ”notSupportedDocumentType” skickas till skatteregistreringstjänsten kommer den att svara med ett felmeddelande (”documentType not supported!”). Det uppströms liggande systemet bör inte tillåta dessa dokumenttyper i det aktuella landet. |
| stödda betalningstyper | RFI |
Lista över betalningsmetoder som stöds (accepteras) i respektive land. Dessa betalningsmetoder kan användas i respektive land. Uppströmsystemet bör endast erbjuda kassanvändaren de betalningsmetoder som stöds i respektive land. |
| notSupportedPaymentTypes | RFI |
Lista över betalningsmetoder som inte stöds (eller inte är tillåtna) i respektive land. Uppströmsystemet bör undertrycka betalningsmetoder som inte stöds i respektive land. |
| overpaymentNotAllowed | RFI |
Lista över betalningsmetoder (PaymentTypes) för vilka överbetalning av det belopp som ska betalas inte är tillåten i det berörda landet. Exempel: Kvittots summa = 38,50 EUR
Dessa transaktioner är inte tillåtna i vissa länder (vilket innebär att de inte kan skickas till skatteregistreringssystemet). Detta innebär att betalningsbeloppen ("payment.amount") alltid måste motsvara bruttosumman för varuposterna ("GrossValue" för alla "positions") och att inga negativa betalningsbelopp får överföras. |
| supportedBusinessTransactionTypes | RFI |
Lista över affärsslagstyper som stöds i respektive land. Dessa affärsfall kan användas i respektive land, till skillnad från notSupportedBusinessTransactionTypes. |
| notSupportedBusinessTransactionTypes | RFI |
Förteckning över affärsslag som inte stöds (eller inte är tillåtna) i respektive land. Dessa affärsfall kan inte användas i respektive land och bör undertryckas av källsystemet och inte överföras till skattetjänsten. |
| supportedVatDefinitions | RFI |
Detaljerad information om de mervärdesskattesatser som stöds i varje land. Denna matris innehåller följande information:
|
| companyIdentification | RFI |
Information om vilka företagsidentifierare som måste användas i respektive land. |
| customerDisplayMandatory | RFI |
”inte obligatoriskt” – Kundvisning krävs inte (ingen skyldighet). ”obligatoriskt (no-RF)” – Kundvisning är obligatorisk, men kontrolleras inte via RetailForce Middleware. Kontrollen utförs automatiskt av respektive skattesystem (t.ex. automatiskt av skatteskrivaren). "obligatoriskt (RF)" – Det är obligatoriskt att använda kunddisplayen och kontrollen sker via RetailForce Middleware.
”inte tillåtet” – Användning av kunddisplay är förbjuden i detta land. |
| terminalSlaveSupported | RFI |
Anger om inmatningsenheter måste registreras i respektive land ("true" / "false"). Inmatningsenheter är inte fristående registreringssystem. För mer information, se: Arkitekturer för elektroniska registreringssystem (EAS) |
| auditLogMandatory | RFI |
"true" – i respektive land finns ett krav på att föra en teknisk logg (revisionslogg) (i detta fall ingår den i RF-licensen).
"false" – det finns inget krav på att föra en teknisk logg (ingår inte i licensen).
|
| mustRecordDocumentReprint | RFI |
"true" – i det aktuella landet måste omtryck av ett dokument registreras obligatoriskt.
"false" – Utskrift av ett dokument behöver inte registreras som obligatorisk. |
| reprintAllowedDomain | RFI |
"terminal" – Ett dokument får endast skrivas ut på samma kassa där originaldokumentet utfärdades. "butik" – Utskrifter av ett dokument får endast göras inom samma filial/butik där även originaldokumentet utfärdades.
"all" – Ett dokument får återutskrivas på en annan kassa samt i en annan filial/butik inom samma företag.
|
| mustSendClosingPerDay | RFI |
"true" – en daglig avstämning (Z-rapport) måste genereras en gång om dagen.
"false" – inget krav på en daglig avstämning. |
| maximumHourIntervalForClosing | RFI |
Anger den tidsperiod sedan den senaste dagliga avslutningen inom vilken nästa dagliga avslutning måste ske (t.ex. inom 24 timmar). När denna period har löpt ut avvisar fiscalisationstjänsten alla dokument utom en daglig avslutning ("documentType": "[99] = EndOfDay") med HTTP-status 400 tills en daglig avslutning har lagrats. Ingen begränsning gäller före den första dagliga avslutningen. "-1" – inte angivet. |
| returnAndSaleBehavior | RFI |
Ange om försäljning och returer får registreras samtidigt på ett kvitto (dokument). "oneReceiptAllowed" – tillåtet (försäljning och returer kan visas blandat på ett kvitto).
"oneReceiptAllowedPerVatRate" – försäljning och returer kan registreras på ett enda (samma) kvitto så länge bruttosummorna för alla Vat-atser på kvittot har samma tecken (alla positiva eller alla negativa). "multiReceipt" – Försäljning och returer måste registreras på olika kvitton.
"NoReturnAllowed" – i det aktuella landet är det inte möjligt att hantera returer via skattehanteringssystemet. I dessa länder hanteras returer ofta via särskilda formulär eller liknande inom redovisningsavdelningen. |
| returnDomainAllowed | RFI |
Var får inköpta varor returneras? "terminal" – Varor får endast tas tillbaka vid samma kassa (utfärdande av kvitto) där den ursprungliga försäljningen ägde rum. "store" – Varor får endast returneras till samma filial/butik (kvittoutfärdningsställe) där det ursprungliga köpet gjordes. "all" – Varor kan även returneras till andra filialer inom samma företag. |
| returnReferenceBehavior | RFI |
Dokumentreferens för returer "single" – vid returer får hänvisning endast göras till ETT tidigare dokument (försäljningsdokument för de returnerade tjänsterna eller varorna).
"multiple" – vid returer får hänvisningar göras till flera tidigare dokument (flera försäljningskvitton om flera tjänster eller varor från flera köp returneras).
|
| printFiscalDocumentNumber | RFI |
Anger om elementet ”fiscalDocumentNumber” i ”fiscalResponse” för motsvarande land måste skrivas ut på dokumenten.
|
| taxFreeVat |
|
|
| getCloudArchiveAccessLicense |
|
Returnerar den nödvändiga licensen för molnarkivering av skattedata. |
| surchargesPossible | RFI |
"true" – i det aktuella landet är tilläggsavgifter på varor eller tjänster tillåtna.
"false" – Pristillägg är inte tillåtna. |
| trainingModeAllowed | RFI |
Anger om tränings-/demoläge stöds av skattehanteringstjänsten för respektive land "true" – tillåtet.
"false" – tränings-/demoläge stöds inte. Fiscalisationstjänsten avvisar alla dokument med "IsTraining": true (valideringsfel "Träningskvitto tillåts inte i detta land."). |
| netValuePositionCalculation | RFI |
"true" – Summan av de enskilda posterna beräknas utifrån nettobeloppet (NetValue) (t.ex. Québec/Kanada). "false" – Summan av de enskilda posterna beräknas utifrån bruttobeloppet (GrossValue) (standard). |
| mustSendCanceledPosition | RFI |
"true" – Poster som har matats in men som inte senare ingår i dokumentet måste överföras i JSON payload. "false" – Poster som har matats in men som inte senare ingår i dokumentet behöver inte överföras. Obs! För mer information, se artikeln ”Skicka positioner för borttagna poster”. |
| startDocumentType | RFI |
Anger typen av startdokument i det aktuella landet. Endast relevant om uppströmsystemet INTE använder funktionen GET /api/v1/transactions/document/{clientId}/start vid initialiseringen och själv genererar respektive startdokument. |
| supportedPayOutTypes | RFI |
Lista över utbetalningstyper som stöds i det aktuella landet. De poster som anges under ”supportedPayOutTypes” kan/måste anges för utbetalningar (”documentType”: ”[10] = PayOut” och ”BusinessTransactionType”: ”[10] = PayOut”). |
| notSupportedPayOutTypes | RFI |
Lista över utbetalningstyper som inte stöds (eller inte är tillåtna) i det aktuella landet. |
| fiscalModuleCalculatesTaxRates | RFI |
Anger om Vat-satserna beräknas av landets respektive skattemodul. "true" – Skattemodulen beräknar momssatserna. "false" – Kassaapparaten måste beräkna Vat-satserna. |
| storeNumberValidCharsRegex | RFI |
Tillåten reguljär uttryck för butiksnummer (filialnummer) |
| terminalNumberValidCharsRegex | RFI |
Tillåtet reguljära uttryck för terminalnumret (kassanummer) |
| fiscalRegions | RFI |
Angivelse av skatteområden, om detta är tillämpligt i det berörda landet. |
| decimaler | RFI |
Anger om och hur många decimaler som måste inkluderas i JSON-dokumentet till Fiscal Middleware vid sändning av belopp/totalbelopp. Gäller alla värdespecifikationer i payloaden ("GrossValue", "NetValue", "TaxValue", "Amount" osv.) |
| entityParameters |
|
Anger vilka parametrar som måste lagras för vilka portalobjekt. |
| legalForms | RFI |
Lista över juridiska företagsformer som finns i landet. |
| mustIndicateTipCompanyTipPayment |
Denna flagga anger om det i det aktuella landet krävs att betalningar avsedda som dricks markeras som sådana. Om fler än en betalning anges måste den genom vilken kunden betalar dricksen markeras med flaggan ”isTip” inställd på ”true”. Exempel: Fakturans totalsumma är 46,30 EUR; kunden betalar
För mer information, se artikeln: Delade betalningar för specifika ändamål. |
|
| itemTypeClassificationRequired | RFI |
I vissa länder krävs en mer detaljerad specifikation av vissa varor. Om värdet på denna egenskap är ”true” måste de värden som anges i `supportedItemTypeClassification` anges för de relevanta varorna i respektive land (egenskapen ItemTypeClassification måste anges i enlighet därmed i positionsobjektet). |
| supportedItemTypeClassification | RFI |
Anger vilka poster som måste märkas särskilt i respektive land (egenskapen ItemTypeClassification måste ställas in i enlighet därmed i positionsobjektet). |
| documentTypeBusinessTransactionTypeSupport | RFI |
Information om vilka BusinessTransactionTypes som kan kombineras med vilka documentTypes. |
Den här artikeln har översatts automatiskt.
Kommentarer
0 kommentarer
logga in för att lämna en kommentar.