GetCustomerInfo

<< Click pentru afișare cuprins >>

Navigare:  SmartCash Everywhere REST Server > Metode de citire SmartCash Everywhere REST Server > Metode de citire pentru nomenclatoare primare >

GetCustomerInfo

Metoda GetCustomerInfo este utilizata pentru intoarcerea tuturor informatiilor disponibile despre un client existent in sistemul SmartCash RMS. Daca clientul este cautat dupa codul dvs. din aplicatie (IDEXTAPP) si acesta nu este unic asociat in SmartCash, atunci sunt intoarse toate articolele care corespund aceluiasi cod. Pentru cautarile dupa IDSMARTCASH totdeauna rezultatul este unic sau vid (daca nu exista nici un articol corespunzator).

 

Parametri Apel

Parametru

Descriere

Tip Date

aIDAPP

ID unic alocat aplicatiei care se conecteaza la serverul REST SmartCash

Integer

aTypeOf

Flag care specifica tipul de cod dupa care se face cautarea articolului in baza de date SmartCash RMS.

Daca:

aTypeOf=1 cautarea se face dupa IDSMARTCASH, codul unic SmartCash pentru orice client (Camp IDCLIENT SmartCash) si totdeauna poate fi returnata doar o singura linie (un singur articol);

aTypeOf=2 cautarea se face dupa IDEXTAPP, codul de cleint extern (cheia primara proprie) din aplicatia dvs. pentru client;

aTypeOf=3 cautarea se face dupa adresa de e-mail a clientului;

aTypeOf=4 cautarea se face dupa Codul Fiscal (CUI sau CNP);

aTypeOf=5 cautarea se face dupa codul de bare de pe cardul de fidelitate al clientului (diferit de IDEXTAPP). In cazul in care sunt identificati mai multi clienti cu acelasi card de fidelitate dar provenind de la mai multi furnizori de carduri, sunt returnati toti, avand insa IDSUPPLIERCARD diferit;

aTypeOf=6 cautarea se face dupa numarul de telefon;

aTypeOf=7 cautarea se face dupa adresa de e-mail;

Integer

aValueSearch

Valoarea codului IDSMARTCASH sau IDEXTAPP dupa care se face cautarea corespunzator flag-ului aTypeOf.

String

 

 

Campuri JSON returnate

Camp

Descriere

Tip Date

RECVERSION

Versiunea setului curent de date. Se utilizeaza la confirmarea primirii (si utilizarii cu succes) a datelor folosind functia ConfirmReceivingDataByTypeOf

Integer

IDSMARTCASH

Codul unic al clientului in sistemul SmartCash

Integer

IDEXTAPP

Codul clientului in sistemul extern

String

NAME

Numele clientului

String

TOWN

Localitatea

String

PHONE

Nr. de Telefon

String

FAX

Nr. de Fax

String

GLN

Global Location Numer pentru clientul respectiv (ILN/GLN)

String

EMAIL

Adresa de e-mail a clientului

String

VAT_NUMBER

Codul fiscal al clientului (CUI sau CNP)

String

VAT_NUMBER_TYPE

Tipul codului fiscal (CUI/CNP)

Integer

TRADE_NUMBER

Nr. Registrul Comertului

String

ALLOW_INVOICES

Flag care semnalizeaza daca este permisa sau nu facturarea catre clientul respectiv. 1 = Permis, 0 = Interzis

Integer

BANK_ACCOUNT

Numarul contului

String

BANK_NAME

Numele Bancii la care e deschis contul clientului respectiv

String

COUNTRY

Tara. Ex. Romania

String

COUNTRY_CODE

Codul international de Tara format din 2 litere

String

COUNTY

Judetul. Denumirea este identica cu cea din nomenclatorul de judete SmartCash RMS care poate fi obtinut cu metoda GetAllLocalities.

String

COUNTY_CODE

Codul de Judet din max. 2 litere

String

TOWN

Localitatea. Denumirea este identica cu cea din nomenclatorul de judete SmartCash RMS care poate fi obtinut cu metoda GetAllLocalities.

String

TOWN_CODE

Codul localitatii 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).

String

STREET_ADDRESS

Adresa care contine informatiile de strada, numar, bloc, etaj apartament cu exceptia celor de tara, judet si localitate.

String

POSTALCODE

Cod Postal

String

LATITUDE

Latitudinea (in grade zecimale cu precizie de 7 zecimale)

Float

LONGITUDE

Longitudinea (in grade zecimale cu precizie de 7 zecimale)

Float

NOTES

Observatii diverse de tip text

String

CARD_CODE

Codul cardului de client generat din sistemul SmartCash RMS (cod card generat in SmartCash) daca acesta exista.

String

DISCOUNT

Discount-ul fix acordat clientului respectiv. Daca valoarea este pozitiva atunci este majorare, pentru discount valoarea trebuie sa fie negativa.

Float

IDCUSTOMER_TYPE

ID-ul unic in sistemul SmartCash al tipului de Client.

Integer

CUSTOMER_TYPE

Denumirea tipului de client SmartCash

String

LISTED

Flag care semnalizeaza daca clientul este activ sau inactiv. 1=Activ, 0=Inactiv.

Integer

FIRSTNAME

Prenumele persoanei de contact fidelizate (poate lipsi in cazul clientilor firme)

String

LASTNAME

Numele de familie al persoanei de contact fidelizate (poate lipsi in cazul clientilor firme)

String

DATEOFBIRTH

Data Nasterii pentru persoana de contact

Data

FACEBOOK_ID

ID Facebook

String

IDSUPPLIERCARD

Codul SmartCash al Furnizorului de Fidelizare (Valoare intreaga fixa din SmartCash, 1 = Cod Card propriu SmartCash >1 pentru alti furnizori de carduri). Valoarea se stabileste in SmartCash si ramane fixa pentru un furnizor de fidelizare.

Integer

CARD

Codul de Card (sau de fidelizare) al clientului, corespunzator Furnizorului de Fidelizare cu ID-ul IDSUPPLIERCARD

String

CUST_BALANCE_T2

Volumul total de cumparaturi efectuate de catre client de la intrarea in program (sau de la ultima resetare) pentru programe de fidelizare de tipar 2 (discount progresiv). Volumul este actualizat dinamic si permite acumularea selectiva a valorii cumparaturilor pe baza de filtre specifice programului de fidelizare. Daca clientul nu este asociat unui program de fidelizare de tipar 2 campul are valoarea zero.

Float

CUST_BALANCE_T4_TOTAL

Volumul total de cumparaturi efectuate de catre client de la intrarea in program pentru programe de fidelizare de tipar 4 (creditare lunara). Volumul este actualizat dinamic si permite acumularea selectiva a valorii cumparaturilor pe baza de filtre specifice programului de fidelizare. Volumul total are o valoare pozitiva doar daca bonificarea valorica continua este activata pentru programul respectiv. Daca clientul nu este asociat unui program de fidelizare de tipar 4 campul are valoarea zero.

Float

CUST_BALANCE_T4_LM

Volumul de cumparaturi inregistrat in luna calendaristica precedenta efectuate de catre client pentru programe de fidelizare de tipar 4 (creditare lunara). Volumul este actualizat lunar si permite acumularea selectiva a valorii cumparaturilor pe baza de filtre specifice programului de fidelizare. Volumul lunar are o valoare pozitiva doar daca bonificarea lunara este activata pentru programul respectiv. Daca clientul nu este asociat unui program de fidelizare de tipar 4 campul are valoarea zero.

Float

CUST_CREDIT

Valoarea creditului exprimat in lei de care dispune clientul la momentul curent ca urmare a apartenentei la un program de fidelizare de tipar 3 sau 4. Creditul poate fi consumat ca forma de plata alternativa exclusiv prin sistemele POS Magister.

Float

CUST_LAST_SALEDATE

Data ultimei tranzactii de vanzare inregistrate de client. Aceasta valoare este folosita pentru validarea conditiei de resetare a programelor de fidelizare de tipar 2. (discount progresiv).

DateTime

FDT_1 ... FDT_N

Campuri personalizate de catre utilizator in cazul in care acestea au fost definite.

String