Preskoči na sadržaj
NG WMS
ERP integracija

ERP i magacin na istim brojevima.

Veza sa ERP-om ide preko API-ja, webhook-ova i outbox-a. Svaki API klijent ima svoj ključ sa rokom, svaka poruka ostavlja trag u dnevniku, a poruka koja nije isporučena čeka u outbox-u i može da se pošalje ponovo, sa istim ID-jem.

  • API sa OAuth2 tokenima
  • Webhook-ovi
  • Outbox sa ponavljanjem
  • Dnevnik u oba smera
Ilustracija interfejsa sa primerom podataka
Mogućnosti

Integracija koja se vidi i kontroliše

Sve što ide između WMS-a i drugih sistema ima vlasnika, status i istoriju — i alat za ispravku kada nešto zapne.

  • API klijenti i ključevi

    Svaki sistem koji se povezuje dobija svog API klijenta: ključ sa prefiksom, oznakom i rokom važenja, u stanju Aktivan, Istekao ili Opozvan. Ključ može da se opozove pre isteka.

  • Tajna se vidi jednom

    Tajna ključa prikazuje se samo pri kreiranju, a čuva se samo njen otisak. Token se dobija po OAuth2 client credentials toku; neaktivan klijent token ne dobija.

  • Statistika poziva

    Po klijentu: broj zahteva, uspešnih, odbijenih i neuspelih, prosečno vreme odgovora, po danu i po endpoint-u, uz poslednje greške.

  • Webhook-ovi

    URL i pretplata na događaje iz kataloga. Autentikacija: bez, Bearer, Basic, OAuth2 password ili OAuth2 client credentials. Probna poruka i brojači isporuke.

  • Outbox

    Odlazne poruke imaju stanje Na čekanju, Poslato ili Neisporučivo, sa brojem pokušaja, vremenom sledećeg pokušaja i poslednjim HTTP statusom.

  • Ponavljanje sa istim ID-jem

    Neisporučena poruka se ručno šalje ponovo, sa istim ID-jem poruke, pa prijemna strana može da prepozna ponovljenu poruku i ne obradi je dvaput.

  • Dnevnik poruka u oba smera

    Ulazne i odlazne poruke u stanju U obradi, Obrađeno, Greška ili Na pregledu, sa correlation id-jem i verzijom ugovora. Poruke na pregledu razrešavaju se ručno.

  • Dokumentacija za programere

    Opis API-ja u OpenAPI formatu, otvoren kroz Swagger UI, i Postman kolekcija za probne pozive.

Kako teče

Kako izgleda jedna veza

Isti obrazac za svaki sistem koji razgovara sa magacinom.

  1. 01

    Povezivanje

    Kreira se API klijent, tajna se preuzme jednom, a sistem dobija token po OAuth2 client credentials toku.

  2. 02

    Razmena

    Ulazne poruke stižu preko API-ja, a događaji iz kataloga odlaze webhook-om, kroz outbox.

  3. 03

    Kontrola

    Dnevnik, statistika i poslednje greške pokazuju stanje, a neisporučene poruke se šalju ponovo.

Šta je drugačije u praksi

Dokumenti koji znaju za ERP

Popis ima stanja „Poslat u ERP“ i „ERP potvrdio“, a nalog u pripremi može da nosi oznaku „ERP stop“ sa razlogom. Razmena sa ERP-om je deo toka, a ne posao sa strane.

Greška se vidi pre nego što je neko prijavi

Statistika po klijentu, poslednje greške i neisporučive poruke u outbox-u pokazuju gde veza zapinje, pre nego što se pojavi razlika u zalihama.

Mapiranje po dogovoru

Mehanizam je isti za svaki sistem: API, webhook-ovi i outbox. Koja polja i koji događaji se razmenjuju sa vašim ERP-om dogovaramo za konkretan projekat.

Česta pitanja

Sa kojim ERP-om radi NG WMS?

Sa vašim. Veza ide preko API-ja, webhook-ova i outbox-a, pa NG WMS radi i sa NG One-om i sa drugim ERP sistemima; koja polja i događaji se razmenjuju podešavamo za vaš sistem.

Kako se drugi sistem autentifikuje prema WMS-u?

Preko API klijenta: dobija ključ i tajnu, pa token po OAuth2 client credentials toku. Ključ ima rok važenja i može da se opozove; neaktivan klijent ne dobija token.

Šta ako ERP nije dostupan kada WMS šalje događaj?

Poruka ostaje u outbox-u sa brojem pokušaja i vremenom sledećeg pokušaja. Poruka koja ostane neisporučiva šalje se ponovo ručno, sa istim ID-jem poruke.

Postoji li dokumentacija API-ja?

Da: opis u OpenAPI formatu kroz Swagger UI i Postman kolekcija za probne pozive.

Kako se vidi šta je stiglo iz ERP-a?

Dnevnik poruka beleži ulazne i odlazne poruke sa stanjem, correlation id-jem i verzijom ugovora. Poruke koje traže proveru stoje u stanju „Na pregledu“ dok ih neko ne razreši.

Povezano

  • WMS osnove6 min čitanja

    Šta je WMS i kada magacinu treba više od ERP-a

    WMS vodi robu po lokacijama, zadacima i skeniranju, a ERP vodi knjige. Šta tačno radi sistem za upravljanje skladištem, po čemu se razlikuje od magacinskog modula ERP-a i po kojim znacima prepoznajete da ste prerasli Excel.

Želite da vidite kako bi ovo izgledalo u vašem magacinu?

Na demonstraciji prolazimo kroz vaš prijem, pripremu i otpremu u NG WMS-u i pokazujemo kako NG Copilot pomaže timu u magacinu.