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