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