GetReceiptDetails

<< Click pentru afișare cuprins >>

Navigare:  SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru documente contabile >

GetReceiptDetails

Metoda GetReceiptDetails este utilizata pentru intoarcerea copiei identice a tranzactiilor emise prin POS  (bonuri fiscale) pentru un anumit numar de bon.

Functia primeste ca parametru valorile NRSHOP, NRPOS, NRBON, NRZ.

Functia este destinata consultarii tranzactiilor de vanzare cu bon fiscal, la nivelul cel mai detaliat, pentru un bon fiscal. Tranzactiile sunt returnate exact asa cum au fost ele adaugate pe bonul fiscal.

Datele sunt returnate in mai multe noduri, subordonate nodului DATASET, iar in radacina sunt aduse anumite detalii ale bonului.

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.

Integer

aNRPOS

Numarul POS-ului de la care provin vanzarile cu amanuntul.

Integer

aNRBON

Numarul bonului fiscal.

Integer

aNRZ

Numarul de Z emis de casa de marcat.

Integer

 

Campuri JSON returnate direct in radacina (identificatori inchidere POS)

Camp

Descriere

Tip Date

NRSHOP

Numarul magazinului.  

Integer

NRPOS

Numarul POS-ului de la care provin vanzarile cu amanuntul.

Integer

RECEIPT_NUMBER

Numarul intern unic per NRPOS al bonului fiscal.

Integer

Z_NUMBER

Numarul raportului Z aferent bonului fiscal

Integer

 

 

Campuri JSON returnate in nodul 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

 

Campuri JSON returnate in nodul 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

 

Campuri JSON returnate in nodul 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

 

Campuri JSON returnate in nodul INVOICE

Camp

Descriere

Tip Date

IDSMARTCASH_CUSTOMER

ID-ul unic al clientului in programul SmartCash.

Integer

IDEXTAPP_CUSTOMER

Codul clientului in sistemul extern.

String

NAME_CUSTOMER

Numele clientului.

String

VAT_NUMBER_CUSTOMER

Codul fiscal al clientului (CUI sau CNP).

String

DATADOC

Data facturii la bon fiscal.

DateTime

DOC

Numarul facturii la bon fiscal.

String