JSON EDI

Moderni pristupi elektronskoj razmjeni podataka koristeći JSON, REST API-je i web-nativne tehnologije

Pregled

JSON EDI predstavlja najnoviju evoluciju u elektronskoj razmjeni podataka, koristeći JavaScript Object Notation (JSON) i moderne web tehnologije za razmjenu poslovnih dokumenata između organizacija. Umjesto jednog standarda, JSON EDI obuhvata raznovrsne pristupe: JSON reprezentacije tradicionalnih EDI standarda, namjenski izgrađene JSON API-je za B2B trgovinu i nove specifikacije koje nastoje standardizirati razmjenu poslovnih dokumenata baziranu na JSON-u.

Pomak ka JSON EDI-ju pokrenut je širim usvajanjem RESTful API-ja, zastupljenošću JSON-a u modernom razvoju softvera i željom za jednostavnijim, programerima prilagođenijim metodama integracije. Dok tradicionalni EDI standardi poput EDIFACT-a i X12 ostaju dominantni po obimu transakcija, JSON-bazirani pristupi dobivaju na zamahu, posebno među tehnološkim kompanijama, platformama za e-trgovinu i organizacijama koje žele smanjiti složenost i troškove B2B integracije.

Historija

JSON je prvi put specificiran od strane Douglasa Crockforda početkom 2000-ih i postao je ECMA standard (ECMA-404) 2013. godine i IETF standard (RFC 8259) 2017. godine. Njegov uspon u B2B razmjeni podataka prati širu API ekonomiju koja se pojavila 2010-ih, kada su kompanije poput Stripea, Twilia i Shopifyja demonstrirale da se složeni poslovni procesi mogu upravljati putem dobro dizajniranih REST API-ja s JSON korisnim teretom.

Rani napori JSON EDI-ja fokusirali su se na kreiranje JSON reprezentacija postojećih X12 i EDIFACT dokumenata, omogućavajući organizacijama rad s poznatom EDI semantikom u pristupačnijem formatu. Kompanije poput Stedi i Orderful počele su nuditi JSON-nativne EDI usluge koje apstrahuju složenost tradicionalnog EDI prevođenja. Zdravstveni sektor je vidio kako je HL7 FHIR usvojio JSON kao prvorazrednu reprezentaciju uz XML, pokazujući da čak i regulirane industrije mogu prihvatiti JSON za razmjenu podataka.

Pristupi JSON EDI-ju

JSON reprezentacije tradicionalnog EDI-ja

Mnoge moderne EDI platforme konvertuju tradicionalne X12 ili EDIFACT dokumente u JSON format, olakšavajući rad s njima u modernim programerskim okruženjima. Struktura odražava originalni EDI dokument ali koristi JSON objekte, nizove i parove ključ-vrijednost umjesto pozicionih razdjelnika.

{
  "transactionSet": "850",
  "version": "004010",
  "heading": {
    "BEG": {
      "purpose": "00",
      "type": "NE",
      "purchaseOrderNumber": "PO-2023-00451",
      "date": "2023-06-15"
    },
    "N1": [
      {
        "entityCode": "BY",
        "name": "Kompanija Kupac",
        "idQualifier": "92",
        "id": "BUYER001"
      }
    ]
  },
  "detail": {
    "PO1": [
      {
        "lineNumber": "1",
        "quantity": 500,
        "unit": "EA",
        "unitPrice": 25.00,
        "productId": "WIDGET-A"
      }
    ]
  }
}

API-first EDI

API-first EDI platforme pružaju RESTful krajnje tačke gdje trgovinski partneri dostavljaju i preuzimaju poslovne dokumente kao JSON korisni teret. Umjesto razmjene datoteka putem VAN mreža (Value Added Networks) ili AS2 konekcija, partneri komuniciraju putem standardnih HTTPS API-ja s JSON tijelom zahtjeva i odgovora. Ovaj pristup dramatično pojednostavljuje integraciju za organizacije koje već imaju modernu API infrastrukturu.

EDI baziran na webhook-ovima

U webhook modelu, trgovinski partneri registruju URL-ove za povratne pozive kako bi primali obavijesti u realnom vremenu kada su novi dokumenti dostupni. Kada se kreira narudžbenica, sistem kupca šalje JSON korisni teret putem HTTP POST-a na webhook krajnju tačku dobavljača. Ovaj push model smanjuje latenciju u poređenju s tradicionalnim EDI mehanizmima prozivanja i omogućava arhitekture pokretane događajima.

GraphQL za B2B

Neke organizacije istražuju GraphQL kao alternativu REST-u za B2B razmjenu podataka. GraphQL-ov jezik upita omogućava trgovinskim partnerima da zatraže tačno one podatke koji su im potrebni, smanjujući prekomjerno dohvatanje i omogućavajući fleksibilnije integracije. Iako još nije ustaljen za EDI, GraphQL dobiva na zamahu u scenarijima vidljivosti lanca snabdijevanja i upravljanja katalogom.

Nove specifikacije

JSON Schema za EDI: JSON Schema pruža strukturnu validaciju za JSON dokumente, analogno XML Schema (XSD) za XML EDI. Trgovinski partneri mogu objaviti JSON sheme koje definišu očekivanu strukturu i tipove podataka svakog poslovnog dokumenta.
OpenAPI za B2B: OpenAPI specifikacija (ranije Swagger) može definirati B2B API ugovore, uključujući sheme zahtjeva/odgovora, autentifikaciju i obradu grešaka.
AsyncAPI: Za arhitekture pokretane događajima, AsyncAPI definiše API-je pokretane porukama, što je relevantno za webhook-bazirani i EDI baziran na redovima poruka.
Peppol BIS s JSON-om: Peppol mreža, koja pretežno koristi UBL XML, istražuje JSON reprezentacije kako bi snizila ulaznu barijeru za manja preduzeća.

Primjena

Integracije e-trgovine: Trgovačke platforme poput Amazona, Shopifyja i eBaya pružaju JSON API-je za upravljanje narudžbama, ažuriranje zaliha i obavijesti o isporuci
Dropshipping: JSON API-ji povezuju trgovce s dropship dobavljačima za provjeru zaliha u realnom vremenu, automatizirano naručivanje i praćenje pošiljki
Fintech i plaćanja: Moderne platforme za plaćanje koriste JSON za isporuku faktura, iniciranje plaćanja i usklađivanje
Logistika i dostava: API-ji prevoznika (FedEx, UPS, DHL) koriste JSON za usporedbu cijena, generiranje naljepnica i praćenje pošiljki
Zdravstvo (FHIR): HL7 FHIR koristi JSON za razmjenu kliničkih podataka, predstavljajući prihvatanje JSON EDI-ja u reguliranoj industriji
Vidljivost lanca snabdijevanja: Platforme za praćenje lanca snabdijevanja u realnom vremenu koriste JSON webhook-ove za propagiranje ažuriranja statusa kroz partnerske mreže

Prednosti

Prilagođeno programerima: JSON je nativan za web razvoj, ne zahtijeva specijalizirano EDI znanje ili prevodiočki softver
Lagani format: JSON dokumenti su obično manji od ekvivalentnih XML dokumenata, smanjujući propusnost i opterećenje parsiranja
Sposobnost rada u realnom vremenu: API i webhook pristupi omogućavaju gotovo trenutnu razmjenu dokumenata, za razliku od tradicionalnog EDI-ja orijentiranog na serije
Niska ulazna barijera: Svaka organizacija s osnovnim sposobnostima web razvoja može implementirati integracije bazirane na JSON-u
Fleksibilnost: Dinamička struktura JSON-a olakšava proširenje dokumenata dodatnim poljima bez narušavanja postojećih parsera
Bogat ekosistem: JSON validatori, generatori shema, alati za testiranje API-ja i integracione platforme su široko dostupni

Povezani standardi

JSON EDI ne zamjenjuje tradicionalne standarde već ih sve više nadopunjuje. Mnoge organizacije koriste moderne EDI platforme koje prihvataju JSON ulaze i prevode ih u X12 ili EDIFACT za partnere koji zahtijevaju tradicionalne formate. XML EDI standardi poput UBL-a služe kao posredni korak između tradicionalnog EDI-ja i JSON pristupa, a mnogi XML EDI dokumenti mogu se direktno konvertovati u JSON. U specijaliziranim domenama, RosettaNet PIP-ovi se reimplementiraju kao JSON API-ji, a SWIFT usvaja JSON uz ISO 20022 XML za finansijske poruke.