GetNextCashRegisterDay

<< Click pentru afișare cuprins >>

Navigare:  SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru documente si informatii operationale >

GetNextCashRegisterDay

Metoda GetNextCashRegisterDay este utilizata pentru intoarcerea tuturor documentelor inregistrate pe registrul de casa al unui magazin intr-o zi. Metoda intoarce la fiecare apelare cate o zi din registrul de casa, in ordine cronologica, incepand cu prima data care contine modificari pe registrul de casa care nu au fost inca preluate de catre aplicatia dvs.

Metoda trebuie urmata de confirmare prin metoda ConfirmReceivingDataByTypeOf (aTYPEOF=34).

In cadrul unei zile, inregistrarile documentelor sunt intoarse in ordinea exacta in care ele sunt colectate pe registrul de casa din magazinul respectiv. Aceasta ordine trebuie pastrata la utilizarea datelor intr-o aplicatie terta deoarece pe fiecare linie de document este inregistrat soldul initial (DOC_INITIAL_ BALANCE) si respectiv soldul final (DOC_FINAL_ BALANCE) al registrului de casa. Astfel soldul initial al primei inregistrari din setul de date este soldul initial al zilei de casa iar soldul final al ultimelei inregistrari din setul de date este soldul final la inchiderea zilei de casa. Acesta trebuie sa se regaseasca ca sold initial pe urmatoarea zi in care au fost efectuate miscari de numerar.

Campurile zilnice de sold initial (DAY_INITIAL_ BALANCE) si sold final (DAY_FINAL_ BALANCE) se repeta pentru fiecare linie de document.

In cazul zilelor fara miscari de numerar sunt intoarse valori doar pentru campurile RECVERSION...DAY_DATA, intr-o singura inregistrare avand soldul initial (DAY_INITIAL_ BALANCE) si soldul final (DAY_FINAL_ BALANCE) egale.

Metoda poate aduce aceeasi zi de mai multe ori (chiar daca a fost confirmata) daca intre timp un operator a adaugat alte documente in sistem. In principiu daca un operator a adaugat un document din urma cu xx zile, sistemul va retransmite datele din urma cu xx zile. (chiar daca acele zile au fost confirmate).

 

Parametri Apel

Parametru

Descriere

Tip Date

aIDAPP

ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash

Integer

 

Campuri JSON returnate

Camp

Descriere

Tip Date

RECVERSION

Versiunea setului curent de date.

Integer

SHOP_NAME

Denumirea magazinului din care provin documentele anulate.

String

NRSHOP

Codul magazinului folosit de catre utilizatori in programul SmartCash pentru magazinul din care provin documentele anulate.

Integer

IDSMARTCASH_SHOP

ID-ul unic al magazinului din care provin documentele anulate in sistemul SmartCash

Integer

IDEXTAPP_SHOP

Codul extern al magazinului respectiv.

String

DAY_INITIAL_BALANCE

Soldul de casa initial al zilei respective.

Float

DAY_FINAL_BALANCE

Soldul de casa final al zilei respective.

Float

DAY_DATA

Data tuturor documentelor din registrul de casa din ziua respectiva. Se repeta identic pe fiecare linie de document din setul de date.

String

DOC_TYPE

Tipul documentului de plata/incasare:

DOC_TYPE=1 – Incasare cu Numerar (alta decat prin casa de marcat, introdusa manual de operator)

DOC_TYPE=2 – Plata cu Numerar

DOC_TYPE=3 – Incasare cu numerar prin casa de marcat (colectat automat)

DOC_TYPE=4 – Diferenta de incasare cu numerar intre raportul Z de inchidere si monetarul pe cupiuri colectat de catre casier la inchiderea de zi. (In cazul in care aceasta functie este utilizata).

Integer

DOC_TYPE_NAME

Denumirea documentului de incasare/plata.

String

DOC

Numarul documentului de incasare/plata.

String

DOC_NOTES

Explicatia incasarii/platii asa cum a fost introdusa de catre operator.

String

IDSMARTCASH_DOC

ID-ul unic al tipului de document in sistemul SmartCash. Lista tipurilor de documente poate fi extrasa cu metoda GetAllDocumentTypes.

Integer

DOC_VALUE

Valoarea documentului de incasare/plata. Valoarea este pozitiva pentru incasari (intrari de numerar) si negativa pentru plati (iesiri de numerar).

Float

DOC_INITIAL_BALANCE

Soldul de casa initial inaintea introducerii documentului respectiv.

Float

DOC_FINAL_BALANCE

Soldul de casa final ca urmare a introducerii documentului respectiv.

Float

IDSMARTCASH_OPERATOR

ID-ul unic al operatorului care a generat documentul.

Integer

OPERATOR_LASTNAME

Numele operatorului care a generat documentul.

String

OPERATOR_FIRSTNAME

Prenumele operatorului care a generat documentul

String

IS_CANCELED

Camp care semnalizeaza faptul ca documentul a fost anulat (sters) de pe registrul de casa al magazinului respectiv. Pentru identificarea operatiilor de stergere documentul original este pastrat fara o valoare financiara, operatorul care a efectuat anularea fiind inregistrat pentru audit ulterior.

Integer

CANCELED_DOC_VALUE

Valoarea originala a documentului de incasare/plata care a fost anulat. Valoarea este pozitiva pentru incasari (intrari de numerar) si negativa pentru plati (iesiri de numerar).

Float

CANCELED_DATE

Data si ora la care a fost efectuata operatia de anulare a documentului pe registrul de casa din magazin.

String

IDSMARTCASH_CANCEL_OPERATOR

ID-ul unic al operatorului care a anulat documentul.

Integer

CANCEL_OPERATOR_LASTNAME

Numele operatorului care a anulat documentul.

String

CANCEL_OPERATOR_FIRSTNAME

Prenumele operatorului care a anulat documentul

String