Propojení s ERP za 2 týdny: průvodce pro vytvoření vlastního rozhraní

Propojení s ERP za 2 týdny: průvodce pro vytvoření vlastního rozhraní

Takto propojíte svůj ERP systém za dva týdny prostřednictvím REST API z Transpareo Connect. Tento návod platí pro systémy od SAP až po Odoo.

Hmotnost produktu je uvedena v systému správy materiálu. Podíl recyklovaného materiálu je uveden v systému receptur. Certifikát dodavatele je uložen ve formátu PDF na síťovém disku. Pas výrobku potřebuje všechny tři údaje v jediném datovém záznamu, a právě v tom spočívá podstata integračního projektu, nikoli ve propojení dvou systémů.

„Hladká integrace ERP“ je standardní slib, po kterém v praxi následuje tříměsíční projekt. Zveřejňujeme našeho průvodce, aby vaše IT oddělení mohlo před podpisem smlouvy ověřit, jaké údaje se skutečně vyžadují. Tento článek ukazuje, jaké údaje z vašich systémů produktový pas potřebuje, jakými třemi způsoby k nám přicházejí a proč to lze zvládnout za dva týdny.

Co musí váš ERP systém vlastně poskytnout

Aby vznikl DPP, potřebujeme pro každý produkt:

  • Kmenová data - číslo položky, označení, varianty, hmotnosti, rozměry, obrázky
  • údaje o kusovníku - komponenty s množstvím a podílem recyklátu
  • údaje o původu - místo výroby, číslo šarže, datum výroby
  • environmentální údaje - CO2eq na jednotku, spotřeba vody, spotřeba energie
  • údaje o dodavatelích - kdo dodává kterou komponentu (pro účely povinností náležité péče)

Ve vašem ERP systému jsou tato data teoreticky všechna k dispozici. V praxi jsou však rozložena do 4 až 7 modulů: řízení materiálů, výroba, kvalita, kmen dodavatelů, někdy samostatný modul pro environmentální data, někdy vlastní systém pro receptury a kusovníky.

Otázka integrace nezní: „Poskytuje váš ERP systém data do DPP?“ Zní: „Jak spojíte data z 5 subsystémů do jednoho uceleného datového souboru?“

Tři osvědčené způsoby

Způsob 1: Načtení dat z ERP

Funguje dobře s moderními systémy ERP (SAP S/4HANA Cloud, Dynamics 365, Odoo). Poskytovatel DPP načítá data přes rozhraní ERP (technicky OData nebo REST). Pouze změny, podle časového plánu nebo vyvolané událostí.

Výhody: minimální vývojové náklady z vaší strany, vy poskytnete přístup pro čtení, dodavatel zajistí konverzi.

Nevýhody: nefunguje se staršími instalacemi SAP ECC bez dodatečné vrstvy rozhraní. Potřebujete jasná pravidla, kdo smí číst která data.

Způsob 2: Předávání změn

Váš ERP systém hlásí každou změnu jako událost (prostřednictvím SAP Event Mesh, Apache Kafka nebo RabbitMQ) a poskytovatel DPP ji přijímá.

Výhody: téměř v reálném čase, systém roste s vámi, systémy nejsou na sobě závislé.

Nevýhody: Nastavení je náročné a vyžaduje infrastrukturu, kterou nemá každé IT oddělení. Pro menší firmy je to většinou zbytečně nákladné.

Způsob 3: Využít stávající integrační vrstvu

Již máte ### integračnívrstvu (Mulesoft, Boomi, Informatica, Azure Data Factory) mezi ERP a externími systémy. Tato vrstva představuje smlouvu: poskytovatel DPP komunikuje s ní, nikdy přímo s ERP.

Výhody: lze využít stávající investice, pravidla zůstávají stabilní, třetí strany nemají přímý přístup k ERP.

Nevýhody: Vaše náklady na integrační vrstvu rostou spolu s ní.

Co děláme jinak v konkrétních projektech

Mnoho poskytovatelů chce navázat přímé propojení s vaším ERP systémem. My však zásadně zavádíme mezikrok: naše rozhraní Transpareo Connect přijímá neutrální datový formát (schéma JSON), který můžete naplnit pomocí nástroje podle vlastního výběru. To znamená:

  • Úpravu dat můžete provádět sami, pomocí nástrojů, které váš tým zná
  • Můžete nás nahradit jiným poskytovatelem - neutrální formát je přenositelný
  • Celý svůj datový fond si můžete kdykoli znovu stáhnout - ve formátech CSV, XLSX, JSON-LD a SQL, stejně jako prostřednictvím REST-API
  • Poskytujeme validátor importu, který vaše data před nahráním zkontroluje

Kompletní formát a všechny dotazy jsou veřejně popsány v dokumentu „ Dokumentace k API “ jako popis rozhraní podle OpenAPI. Vaše IT oddělení může rozhraní otestovat ještě před podpisem smlouvy - včetně ukázkových dotazů, chybových odpovědí a podrobností o autentizaci.

Časový rámec tohoto přístupu v praxi:

  • 1. až 2. den: Workshop k mapování. Které pole v ERP se stane kterým polem v DPP?
  • 3. až 5. den: První exporty v formátu JSON z ERP, prověřené naším validátorem.
  • 6. až 8. den: Oprava chyb (chybějící pole, nekonzistentní kódování).
  • 9. až 10. den: První DPP jsou v provozu.

Dva týdny, ne tři měsíce. Klíčovým bodem je workshop k mapování - tam se rozhoduje o kvalitě dat.

Co se může pokazit: nejčastější úskalí

Základní údaje o produktech v několika systémech: SAP má číslo artiklu, PIM má obrázky a marketingové texty, PLM má kusovník. Nikdo nemá ucelený přehled. Řešení: před zahájením projektu definujte, který systém je pro které pole vedoucí.

Certifikáty ve formátu PDF: dodavatelé dodávají certifikáty GOTS, OEKO-TEX nebo REACH jako naskenované soubory PDF. To není strukturovaný zdroj dat. Řešení: Certifikační orgány stále častěji nabízejí dotazování prostřednictvím rozhraní (OEKO-TEX je v čele, GOTS zaostává). Nebo: ruční zadávání, ale s datem platnosti, aby se v DPP neobjevovaly certifikáty s prošlou platností.

Důvěrnost složení: zejména v kosmetice, potravinářství a farmaceutickém průmyslu: kompletní složení je obchodním tajemstvím. Má je DPP zveřejnit? Řešení: Tříúrovňový model ESPR. Veřejně je dostupná kategorie produktu, úřady vidí kompletní složení. Téměř nikdy to není překážka, ale je třeba to vyjasnit včas.

Údaje o CO₂ na základě dodavatelů: Váš dodavatel uvádí průměrnou hodnotu pro celé své portfolio, nikoli pro jednotlivé šarže. Řešení: Dočasně to akceptujte, dlouhodobě upravte dodavatelské smlouvy. ESPR vyžaduje hodnoty specifické pro jednotlivé produkty od určitého data, ale současná praxe představuje kompromis.

Místní jazykové verze: Váš ERP systém obsahuje pouze názvy produktů v němčině a angličtině. Pro 27 zemí EU potřebujete více. Řešení: strojový překlad s terminologickou databází; k tomuto tématu máme samostatný článek.

Otázky, které byste si měli položit před zahájením projektu

Než zašlete žádost o nabídku (RFP) třem dodavatelům, odpovězte si interně na následující otázky:

  1. Kolik produktů/čísel položek má mít DPP? (10, 10 000, 1 milion?)
  2. Které systémy dnes uchovávají data relevantní pro DPP?
  3. Které oddělení spravuje jednotlivé systémy?
  4. Máte integrační vrstvu, kterou byste měli využít?
  5. Existuje již funkční rozhraní přes váš ERP systém?

Odpovědi určí, který ze tří přístupů je pro vás vhodný.

Odpovědi určují, zda projekt potrvá dva týdny nebo šest měsíců.

Dotazy k tomuto příspěvku

Stačí rozhraní REST, nebo potřebujeme middleware?

Rozhraní stačí. Tyto tři vzory se liší tím, kde k transformaci dochází, nikoli tím, co přijímáme - naše rozhraní přijímá neutrální schéma JSON, bez ohledu na to, čím jste jej vytvořili. Ať už jde o stahování dat z moderního ERP systému, proud událostí nebo stávající integrační vrstvu, vše končí na stejném koncovém bodě. Middleware se vyplatí, pokud jej již provozujete a má zůstat smluvním partnerem vůči třetím stranám. Pokud jej dnes nemáte, nekupujte jej kvůli pasu výrobku.

O čem se rozhoduje v rámci workshopu o mapování?

Které pole v ERP se stane referenčním polem - a který systém je primárním zdrojem, pokud více systémů obsahuje stejnou hodnotu. Workshop se koná v 1. a 2. dni a je klíčovým bodem celého projektu, protože právě tam se rozhoduje o kvalitě dat, a ne až později v kódu. Přiveďte s sebou osoby, které systémy spravují, nejen ty, které za projekt odpovídají - kmenová data, výroba, kvalita a nákup zřídka spadají do jednoho oddělení. Vše, co následuje, tedy exporty, validace a odstraňování chyb, je již jen řemeslná práce.

Naše certifikáty máme k dispozici pouze jako naskenované soubory ve formátu PDF. Co s nimi máme dělat?

Sken není strukturovaným zdrojem dat, a proto je pro pas nepoužitelný. Existují dva způsoby - provozovatelé certifikací stále častěji nabízejí dotazy přes API a tam, kde to není možné, zadávejte hodnoty ručně, vždy však s datem platnosti, aby v publikovaném pasu nezůstalo žádné certifikát s prošlou platností. Plánujte ruční zadávání jako opakující se činnost, nikoli jako jednorázový úkol.

Může naše IT oddělení zkontrolovat rozhraní, než něco podepíšeme?

Ano. Kompletní schéma a všechny koncové body služby Transpareo Connect jsou k dispozici jako specifikace OpenAPI na adrese Dokumentace k API, včetně ukázkových dotazů, chybových odpovědí a podrobností o autentizaci. Nic z toho není skryto za obchodními jednáními, takže váš integrační tým může odhadnout náročnost projektu ještě před uzavřením smlouvy. Pokud dodavatel v této fázi své rozhraní nezveřejní, je to také určitá odpověď.

Co se stane s našimi údaji, když změníme poskytovatele?

Jdou s vámi. Rozhraní přijímá neutrální schéma JSON namísto proprietárního formátu a veškerá vaše data jsou výstupem ve formátech CSV, XLSX, JSON-LD a SQL nebo prostřednictvím REST API. To je záměr - formát, do kterého data vkládáte, je přenositelný, takže změna vyžaduje pouze export, nikoli vytvoření nového modelu. Před workshopem o mapování položte každému poskytovateli stejnou otázku, protože poté budou názvy vašich polí součástí jeho modelu.

Jak dlouho připojení ve skutečnosti trvá?

V projektech, na kterých spolupracujeme, to trvá dva týdny - dva dny mapování, tři dny do prvních exportů prostřednictvím našeho validátoru, tři dny odstraňování chyb, dva dny do zveřejnění prvních pasů. Dlouhá cesta nikdy nespočívá v kódu, ale v tom, co validátor najde - chybějící pole, nejednotné kódování, hodnoty, za které se nikdo necítí zodpovědný. Naplánujte si tyto dny, místo abyste je zkracovali. Projekt, který je přeskočí, zveřejní i tyto mezery.

Musíme propojit všechny produkty najednou?

Ne. Začněte s produkty, které potřebují průkaz jako první, a se zdrojovým systémem - neutrální schéma přijímá jak dílčí katalog, tak kompletní katalog, a importy jsou opakovatelné, takže pozdější běhy aktualizují stav zásob. Díky tomu zůstane workshop věnovaný mapování dostatečně krátký, aby se dal zvládnout za dva dny. Následné rozšíření je úkolem v rámci mapování, nikoli novým projektem.

Tipy k integraci v newsletteru

API vzory, propojení s ERP a PIM a praktické příručky - každý měsíc ve vaší e-mailové schránce.