GetRetailSaleDetails

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