Integrari API¶
Pe aceasta pagina configurezi integrarile prin API dintre Planograma si sistemele externe cu care lucreaza compania ta: platforme de e-commerce si sisteme ERP. O integrare activa permite Planograma sa preia automat comenzi, receptii (NIR-uri) sau bonuri de consum din sistemul extern si sa trimita inapoi stocuri si statusuri pe masura ce documentele sunt procesate in depozit.
Note
Configurarea integrarilor este o operatiune de administrare. Optiunile sunt vizibile si pot fi salvate doar de utilizatorii cu nivel de permisiune de administrator. Anumite actiuni (de exemplu re-sincronizarea completa a datelor) sunt rezervate superadministratorului.
Integrari disponibile¶
Fiecare integrare se activeaza printr-un comutator (switch). Integrarile se exclud reciproc: cand activezi una, celelalte se dezactiveaza automat, pentru ca un tenant comunica la un moment dat cu un singur sistem extern.
| Integrare | Tip sistem | Activare |
|---|---|---|
| SofTech | ERP | comutator "Comunicare cu SofTech" |
| WinMentor | ERP | comutator "Comunicare cu Winmentor" |
| SoftOne | ERP | comutator "Comunicare cu SoftOne" |
| Nexus | ERP | comutator "Comunicare cu Nexus" |
| GoMag | platforma e-commerce | comutator "Comunicare cu GoMag" |
| EasySales | platforma e-commerce | comutator "Comunicare cu EasySales" |
| MerchantPro | platforma e-commerce | comutator "Comunicare cu MerchantPro" |
Dupa ce activezi o integrare, sub comutator apar campurile specifice de configurare (date de conectare, optiuni de sincronizare si maparile de status).
Optiuni comune de sincronizare¶
Indiferent de sistemul ales, integrarile expun un set comun de optiuni, sub forma de comutatoare:
- Sincronizare comenzi — Planograma preia comenzile (iesirile) din sistemul extern.
- Sincronizare NIR-uri — Planograma preia documentele de receptie (intrarile) din sistemul extern.
- Sincronizare bonuri de consum — Planograma preia bonurile de consum din sistemul extern.
- Trimitere stocuri — Planograma trimite inapoi catre sistemul extern stocurile actualizate.
Note
Nu toate optiunile sunt disponibile la fiecare integrare. De exemplu, sincronizarea NIR-urilor apare doar la sistemele ERP (Nexus, SoftOne, WinMentor), iar trimiterea de stoc apare la platformele de e-commerce si la o parte din ERP-uri.
Maparea statusurilor (Status ID)¶
Pentru integrarile cu comenzi si NIR-uri completezi maparile de status dintre Planograma si sistemul extern, grupate pe Setari Status ID Iesiri si Setari Status ID Intrari:
- Status ID eligibilitate preluare iesire in Planograma — statusul din ERP la care o iesire devine eligibila pentru preluare in Planograma.
- Status ID eligibil trimitere document in picking — statusul la care documentul este trimis in picking.
- Status ID ERP la finalizarea picking-ului iesirii — statusul setat in ERP cand picking-ul iesirii s-a incheiat.
- Status ID ERP la finalizarea returului — statusul setat in ERP la finalizarea unui retur.
- Status ID corespondent unei iesiri sterse (de obicei 0) si Status ID corespondent unei iesiri returnate.
- Echivalentele pe partea de intrari: Status ID eligibilitate preluare intrare, Status ID ERP la finalizarea procesarii intrarii, Status ID corespondent unei intrari sterse.
Valorile sunt identificatorii de status folositi de sistemul tau extern; le obtii din configurarea acelui sistem.
Datele de conectare per integrare¶
In functie de integrarea activata, completezi urmatoarele:
- SofTech — ID Colectie, Cont Utilizator, Sursa Date, Cod Gestiune Stocuri Iesiri, Cod Gestiune Stocuri Intrari, Nume Comisionar, Cod Centru Cost, Cod Centru Profit.
- WinMentor — IP, Port si maparile de status (Anulata, Operata, Blocata, Inchisa).
- SoftOne — ID-ul aplicatiei, URL-ul aplicatiei, Utilizatorul aplicatiei, Parola aplicatiei, Serie NIR si maparile de status pentru iesiri si intrari.
- Nexus — IP, Port, API Key, plus filtrele de citire a comenzilor (vezi mai jos).
- GoMag — ID-ul aplicatiei, URL-ul aplicatiei si maparile de status.
- EasySales — URL-ul aplicatiei, maparile de status si o cheie API (sectiunea Credentiale, vezi mai jos), plus lista de website-uri.
- MerchantPro — URL-ul aplicatiei, maparile de status si o cheie API (sectiunea Credentiale).
Filtrele de comenzi Nexus¶
Pentru Nexus, sub "Configurator citire comenzi" ai comutatoare suplimentare care restrang ce comenzi sunt preluate: doar comenzi rezervate integral, include comenzi inchise, doar comenzi ferme, doar comenzi aprobate, include comenzi aprobate pentru livrare, include comenzi onorate, include detalii linii, include componentele produselor compuse.
Generarea si gestionarea unei chei API¶
Pentru integrarile care folosesc o cheie API (de exemplu EasySales si MerchantPro), in sectiunea Credentiale completezi:
- Api Key — cheia (identificatorul) emisa de platforma externa.
- Api Secret — secretul asociat cheii.
- URL-ul API — adresa endpoint-ului API al platformei (vine precompletata cu o valoare implicita pe care o poti modifica).
Apasa Adauga pentru a salva. Cheia este stocata securizat in Planograma; alaturi de eticheta apare un indicator vizual: o bifa verde daca o cheie este deja salvata, respectiv un semn de avertizare daca inca nu ai introdus una.
Warning
Din motive de securitate, secretul nu este returnat in clar dupa salvare. Daca trebuie sa schimbi cheia, introdu valorile noi si salveaza din nou — vor inlocui cheia anterioara.
Website-uri (token per magazin)¶
La integrarile care suporta mai multe magazine (de exemplu EasySales), sub Website-uri apare lista magazinelor detectate. Fiecare magazin este afisat ca o eticheta colorata: verde daca are deja un token configurat, respectiv galben daca tokenul lipseste (vezi mesajul la trecerea cu mouse-ul). Apasa pe un magazin pentru a deschide fereastra in care introduci sau resetezi Tokenul acelui magazin, apoi salveaza.
Re-sincronizare si verificare¶
In zona de integrari ai si actiuni de control:
- Re-sincronizare — declanseaza o re-sincronizare completa a datelor pentru tenantul curent. Este o actiune rezervata superadministratorului si o folosesti dupa o reconfigurare sau pentru a forta o aliniere completa cu sistemul extern.
- Data ultimei sincronizari — afiseaza momentul ultimei sincronizari reusite, ca punct de reper pentru a verifica daca integrarea ruleaza.
- Verificare integrare — confirma daca tenantul are cel putin o integrare activa configurata.
Note
Dupa ce salvezi configurarea unei integrari, sincronizarile automate ruleaza periodic in fundal. Re-sincronizarea manuala este utila doar cand vrei o aliniere imediata, in afara programului automat.