|
<< Click pentru afișare cuprins >> Navigare: SmartCash eCommerce Service > Instalare si Configurare > Configurare instante SmartCash eCommerce Framework - SmartCash RMS |
Fișierul de configurare definește una sau mai multe instanțe de integrare între Smart Cash RMS, SmartCash eCommerce Framework sau WooCommerce API.
•[ECommerceInstance_<NrInstanta>] -Fiecare instanță este identificată printr-o secțiune. Exemplu:[ECommerceInstance_1], [ECommerceInstance_2].
•DbUsername=SYSDBA
DbPassword=masterkey
Fiecare instanță utilizează propria bază de date cache Firebird: C:\ProgramData\Magister\SmartCashECommerce\Databases\DATABASE_X.FDB unde X reprezintă numărul instanței.
•isWriteLog-Activează sau dezactivează generarea fișierelor jurnal (log). Logurile conțin informații despre operațiile efectuate de serviciu și sunt utilizate pentru diagnosticarea problemelor.
Valori: 0 – logarea este dezactivată (recomandat în producție);
1 – logarea este activă.
•EverywhereRESTServerURL-Adresa serviciului Everywhere REST la care modulul se conecteaza pentru integrare cu SmartCash RMS.
•EverywhereRESTServerUsername-Se completeaza numele de acces la serviciul Everywhere REST la care modulul se conecteaza pentru integrare cu SmartCash RMS.
•EverywhereRESTServerPassword-Se completeaza cu parola de acces la serviciul Everywhere REST la care modulul se conecteaza pentru integrare cu SmartCash RMS
•EverywhereRESTAuthKey-Tipul de autentificare la serviciul Everywhere REST la care modulul se conecteaza pentru integrare cu SmartCash RMS
•EverywhereRESTServerIDApp-Se completeaza cu ID-ul aplicatiei web corespunzatoare sit-ului eCommerce conectat, asa cum a fost el definit in SmartCash RMS.
•EverywhereRESTServerNrShop-Se completeaza cu numarul magazinului din reteaua SmartCash RMS cu care se mapeaza lista de preturi aferenta magazinului online
•ECommerceAPIURL-Se completeaza cu adresa specifică (URL) endpoint-ului WooCommerce REST API la care SmartCash eCommerce Framework se conectează pentru a sincroniza datele dintre SmartCash RMS și magazinul online.
•ECommerceAPIMagisterKey- Se completeaza cu cheia de licență emisă de Magister Software pentru instanța SmartCash eCommerce Framework. Această cheie identifică și autorizează utilizarea modulului de integrare dintre SmartCash RMS și platforma eCommerce.
•ECommerceAPIClientKey- Se completeaza cu cheia clientului utilizată pentru autentificarea SmartCash eCommerce Framework în API-ul REST WooCommerce.
•ECommerceAPISecretKey- Se completeaza cu (Secret Key) utilizată pentru autentificarea SmartCash eCommerce Framework în API-ul REST WooCommerce.
•ArticlesReceiveInterval: Stabilește intervalul, exprimat în minute, la care serviciul verifică existența modificărilor de articole în SmartCash RMS și le copiază în baza de date cache locală.
Valori: 0 – sincronizarea articolelor din SmartCash este dezactivată;
1-5 – sincronizare foarte frecventă, recomandată doar pentru testare;
10-30 – recomandată pentru exploatarea normală.
•CustomersReceiveInterval-Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Catalogul de Clienti si primirea lor din sistemul SmartCash RMS in baza de date cache a modulului
•StoresReceiveInterval-Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Catalogul de Magazine si primirea lor din sistemul SmartCash RMS in baza de date cache a modulului
•StockReceiveInterval- Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Stoc si primirea lui din sistemul SmartCash RMS in baza de date cache a modulului.
•ArticlesSendInterval- Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Catalogul de Articole din baza de date cache a modulului si transmiterea lor catre API eCommerce.
•CustomersSendInterval- Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Catalogul de Clienti din baza de date cache a modulului si transmiterea lor catre API eCommerce.
•StoresSendInterval- Se completeaza cu intervalul masurat in minute de verificare a actualizarilor pentru Catalogul de Magazine din baza de date cache a modulului si transmiterea lor catre API eCommerce
•StockSendInterval- Se completeaza cu intervalul masurat in minute de verificare a actualizarilor de Stoc din baza de date cache a modulului si transmiterea lor catre API eCommerce.
•OrdersReceiveInterval -Se completeaza cu intervalul masurat in minute de verificare a noilor comenzi salvate pe site-ul eCommerce si de primire a lor din API eCommerce in baza de date cache a modulului.
Daca valoarea este 0 sau nula nu se sincronizeaza comenzile online.
•OrdersSendInterval-Se completeaza cu intervalul masurat in minute de transmitere a noilor comenzi salvate in baza de date cache a modulului catre SmartCashRMS. Daca valoarea este 0 sau nula nu se sincronizeaza comenzile online.
•OrdersSyncDate- Se completeaza cu Data incepand cu care comenzile online sunt sincronizare cu sistemul SmartCashRMS. Formatul de data este YYYY.MM.DD. Daca nu este furnizat sincronizarea comenzilor este oprita.
•OrdersStatusReceiveInterval- Se completeaza cu Intervalul masurat in minute de verificare a modificarilor de stare pentru ordinele de livrare din SmartCashRMS. Daca valoarea este 0 sau nula nu se sincronizeaza starile comenzilor.
•OrdersStatusSendInterval-Se completeaza cu intervalul masurat in minute de verificare a modificarilor de stare pentru transmiterea lor catre site-ul eCommerce. Daca valoarea este 0 sau nula nu se sincronizeaza starile comenzilor.
•LogDaysLife- Se completeaza cu durata maxima a inregistrarilor din Log-ul acestui modul.
•SmartCashMappedCategories- Se completeaza cu ID-ul categoriilor din SmartCash RMS ce sunt mapate cu categoriile din site Ordinea in lista separata de virgule este cea a ierarhiei acestor categorii. Daca valoare este nula, nu se foloseste maparea clasificarilor si nici o clasificare nu va fi generata automat pe site.
•SmartCashMappedAtributes- Se completeaza cu ID-ul categoriilor din SmartCash RMS ce sunt mapate cu atributele ce identifica Variantii din site. Daca valoarea este nula, nu se foloseste clasificarea pentru atribute varianti.
•IgnoreVariants- Se completeaza cu Optiunea care ignora articolele de tip varianti si le trateaza ca articole standard la transmiterea catre site. Daca valoarea este nula programul functioneaza normal tratand variantii in mod natural. Daca valoarea este 1 toate articolele de tip variant sunt transmise catre site ca articole principale, iar articolul generic la care sunt alocati variantii este ignorat.
•ArticlePagedRecords- Se completeaza cu numarul maxim de articole care poate fi trimis catre API eCommerce in cazul adaugarii/actualizarii inregistrarilor. Valoare maxima 99.
•IsUpdateTaxes- Actualizare cote TVA. Valori posibile 1 = Lista de cote TVA este transmisa catre API Ecommerce si 0 sau nimic = Lista de cote TVA NU este transmisa. Verificarea se face la fiecare ciclu de actualizare articole. Dupa prima tramsitere a cotelor de TVA optiunea poate fi dezactivata. Se activeaza doar daca se adauga o noua cota TVA in SmartCash, apoi se dezactiveaza.
•IsUpdateArticleDetails-Actualizare definitii articole. Valori posibile 1 = Artibutele sunt actualizate si 0 sau nimic = dupa adaugarea initiala detaliile articolelor nu mai sunt actualizate.
•PrimaryArticleNameField- Campul utilizat pentru denumirea principala de pe eCommerce.
Valori posibile:
NAME = Denumirea principala a articolului din SmartCashRMS.
DESCRIPTION = Descrierea secundara scurta a articolului din SmartCashRMS.
DETAILS = Descrierea secundara scurta a articolului din SmartCashRMS.
•PrimaryArticleNameSpelling-Se completeaza cu Campul utilizat pentru denumirea principala de pe eCommerce.
Valori posibile:
0 = Denumirea articolului din SmartCash ramane nemodificata.
1 = Denumirea articolului din SmartCash va fi convertita cu litera mare la inceput de propozitie.
2 = Denumirea articolului din SmartCash va fi convertita cu litera mare la inceputul fiecarui cuvant.
3 = Denumirea articolului din SmartCash va fi convertita cu toate literele mici.
4 = Denumirea articolului din SmartCash va fi convertita cu toate literele mari.
•ArticleNotesDestination-Destinatia campului NOTES (observatii) din SmartCashRMS.
Valori posibile:
0 = Nu este preluat.
1 = Preluat in descriere scurta.
2 = Preluat in descriere extinsa.
•IsUpdateArticlePrices-Activare sau inactivare actualizare preturi articole pentru produsele existente deja pe platforma eCommerce
Valori posibile:
1 = Preturile sunt actualizate si
0 sau nimic = dupa adaugarea initiala preturile articolelor nu mai sunt actualizate.
•ArticleDiscountText-Personalizarea denumirii liniilor de discount valorice. Se folosesc urmatoarele cuvinte cheie: TVA VAT_VALUE, cuvant cheie rezervat pentru valoarea cotei de TVA - programul inlocuieste cuvantul cheie cu valoarea cotei TVA VAT_LETTER, cuvant cheie rezervat pentru litera cotei de TVA. Programul inlocuieste cuvantul cheie cu litera TVA. Exemplu: Discount cota VAT_LETTER VAT_VALUE% => Discount cota A 21%.
•ArticleShippingText-Se completeaza cu denumirea serviciilor de transport, asa cum se doresc a fi afisate pe factura catre client.
•IsUpdateCategoryDetails-Actualizare definitii categorii
Valori posibile:
1 = Categoriile sunt actualizate
0 sau nimic = dupa adaugarea initiala detaliile categoriilor nu mai sunt actualizate.
Optiunea este luata in calcul doar daca optiunea SmartCashMappedCategories are o valoare nenula.
•IsUpdateCustomersDetails- Actualizare definitii clienti
Valori posibile:
1 = Clientii sunt actualizati
0 sau nimic = dupa adaugarea initiala detaliile clientilor nu mai sunt actualizate.
•IsUpdateLocationsDetails-Actualizare definitii locatii
Valori posibile:
1 = Locatiile sunt actualizate
0 sau nimic = dupa adaugarea initiala detaliile locatiilor nu mai sunt actualizate.
•StockLocationsMapping-Maparea stocului pe locatiile din SmartCashRMS.
Valori posibile:
0 sau o lista separata de virgule constand in numerele de magazine de la care se ia in calcul stocul.
0 = Stoc cumulat de la toate locatiile. Ex 15,16,19 = Stocul cumulat de la magazinele 15, 16 si 19.
•PrefixOrderNumber-Prefixul adaugat la numarul/codul de comanda sosit de la aplicatia e-commerce.
Este indicata adaugarea unui prefix totdeauna pentru a asigura unicitatea codului unei comeni in sistemul Smartcash RMS in special in cazul in care comenzile provin de la mai multe aplicatii online operate simultan. Prefixul este adaugat inaintea codului comenzii dupa modelul de ex: MS-<cod comanda online>, separatorul fiind "-".
•IsUpdateOrderStatusPickingStarted-Actualizare stare comanda online atunci cand pickingul a inceput in SmartCash RMS.
Status = CL_Status_InLucru, SubStatus=_CL_SubStatusPickingNeinceput. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•UpdateOrderStatusPickingStartedMessage-;Actualizare stare comanda online atunci cand pickingul a inceput in SmartCash RMS.
Caracter special <EX> - Carrige Return
ORDER_NUMBER - Numarul comenzii online
ORDER_DATE - Data comenzii online
PICKING_TIME- Data si ora deschiderii comenzii de livrare in SmartCashRMS. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•IsUpdateOrderStatusPickingCompleted- Actualizare stare comanda online atunci cand pickingul a fost finalizat si s-a emis comanda de livrare in SmartCash RMS.
Status = _CL_Status_InLucru, SubStatus=_CL_SubStatusPickingFinalizat. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•UpdateOrderStatusPickingCompletedMessage- Actualizare stare comanda online atunci cand pickingul a fost completat in SmartCash RMS.
Caracter special <EX> - Carrige Return
ORDER_NUMBER - Numarul comenzii online
ORDER_DATE - Data comenzii online
PICKING_TIME - Data si ora emiterii comenzii de livrare in SmartCashRMS.
PICKING_ORDER_NUMBER - Numarul comenzii de livrare din SmartCashRMS.
PICKING_USER_NAME - Numele si Prenumele operatorului comenzii de livrare din SmartCashRMS. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•IsUpdateOrderStatusDeliveryPrepared-Actualizare stare comanda online atunci cand s-a emis atat factura cat si AWB-ul pentru comanda de livrare in SmartCash RMS.
Status = _CL_Status_Facturat, SubStatus=_CL_SubStatusAmbalat.
•UpdateOrderStatusDeliveryPreparedMessage-Actualizare stare comanda online atunci cand comanda a fost facturata si are AWB emis in SmartCash RMS.
Caracter special <EX> - Carrige Return
ORDER_NUMBER - Numarul comenzii online
ORDER_DATE - Data comenzii online
SHIPPING_DATE - Data si ora finalizarii operatiei de pregatire a livrarii in SmartCashRMS.
SHIPPING_DOC - Numarul AWB-ului din SmartCashRMS.
SHIPPING_COMPANY - Firma de curierat prin care se face livrarea.
SHIPPING_USER_NAME - Numele si Prenumele operatorului responsabilului cu expeditia comenzii din SmartCashRMS.
INVOICE_NUMBER - Numarul facturii aferente comenzii din SmartCashRMS.
INVOICE_TIME - Data si ora emiterii facturii in SmartCashRMS.
INVOICE_USER_NAME - Numele si Prenumele operatorului facturii din SmartCashRMS. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•IsUpdateOrderStatusDeliveryPicked- Actualizare stare comanda online atunci cand comanda a fost ridicata de curier in SmartCash RMS.
Status = _CL_Status_Facturat, SubStatus=_CL_SubStatusExpediat.
•UpdateOrderStatusDeliveryPickedMessage-Actualizare stare comanda online atunci cand comanda a fost ridicata de curier in SmartCash RMS.
Caracter special <EX> - Carrige Return
ORDER_NUMBER - Numarul comenzii online
ORDER_DATE - Data comenzii online
SHIPPING_DATE - Data si ora finalizarii operatiei de pregatire a livrarii in SmartCashRMS.
SHIPPING_DOC - Numarul AWB-ului din SmartCashRMS.
SHIPPING_COMPANY - Firma de curierat prin care se face livrarea.
SHIPPING_USER_NAME - Numele si Prenumele operatorului responsabilului cu expeditia comenzii din SmartCashRMS. Ca efect transmite la API eComerce doar un mesaj, nu schimbare stare.
•IsUpdateOrderStatusDeliveryCompleted-Actualizare stare comanda online atunci cand comanda a fost livrata la destinatar.
Status = _CL_Status_Facturat, SubStatus=_CL_SubStatusConfirmatPrimire. Ca efect transmite la API eComerce atat un mesaj, cat si schimbarea de stare in "Comanda Finalizata".
•UpdateOrderStatusDeliveryCompletedMessage-Actualizare stare comanda online atunci cand comanda a fost livrata la destinatar.
Caracter special <EX> - Carrige Return
ORDER_NUMBER - Numarul comenzii online
ORDER_DATE - Data comenzii onlin se transmite la ecomerce mesaj si schimbare stare in order completed.
•AddifyB2BWooCommerceRoleNames- Setare necesara exclusiv pentru modulul B2B for WooCommerce produs de Addify.
https://woocommerce.com/products/b2b-for-woocommerce
Contine lista separata de virgule a tuturor slug-urilor de rol pentru care se aplica discounturi de volum SmartCashRMS.
Numele se obtin dupa definirea rolurilor din baza de date a site-ului eCommerce.
Daca campul e gol nu se efectueaza procesari suplimentare pentru acest modul.