GetNextWholeSale

<< Click pentru afișare cuprins >>

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

GetNextWholeSale

Metoda GetNextWholeSale este utilizata pentru intoarcerea urmatoarei vanzari cu ridicata inregistrata intr-un magazin din retea, vanzare care nu a fost inca prelucrata de catre aplicatia dvs. Datele sunt returnate pe linii, detaliat la nivel de articole. Campurile de tip antet (SHOP_NAME, DATADOC, etc) se repeta pentru fiecare linie de articol. Acelasi articol poate fi multiplicat daca corespunde la loturi de fabricatie diferite sau preturi de achizitie diferite (de iesire).

Metoda trebuie urmata de confirmare prin metoda ConfirmReceivingDataByTypeOf.

 

Parametri Apel

Parametru

Descriere

Tip Date

aIDAPP

ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash

Integer

 

Campuri JSON returnat

Camp

Descriere

Tip Date

RECVERSION

Versiunea setului curent de date.

Integer

SHOP_NAME

Denumirea magazinului din care provin vanzarile respective

String

NRSHOP

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

Integer

IDSMARTCASH_SHOP

ID-ul unic al magazinului din care provin vanzarile cu amanuntul in sistemul SmartCash

Integer

IDEXTAPP_SHOP

Codul extern al magazinului respectiv

String

IDSMARTCASH_CUSTOMER

ID-ul unic al clientului in sistemul SmartCash. Clientii din nomenclatorul sistemului SmartCash RMS au totdeauna pentru codul IDSMARTCASH_CUSTOMER o valoare pozitiva unica. Incepand cu versiunea 18.0 SmartCash RMS, a fost adaugat suport pentru clientii anonimi (GUEST). Acestia sunt clienti care nu se salveaza in nomenclatorul de clienti ci exclusiv pe comanda de livrare aferenta. Pentru acesti clienti campul IDSMARTCASH_CUSTOMER are valoarea fixa, -5. In acest caz detaliile clientului sunt obtinute din noile campuri cu prefixul „INVOICE_...” returnate de aceasta metoda.

Integer

IDEXTAPP_CUSTOMER

Codul clientului corespunzator aplicatiei cu ID-ul IdApp. Acest cod este specific fiecarui client generat in aplicatia terta si se cupleaza cu SmartCash ca un cod echivalent de fidelizare. Pentru clientii mapati, pot exista un numar nelimitat de coduri IDEXTAPP_CUSTOMER, cate unul pentru fiecare aplicatie terta identificat prin IDAPP.

String

NAME_CUSTOMER

Numele clientului.

String

VAT_NUMBER_CUSTOMER

Codul fiscal al clientului.

String

DOC

Numarul (si seria) facturii emise in programul SmartCash.

Integer

DATADOC

Data facturii emise in programul SmartCash.

String

EXTERNAL_ORDER_NUMBER

Camp optional care, daca este furnizat, reprezinta comanda externa ce a fost livrata cu factura respectiva (in cazul in care factura corespunde unei comenzi sosite de exemplu de pe un site online).

String

IDDELIVERY

ID-ul ordinului de livrare adaugat prin comanda AddNewDeliveryOrder in sistemul SmartCash (daca a existat un astfel de ordin de livrare)

Integer

NOTES

Observatii optionale diverse de tip text.

String

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

QTY

Cantitatea vanduta din articolul respectiv (la vanzarea pe mai multe loturi se poate defalca pe cantitati corespondente pe lot)

Float

SALE_UM

Unitatea de masura de vanzare pentru articolul respectiv

String

UNIT_COST

Pretul de achizitie unitar al articolului respectiv (nu include TVA)

Float

UNIT_PRICE

Pretul de vanzare unitar inclusiv TVA-ul (pretul de raft) pe articolul respectiv

Float

COST_VALUE

Valoarea de achizitie (QTY * UNIT_COST) pe articolul respectiv (nu include TVA)

Float

SALE_VALUE_VAT_INCLUDED

Valoarea de vanzare la pret intreg, inclusiv TVA pe articolul respectiv

Float

DISCOUNT_VALUE_VAT_INCLUDED

Valoarea discount-ului acordat pentru articolul respectiv, inclusiv TVA-ul

Float

DISCOUNTED_SALE_VALUE_VAT_INCLUDED

Valoarea incasata efectiv pentru articolul respectiv, inclusiv TVA dupa aplicarea discount-ului.

Float

DISCOUNTED_SALE_VALUE

Valoarea incasata efectiv pentru articolul respectiv, exclusiv TVA dupa aplicarea discount-ului.

Float

VAT_PERCENT

Procentul de TVA aplicat pe articolul respectiv

Float

VAT_COST_VALUE

Valoarea TVA-ului la pret de achizitie pe articolul respectiv

Float

VAT_SALE_VALUE

Valoarea TVA-ului aplicat pentru valoarea de vanzare intreaga (la pretul de pe raft) pe articolul respectiv

Float

VAT_DISCOUNTED_SALE_VALUE

Valoarea TVA-ului aplicat pentru valoarea de vanzare redusa (la pretul redus dupa aplicarea discount-ului) pe articolul respectiv

Float

MARGIN_VALUE

Valoarea marginii comerciale (nu include TVA) fata de valoarea de vanzare la pret intreg.

Float

DISCOUNTED_MARGIN_VALUE

Valoarea marginii comerciale efective (nu include TVA) dupa ce s-a scazut discount-ul.

Float

BATCH

Lotul de fabricatie

Float

BATCH_DATE

Data Lotului de fabricatie

Float

BATCH_DESCRIPTION

Descrierea lotului de fabricatie

String

CURRENCY

Denumirea valutei in cazul in facturilor in valuta.

String

CURRENCY_RATE

Cursul de schimb dintre valuta si leu.

Float

CURRENCY_UNIT_PRICE

Pretul de vanzare unitar exprimat in valuta inclusiv TVA-ul (pretul de raft) pe articolul respectiv.

Float

CURRENCY_DISCOUNTED_SALE_VALUE_VAT_INCLUDED

Valoarea incasata efectiv in valuta pentru articolul respectiv, inclusiv TVA dupa aplicarea discount-ului.

Float

CURRENCY_DISCOUNTED_SALE_VALUE

Valoarea incasata efectiv in valuta pentru articolul respectiv, exclusiv TVA dupa aplicarea discount-ului.

Float

ACCOUNTING_CODE

Codul categoriei contabile din care articolul curent face parte, implicit valoarea 1 = Marfa, 2 = Materie Prima.

String

CATEG_1_CODE

Codul categoriei aferent criteriului de clasificare 1.

String

CATEG_2_CODE

Codul categoriei aferent criteriului de clasificare 2.

String

CATEG_3_CODE

Codul categoriei aferent criteriului de clasificare 3.

String

CATEG_4_CODE

Codul categoriei aferent criteriului de clasificare 4.

String

CATEG_5_CODE

Codul categoriei aferent criteriului de clasificare 5.

String

CATEG_6_CODE

Codul categoriei aferent criteriului de clasificare 6.

String

CATEG_7_CODE

Codul categoriei aferent criteriului de clasificare 7.

String

CATEG_8_CODE

Codul categoriei aferent criteriului de clasificare 8.

String

CATEG_9_CODE

Codul categoriei aferent criteriul de clasificare 9.

String

CATEG_10_CODE

Codul categoriei aferent criteriului de clasificare 10.

String

NC_CODE

Codul vamal NC.

String

CPV_CODE

Codul CPV SEAP.

String

INVOICE_FIRSTNAME

Prenumele persoanei de contact pentru comanda aferenta facturii respective, daca aceasta are o comanda de livrare asociata. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_LASTNAME

Numele de familie al persoanei de contac pentru comanda aferenta facturii respective, daca aceasta are o comanda de livrare asociata. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_PHONE

Nr. de telefon al persoanei de contact  pentru comanda aferenta facturii respective, daca aceasta are o comanda de livrare asociata. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_EMAIL

Adresa de e-mail a persoanei de contact (email cont eCommerce). Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_COMPANY_NAME

Numele firmei catre care s-a emis factura fiscala pentru o comanda de livare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_VAT_NUMBER

Codul fiscal al clientului (CUI, CNP, Altele). Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_TRADE_NUMBER

Nr. Registrul Comertului. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_COUNTRY_CODE

Codul de Tara pentru adresa de facturare. Codul trebuie sa fie cel din nomenclatorul de tari SmartCash RMS, care este egal cu codul international din 2 litere al tarii. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_COUNTRY

Tara pentru adresa de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_COUNTY_CODE

Codul de Judet pentru adresa de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_COUNTY

Judetul pentru adresa de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_TOWN_CODE

Codul localitatii pentru adresa de facturare, din nomenclatorul SmartCash RMS care poate fi obtinut cu metoda GetAllLocalities. Acest cod este egal cu codul unic SIRUTA al localitatii disponibil pe site-ul Ministerului Dezvoltarii (pentru Romania) pentru localitati cu nivelul 3 ierarhic. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_TOWN

Localitatea pentru adresa de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_STREET_ADDRESS

Adresa de facturare care contine informatiile de strada, numar, bloc, etaj apartament cu exceptia celor de tara, judet si localitate. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

INVOICE_POSTALCODE

Codul Postal pentru adresa de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

USE_DELIVERY_ADRESS

Campul are valoarea 1 daca adresa de livrare este diferita de cea de facturare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

Integer

 

DELIVERY_FIRSTNAME

Prenumele persoanei care va ridica comanda de la adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_LASTNAME

Numele de familie al persoanei care va ridica comanda de la adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_PHONE

Nr. de telefon al persoanei care va ridica comanda. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_COUNTRY_CODE

Codul de Tara pentru adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_COUNTRY

Tara pentru adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_COUNTY_CODE

Codul de Judet pentru adresa de livrare Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_COUNTY

Judetul pentru adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_TOWN_CODE

Codul localitatii pentru adresa de livrare, din nomenclatorul SmartCash RMS care poate fi obtinut cu metoda GetAllLocalities. Acest cod este egal cu codul unic SIRUTA al localitatii disponibil pe site-ul Ministerului Dezvoltarii (pentru Romania) pentru localitati cu nivelul 3 ierarhic. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_TOWN

Localitatea pentru adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_STREET_ADDRESS

Adresa de livrare care contine informatiile de strada, numar, bloc, etaj apartament cu exceptia celor de tara, judet si localitate. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String

 

DELIVERY_POSTALCODE

Codul Postal pentru adresa de livrare. Campul va fi utilizat exclusiv pentru clienti de tip GUEST care au IDSMARTCASH_CUSTOMER = -5 (clienti anonumi).

String