Pregled
APERAK (Application Error and Acknowledgement — Greška aplikacije i potvrda) poruka se koristi za komunikaciju grešaka ili potvrda na nivou poslovne aplikacije. Za razliku od CONTRL poruke koja se bavi samo sintaksnom ispravnošću, APERAK radi na višem nivou — provjerava da li je sadržaj poruke validan sa stanovišta poslovne logike i da li ga primateljeva aplikacija može obraditi.
Poruka može proći CONTRL validaciju (sintaksno je ispravna) ali biti odbijena od strane poslovne aplikacije. Na primjer, ORDERS poruka može biti savršeno formatirana prema EDIFACT standardu, ali sadržavati referentni broj proizvoda koji ne postoji u sistemu primatelja, ili tražiti isporuku na nepoznatu adresu. U takvim slučajevima, APERAK služi za informisanje pošiljaoca o konkrektnom problemu.
APERAK je ključan za postizanje potpune automatizacije EDI procesa. Bez njega, greške na nivou aplikacije ostaju neotkrivene dok ih neko ručno ne primijeti — što može uzrokovati kašnjenja u isporuci, pogrešne fakture ili druge poslovne probleme. Sa APERAK-om, pošiljalac dobija trenutnu, strukturiranu povratnu informaciju i može brzo korigirati i ponovo poslati poruku.
Struktura poruke
APERAK poruka sadrži referencu na originalnu poruku koja je uzrokovala grešku, identifikaciju segmenta i elementa gdje je problem pronađen, te tekstualni opis greške. Može se koristiti i kao pozitivna potvrda da je poruka uspješno obrađena od strane poslovne aplikacije.
Ključni segmenti
| Segment | Naziv | Namjena |
|---|---|---|
BGM | Početak poruke | Identificira APERAK poruku i njenu funkciju (greška ili potvrda) |
DTM | Datum/Vrijeme/Period | Datum i vrijeme kada je greška otkrivena |
RFF | Referenca | Referencira originalnu poruku koja je uzrokovala grešku (tip i broj poruke) |
NAD | Ime i adresa | Identificira pošiljaoca originalne poruke i primatelja koji prijavljuje grešku |
ERC | Kod greške aplikacije | Kodiran razlog greške prema dogovorenim kodnim listama |
FTX | Slobodan tekst | Detaljan tekstualni opis greške za ljudsko čitanje |
RFF | Referenca (na nivo greške) | Identificira konkretan segment ili element u originalnoj poruci gdje je greška pronađena |
UNT | Završetak poruke | Broj segmenata i referentni broj poruke |
APERAK vs CONTRL
Razumijevanje razlike između APERAK-a i CONTRL-a je ključno za pravilnu EDI implementaciju:
- CONTRL (nivo sintakse): Provjerava da li poruka slijedi EDIFACT pravila formatiranja. Primjer greške: segment NAD ima previše podatkovnih elemenata. CONTRL se generiše automatski od strane EDI parsera.
- APERAK (nivo aplikacije): Provjerava da li je sadržaj poruke poslovno validan. Primjer greške: GTIN u LIN segmentu ne postoji u katalogu proizvoda. APERAK se generiše od strane poslovne aplikacije nakon obrade poruke.
U praksi, obrada poruke prolazi dva nivoa validacije: prvo CONTRL potvrđuje sintaksnu ispravnost, a zatim — ako je poruka sintaksno ispravna — poslovna aplikacija je obrađuje i šalje APERAK ako pronađe probleme ili kao pozitivnu potvrdu obrade.
Uobičajeni slučajevi korištenja
- Nepoznat proizvod: ORDERS poruka referencira GTIN koji ne postoji u sistemu dobavljača. APERAK informiše kupca da artikal nije prepoznat i da narudžba ne može biti obrađena za tu stavku.
- Nevalidna adresa isporuke: Narudžbenica navodi lokaciju isporuke koja nije registrirana u sistemu dobavljača. APERAK traži korekciju podataka adrese.
- Duplikat dokumenta: Sistem detektira da je faktura sa istim brojem već primljena i obrađena. APERAK obavještava pošiljaoca o duplikatu kako bi se izbjeglo dvostruko plaćanje.
- Pozitivna potvrda: Neki trgovinski partneri koriste APERAK kao funkcionalnu potvrdu da je poruka uspješno uvezena u poslovni sistem, nadopunjujući CONTRL sintaksnu potvrdu.
- Poslovni rokovi: Narudžba traži isporuku na datum koji je u prošlosti ili koji je prekratak za pripremu. APERAK obavještava kupca da datum isporuke nije izvediv.
Primjer isječka
UNH+1+APERAK:D:96A:UN'
BGM+313+APE-2024-00567+9'
DTM+137:20240316:102'
RFF+ACE:PO-2024-00456'
NAD+MS+4012345000010::9'
NAD+MR+5412345000013::9'
ERC+12'
FTX+AAO+++Artikal 4012345000099 nije pronađen u katalogu proizvoda'
RFF+LI:3'
UNT+9+1'Razmatranja za implementaciju
Definirajte sa trgovinskim partnerima jasne kodne liste grešaka (ERC segment) koje će se koristiti u APERAK porukama. Standardni EDIFACT kodovi pokrivaju opšte slučajeve, ali mnoge industrije i bilateralni sporazumi definišu dodatne kodove specifične za njihove poslovne procese.
Implementirajte automatsku obradu dolaznih APERAK poruka u vašem EDI sistemu. Kada primite APERAK sa greškom, sistem treba automatski označiti originalnu poruku kao odbijenu i obavijestiti odgovornog korisnika. Za kritične poruke poput narudžbi, razmotrite automatsko pokretanje ponovnog slanja nakon korekcije.
Koristite FTX segment za pružanje smislenih, čovjeku razumljivih opisa grešaka. Dok je ERC kod koristan za automatsku obradu, tekstualni opis u FTX segmentu pomaže ljudima brzo razumjeti i riješiti problem bez potrebe za pretragom kodnih tabela.