|
<< 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 |