|
<< Click pentru afișare cuprins >> Navigare: SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru documente contabile > GetRetailSaleDetails |
Metoda GetRetailSaleDetails este utilizata pentru intoarcerea copiei identice a tranzactiilor emise prin POS (bonuri fiscale) pentru o inchidere de zi.
Functia primeste ca parametru valorile RECVERSION si NRSHOP intoarse de metoda GetNextRetailSale ce trebuie apelata anterior.
Functia este destinata consultarii tranzactiilor de vanzare cu bon fiscal, la nivelul cel mai detaliat, pentru o inchidere de zi.
Tranzactiile sunt returnate exact asa cum au fost ele adaugate pe bonul fiscal in timp ce functia GetNextRetailSale este destinata sa intoarca aceste date cumulate cantitativ, impreuna cu descarcarea de gestiune, fara a mai exista referinta la bonul fiscal original.
Datele sunt returnate in mai multe noduri, subordonate nodului DATASET, iar in radacina sunt aduse detaliile inchiderii.
Nodurile returnate sunt: DATASET/POS_ITEMS pentru articole, DATASET/POS_PAYMENTS pentru tranzactiile generale de plata si DATASET/POS_COUPON_PAYMENTS pentru detalierea incasarilor pe tichete de valorice.
Atat datele intoarse in radacina cat si cele repartizate pe noduri, sunt descrise in continuare:
Parametri Apel
Parametru |
Descriere |
Tip Date |
aIDAPP |
ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash |
Integer |
aNRSHOP |
Codul magazinului folosit de catre utilizatori in programul SmartCash pentru magazinul respectiv. (returnata de apelul anterior al metodei GetNextRetailSale). |
Integer |
aIndexValue |
Valoarea RECVERSION returnata de apelul anterior al metodei GetNextRetailSale. |
Integer |
Campuri JSON returnate direct in radacina (identificatori inchidere POS)
Camp |
Descriere |
Tip Date |
NRPOS |
Numarul POS-ului de la care provin vanzarile cu amanuntul. |
Integer |
DOC |
Numarul descarcarii de gestiune din programul SmartCash aferente inchiderii respective de zi |
Integer |
DAY_CLOSURE_NUMBER |
Numarul de Z emis de casa de marcat sau de POS pentru vanzarile cu amanuntul din ziua respectiva. Numarul este unic pe POS si se poate repeta dupa inlocuirea unei memorii fiscale (dupa aprox 2700 de inchideri). In combinatie cu campul DOC este insa unic. |
Integer |
DATASET |
Nod care contine 3 sectiuni: POS_ITEMS, POS_PAYMENTS, POS_COUPON_PAYMENTS. |
Integer |
Campuri JSON returnate in nodul DATASET/POS_ITEMS
Camp |
Descriere |
Tip Date |
RECEIPT_NUMBER |
Numarul intern unic per NRPOS al bonului fiscal. |
Integer |
RECEIPT_NUMBER_RESET |
Codul de reset al numerotatiei interne al bonurilor fiscale. Valoarea initiala este zero. Pentru RECEIPT_NUMBER > 999999, numerotatia se reia de la 1 iar campul RECEIPT_NUMBER_RESET este incrementat cu o unitate. |
Integer |
IDSMARTCASH_ARTICLE |
ID-ul unic al articolului vandut in sistemul SmartCash ID-ul are valori intregi si pozitive pentru orice articol (marfa sau servicii) adaugat de catre utilizatori in SmartCash. ID-ul poate avea si urmatoarele valori negative, predefinite intern si rezervate pentru o serie de operatii comerciale: -3 = DISCOUNT PROCENTUAL COTA TVA A -4 = DISCOUNT PROCENTUAL COTA TVA B -5 = DISCOUNT PROCENTUAL COTA TVA C -6 = DISCOUNT PROCENTUAL COTA TVA D -7 = DISCOUNT PROCENTUAL COTA TVA E
-8 = DISCOUNT VALORIC COTA TVA A -9 = DISCOUNT VALORIC COTA TVA B -10 = DISCOUNT VALORIC COTA TVA C -11 = DISCOUNT VALORIC COTA TVA D -12 = DISCOUNT VALORIC COTA TVA E
-30 = AVANS COTA TVA A -31 = AVANS COTA TVA B -32 = AVANS COTA TVA C -33 = AVANS COTA TVA D -34 = AVANS COTA TVA E |
Integer |
IDEXTAPP_ARTICLE |
Codul extern al articolului |
String |
ARTICLE_DESCRIPTION |
Denumirea articolului asa cum a fost inregistrata pe bonul fiscal. |
String |
QTY |
Cantitatea vanduta pe linia de vanzare. Poate avea valori negative in cazul voidarilor. |
Float |
SALE_UM |
Unitatea de masura de vanzare pentru articolul respectiv |
String |
UNIT_PRICE |
Pretul de vanzare unitar inclusiv TVA-ul (pretul de raft) pe linia respectiva. |
Float |
SALE_VALUE_VAT_INCLUDED |
Valoarea de vanzare la pret intreg, inclusiv TVA pe linia respectiva. |
Float |
DISCOUNT_VALUE_VAT_INCLUDED |
Valoarea discount-ului acordat pe linia respectiva, inclusiv TVA-ul |
Float |
DISCOUNT_PERCENT |
Procentul de discount acordat pe linia respectiva. |
Float |
DISCOUNTED_ UNIT_PRICE |
Pretul de vanzare unitar dupa aplicarea reducerii inclusiv TVA-ul pe linia respectiva. |
Float |
VAT_PERCENT |
Procentul de TVA aplicat pe linie vanzare. |
Float |
SALE_DATE |
Data si ora la care s-a efectuat linia de tranzactie. |
DateTime |
IDSMARTCASH_CUSTOMER |
ID-ul unic al clientului in programul SmartCash in cazul in care bonul a fost emis pentru un client fidelizat. Daca bonul este anonim, acest camp este totdeauna = 0. |
Integer |
IDEXTAPP_CUSTOMER |
Codul clientului in sistemul extern in cazul in care bonul a fost emis pentru un client fidelizat si clientul are asociat un cod extern. Daca bonul este anonim, acest camp este totdeauna gol. |
String |
Campuri JSON returnate in nodul DATASET/ POS_PAYMENTS
Camp |
Descriere |
Tip Date |
RECEIPT_NUMBER |
Numarul intern unic per NRPOS al bonului fiscal. |
Integer |
RECEIPT_NUMBER_RESET |
Codul de reset al numerotatiei interne al bonurilor fiscale. Valoarea initiala este zero. Pentru RECEIPT_NUMBER > 999999, numerotatia se reia de la 1 iar campul RECEIPT_NUMBER_RESET este incrementat cu o unitate. |
Integer |
TYPEOF_PAYMENT |
Tipul de plata. Valori posibile: TYPEOF_PAYMENT=1 – NUMERAR TYPEOF_PAYMENT=2 – CEC TYPEOF_PAYMENT=3 – COUPON TYPEOF_PAYMENT=4 – CREDIT CARD |
Integer |
PAYMENT_VALUE |
Valoarea totala platita pe acest tip de plata. (inclusiv rest). |
Float |
PAYMENT_REST |
Valoarea restului (cu minus) pe aceasta forma de plata. |
Float |
PAYMENT_DATE |
Data si ora la care s-a efectuat linia de tranzactie de plata. |
DateTime |
PAYMENT_BANK_ID |
Identificatorul de tranzactie bancara in cazul platilor cu cardul sau metode online. |
String |
VAT_NUMBER |
Codul fiscal trecut pe bon in cazul bonurilor fiscale de tip factura simplificata. (CUI pe bon). |
String |
IDSMARTCASH_CUSTOMER |
ID-ul unic al clientului in programul SmartCash in cazul in care bonul a fost emis pentru un client fidelizat. Daca bonul este anonim, acest camp este totdeauna = 0. |
Integer |
IDEXTAPP_CUSTOMER |
Codul clientului in sistemul extern in cazul in care bonul a fost emis pentru un client fidelizat si clientul are asociat un cod extern. Daca bonul este anonim, acest camp este totdeauna gol. |
String |
Campuri JSON returnate in nodul DATASET/POS_COUPON_PAYMENTS
Camp |
Descriere |
Tip Date |
RECEIPT_NUMBER |
Numarul intern unic per NRPOS al bonului fiscal. |
Integer |
RECEIPT_NUMBER_RESET |
Codul de reset al numerotatiei interne al bonurilor fiscale. Valoarea initiala este zero. Pentru RECEIPT_NUMBER > 999999, numerotatia se reia de la 1 iar campul RECEIPT_NUMBER_RESET este incrementat cu o unitate. |
Integer |
COUPON_VALUE |
Valoarea unitara a tichetului valoric. |
Float |
PAYMENT_DATE |
Data si ora la care s-a efectuat linia de tranzactie de plata. |
DateTime |
QTY |
Numarul de tichete valorice incasate. |
Integer |
COUPON_NAME |
Numele tichetului. |
String |
COUPON_CODE |
Codul tichetului. |
String |
COUPON_EXPIRE_DATE |
Data la care expira tichetul. |
DateTime |
COUPON_SUPPLIER |
Denumirea furnizorului tichetului. |
String |
GIFTCARD_CODE |
Codul unic al bonurilor cadou (in caz ca exista). |
String |
IDSMARTCASH_CUSTOMER |
ID-ul unic al clientului in programul SmartCash in cazul in care bonul a fost emis pentru un client fidelizat. Daca bonul este anonim, acest camp este totdeauna =0. |
Integer |
IDEXTAPP_CUSTOMER |
Codul clientului in sistemul extern in cazul in care bonul a fost emis pentru un client fidelizat si clientul are asociat un cod extern. Daca bonul este anonim, acest camp este totdeauna gol. |
String |