Format	Adresă	Content-Type
JSON	`http://localhost:9203/fpservice/json/{Metodă}`	`application/json`
XML	`http://localhost:9203/fpservice/xml/{Metodă}`	`application/xml`
SOAP	`http://localhost:9203/fpservice/soap` · WSDL: `http://localhost:9203/fpservice?wsdl`	`text/xml`

Câmp	Tip	Descriere
`Date`	datetime	Momentul executării (tipăririi) tranzacţiei
`MEVDate`	datetime?	Data înregistrării în MEV; `null` dacă încă nu a ajuns acolo
`MEVID`	string	Identificatorul atribuit de MEV
`MEVResponse`	string	Răspunsul MEV la înregistrare
`TaskId`	int	Numărul tranzacţiei în coada serviciului
`ShiftId`	int	Tura (raportul zilnic)
`ShiftOrderId`	int	Numărul tranzacţiei în cadrul turei

Câmp	Tip	Descriere
`ClientEmail`	string	E-mailul clientului, pentru trimiterea copiei bonului. Obligatoriu la `DisplayType` = 3.
`ClientPhone`	string	Telefonul clientului, pentru trimiterea copiei prin SMS. Obligatoriu la `DisplayType` = 2.
`DisplayType`	int	Modul de prezentare a bonului: `0` — tipărire pe hârtie (implicit); `1` — cod QR pe ecranul cumpărătorului; `2` — SMS; `3` — e-mail
`FooterText`	string	Text liber tipărit la finalul bonului
`ForcePrint`	bool	Tipărire forţată pe hârtie — are prioritate faţă de toţi ceilalţi parametri şi faţă de setările modulului fiscal
`HeaderText`	string	Text liber tipărit la începutul bonului
`Lines`	BillLine[]	Liniile bonului — cel puţin una. Structura
`MyDiscountUid`	guid	Identificatorul clientului în sistemul de fidelizare MyDiscount
`Number`	string	Numărul bonului în sistemul extern de evidenţă
`Payments`	BillPayment[]	Plăţile bonului — cel puţin una. Structura
`PrinterURI`	string	URI-ul imprimantei POS conectate la serviciu pentru tipărirea bonului. Gol — se tipăreşte pe imprimanta implicită din Windows.
`Uid`	guid	GUID-ul bonului în sistemul extern. Gol — îl atribuie serviciul. Recomandat: trimiteţi-l mereu — face repetarea cererii sigură şi permite copia după propriul identificator.

Câmp	Tip	Descriere
`Code`	string	Codul produsului în sistemul extern
`Discount`	decimal	Reducere, în lei, pe suma totală a liniei
`Margin`	decimal	Adaos, în lei, pe suma totală a liniei
`Name`	string	Denumirea produsului; obligatorie
`Price`	decimal	Preţul unitar; mai mare decât 0
`Quantity`	decimal	Cantitatea; mai mare decât 0, până la 3 zecimale
`UnitCode`	int	Codul unităţii de măsură după clasificarea MEV: `1` — litri, `2` — metri cubi, `3` — produs care nu e combustibil, `0` — nespecificat. Contează doar la staţiile PECO — vezi regulile.
`UnitName`	string	Denumirea unităţii de măsură
`VAT`	string	Codul cotei TVA: o literă `A`–`Z` dintre cele configurate în serviciu (lista vine în GetServiceState → `VATRates`), sau `_` — fără TVA. Obligatoriu.

Câmp	Tip	Descriere
`Amount`	decimal	Suma plăţii; mai mare decât 0
`BankResponse`	string	Răspunsul terminalului bancar, la plata cu cardul
`Code`	string	Codul tipului de plată — vezi tipurile de plată
`RRN`	string	RRN-ul tranzacţiei bancare, la plata cu cardul

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`CloudSyncWarning`	bool	În coadă există cel puţin o sarcină care încă nu a fost transmisă în MEV
`ShiftId`	int	Identificatorul turei (raportului zilnic) în care s-a înregistrat sarcina
`ShiftOrderId`	int	Numărul de ordine al sarcinii în cadrul turei
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal
`TaskUid`	guid	Identificatorul unic al sarcinii — egal cu `Uid` din cerere sau atribuit automat dacă acesta lipsea
`QR`	string	Linkul spre portalul MEV pentru validarea bonului. Se afişează ca QR pe ecranul cumpărătorului sau se tipăreşte la finalul bonului.

Câmp	Tip	Descriere
`Amount`	decimal	Suma introdusă; valoare negativă — suma extrasă
`Reason`	int	Motivul extragerii: `0` — restituire, `1` — încasare. Câmpul e acceptat, dar versiunea curentă a serviciului nu îl prelucrează.
`ForcePrint`	bool	Tipărire forţată pe hârtie (are prioritate faţă de setările modulului fiscal)
`PrinterURI`	string	URI-ul imprimantei POS conectate la serviciu pentru tipărirea bonului de serviciu. Gol — se tipăreşte pe imprimanta implicită din Windows.

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`CloudSyncWarning`	bool	În coadă există cel puţin o sarcină care încă nu a fost transmisă în MEV
`ShiftId`	int	Identificatorul turei (raportului zilnic) în care s-a înregistrat sarcina
`ShiftOrderId`	int	Numărul de ordine al sarcinii în cadrul turei
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal
`TaskUid`	guid	Identificatorul unic al sarcinii (atribuit automat)

Câmp	Tip	Descriere
`CloseReport`	bool	`true` — raport cu închidere (Z), `false` — fără închidere (X)
`ForcePrint`	bool	Tipărire forţată pe hârtie. Raportul Z poate fi tipărit şi fără ea, dacă serviciul e configurat să tipărească mereu Z.
`PrinterURI`	string	URI-ul imprimantei POS conectate la serviciu pentru tipărirea raportului. Gol — se tipăreşte pe imprimanta implicită din Windows.

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`CloudSyncWarning`	bool	În coadă există cel puţin o sarcină care încă nu a fost transmisă în MEV
`ShiftId`	int	Identificatorul turei (raportului zilnic) în care s-a înregistrat sarcina
`ShiftOrderId`	int	Numărul de ordine al sarcinii în cadrul turei
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal
`TaskUid`	guid	Identificatorul unic al sarcinii (atribuit automat)

Câmp	Tip	Descriere
`Lines`	string[]	Rândurile de tipărit; cel puţin unul, altfel eroarea `20`
`PrinterURI`	string	URI-ul imprimantei POS conectate la serviciu pentru tipărirea textului. Gol — se tipăreşte pe imprimanta implicită din Windows.

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`CloudSyncWarning`	bool	În coadă există cel puţin o sarcină care încă nu a fost transmisă în MEV
`ShiftId`	int	Identificatorul turei (raportului zilnic) în care s-a înregistrat sarcina
`ShiftOrderId`	int	Numărul de ordine al sarcinii în cadrul turei
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal

Câmp	Tip	Descriere
`TaskId`	int	Numărul sarcinii din coadă care trebuie retipărită
`TaskUid`	guid	GUID-ul tranzacţiei — `Uid` trimis la înregistrare sau `TaskUid` primit în răspuns. E suficient unul dintre `TaskId` şi `TaskUid`; dacă vin amândouă, contează `TaskUid`.
`PrinterURI`	string	URI-ul imprimantei POS conectate la serviciu pentru tipărirea copiei. Gol — se tipăreşte pe imprimanta implicită din Windows.

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`TaskId`	int	Numărul de ordine al sarcinii în coada serviciului fiscal

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`GeneralError`	bool	Indicator general. `true` — înregistrarea tranzacţiilor e imposibilă acum; cauza o dau indicatorii de mai jos.
`ActivityType`	string	Activitatea casei: `ACPS` — comerţ, `ACPPGL` — staţie PECO, `ACPSPPGL` — PECO cu magazin. Determină codurile de plată şi unităţile admise.
`ServiceSerialNumber`	string	Numărul de înregistrare al serviciului în MEV
`ServiceDateTime`	datetime	Data/ora curentă a serviciului (ceasul calculatorului)
`FiscalMemorySerialNumber`	string	Numărul memoriei fiscale; gol dacă casa lucrează fără memorie fiscală
`FiscalMemoryError`	bool	Memoria fiscală răspunde cu eroare. Ridică `GeneralError`.
`FiscalMemoryFiscalized`	bool	Memoria fiscală e fiscalizată
`ServiceRegistrationInvalid`	bool	Înregistrarea în MEV e anulată sau dispozitivul e necunoscut cloud-ului
`ServiceSignatureInvalid`	bool	Cloud-ul a respins tranzacţii din cauza semnăturii digitale. Tranzacţiile sunt blocate.
`ServiceMEVSyncError`	bool	Cea mai veche tranzacţie netransmisă în MEV a depăşit limita offline
`ServiceDatabaseCorrupted`	bool	Integritatea bazei de date a serviciului e compromisă. Tranzacţiile sunt blocate.
`OfflineModeEnabled`	bool	Există tranzacţii netransmise în MEV de peste un minut, dar limita offline nu e încă depăşită
`OfflineHoursLimit`	int	Câte ore poate lucra casa cu tranzacţii netransmise. `0` — offline interzis. Pe casele cu memorie fiscală, dacă nu e setat, se aplică 72.
`FirstNotSyncedTransactionDate`	datetime?	Data celei mai vechi tranzacţii netransmise în MEV — de la ea se numără timpul offline
`FirstNotSyncedTransactionNumber`	int?	`TaskId` al acelei tranzacţii
`CurrentReportNumber`	int?	Numărul turei deschise (`ShiftId`); `null` dacă nu e deschisă nicio tură
`CurrentReportDate`	datetime?	Data deschiderii turei curente
`CurrentReport24HoursExpired`	bool	Au trecut peste 24 de ore de la deschiderea turei. Până la raportul Z bonurile sunt respinse cu eroarea `9`.
`VATRates`	VATRate[]	Cotele TVA configurate: `Code` (litera folosită în `Lines[].VAT`) şi `Percent`
`…`		`LastTransactionDate`, `LastTransactionMEVID`, `LastTransactionNumber`, `LastSyncedTransactionDate`, `ServiceDatetimeInvalid`, `FiscalMemoryReportNotWritten`, `PrinterUnavailable`, `PrinterHasJobsInQueue`, `PrinterIsOutOfPaper`, `CompanyState` — prezente în răspuns, dar versiunea curentă nu le completează. Nu vă bazaţi pe ele.

Câmp	Tip	Descriere
`onDate`	date (query)	Ziua, în formatul `YYYY-MM-DD`. Opţional.

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`Reports`	ReportHeader[]	Rapoartele găsite; câmpurile fiecăruia sunt mai jos
`· Date`	datetime	Data înregistrării raportului în modulul fiscal
`· MEVDate`	datetime	Data înregistrării raportului în MEV
`· MEVID`	string	Identificatorul atribuit de MEV
`· MEVResponse`	string	Răspunsul MEV la înregistrare
`· ShiftId`	int	Numărul turei (raportului zilnic)
`· ShiftOrderId`	int	Numărul sarcinii în cadrul turei
`· TaskId`	int	Numărul sarcinii în coadă
`· TaskUid`	guid	Identificatorul unic al sarcinii
`· TotalBill`	int	Numărul de bonuri fiscale din tură

Câmp	Tip	Descriere
`shiftID`	int (query)	Numărul turei — `ShiftId` din răspunsurile de înregistrare sau `CurrentReportNumber` din GetServiceState

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`Transactions`	TransactionHeader[]	Tranzacţiile; câmpurile fiecăreia sunt mai jos
`· Type`	int / enum	Tipul: `0` bon fiscal, `1` text nefiscal, `2` raport X, `3` raport Z, `5` extragere, `6` introducere, `11` copie, `12` bon de plată. În JSON — număr, în XML — nume (`Bill`, `BillNonFiscal`, `XReport`, `ZReport`, `WithdrawalOfFunds`, `SupplyWithMoney`, `PrintCopy`, `PaymentReceipt`).
`· TotalAmount`	decimal	Suma tranzacţiei
`· Date, MEVDate, MEVID, MEVResponse, TaskId, ShiftOrderId`		Ca în câmpurile comune. `ShiftId` şi `TaskUid` nu se completează aici.

Câmp	Tip	Descriere
`transactionId`	int (query)	`TaskId` al tranzacţiei — cel primit la înregistrare sau din GetTransactions

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`FiscalReceipt`	FiscalReceipt	Bonul; câmpurile sunt mai jos
`· Date`	datetime	Momentul executării (tipăririi) tranzacţiei
`· MEVDate`	datetime?	Data înregistrării în MEV; `null` dacă încă nu a ajuns acolo
`· MEVID`	string	Identificatorul atribuit de MEV
`· MEVResponse`	string	Răspunsul MEV la înregistrare
`· TaskId`	int	Numărul tranzacţiei în coada serviciului
`· ShiftId`	int	Tura (raportul zilnic)
`· ShiftOrderId`	int	Numărul tranzacţiei în cadrul turei
`· Number`	string	`Number` din cerere
`· Uid`	guid	`Uid` al bonului
`· MyDiscountUid`, `ClientPhone`, `ClientEmail`, `HeaderText`, `FooterText`		Aşa cum au venit în cerere
`· Lines`	ReceiptLine[]	Liniile, aşa cum s-au înregistrat: `Code`, `Name`, `UnitCode`, `UnitName`, `Quantity`, `Amount` (cantitate × preţ, înainte de reducere), `Discount`, `Margin`, `Price` (preţul efectiv, după reducere şi adaos) şi `VAT` — obiect cu `Code`, `Percent`, `Amount` (suma TVA), `Brut` (suma cu TVA)
`· Payments`	ReceiptPayment[]	`Code`, `Amount`, `RRN`, `BankResponse`
`· Taxes`	ReceiptTax[]	Totalurile pe cote TVA: `Code`, `Percent`, `Amount` (suma TVA), `Brut` (suma cu TVA)
`· SubTotalAmount`	decimal	Subtotalul, aşa cum apare pe bon
`· TotalAmount`	decimal	Totalul bonului
`· Deposit`	decimal	Suma achitată (toate plăţile)
`· Change`	decimal	Restul dat

Câmp	Tip	Descriere
`transactionId`	int (query)	`TaskId` al tranzacţiei — cel primit la înregistrare sau din GetTransactions

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`PaymentReceipt`	PaymentReceipt	Bonul de plată: toate câmpurile din FiscalReceipt plus cel de mai jos
`· SeriaAndNumber`	string	Seria şi numărul din intervalul alocat casei

Câmp	Tip	Descriere
`transactionId`	int (query)	`TaskId` al tranzacţiei — cel primit la înregistrare sau din GetTransactions

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`ServiceReceipt`	ServiceReceipt	Bonul; câmpurile sunt mai jos
`· Amount`	decimal	Suma: pozitivă — introducere, negativă — extragere
`· CashInDrawer`	decimal	Numerarul din sertar după operaţie
`· Date`	datetime	Momentul executării (tipăririi) tranzacţiei
`· MEVDate`	datetime?	Data înregistrării în MEV; `null` dacă încă nu a ajuns acolo
`· MEVID`	string	Identificatorul atribuit de MEV
`· MEVResponse`	string	Răspunsul MEV la înregistrare
`· TaskId`	int	Numărul tranzacţiei în coada serviciului
`· ShiftId`	int	Tura (raportul zilnic)
`· ShiftOrderId`	int	Numărul tranzacţiei în cadrul turei

Câmp	Tip	Descriere
`transactionId`	int (query)	`TaskId` al tranzacţiei — cel primit la înregistrare sau din GetTransactions

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`Report`	Report	Raportul; câmpurile sunt mai jos
`· ReportType`	int / enum	`1` — Z (`RaportZ`), `2` — X (`RaportX`)
`· Total`	decimal	Circulaţia zilnică totală
`· TotalUntaxed`	decimal	Circulaţia zilnică neimpozitată
`· Tax`	decimal	TVA zilnic total
`· TotalBill`	int	Numărul de bonuri fiscale
`· LastBillNumber`	int	Numărul ultimului bon fiscal
`· Taxes`	ReceiptTax[]	Pe cote TVA: `Code`, `Percent`, `Amount` (suma TVA), `Brut` (suma cu TVA)
`· Payments`	ReportPayment[]	Pe tipuri de plată: `Code` (numele tipului, de ex. `NUMERAR`), `Amount`
`· PaymentReceiptsTaxes, PaymentReceiptsPayments`		Aceleaşi totaluri, pentru bonurile de plată
`· CashIn, CashOut`	decimal	Numerarul introdus şi extras în tură
`· Balance`	decimal	Soldul de numerar din sertar
`· TotalYear, TotalYearTax`	decimal	Circulaţia şi TVA de la începutul anului; doar în raportul Z
`· Date`	datetime	Momentul executării (tipăririi) tranzacţiei
`· MEVDate`	datetime?	Data înregistrării în MEV; `null` dacă încă nu a ajuns acolo
`· MEVID`	string	Identificatorul atribuit de MEV
`· MEVResponse`	string	Răspunsul MEV la înregistrare
`· TaskId`	int	Numărul tranzacţiei în coada serviciului
`· ShiftId`	int	Tura (raportul zilnic)
`· ShiftOrderId`	int	Numărul tranzacţiei în cadrul turei

Câmp	Tip	Descriere
`transactionId`	int (query)	`TaskId` al tranzacţiei — cel primit la înregistrare sau din GetTransactions

Câmp	Tip	Descriere
`ErrorCode`	int / enum	Codul erorii; `0` (`OK`) — metoda s-a executat fără erori. Vezi codurile de eroare.
`ErrorMessage`	string	Mesaj explicativ al erorii
`Template`	string	HTML codificat Base64

Cod	MEV	Descriere	Admis în
`1`	NUMERAR	numerar	toate
`2`	CARD	card bancar	toate
`3.1`	VAUCHER	voucher	toate
`3.2`	CEC (CERTIFICAT VALORIC)	certificat valoric	toate
`3.3`	TICHET	document cu valoare prestabilită, în lei	toate
`5`	TME	tichet de masă pe suport electronic	ACPS; ACPSPPGL — doar pe bonuri fără combustibil
`6`	ABONAMENT	abonament	toate
`7`	ALT TIP	alt tip	toate
`8.1`	Credit	credit	ACPS (MEV v2), ACPSPPGL
`8.2`	Leasing	leasing	ACPS (MEV v2), ACPSPPGL
`8.3`	Avans	avans	ACPS (MEV v2), ACPSPPGL
`8.4`	Arvuna	arvună	ACPS (MEV v2), ACPSPPGL
`8.5`	Gaj	gaj	ACPS (MEV v2), ACPSPPGL

Cod	Nume	Semnificaţie
Serviciu
`0`	`OK`	metoda s-a executat fără erori
`1`	`ServiceUnknownInternalError`	eroare internă necunoscută a serviciului
`2`	`ServiceDatabaseNotResponding`	baza de date a serviciului nu răspunde
`3`	`ServiceDatabaseCorrupted`	baza de date a serviciului e deteriorată
`4`	`ServiceSignatureInvalid`	semnătura digitală a serviciului nu e validă
`5`	`ServiceNotConfigured`	serviciul nu e configurat sau e configurat greşit
`6`	`ServiceActivationCancelled`	înregistrarea serviciului în MEV a fost anulată
`7`	`ServiceInvalidDateTime`	ceasul calculatorului pe care rulează serviciul e setat greşit
`8`	`ServiceCloudSyncError`	eroare de sincronizare a tranzacţiilor cu ISFiscalCloud şi/sau MEV
`9`	`ServiceDailyReportRequired`	e necesar raportul zilnic cu închidere (Z)
`10`	`ServiceDailyReportPrinting`	se tipăreşte raportul zilnic cu închidere
`11`	`ServiceCloudConnectionError`	eroare de conectare la ISFiscalCloud (doar în configuraţia fără offline)
`12`	`ServiceCloudTimeoutError`	ISFiscalCloud nu a răspuns la timp (doar în configuraţia fără offline)
`13`	`ServicePaymentReceiptRangeNotSet`	legătura cu MEV lipseşte peste limita offline, iar intervalul de numere pentru bonurile de plată nu e setat sau s-a epuizat
`14`	`ServiceSMSNotConfigured`	în cerere e `ClientPhone`, dar trimiterea SMS nu e configurată în serviciu
`15`	`ServiceEmailNotConfigured`	în cerere e `ClientEmail`, dar trimiterea e-mail nu e configurată în serviciu
`16`	`ServiceTaskProcessing`	în acest moment se înregistrează un bon sau un raport; primirea unui bon nou e temporar imposibilă — repetaţi cererea peste câteva secunde
Formatul cererii
`20`	`FormatBillDoesNotContainLines`	bonul nu conţine produse
`21`	`FormatBillDoesNotContainPayments`	bonul nu conţine plăţi
`22`	`FormatIncorrectProductName`	denumirea produsului e greşită sau goală
`23`	`FormatIncorrectQuantity`	cantitate greşită
`24`	`FormatIncorrectAmount`	sumă greşită
`25`	`FormatIncorrectPrice`	preţ greşit
`26`	`FormatUnknownUnit`	unitate de măsură necunoscută sau nepermisă
`27`	`FormatUnknownVAT`	cotă TVA necunoscută
`28`	`FormatUnknownPayment`	cod de plată necunoscut
`29`	`FormatUnknownDepartment`	subdiviziune necunoscută
`30`	`FormatPhoneNumberMissing`	lipseşte numărul de telefon (necesar pentru `DisplayType` = 2)
`31`	`FormatEmailMissing`	lipseşte adresa de e-mail (necesară pentru `DisplayType` = 3)
Procesare
`40`	`ProcessingInsufficientFundsInBox`	numerar insuficient în sertar pentru operaţie
`41`	`ProcessingInsufficientPaymentAmount`	suma plăţilor e mai mică decât suma produselor
`42`	`ProcessingChangeCanNotBeCalculated`	restul nu poate fi calculat
`43`	`ProcessingTaskNotFound`	sarcina nu a fost găsită
`44`	`ProcessingTaskFinished`	sarcina e deja finalizată
`45`	`ProcessingIllegalCommand`	comandă nepermisă în starea curentă
`46`	`ProcessingTaskExists`	un bon cu acest `Uid` există deja; răspunsul conţine `TaskId` al lui
Imprimantă
`61`	`PrinterNotFound`	imprimanta nu a fost găsită
`62`	`PrinterUnavailable`	imprimanta nu e disponibilă
`63`	`PrinterOffline`	imprimanta e în regim offline
`64`	`PrinterHasJobsInQueue`	coada imprimantei are sarcini neexecutate
`65`	`PrinterIsOutOfPaper`	imprimanta nu are hârtie
Memorie fiscală
`71`	`FiscalMemoryNotConnected`	memoria fiscală nu e conectată
`72`	`FiscalMemoryNotFiscalized`	memoria fiscală nu e fiscalizată
`73`	`FiscalMemoryIDReadingError`	eroare la citirea identificatorului memoriei fiscale
`74`	`FiscalMemoryWrongID`	identificatorul memoriei fiscale e greşit
`75`	`FiscalMemoryReportNotWritten`	raportul nu a fost scris în memoria fiscală

ISFiscalService API

Служба Windows, которая печатает фискальные чеки и отчёты торгового приложения, регистрирует их в электронном журнале и передаёт в ISFiscalCloud и MEV.

Базовый адресhttp://localhost:9203/fpservice

ФорматыJSON · XML

Методы14

Версия сервиса1.26.2.256

Обзор

Торговое приложение третьей стороны, интегрированное с ISFiscalCloud, работает в торговой точке и передаёт продажи в веб-сервис ISFiscalService. Каждому чеку и отчёту при сохранении присваивается уникальный порядковый номер и QR-код, затем он печатается на фискальном или POS-принтере.
Фискальные чеки, служебные чеки и отчёты передаются одновременно в ISFiscalCloud и в MEV — не сначала в один, потом в другой.
Любой покупатель, получивший чек с QR-кодом, может проверить его подлинность на freceipt.eservicii.md или mev.sfs.md, а продавец видит свои чеки в кабинете на mev.md.

Подключение и форматы

Сервис слушает локально, на компьютере кассы, порт 9203 (меняется ключом Port в appSettings конфигурационного файла сервиса). Каждый метод доступен через три точки входа — сегмент адреса задаёт формат и запроса, и ответа:

Формат	Адрес	Content-Type
JSON	`http://localhost:9203/fpservice/json/{Метод}`	`application/json`
XML	`http://localhost:9203/fpservice/xml/{Метод}`	`application/xml`
SOAP	`http://localhost:9203/fpservice/soap` · WSDL: `http://localhost:9203/fpservice?wsdl`	`text/xml`

Различия форматов

ErrorCode в JSON приходит числом (0), в XML — именем (OK).
Даты в JSON приходят в формате WCF /Date(мс+зона)/ — миллисекунды от 1970-01-01 UTC плюс часовой пояс, — в XML как ISO 8601.
XML-запросы несут пространство имён http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service, элементы идут в алфавитном порядке, как в примерах.

Очередь задач

Методы регистрации не печатают синхронно: они ставят задачу в очередь сервиса и сразу возвращают её идентификаторы. TaskId — номер в очереди, ShiftId — смена (дневной отчёт), ShiftOrderId — номер в смене, TaskUid — GUID, ваш или присвоенный автоматически.

Общие поля транзакций

Методы, читающие транзакции обратно (Get…), кроме собственных полей возвращают эти:

Поле	Тип	Описание
`Date`	datetime	Момент выполнения (печати) транзакции
`MEVDate`	datetime?	Дата регистрации в MEV; `null`, если ещё не передана
`MEVID`	string	Идентификатор, присвоенный MEV
`MEVResponse`	string	Ответ MEV при регистрации
`TaskId`	int	Номер транзакции в очереди сервиса
`ShiftId`	int	Смена (дневной отчёт)
`ShiftOrderId`	int	Номер транзакции в рамках смены

CloudSyncWarning = true — не ошибка: задача зарегистрирована, но в очереди есть транзакции, ещё не переданные в MEV. Проверьте GetServiceState. Если это продлится дольше оффлайн-лимита, новые чеки будут выдаваться как платёжные квитанции — см. правила.

Типовой сценарий

При запуске приложения — GetServiceState. Если GeneralError = true, покажите оператору причину по флагам состояния.
В начале смены, если нужна разменная наличность — RegisterServiceReceipt с положительной суммой.
На каждую продажу — RegisterFiscalReceipt со своим Uid. Ссылку из QR показать покупателю. При таймауте или сетевой ошибке повторите тот же запрос с тем же Uid: если чек уже прошёл, придёт ошибка 46 и его TaskId, а не дубль.
Если чек не напечатался (кончилась бумага и т.п.) — PrintCopy по Uid, а не повторная регистрация: повторный чек — это вторая продажа в MEV.
При закрытии дня — изъятие наличных (RegisterServiceReceipt с отрицательной суммой), затем Z-отчёт (RegisterReport, CloseReport = true). Через 24 часа после открытия смены сервис отклоняет чеки до Z.
Для сверки — GetReports и GetTransactions дают список, а методы Get… — каждую транзакцию так, как её зарегистрировал сервис.

Регистрация фискального чека

POSThttp://localhost:9203/fpservice/json/RegisterFiscalReceipt

Регистрирует в очереди фискального сервиса задачу печати фискального чека. Ответ содержит ссылку проверки MEV, которую нужно показать покупателю в виде QR-кода или напечатать внизу чека.

Повтор безопасен. Если прислать уже зарегистрированный Uid, сервис не создаёт второй чек: он возвращает ErrorCode = 46 (ProcessingTaskExists) вместе с TaskId существующего чека. Поэтому при таймауте повторите тот же запрос с тем же Uid.

Параметры запроса

Поле	Тип	Описание
`ClientEmail`	string	E-mail клиента для отправки копии чека. Обязателен при `DisplayType` = 3.
`ClientPhone`	string	Телефон клиента для отправки копии по SMS. Обязателен при `DisplayType` = 2.
`DisplayType`	int	Способ предъявления чека: `0` — печать на бумаге (по умолчанию); `1` — QR-код на мониторе покупателя; `2` — SMS; `3` — e-mail
`FooterText`	string	Произвольный текст в конце чека
`ForcePrint`	bool	Принудительная печать на бумаге — приоритетнее всех остальных параметров и настроек фискального модуля
`HeaderText`	string	Произвольный текст в начале чека
`Lines`	BillLine[]	Строки чека — минимум одна. Структура
`MyDiscountUid`	guid	Идентификатор в дисконтной системе MyDiscount
`Number`	string	Номер чека во внешней учётной системе
`Payments`	BillPayment[]	Оплаты чека — минимум одна. Структура
`PrinterURI`	string	URI POS-принтера, подключённого к сервису, для печати чека. Пусто — печать на принтер Windows по умолчанию.
`Uid`	guid	GUID чека во внешней системе. Пусто — присвоит сервис. Рекомендуется передавать всегда: повтор запроса становится безопасным, а копию можно запросить по своему идентификатору.

`Lines · BillLine`

Минимум одна строка.

Поле	Тип	Описание
`Code`	string	Код товара во внешней системе
`Discount`	decimal	Скидка в леях на всю сумму строки
`Margin`	decimal	Наценка в леях на всю сумму строки
`Name`	string	Наименование товара; обязательно
`Price`	decimal	Цена за единицу; больше 0
`Quantity`	decimal	Количество; больше 0, до 3 знаков после запятой
`UnitCode`	int	Код единицы измерения по классификации MEV: `1` — литры, `2` — куб. метры, `3` — товар, не являющийся топливом, `0` — не указан. Важен только на АЗС — см. правила.
`UnitName`	string	Наименование единицы измерения
`VAT`	string	Код ставки НДС: буква `A`–`Z` из настроенных в сервисе (список — в GetServiceState → `VATRates`) или `_` — без НДС. Обязателен.

`Payments · BillPayment`

Минимум одна оплата. Суммы должны покрывать чек — см. правила.

Поле	Тип	Описание
`Amount`	decimal	Сумма оплаты; больше 0
`BankResponse`	string	Ответ банковского терминала при оплате картой
`Code`	string	Код типа оплаты — см. типы оплат
`RRN`	string	RRN банковской транзакции при оплате картой

Правила проверки

Сервис проверяет чек, прежде чем поставить его в очередь. Часть правил зависит от вида деятельности кассы — поле ActivityType в GetServiceState: ACPS — торговля, ACPPGL — АЗС, ACPSPPGL — АЗС с магазином.

Сумма чека. Сумма строки = round(Quantity × Price, 2) − Discount + Margin; сумма чека — сумма строк.
Оплаты. Если оплат меньше суммы чека — ошибка 41. Если больше, разница — это сдача, а сдача выдаётся только из наличных (код 1): если наличная оплата не покрывает сдачу — ошибка 42.
АЗС (ACPPGL). Одна строка и одна оплата. Допустимые UnitCode: 0, 1, 2; 0 регистрируется как литры.
АЗС с магазином (ACPSPPGL). Допустимые UnitCode: 0–3. Строки с 1 или 2 — топливо, с 0 или 3 — товар. Чек с топливом содержит одну оплату.
Округление топлива. В чеке с одной строкой топлива расхождение между оплатой и чеком не больше цены 10 мл (Price / 100) допускается: сумма строки становится суммой оплаты.
Коды оплат допускаются в зависимости от деятельности — см. типы оплат. Иначе — ошибка 28.
Часы. Если время компьютера меньше времени последней зарегистрированной транзакции — ошибка 7.
Смена 24 часа. Более чем через 24 часа после открытия смены — ошибка 9, до Z-отчёта. Если в сервисе настроен автоматический Z-отчёт, сервис сделает его сам и зарегистрирует чек.
Нет связи с MEV. Если непереданные в MEV транзакции превысили оффлайн-лимит (или лимит равен 0 и облако не отвечает), чек не отклоняется: он регистрируется как платёжная квитанция с серией и номером из выделенного кассе диапазона (GetTransactions показывает её с Type = 12, подробности — GetPaymentReceipt). Если диапазон не задан или исчерпан — ошибка 13.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`CloudSyncWarning`	bool	В очереди есть хотя бы одна задача, ещё не переданная в MEV
`ShiftId`	int	Идентификатор смены (дневного отчёта), в которой зарегистрирована задача
`ShiftOrderId`	int	Порядковый номер задачи в рамках смены
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса
`TaskUid`	guid	Уникальный идентификатор задачи — равен `Uid` из запроса либо присваивается автоматически, если его не было
`QR`	string	Ссылка на портал MEV для проверки чека. Показывается QR-кодом на экране покупателя или печатается внизу чека.

Пример

POST http://localhost:9203/fpservice/json/RegisterFiscalReceipt
Content-Type: application/json

{
  "ClientEmail": "",
  "ClientPhone": "",
  "DisplayType": 0,
  "FooterText": "Thank you!",
  "ForcePrint": true,
  "HeaderText": "Operator 1",
  "Lines": [{
    "Code": "2",
    "Discount": 2.00,
    "Margin": 0.00,
    "Name": "Ext DE5",
    "Price": 31.50,
    "Quantity": 2.150,
    "UnitCode": 1,
    "UnitName": "liters",
    "VAT": "A"
  }],
  "Number": "248",
  "Payments": [{
    "Amount": 100.00,
    "BankResponse": "",
    "Code": "1",
    "RRN": ""
  }],
  "PrinterURI": "",
  "Uid": "3d0f65db-9f8f-49bc-b71d-8fc014f4af98"
}

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "CloudSyncWarning": false,
  "ShiftId": 11,
  "ShiftOrderId": 1,
  "TaskId": 46,
  "TaskUid": "3d0f65db-9f8f-49bc-b71d-8fc014f4af98",
  "QR": "https://mev.sfs.md/receipt-verifier/33C303B4706C3467CCD14EAA6662CEDE"
}

Тот же запрос в XML

POST http://localhost:9203/fpservice/xml/RegisterFiscalReceipt
Content-Type: application/xml

<RegisterFiscalReceiptRequest xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service">
  <ClientEmail></ClientEmail>
  <ClientPhone></ClientPhone>
  <DisplayType>0</DisplayType>
  <FooterText>Thank you!</FooterText>
  <ForcePrint>true</ForcePrint>
  <HeaderText>Operator 1</HeaderText>
  <Lines>
    <BillLine>
      <Code>2</Code>
      <Discount>2.00</Discount>
      <Margin>0.00</Margin>
      <Name>Ext DE5</Name>
      <Price>31.50</Price>
      <Quantity>2.150</Quantity>
      <UnitCode>1</UnitCode>
      <UnitName>liters</UnitName>
      <VAT>A</VAT>
    </BillLine>
  </Lines>
  <Number>248</Number>
  <Payments>
    <BillPayment>
      <Amount>100.00</Amount>
      <BankResponse></BankResponse>
      <Code>1</Code>
      <RRN></RRN>
    </BillPayment>
  </Payments>
  <PrinterURI></PrinterURI>
  <Uid>2a0ce057-213b-4837-b3c7-d77c91e4661c</Uid>
</RegisterFiscalReceiptRequest>

<RegisterFiscalReceiptResponse xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorCode>OK</ErrorCode>
  <ErrorMessage/>
  <CloudSyncWarning>false</CloudSyncWarning>
  <ShiftId>10</ShiftId>
  <ShiftOrderId>8</ShiftOrderId>
  <TaskId>44</TaskId>
  <TaskUid>2a0ce057-213b-4837-b3c7-d77c91e4661c</TaskUid>
  <QR>https://mev.sfs.md/receipt-verifier/5CA4D2CA0450DF80FEB2A62354D75311</QR>
</RegisterFiscalReceiptResponse>

Регистрация служебного чека

POSThttp://localhost:9203/fpservice/json/RegisterServiceReceipt

Регистрирует служебный чек о внесении (Amount > 0) или изъятии (Amount < 0) наличных. Сумма изъятия не может превышать наличность в ящике за текущую смену — наличные оплаты плюс внесения, минус изъятия и выданная сдача, — иначе ошибка 40. Сумма 0 — ошибка 24.

Параметры запроса

Поле	Тип	Описание
`Amount`	decimal	Сумма внесения; отрицательное значение — сумма изъятия
`Reason`	int	Причина изъятия: `0` — возврат, `1` — инкассация. Поле принимается, но текущая версия сервиса его не обрабатывает.
`ForcePrint`	bool	Принудительная печать на бумаге (приоритетнее настроек фискального модуля)
`PrinterURI`	string	URI POS-принтера, подключённого к сервису, для печати служебного чека. Пусто — печать на принтер Windows по умолчанию.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`CloudSyncWarning`	bool	В очереди есть хотя бы одна задача, ещё не переданная в MEV
`ShiftId`	int	Идентификатор смены (дневного отчёта), в которой зарегистрирована задача
`ShiftOrderId`	int	Порядковый номер задачи в рамках смены
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса
`TaskUid`	guid	Уникальный идентификатор задачи (присваивается автоматически)

Пример

POST http://localhost:9203/fpservice/json/RegisterServiceReceipt
Content-Type: application/json

{
  "Amount": 10.22,
  "ForcePrint": true,
  "PrinterURI": ""
}

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "CloudSyncWarning": false,
  "ShiftId": 11,
  "ShiftOrderId": 3,
  "TaskId": 49,
  "TaskUid": "22ebb07d-57d6-4b5b-96bd-ee6bfd9bebb6"
}

Тот же запрос в XML

POST http://localhost:9203/fpservice/xml/RegisterServiceReceipt
Content-Type: application/xml

<RegisterServiceReceiptRequest xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service">
  <Amount>10.22</Amount>
  <ForcePrint>true</ForcePrint>
  <PrinterURI></PrinterURI>
</RegisterServiceReceiptRequest>

<RegisterServiceReceiptResponse xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorCode>OK</ErrorCode>
  <ErrorMessage/>
  <CloudSyncWarning>false</CloudSyncWarning>
  <ShiftId>11</ShiftId>
  <ShiftOrderId>4</ShiftOrderId>
  <TaskId>50</TaskId>
  <TaskUid>def450fe-f9d5-4aa6-a0de-e11c94774b54</TaskUid>
</RegisterServiceReceiptResponse>

Регистрация дневного отчёта

POSThttp://localhost:9203/fpservice/json/RegisterReport

Регистрирует задачу формирования и печати дневного отчёта: с закрытием смены (Z-отчёт) или без (X-отчёт). Z-отчёт закрывает текущую смену; если открытой смены не было, открывается и закрывается пустая. Пока предыдущий Z ещё обрабатывается — ошибка 10. На кассах с фискальной памятью ошибка памяти блокирует Z-отчёт, но не X-отчёт — он остаётся доступным для проверки кассы.

Параметры запроса

Поле	Тип	Описание
`CloseReport`	bool	`true` — отчёт с закрытием (Z), `false` — без закрытия (X)
`ForcePrint`	bool	Принудительная печать на бумаге. Z-отчёт может печататься и без неё, если сервис настроен всегда печатать Z.
`PrinterURI`	string	URI POS-принтера, подключённого к сервису, для печати отчёта. Пусто — печать на принтер Windows по умолчанию.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`CloudSyncWarning`	bool	В очереди есть хотя бы одна задача, ещё не переданная в MEV
`ShiftId`	int	Идентификатор смены (дневного отчёта), в которой зарегистрирована задача
`ShiftOrderId`	int	Порядковый номер задачи в рамках смены
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса
`TaskUid`	guid	Уникальный идентификатор задачи (присваивается автоматически)

Пример

POST http://localhost:9203/fpservice/json/RegisterReport
Content-Type: application/json

{
  "CloseReport": false,
  "ForcePrint": true,
  "PrinterURI": ""
}

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "CloudSyncWarning": false,
  "ShiftId": 11,
  "ShiftOrderId": 6,
  "TaskId": 52,
  "TaskUid": "9cc9ac78-270d-429a-9867-c386e3e29409"
}

Тот же запрос в XML

POST http://localhost:9203/fpservice/xml/RegisterReport
Content-Type: application/xml

<RegisterReportRequest xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service">
  <CloseReport>false</CloseReport>
  <ForcePrint>true</ForcePrint>
  <PrinterURI></PrinterURI>
</RegisterReportRequest>

<RegisterReportResponse xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorCode>OK</ErrorCode>
  <ErrorMessage/>
  <CloudSyncWarning>false</CloudSyncWarning>
  <ShiftId>11</ShiftId>
  <ShiftOrderId>7</ShiftOrderId>
  <TaskId>53</TaskId>
  <TaskUid>ec76c1ba-0dc4-4685-bd8a-994d35fad2e5</TaskUid>
</RegisterReportResponse>

Печать нефискального текста

POSThttp://localhost:9203/fpservice/json/PrintNonFiscalText

Регистрирует задачу печати произвольного текста для покупателя — без фискального значения.

Параметры запроса

Поле	Тип	Описание
`Lines`	string[]	Массив строк для печати; минимум одна, иначе ошибка `20`
`PrinterURI`	string	URI POS-принтера, подключённого к сервису, для печати текста. Пусто — печать на принтер Windows по умолчанию.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`CloudSyncWarning`	bool	В очереди есть хотя бы одна задача, ещё не переданная в MEV
`ShiftId`	int	Идентификатор смены (дневного отчёта), в которой зарегистрирована задача
`ShiftOrderId`	int	Порядковый номер задачи в рамках смены
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса

Пример

POST http://localhost:9203/fpservice/json/PrintNonFiscalText
Content-Type: application/json

{
  "Lines": ["Acesta este un exemplu", "de bon nefiscal."],
  "PrinterURI": ""
}

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "CloudSyncWarning": false,
  "ShiftId": 11,
  "ShiftOrderId": 5,
  "TaskId": 63
}

Печать копии чека или отчёта

POSThttp://localhost:9203/fpservice/json/PrintCopy

Регистрирует задачу повторной печати фискального чека, служебного чека или X/Z-отчёта, ранее зарегистрированного через этот сервис. Нефискальный текст и копии не копируются. Копия всегда печатается на бумаге с водяным знаком COPIE и получает собственный TaskId. Если транзакция не найдена — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`TaskId`	int	Номер задачи из очереди, которую нужно напечатать повторно
`TaskUid`	guid	GUID транзакции — `Uid`, переданный при регистрации, или `TaskUid` из ответа. Достаточно одного из `TaskId` и `TaskUid`; если переданы оба, используется `TaskUid`.
`PrinterURI`	string	URI POS-принтера, подключённого к сервису, для печати копии. Пусто — печать на принтер Windows по умолчанию.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса

Пример

POST http://localhost:9203/fpservice/json/PrintCopy
Content-Type: application/json

{
  "TaskId": 61,
  "TaskUid": "00000000-0000-0000-0000-000000000000",
  "PrinterURI": ""
}

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "TaskId": 67
}

Печать копии последней транзакции

GEThttp://localhost:9203/fpservice/json/PrintLastCopy

Регистрирует задачу повторной печати последней выполненной транзакции (фискальный чек, служебный чек, X/Z-отчёт) с водяным знаком COPIE. Параметров нет. Если такой транзакции нет — ошибка 43.

Параметры запроса

Нет.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`TaskId`	int	Порядковый номер задачи в очереди фискального сервиса

Пример

GET http://localhost:9203/fpservice/json/PrintLastCopy

<PrintCopyTaskResponse xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorCode>OK</ErrorCode>
  <ErrorMessage/>
  <TaskId>68</TaskId>
</PrintCopyTaskResponse>

Состояние сервиса

GEThttp://localhost:9203/fpservice/json/GetServiceState

Возвращает текущее состояние фискального сервиса: регистрационные номера, последние транзакции и флаги ошибок. Вызывайте при запуске приложения и перед продажей, если в предыдущих ответах появился CloudSyncWarning.

Параметры запроса

Нет.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`GeneralError`	bool	Общий флаг. `true` — регистрация транзакций сейчас невозможна; причину показывают флаги ниже.
`ActivityType`	string	Вид деятельности кассы: `ACPS` — торговля, `ACPPGL` — АЗС, `ACPSPPGL` — АЗС с магазином. Определяет допустимые коды оплат и единицы.
`ServiceSerialNumber`	string	Регистрационный номер сервиса в MEV
`ServiceDateTime`	datetime	Текущие дата/время сервиса (часы компьютера)
`FiscalMemorySerialNumber`	string	Номер фискальной памяти; пусто, если касса работает без неё
`FiscalMemoryError`	bool	Фискальная память отвечает с ошибкой. Поднимает `GeneralError`.
`FiscalMemoryFiscalized`	bool	Фискальная память фискализирована
`ServiceRegistrationInvalid`	bool	Регистрация в MEV аннулирована или устройство неизвестно облаку
`ServiceSignatureInvalid`	bool	Облако отклонило транзакции из-за цифровой подписи. Транзакции заблокированы.
`ServiceMEVSyncError`	bool	Самая старая непереданная в MEV транзакция превысила оффлайн-лимит
`ServiceDatabaseCorrupted`	bool	Целостность БД сервиса нарушена. Транзакции заблокированы.
`OfflineModeEnabled`	bool	Есть транзакции, не переданные в MEV дольше минуты, но оффлайн-лимит ещё не превышен
`OfflineHoursLimit`	int	Сколько часов касса может работать с непереданными транзакциями. `0` — оффлайн запрещён. На кассах с фискальной памятью, если не задано, действует 72.
`FirstNotSyncedTransactionDate`	datetime?	Дата самой старой не переданной в MEV транзакции — от неё отсчитывается оффлайн
`FirstNotSyncedTransactionNumber`	int?	`TaskId` этой транзакции
`CurrentReportNumber`	int?	Номер открытой смены (`ShiftId`); `null`, если смена не открыта
`CurrentReportDate`	datetime?	Дата открытия текущей смены
`CurrentReport24HoursExpired`	bool	С открытия смены прошло более 24 часов. До Z-отчёта чеки отклоняются с ошибкой `9`.
`VATRates`	VATRate[]	Настроенные ставки НДС: `Code` (буква для `Lines[].VAT`) и `Percent`
`…`		`LastTransactionDate`, `LastTransactionMEVID`, `LastTransactionNumber`, `LastSyncedTransactionDate`, `ServiceDatetimeInvalid`, `FiscalMemoryReportNotWritten`, `PrinterUnavailable`, `PrinterHasJobsInQueue`, `PrinterIsOutOfPaper`, `CompanyState` — присутствуют в ответе, но текущая версия их не заполняет. Не полагайтесь на них.

Пример

GET http://localhost:9203/fpservice/json/GetServiceState

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "GeneralError": false,
  "ActivityType": "ACPS",
  "ServiceSerialNumber": "AA0101000023",
  "ServiceDateTime": "/Date(1665499064440+0300)/",
  "FiscalMemorySerialNumber": "",
  "FiscalMemoryError": false,
  "FiscalMemoryFiscalized": false,
  "ServiceRegistrationInvalid": false,
  "ServiceSignatureInvalid": false,
  "ServiceMEVSyncError": false,
  "ServiceDatabaseCorrupted": false,
  "OfflineModeEnabled": false,
  "OfflineHoursLimit": 0,
  "FirstNotSyncedTransactionDate": null,
  "FirstNotSyncedTransactionNumber": null,
  "CurrentReportNumber": 37,
  "CurrentReportDate": "/Date(1665480576767+0300)/",
  "CurrentReport24HoursExpired": false,
  "VATRates": [
    { "Code": "A", "Percent": 20.00 },
    { "Code": "B", "Percent": 8.00 },
    { "Code": "C", "Percent": 0.00 }
  ]
}

Список фискальных отчётов

GEThttp://localhost:9203/fpservice/json/GetReports?onDate=2023-08-23

Возвращает выполненные Z-отчёты за указанный день в хронологическом порядке. Без даты — все. В конец добавляется открытая смена, если в ней есть чеки: без TaskId и MEVID, с Date = моментом запроса — так видно, сколько чеков в текущей смене. Цифры отчёта — GetReport.

Параметры запроса

Поле	Тип	Описание
`onDate`	date (query)	День в формате `YYYY-MM-DD`. Необязателен.

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`Reports`	ReportHeader[]	Найденные отчёты; поля каждого ниже
`· Date`	datetime	Дата регистрации отчёта в фискальном модуле
`· MEVDate`	datetime	Дата регистрации отчёта в MEV
`· MEVID`	string	Идентификатор, присвоенный MEV
`· MEVResponse`	string	Ответ MEV при регистрации
`· ShiftId`	int	Номер смены (дневного отчёта)
`· ShiftOrderId`	int	Номер задачи в рамках смены
`· TaskId`	int	Номер задачи в очереди
`· TaskUid`	guid	Уникальный идентификатор задачи
`· TotalBill`	int	Количество фискальных чеков в смене

Пример

GET http://localhost:9203/fpservice/json/GetReports?onDate=2023-08-23

<GetReportsResponse xmlns="http://schemas.datacontract.org/2004/07/Hardware.FiscalPrinters.Service" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorCode>OK</ErrorCode>
  <ErrorMessage/>
  <Reports>
    <ReportHeader>
      <Date>2023-08-23T15:19:18.853</Date>
      <MEVDate>2023-08-23T15:19:26.183</MEVDate>
      <MEVID>99f5697f-c1a4-4d86-880f-7a8f46015f50</MEVID>
      <MEVResponse i:nil="true"/>
      <ShiftId>11</ShiftId>
      <ShiftOrderId>0</ShiftOrderId>
      <TaskId>55</TaskId>
      <TaskUid>a414d8d6-1faa-428d-9758-1706266b313e</TaskUid>
      <TotalBill>0</TotalBill>
    </ReportHeader>
  </Reports>
</GetReportsResponse>

Транзакции смены

GEThttp://localhost:9203/fpservice/json/GetTransactions?shiftID=11

Возвращает все транзакции указанной смены в хронологическом порядке: чеки, платёжные квитанции, служебные чеки, отчёты, копии. Подробности транзакции — методом, соответствующим её типу (GetFiscalReceipt, GetPaymentReceipt, GetServiceReceipt, GetReport).

Параметры запроса

Поле	Тип	Описание
`shiftID`	int (query)	Номер смены — `ShiftId` из ответов регистрации или `CurrentReportNumber` из GetServiceState

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`Transactions`	TransactionHeader[]	Транзакции; поля каждой ниже
`· Type`	int / enum	Тип: `0` фискальный чек, `1` нефискальный текст, `2` X-отчёт, `3` Z-отчёт, `5` изъятие, `6` внесение, `11` копия, `12` платёжная квитанция. В JSON — число, в XML — имя (`Bill`, `BillNonFiscal`, `XReport`, `ZReport`, `WithdrawalOfFunds`, `SupplyWithMoney`, `PrintCopy`, `PaymentReceipt`).
`· TotalAmount`	decimal	Сумма транзакции
`· Date, MEVDate, MEVID, MEVResponse, TaskId, ShiftOrderId`		Как в общих полях. `ShiftId` и `TaskUid` здесь не заполняются.

Пример

GET http://localhost:9203/fpservice/json/GetTransactions?shiftID=11

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "Transactions": [
    { "Type": 6, "TotalAmount": 500.00, "TaskId": 45, "ShiftOrderId": 0,
      "Date": "/Date(1692792000000+0300)/", "MEVDate": "/Date(1692792004000+0300)/",
      "MEVID": "4f1c0a2e-7d3b-4c55-9e0a-2b8d6f7e1c90", "MEVResponse": "",
      "ShiftId": 0, "TaskUid": "00000000-0000-0000-0000-000000000000" },
    { "Type": 0, "TotalAmount": 65.73, "TaskId": 46, "ShiftOrderId": 1,
      "Date": "/Date(1692793158853+0300)/", "MEVDate": "/Date(1692793166183+0300)/",
      "MEVID": "99f5697f-c1a4-4d86-880f-7a8f46015f50", "MEVResponse": "",
      "ShiftId": 0, "TaskUid": "00000000-0000-0000-0000-000000000000" }
  ]
}

Зарегистрированный фискальный чек

GEThttp://localhost:9203/fpservice/json/GetFiscalReceipt?transactionId=46

Возвращает фискальный чек в том виде, как его зарегистрировал сервис, — с фактическими ценами, рассчитанным НДС и сдачей. Удобно для сверки с внешней системой. Если транзакции нет или это не чек — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`transactionId`	int (query)	`TaskId` транзакции — полученный при регистрации или из GetTransactions

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`FiscalReceipt`	FiscalReceipt	Чек; поля ниже
`· Date`	datetime	Момент выполнения (печати) транзакции
`· MEVDate`	datetime?	Дата регистрации в MEV; `null`, если ещё не передана
`· MEVID`	string	Идентификатор, присвоенный MEV
`· MEVResponse`	string	Ответ MEV при регистрации
`· TaskId`	int	Номер транзакции в очереди сервиса
`· ShiftId`	int	Смена (дневной отчёт)
`· ShiftOrderId`	int	Номер транзакции в рамках смены
`· Number`	string	`Number` из запроса
`· Uid`	guid	`Uid` чека
`· MyDiscountUid`, `ClientPhone`, `ClientEmail`, `HeaderText`, `FooterText`		Как пришли в запросе
`· Lines`	ReceiptLine[]	Строки в том виде, как зарегистрированы: `Code`, `Name`, `UnitCode`, `UnitName`, `Quantity`, `Amount` (количество × цена, до скидки), `Discount`, `Margin`, `Price` (фактическая цена после скидки и наценки) и `VAT` — объект с `Code`, `Percent`, `Amount` (сумма НДС), `Brut` (сумма с НДС)
`· Payments`	ReceiptPayment[]	`Code`, `Amount`, `RRN`, `BankResponse`
`· Taxes`	ReceiptTax[]	Итоги по ставкам НДС: `Code`, `Percent`, `Amount` (сумма НДС), `Brut` (сумма с НДС)
`· SubTotalAmount`	decimal	Подытог, как на чеке
`· TotalAmount`	decimal	Итог чека
`· Deposit`	decimal	Внесённая сумма (все оплаты)
`· Change`	decimal	Выданная сдача

Пример

GET http://localhost:9203/fpservice/json/GetFiscalReceipt?transactionId=46

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "FiscalReceipt": {
    "Date": "/Date(1692793158853+0300)/",
    "MEVDate": "/Date(1692793166183+0300)/",
    "MEVID": "99f5697f-c1a4-4d86-880f-7a8f46015f50",
    "MEVResponse": "",
    "TaskId": 46,
    "TaskUid": "00000000-0000-0000-0000-000000000000",
    "ShiftId": 11,
    "ShiftOrderId": 1,
    "Number": "248",
    "Uid": "3d0f65db-9f8f-49bc-b71d-8fc014f4af98",
    "MyDiscountUid": "00000000-0000-0000-0000-000000000000",
    "ClientPhone": "",
    "ClientEmail": "",
    "HeaderText": "Operator 1",
    "FooterText": "Thank you!",
    "Lines": [{
      "Code": "2",
      "Name": "Ext DE5",
      "UnitCode": 0,
      "UnitName": "liters",
      "Quantity": 2.150,
      "Amount": 67.73,
      "Discount": 2.00,
      "Margin": 0.00,
      "Price": 30.57,
      "VAT": { "Code": "A", "Percent": 20.00, "Amount": 10.96, "Brut": 65.73 }
    }],
    "Payments": [{ "Code": "1", "Amount": 100.00, "RRN": "", "BankResponse": "" }],
    "Taxes": [{ "Code": "A", "Percent": 20.00, "Amount": 10.96, "Brut": 65.73 }],
    "SubTotalAmount": 65.73,
    "TotalAmount": 65.73,
    "Deposit": 100.00,
    "Change": 34.27
  }
}

Зарегистрированная платёжная квитанция

GEThttp://localhost:9203/fpservice/json/GetPaymentReceipt?transactionId=47

Возвращает платёжную квитанцию — документ, который сервис выдал вместо фискального чека, потому что связи с MEV не было дольше оффлайн-лимита (см. правила). Поля те же, что у GetFiscalReceipt, плюс серия и номер. Если транзакция не платёжная квитанция — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`transactionId`	int (query)	`TaskId` транзакции — полученный при регистрации или из GetTransactions

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`PaymentReceipt`	PaymentReceipt	Платёжная квитанция: все поля FiscalReceipt плюс поле ниже
`· SeriaAndNumber`	string	Серия и номер из выделенного кассе диапазона

Пример

GET http://localhost:9203/fpservice/json/GetPaymentReceipt?transactionId=47

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "PaymentReceipt": {
    "SeriaAndNumber": "AA0000125",
    "Date": "/Date(1692793158853+0300)/",
    "MEVDate": null,
    "MEVID": "",
    "MEVResponse": "",
    "TaskId": 47,
    "TaskUid": "00000000-0000-0000-0000-000000000000",
    "ShiftId": 11,
    "ShiftOrderId": 1,
    "Number": "248",
    "Uid": "3d0f65db-9f8f-49bc-b71d-8fc014f4af98",
    "MyDiscountUid": "00000000-0000-0000-0000-000000000000",
    "ClientPhone": "",
    "ClientEmail": "",
    "HeaderText": "Operator 1",
    "FooterText": "Thank you!",
    "Lines": [{
      "Code": "2",
      "Name": "Ext DE5",
      "UnitCode": 0,
      "UnitName": "liters",
      "Quantity": 2.150,
      "Amount": 67.73,
      "Discount": 2.00,
      "Margin": 0.00,
      "Price": 30.57,
      "VAT": { "Code": "A", "Percent": 20.00, "Amount": 10.96, "Brut": 65.73 }
    }],
    "Payments": [{ "Code": "1", "Amount": 100.00, "RRN": "", "BankResponse": "" }],
    "Taxes": [{ "Code": "A", "Percent": 20.00, "Amount": 10.96, "Brut": 65.73 }],
    "SubTotalAmount": 65.73,
    "TotalAmount": 65.73,
    "Deposit": 100.00,
    "Change": 34.27
  }
}

Зарегистрированный служебный чек

GEThttp://localhost:9203/fpservice/json/GetServiceReceipt?transactionId=45

Возвращает чек внесения или изъятия наличных. Если транзакция не служебный чек — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`transactionId`	int (query)	`TaskId` транзакции — полученный при регистрации или из GetTransactions

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`ServiceReceipt`	ServiceReceipt	Чек; поля ниже
`· Amount`	decimal	Сумма: положительная — внесение, отрицательная — изъятие
`· CashInDrawer`	decimal	Наличность в ящике после операции
`· Date`	datetime	Момент выполнения (печати) транзакции
`· MEVDate`	datetime?	Дата регистрации в MEV; `null`, если ещё не передана
`· MEVID`	string	Идентификатор, присвоенный MEV
`· MEVResponse`	string	Ответ MEV при регистрации
`· TaskId`	int	Номер транзакции в очереди сервиса
`· ShiftId`	int	Смена (дневной отчёт)
`· ShiftOrderId`	int	Номер транзакции в рамках смены

Пример

GET http://localhost:9203/fpservice/json/GetServiceReceipt?transactionId=45

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "ServiceReceipt": {
    "Amount": 500.00,
    "CashInDrawer": 500.00,
    "Date": "/Date(1692792000000+0300)/",
    "MEVDate": "/Date(1692792004000+0300)/",
    "MEVID": "4f1c0a2e-7d3b-4c55-9e0a-2b8d6f7e1c90",
    "MEVResponse": "",
    "TaskId": 45,
    "TaskUid": "00000000-0000-0000-0000-000000000000",
    "ShiftId": 11,
    "ShiftOrderId": 0
  }
}

Зарегистрированный X- или Z-отчёт

GEThttp://localhost:9203/fpservice/json/GetReport?transactionId=55

Возвращает цифры дневного отчёта: итоги по ставкам НДС и типам оплат, наличность и, для Z, итоги с начала года. Если транзакция не отчёт — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`transactionId`	int (query)	`TaskId` транзакции — полученный при регистрации или из GetTransactions

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`Report`	Report	Отчёт; поля ниже
`· ReportType`	int / enum	`1` — Z (`RaportZ`), `2` — X (`RaportX`)
`· Total`	decimal	Общий дневной оборот
`· TotalUntaxed`	decimal	Необлагаемый дневной оборот
`· Tax`	decimal	Общий дневной НДС
`· TotalBill`	int	Количество фискальных чеков
`· LastBillNumber`	int	Номер последнего фискального чека
`· Taxes`	ReceiptTax[]	По ставкам НДС: `Code`, `Percent`, `Amount` (сумма НДС), `Brut` (сумма с НДС)
`· Payments`	ReportPayment[]	По типам оплат: `Code` (имя типа, напр. `NUMERAR`), `Amount`
`· PaymentReceiptsTaxes, PaymentReceiptsPayments`		Те же итоги для платёжных квитанций
`· CashIn, CashOut`	decimal	Внесённые и изъятые наличные за смену
`· Balance`	decimal	Остаток наличных в ящике
`· TotalYear, TotalYearTax`	decimal	Оборот и НДС с начала года; только в Z-отчёте
`· Date`	datetime	Момент выполнения (печати) транзакции
`· MEVDate`	datetime?	Дата регистрации в MEV; `null`, если ещё не передана
`· MEVID`	string	Идентификатор, присвоенный MEV
`· MEVResponse`	string	Ответ MEV при регистрации
`· TaskId`	int	Номер транзакции в очереди сервиса
`· ShiftId`	int	Смена (дневной отчёт)
`· ShiftOrderId`	int	Номер транзакции в рамках смены

Пример

GET http://localhost:9203/fpservice/json/GetReport?transactionId=55

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "Report": {
    "ReportType": 1,
    "Total": 65.73,
    "TotalUntaxed": 0.00,
    "Tax": 10.96,
    "TotalBill": 1,
    "LastBillNumber": 1,
    "Taxes": [{ "Code": "A", "Percent": 20.00, "Amount": 10.96, "Brut": 65.73 }],
    "Payments": [{ "Code": "NUMERAR", "Amount": 65.73 }],
    "PaymentReceiptsTaxes": [],
    "PaymentReceiptsPayments": [],
    "CashIn": 500.00,
    "CashOut": 0.00,
    "Balance": 565.73,
    "TotalYear": 184250.40,
    "TotalYearTax": 30708.40,
    "Date": "/Date(1692793158853+0300)/",
    "MEVDate": "/Date(1692793166183+0300)/",
    "MEVID": "99f5697f-c1a4-4d86-880f-7a8f46015f50",
    "MEVResponse": "",
    "TaskId": 55,
    "TaskUid": "00000000-0000-0000-0000-000000000000",
    "ShiftId": 11,
    "ShiftOrderId": 3
  }
}

Изображение транзакции

GEThttp://localhost:9203/fpservice/json/GetTransactionTemplate?transactionId=46

Возвращает печатный макет любой транзакции как HTML-страницу (ширина 57 мм, изображения встроены) в кодировке Base64. Удобно для показа чека на экране или отправки клиенту. Если транзакции нет — ошибка 43.

Параметры запроса

Поле	Тип	Описание
`transactionId`	int (query)	`TaskId` транзакции — полученный при регистрации или из GetTransactions

Ответ

Поле	Тип	Описание
`ErrorCode`	int / enum	Код ошибки; `0` (`OK`) — метод выполнен без ошибок. См. коды ошибок.
`ErrorMessage`	string	Пояснительное сообщение об ошибке
`Template`	string	HTML в кодировке Base64

Пример

GET http://localhost:9203/fpservice/json/GetTransactionTemplate?transactionId=46

{
  "ErrorCode": 0,
  "ErrorMessage": "",
  "Template": "PCFET0NUWVBFIGh0bWw+PGh0bWw+PGhlYWQ+..."
}

Типы оплат

Значение поля Payments[].Code. Названия — из классификации MEV, так они печатаются на чеке.

Код	MEV	Описание	Допускается в
`1`	NUMERAR	наличные	все
`2`	CARD	банковская карта	все
`3.1`	VAUCHER	ваучер	все
`3.2`	CEC (CERTIFICAT VALORIC)	подарочный сертификат	все
`3.3`	TICHET	документ с заранее установленной стоимостью в леях	все
`5`	TME	электронный талон на питание	ACPS; ACPSPPGL — только в чеках без топлива
`6`	ABONAMENT	абонемент	все
`7`	ALT TIP	другой тип	все
`8.1`	Credit	кредит	ACPS (MEV v2), ACPSPPGL
`8.2`	Leasing	лизинг	ACPS (MEV v2), ACPSPPGL
`8.3`	Avans	аванс	ACPS (MEV v2), ACPSPPGL
`8.4`	Arvuna	задаток	ACPS (MEV v2), ACPSPPGL
`8.5`	Gaj	залог	ACPS (MEV v2), ACPSPPGL

Вид деятельности кассы — в GetServiceState → ActivityType. На АЗС (ACPPGL) допускаются только коды с пометкой «все». Недопустимый код — ошибка 28.

Коды ошибок

Значения поля ErrorCode, возвращаемые всеми методами.

Код	Имя	Значение
Сервис
`0`	`OK`	метод выполнен без ошибок
`1`	`ServiceUnknownInternalError`	неизвестная внутренняя ошибка сервиса
`2`	`ServiceDatabaseNotResponding`	база данных сервиса недоступна
`3`	`ServiceDatabaseCorrupted`	база данных сервиса повреждена
`4`	`ServiceSignatureInvalid`	цифровая подпись сервиса недействительна
`5`	`ServiceNotConfigured`	сервис не настроен или настроен неверно
`6`	`ServiceActivationCancelled`	регистрация сервиса в MEV аннулирована
`7`	`ServiceInvalidDateTime`	неверно настроены часы компьютера, где работает сервис
`8`	`ServiceCloudSyncError`	ошибка синхронизации транзакций с ISFiscalCloud и/или MEV
`9`	`ServiceDailyReportRequired`	необходима печать дневного отчёта с закрытием (Z)
`10`	`ServiceDailyReportPrinting`	выполняется печать дневного отчёта с закрытием
`11`	`ServiceCloudConnectionError`	ошибка подключения к ISFiscalCloud (только в конфигурации с запретом оффлайн)
`12`	`ServiceCloudTimeoutError`	превышено время ожидания ответа ISFiscalCloud (только в конфигурации с запретом оффлайн)
`13`	`ServicePaymentReceiptRangeNotSet`	нет связи с MEV сверх оффлайн-лимита, а диапазон номеров платёжных квитанций не задан или исчерпан
`14`	`ServiceSMSNotConfigured`	в запросе есть `ClientPhone`, но отправка SMS в сервисе не настроена
`15`	`ServiceEmailNotConfigured`	в запросе есть `ClientEmail`, но отправка e-mail в сервисе не настроена
`16`	`ServiceTaskProcessing`	в данный момент регистрируется чек или отчёт, приём нового чека временно невозможен — повторите запрос через несколько секунд
Формат запроса
`20`	`FormatBillDoesNotContainLines`	чек не содержит товаров
`21`	`FormatBillDoesNotContainPayments`	чек не содержит оплат
`22`	`FormatIncorrectProductName`	неверное или пустое наименование товара
`23`	`FormatIncorrectQuantity`	неверное количество
`24`	`FormatIncorrectAmount`	неверная сумма
`25`	`FormatIncorrectPrice`	неверная цена
`26`	`FormatUnknownUnit`	неизвестная или недопустимая единица измерения
`27`	`FormatUnknownVAT`	неизвестная ставка НДС
`28`	`FormatUnknownPayment`	неизвестный код оплаты
`29`	`FormatUnknownDepartment`	неизвестное подразделение
`30`	`FormatPhoneNumberMissing`	не указан телефон (нужен при `DisplayType` = 2)
`31`	`FormatEmailMissing`	не указан e-mail (нужен при `DisplayType` = 3)
Обработка
`40`	`ProcessingInsufficientFundsInBox`	недостаточно наличных в денежном ящике
`41`	`ProcessingInsufficientPaymentAmount`	сумма оплат меньше суммы товаров
`42`	`ProcessingChangeCanNotBeCalculated`	сдача не может быть рассчитана
`43`	`ProcessingTaskNotFound`	задача не найдена
`44`	`ProcessingTaskFinished`	задача уже завершена
`45`	`ProcessingIllegalCommand`	недопустимая команда в текущем состоянии
`46`	`ProcessingTaskExists`	чек с таким `Uid` уже существует; ответ содержит его `TaskId`
Принтер
`61`	`PrinterNotFound`	принтер не найден
`62`	`PrinterUnavailable`	принтер недоступен
`63`	`PrinterOffline`	принтер в режиме оффлайн
`64`	`PrinterHasJobsInQueue`	в очереди принтера есть невыполненные задачи
`65`	`PrinterIsOutOfPaper`	в принтере нет бумаги
Фискальная память
`71`	`FiscalMemoryNotConnected`	фискальная память не подключена
`72`	`FiscalMemoryNotFiscalized`	фискальная память не фискализирована
`73`	`FiscalMemoryIDReadingError`	ошибка чтения идентификатора фискальной памяти
`74`	`FiscalMemoryWrongID`	неверный идентификатор фискальной памяти
`75`	`FiscalMemoryReportNotWritten`	отчёт не записан в фискальную память

Field	Type	Description
`Date`	datetime	When the transaction was executed (printed)
`MEVDate`	datetime?	Date registered in MEV; `null` if not there yet
`MEVID`	string	ID assigned by MEV
`MEVResponse`	string	MEV response at registration
`TaskId`	int	Transaction number in the service queue
`ShiftId`	int	Shift (daily report)
`ShiftOrderId`	int	Transaction number within the shift

Field	Type	Description
`ClientEmail`	string	Customer e-mail for sending a copy of the receipt. Required when `DisplayType` = 3.
`ClientPhone`	string	Customer phone for sending a copy by SMS. Required when `DisplayType` = 2.
`DisplayType`	int	How the receipt is delivered: `0` — printed on paper (default); `1` — QR code on the customer display; `2` — SMS; `3` — e-mail
`FooterText`	string	Free text printed at the end of the receipt
`ForcePrint`	bool	Force printing on paper — overrides all other parameters and the fiscal module settings
`HeaderText`	string	Free text printed at the start of the receipt
`Lines`	BillLine[]	Receipt lines — at least one. Structure
`MyDiscountUid`	guid	Customer identifier in the MyDiscount loyalty system
`Number`	string	Receipt number in the external accounting system
`Payments`	BillPayment[]	Receipt payments — at least one. Structure
`PrinterURI`	string	URI of the POS printer attached to the service used for printing the receipt. Empty — the Windows default printer is used.
`Uid`	guid	Receipt GUID in the external system. Empty — assigned by the service. Recommended: always send it — it makes retries safe and lets you request copies by your own ID.

Field	Type	Description
`Code`	string	Product code in the external system
`Discount`	decimal	Discount, in lei, on the line total
`Margin`	decimal	Surcharge, in lei, on the line total
`Name`	string	Product name; required
`Price`	decimal	Unit price; greater than 0
`Quantity`	decimal	Quantity; greater than 0, up to 3 decimals
`UnitCode`	int	Unit code per MEV classification: `1` — litres, `2` — cubic metres, `3` — non-fuel product, `0` — unspecified. Matters only at fuel stations — see the rules.
`UnitName`	string	Unit name
`VAT`	string	VAT rate code: a letter `A`–`Z` among those configured in the service (the list comes in GetServiceState → `VATRates`), or `_` — no VAT. Required.

Field	Type	Description
`Amount`	decimal	Payment amount; greater than 0
`BankResponse`	string	Bank terminal response, for card payments
`Code`	string	Payment type code — see payment types
`RRN`	string	RRN of the bank transaction, for card payments

Field	Type	Description
`ErrorCode`	int / enum	Error code; `0` (`OK`) means success. See error codes.
`ErrorMessage`	string	Human-readable error message
`CloudSyncWarning`	bool	At least one task in the queue has not yet been transmitted to MEV
`ShiftId`	int	ID of the shift (daily report) the task was registered in
`ShiftOrderId`	int	Sequence number of the task within the shift
`TaskId`	int	Sequence number of the task in the fiscal service queue
`TaskUid`	guid	Unique task ID — equals the request `Uid`, or is assigned automatically if it was missing
`QR`	string	Link to the MEV portal for validating the receipt. Show it as a QR code on the customer display or print it at the bottom of the receipt.

Field	Type	Description
`Amount`	decimal	Cash-in amount; a negative value is a withdrawal
`Reason`	int	Withdrawal reason: `0` — refund, `1` — cash collection. Accepted, but not processed by the current service version.
`ForcePrint`	bool	Force printing on paper (overrides the fiscal module settings)
`PrinterURI`	string	URI of the POS printer attached to the service used for printing the service receipt. Empty — the Windows default printer is used.

Field	Type	Description
`CloseReport`	bool	`true` — closing report (Z), `false` — non-closing (X)
`ForcePrint`	bool	Force printing on paper. A Z report may be printed without it if the service is configured to always print Z.
`PrinterURI`	string	URI of the POS printer attached to the service used for printing the report. Empty — the Windows default printer is used.

Field	Type	Description
`Lines`	string[]	Lines to print; at least one, otherwise error `20`
`PrinterURI`	string	URI of the POS printer attached to the service used for printing the text. Empty — the Windows default printer is used.

Field	Type	Description
`TaskId`	int	Queue number of the task to reprint
`TaskUid`	guid	Transaction GUID — the `Uid` sent at registration or the `TaskUid` received in the response. One of `TaskId` or `TaskUid` is enough; if both are sent, `TaskUid` wins.
`PrinterURI`	string	URI of the POS printer attached to the service used for printing the copy. Empty — the Windows default printer is used.

Code	MEV	Description	Allowed in
`1`	NUMERAR	cash	all
`2`	CARD	bank card	all
`3.1`	VAUCHER	voucher	all
`3.2`	CEC (CERTIFICAT VALORIC)	gift certificate	all
`3.3`	TICHET	document with a preset value, in lei	all
`5`	TME	electronic meal voucher	ACPS; ACPSPPGL — only on receipts without fuel
`6`	ABONAMENT	subscription	all
`7`	ALT TIP	other type	all
`8.1`	Credit	credit	ACPS (MEV v2), ACPSPPGL
`8.2`	Leasing	leasing	ACPS (MEV v2), ACPSPPGL
`8.3`	Avans	advance payment	ACPS (MEV v2), ACPSPPGL
`8.4`	Arvuna	deposit	ACPS (MEV v2), ACPSPPGL
`8.5`	Gaj	pledge	ACPS (MEV v2), ACPSPPGL

Code	Name	Meaning
Service
`0`	`OK`	the method completed successfully
`1`	`ServiceUnknownInternalError`	unknown internal service error
`2`	`ServiceDatabaseNotResponding`	the service database is not responding
`3`	`ServiceDatabaseCorrupted`	the service database is corrupted
`4`	`ServiceSignatureInvalid`	the service digital signature is invalid
`5`	`ServiceNotConfigured`	the service is not configured or misconfigured
`6`	`ServiceActivationCancelled`	the service registration in MEV was cancelled
`7`	`ServiceInvalidDateTime`	the clock of the computer running the service is wrong
`8`	`ServiceCloudSyncError`	transaction sync error with ISFiscalCloud and/or MEV
`9`	`ServiceDailyReportRequired`	a closing daily report (Z) is required
`10`	`ServiceDailyReportPrinting`	the closing daily report is being printed
`11`	`ServiceCloudConnectionError`	cannot connect to ISFiscalCloud (offline-forbidden configuration only)
`12`	`ServiceCloudTimeoutError`	ISFiscalCloud response timed out (offline-forbidden configuration only)
`13`	`ServicePaymentReceiptRangeNotSet`	MEV has been unreachable beyond the offline limit and the payment receipt number range is not set or exhausted
`14`	`ServiceSMSNotConfigured`	the request has `ClientPhone`, but SMS delivery is not configured in the service
`15`	`ServiceEmailNotConfigured`	the request has `ClientEmail`, but e-mail delivery is not configured in the service
`16`	`ServiceTaskProcessing`	a receipt or report is being registered right now; a new receipt cannot be accepted temporarily — retry in a few seconds
Request format
`20`	`FormatBillDoesNotContainLines`	the receipt has no lines
`21`	`FormatBillDoesNotContainPayments`	the receipt has no payments
`22`	`FormatIncorrectProductName`	product name is invalid or empty
`23`	`FormatIncorrectQuantity`	invalid quantity
`24`	`FormatIncorrectAmount`	invalid amount
`25`	`FormatIncorrectPrice`	invalid price
`26`	`FormatUnknownUnit`	unknown or disallowed unit
`27`	`FormatUnknownVAT`	unknown VAT rate
`28`	`FormatUnknownPayment`	unknown payment code
`29`	`FormatUnknownDepartment`	unknown department
`30`	`FormatPhoneNumberMissing`	phone number missing (required for `DisplayType` = 2)
`31`	`FormatEmailMissing`	e-mail missing (required for `DisplayType` = 3)
Processing
`40`	`ProcessingInsufficientFundsInBox`	not enough cash in the drawer
`41`	`ProcessingInsufficientPaymentAmount`	payment total is lower than the goods total
`42`	`ProcessingChangeCanNotBeCalculated`	change cannot be calculated
`43`	`ProcessingTaskNotFound`	task not found
`44`	`ProcessingTaskFinished`	task already finished
`45`	`ProcessingIllegalCommand`	command not allowed in the current state
`46`	`ProcessingTaskExists`	a receipt with this `Uid` already exists; the response carries its `TaskId`
Printer
`61`	`PrinterNotFound`	printer not found
`62`	`PrinterUnavailable`	printer unavailable
`63`	`PrinterOffline`	printer is offline
`64`	`PrinterHasJobsInQueue`	printer queue has pending jobs
`65`	`PrinterIsOutOfPaper`	printer is out of paper
Fiscal memory
`71`	`FiscalMemoryNotConnected`	fiscal memory not connected
`72`	`FiscalMemoryNotFiscalized`	fiscal memory not fiscalized
`73`	`FiscalMemoryIDReadingError`	error reading the fiscal memory ID
`74`	`FiscalMemoryWrongID`	wrong fiscal memory ID
`75`	`FiscalMemoryReportNotWritten`	report was not written to fiscal memory

ISFiscalService API

Prezentare

Conexiune şi formate

Diferenţe între formate

Coada de sarcini

Câmpurile comune ale tranzacţiilor

Fluxul tipic

Înregistrarea bonului fiscal

Lines · BillLine

Payments · BillPayment

Reguli de validare

Înregistrarea bonului de serviciu

Înregistrarea raportului zilnic

Tipărirea textului nefiscal

Tipărirea copiei unui bon sau raport

Tipărirea copiei ultimei tranzacţii

Starea serviciului

Lista rapoartelor fiscale

Tranzacţiile unei ture

Bonul fiscal înregistrat

Bonul de plată înregistrat

Bonul de serviciu înregistrat

Raportul X sau Z înregistrat

Imaginea tranzacţiei

Tipuri de plată

Coduri de eroare

ISFiscalService API

Обзор

Подключение и форматы

Различия форматов

Очередь задач

Общие поля транзакций

Типовой сценарий

Регистрация фискального чека

Lines · BillLine

Payments · BillPayment

Правила проверки

Регистрация служебного чека

Регистрация дневного отчёта

Печать нефискального текста

Печать копии чека или отчёта

Печать копии последней транзакции

Состояние сервиса

Список фискальных отчётов

Транзакции смены

Зарегистрированный фискальный чек

Зарегистрированная платёжная квитанция

Зарегистрированный служебный чек

Зарегистрированный X- или Z-отчёт

Изображение транзакции

Типы оплат

Коды ошибок

ISFiscalService API

Overview

Connection and formats

Format differences

Task queue

Common transaction fields

Typical flow

Register a fiscal receipt

Lines · BillLine

Payments · BillPayment

Validation rules

Register a service receipt

Register a daily report

Print non-fiscal text

Print a copy of a receipt or report

Print a copy of the last transaction

Service state

List fiscal reports

Transactions of a shift

A registered fiscal receipt

A registered payment receipt

A registered service receipt

A registered X or Z report

Transaction image

Payment types

Error codes

`Lines · BillLine`

`Payments · BillPayment`

`Lines · BillLine`

`Payments · BillPayment`

`Lines · BillLine`

`Payments · BillPayment`