Ugrás a tartalomra
XSIS

Vállalatok és integrációk

ERP és harmadik felek közötti API-kapcsolatok

Az ERP-től a harmadik felekig: CRM, logisztika, adó és személyazonosság

REST-, SOAP-, webhook- és iPaaS-kapcsolatok az ERP és a körülötte működő szolgáltatások között, újrapróbálkozásokkal és riasztásokkal.

Tervrajz

ERP és harmadik felek: egy platform, sok partnerAz üzleti események egyszer lépnek ki az ERP-ből, és az integrációs platform minden partnernek az általa elvárt formátumban kézbesíti őket. A visszahívások ugyanígy érkeznek vissza. Az az üzenet, amely az újrapróbálkozások után is sikertelen, a kézbesíthetetlen üzenetek sorába kerül, és riasztást vált ki, amelyhez a hasznos adat is csatolva van.ERPERPÜgyfelek, rendelések,számlákXSISIntegrációsplatformiPaaS vagy egyediszolgáltatások,leképezés ésújrapróbálkozásokHarmadik félCRMÜgyfélrekordok,kapcsolattartók ésértékesítésilehetőségekHarmadik félLogisztika ésfuvarozókSzállítmányok ésnyomon követésHarmadik félE-számlázási ésadóplatformJóváhagyás ésjelentésHarmadik félKYC- ésidentitásszolgáltatóEllenőrzés és szűrésSzolgáltatásKézbesíthetetlenüzenetek sora ésriasztásokSemmi nem vész elEmberekTámogatási csapat1REST · OData · webhook2REST/JSON3REST/JSON4webhook5SOAP/XML · REST6REST/JSON7webhook89

ERP és harmadik felek: egy platform, sok partner

Az üzleti események egyszer lépnek ki az ERP-ből, és az integrációs platform minden partnernek az általa elvárt formátumban kézbesíti őket. A visszahívások ugyanígy érkeznek vissza. Az az üzenet, amely az újrapróbálkozások után is sikertelen, a kézbesíthetetlen üzenetek sorába kerül, és riasztást vált ki, amelyhez a hasznos adat is csatolva van.

  • Elsődleges folyamat
  • Aszinkron
  • Kivételi útvonal
A folyamat 9 lépésben

A folyamat lépésről lépésre

  1. Forrás: ERP, cél: Integrációs platform. Üzleti események, REST · OData · webhook protokollon keresztül (elsődleges folyamat).
  2. Forrás: Integrációs platform, cél: CRM. Ügyfelek és rendelések, REST/JSON protokollon keresztül (elsődleges folyamat).
  3. Forrás: Integrációs platform, cél: Logisztika és fuvarozók. Lefoglalt szállítmányok, REST/JSON protokollon keresztül (elsődleges folyamat).
  4. Forrás: Logisztika és fuvarozók, cél: Integrációs platform. Nyomon követési események, webhook protokollon keresztül (aszinkron).
  5. Forrás: Integrációs platform, cél: E-számlázási és adóplatform. Számlák jóváhagyásra, SOAP/XML · REST protokollon keresztül (elsődleges folyamat).
  6. Forrás: Integrációs platform, cél: KYC- és identitásszolgáltató. Személyazonosság-ellenőrzések, REST/JSON protokollon keresztül (elsődleges folyamat).
  7. Forrás: KYC- és identitásszolgáltató, cél: Integrációs platform. Ellenőrzési eredmények, webhook protokollon keresztül (aszinkron).
  8. Forrás: Integrációs platform, cél: Kézbesíthetetlen üzenetek sora és riasztások. Az újrapróbálkozások után sikertelen, a kézbesíthetetlen üzenetek sorába (kivételi útvonal).
  9. Forrás: Kézbesíthetetlen üzenetek sora és riasztások, cél: Támogatási csapat. Riasztás a hasznos adattal és a hibával (kivételi útvonal).

Áttekintés

Ez az ERP és a körülötte működő szolgáltatások közötti folyamat: a CRM, a fuvarozók és logisztikai szolgáltatók, az e-számlázási és adóplatformok, valamint a személyazonosság-ellenőrzési és KYC-szolgáltatók. Minden partnernek saját API-ja, saját formátuma és saját hibái vannak, és mindegyik általában külön projektként jelenik meg.

A referenciaterv az üzleti eseményeket egyszer küldi ki az ERP-ből egy integrációs platformra, amely minden partnernek az általa várt formátumban továbbítja őket: REST-en, SOAP-on, webhookon, vagy ahol a kereskedelmi partnerek megkövetelik, AS2 feletti EDI-n. A visszahívások (callback), például a nyomkövetési események vagy az ellenőrzések eredményei, ugyanezen a platformon érkeznek vissza.

Ha egy partner nem elérhető, az szokásos esemény, nem vészhelyzet. Az átmeneti hibáknál újrapróbálkozunk. Az újrapróbálkozások után is sikertelen üzenet a kézbesíthetetlen üzenetek sorába kerül, a támogatási csapat pedig riasztást kap a tartalommal és a hibával, így a hiba javítható, az üzenet pedig újra lejátszható.

Hogyan működik a folyamat

  1. Az ERP közzétesz egy eseményt

    Amikor egy ügyfél, rendelés vagy számla megváltozik, az ERP az API-ján, OData-szolgáltatásain vagy webhookjain keresztül egyetlen üzleti eseményt tesz közzé az integrációs platformon.

  2. A CRM naprakész marad

    A platform frissíti a CRM-ben a fiókokat, a kapcsolattartókat és a rendeléseket, így az értékesítési és ügyfélszolgálati csapatok azt látják, amit az ERP tud.

  3. A szállítmányok lefoglalása

    A szállításra kész rendeléseket a fuvarozó vagy logisztikai szolgáltató API-ján keresztül foglaljuk le, a címkék és a hivatkozási számok pedig visszaérkeznek.

  4. Visszaérkező nyomkövetési adatok

    A fuvarozó webhookon küldi a nyomkövetési és kézbesítésigazolási eseményeket, a platform pedig frissíti a rendelést az ERP-ben.

  5. A számlák adóhatósági jóváhagyása

    A számlákat a hatóság által előírt formátumban küldjük az e-számlázási vagy adóplatformra, a jóváhagyás állapotát pedig a számlával együtt tároljuk.

  6. A személyazonosság ellenőrzése

    Az új ügyfeleket vagy szállítókat a KYC- vagy személyazonosság-ellenőrzési szolgáltatóhoz küldjük, az eredmény pedig webhookon érkezik vissza, mielőtt a fiók aktiválódna.

Amikor valami elromlik

  • Egy partner átmenetileg nem elérhető

    A hívást növekvő várakozással próbáljuk újra. Minden íráshoz idempotenciakulcs tartozik, így az újrapróbálkozás soha nem hoz létre második szállítmányt vagy számlát.

  • Egy üzenet az újrapróbálkozások után is sikertelen

    A tartalommal és a partner hibaüzenetével együtt a kézbesíthetetlen üzenetek sorába kerül, a támogatási csapat pedig riasztást kap. Javítás után a sorból újra lejátsszuk.

  • Egy partner megváltoztatja az API-ját

    Minden partner tesztkörnyezetén szerződéstesztek futnak, amelyek észlelik a változást. A bejelentett változásokat a partner határideje előtt ütemezzük és teszteljük.

  • Az adatokat elutasítják

    Ha egy partner üzleti okból, például hiányzó adószám miatt utasítja el az adatot, a hibát visszaküldi az ERP-rekordhoz, ahol a felelőse kijavíthatja.

Szabványok és rendszerek

Integráció
  • REST
  • SOAP
  • Webhooks
  • OpenAPI
  • EDI (EDIFACT, ANSI X12)
  • AS2
  • MuleSoft
  • Boomi
  • Azure Logic Apps
Identitás és hozzáférés
  • OAuth 2.0

Kérdések és válaszok

Milyen külső szolgáltatásokat tudnak bekötni?

Bármely szolgáltatást, amelynek dokumentált API-ja vagy fájlinterfésze van. Jellemző példák a CRM-platformok, a fuvarozók és logisztikai szolgáltatók, a piacterek, az e-számlázási és adóplatformok, a bérszámfejtés, a KYC- és személyazonosság-ellenőrzési szolgáltatók, valamint az AS2 felett EDI-dokumentumokat cserélő kereskedelmi partnerek. Mielőtt egy terv mellett elköteleződnénk, áttekintjük minden partner API-ját, korlátait és tesztkörnyezetét.

Szükségünk van ehhez integrációs platformra?

Ha már több partner kapcsolódik egy ERP-hez, egy platform, például a MuleSoft, a Boomi vagy az Azure Logic Apps, vagy egy üzenetsorra épülő egyedi szolgáltatáskészlet egy helyen tartja a leképezést, az újrapróbálkozásokat és a monitorozást. Egy-két partnernél a közvetlen kapcsolatok is elegendők lehetnek. Az Ön esetére bemutatjuk az előnyöket és hátrányokat, a licencköltségekkel együtt.

Össze tudnak kötni minket e-számlázási és adójóváhagyási platformokkal?

Igen. Sok ország ma már előírja, hogy a számlákat meghatározott formátumban, állami vagy akkreditált platformon keresztül állítsák ki vagy hagyassák jóvá. Az ERP-t az országában előírt platformmal vagy egy akkreditált szolgáltatóval integráljuk, minden számlánál tároljuk a jóváhagyás állapotát és azonosítóit, és kezeljük az elutasításokat. Az Önre vonatkozó szabályokat adótanácsadói erősítik meg.

Hogyan védik a bejövő webhookokat?

Minden bejövő webhookot feldolgozás előtt ellenőrzünk: aláírással, ha a partner aláírja az üzeneteit, egyébként token-, forrás- és időbélyeg-ellenőrzéssel. A tartalmat a szerződés szerint érvényesítjük, az eseményeket pedig akkor is csak egyszer dolgozzuk fel, ha a partner többször küldi el őket.

Mi történik, ha egy partner kiesik?

A többi folyamat tovább fut. Az adott partnernek szóló üzeneteknél újrapróbálkozunk, majd sorba állítjuk őket, a támogatási csapat riasztást kap, és semmi sem vész el. Amikor a partner helyreáll, a sorban álló üzeneteket sorrendben újra lejátsszuk. Az irányítópult mutatja, melyik partner érintett, és hány üzenet várakozik.

Kié az Önök által épített összekötők tulajdonjoga?

Az Ön számára végzett munka szellemi tulajdona az első committól kezdve az Öné, a végén nincs szükség külön átruházásra. Az összekötőket forráskóddal, tesztekkel és dokumentációval adjuk át, így a saját csapata vagy egy másik beszállító is karbantarthatja őket. A korábban már létező XSIS-eszközök a mieink maradnak, ezekre licencet adunk Önnek. A partnerek API-jaira és az integrációs platformok licenceire az adott beszállítók saját feltételei vonatkoznak.

Beszélgetéssel kezdje, nem szerződéssel.

Mondja el, mit szeretne megépíteni, összekötni vagy biztonságossá tenni. Egy architekt végigmegy Önnel a részleteken, majd javasolja, hol érdemes kezdeni.

Mi történik ezután

  1. Időpont egyeztetése

    Csapatunk e-mailben egyeztet Önnel egy időpontot a konzultációra.

  2. Előzetes konzultáció

    Egy ingyenes 30 perces online előzetes konzultáció: áttekintjük a céljait, rendszereit és korlátait.

  3. Felkészültségi értékelés

    Egy ingyenes 48 órás felkészültségi értékelés során egyik vezető architektünk a hatpontos készenléti definíció (Definition of Ready) alapján megvizsgálja a projektjét, és javasolja a hozzá illő utat.

  4. Az út kiválasztása

    A kész hatókörű projektek 3 és 5 munkanapon belül kötelező érvényű ajánlatot kapnak. A koncepciószakaszban lévő projektek a Blueprint Studióban indulnak. A hibás, dokumentálatlan vagy integrációra szoruló éles rendszer diagnosztikával indul (időtartam: 1 és 2 hét között). A Blueprint Studiónak és a diagnosztikának egyaránt fix díja van, amelyet az ajánlat tartalmaz.