Pengakuan fungsional 997 dan kode kesalahan untuk pesan X12 di Azure Logic Apps
Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)
Di Azure Logic Apps, Anda dapat membuat alur kerja yang menangani pesan X12 untuk komunikasi Pertukaran Data Elektronik (EDI) saat Anda menggunakan operasi X12. Dalam pesan EDI, pengakuan memberikan status dari pemrosesan pertukaran EDI. Ketika menerima pertukaran, tindakan Decode X12 dapat mengembalikan satu atau lebih jenis pengakuan kepada pengirim, berdasarkan jenis pengakuan yang diaktifkan dan tingkat validasi yang sudah ditentukan.
Misalnya, penerima melaporkan status dari memvalidasi Kepala Grup Fungsional (GS) dan Ekor Grup Fungsional (GE) dalam pesan yang dikodekan X12 yang diterima dengan mengirimkan pengakuan fungsional 997 (ACK) bersama dengan setiap kesalahan yang terjadi selama pemrosesan. Tindakan Decode X12 selalu menghasilkan ACK 997 yang patuh dengan 4010, sementara tindakan Encode X12 dan tindakan Decode X12 dapat memvalidasi ACK 997 yang patuh dengan 5010.
Penerima mengirimkan ACK 997 di dalam amplop Kepala Grup Fungsional (GS) dan Ekor Grup Fungsional (GE). Namun, amplop GS dan GE ini tidak sama dengan di kumpulan transaksi lainnya.
Topik ini memberikan gambaran singkat tentang ACK 997 X12, termasuk segmen ACK 997 dalam pertukaran dan kode kesalahan yang digunakan di segmen tersebut. Untuk informasi lebih lanjut, tinjau dokumentasi berikut ini:
- Kode kesalahan dan pengakuan teknis TA1 X12
- Pesan Exchange X12 untuk integrasi perusahaan B2B
- Pesan Exchange EDIFACT untuk integrasi perusahaan B2B
- Apa itu Azure Logic Apps
- Solusi integrasi perusahaan B2B dengan Azure Logic Apps dan Enterprise Integration Pack
Segmen ACK 997
Tabel berikut menjelaskan segmen ACK 997 dalam pertukaran dan menggunakan definisi berikut:
- M= Wajib
- O= Opsional
| Posisi | ID Segmen | Nama | Penugasan yang diperlukan (Des. Waj.) |
Penggunaan maksimum | Pengulangan loop |
|---|---|---|---|---|---|
| 010 | ST | Judul Kumpulan Transaksi, untuk pengakuan | M | 1 | - |
| 020 | AK1 | Judul Respons Grup Fungsional | M | 1 | - |
| 030 | AK2 | Judul Respons Kumpulan Transaksi | O | 1 | 999999 (ID Loop = AK2) |
| 040 | AK3 | Catatan Segmen Data | O | 1 | 999999 (ID Loop = AK2 atau AK3) |
| 050 | AK4 | Catatan Elemen Data | O | 9 9 | - |
| 060 | AK5 | Ekor Respons Kumpulan Transaksi | M | 1 | - |
| 070 | AK9 | Ekor Respons Grup Fungsional | M | 1 | - |
| 080 | SE | Ekor Kumpulan Transaksi, untuk pengakuan | M | 1 | - |
Bagian berikut ini menyediakan informasi selengkapnya tentang segmen AK ini. Dalam loop AK2 ke AK5, segmen memberikan informasi tentang kesalahan dengan satu kumpulan transaksi.
AK1
Segmen AK1 wajib mengidentifikasi grup fungsional untuk mengakui dengan menggunakan elemen data berikut:
| Elemen | Deskripsi |
|---|---|
| AK101 | Wajib, mengidentifikasi ID grup fungsional (GS01) untuk grup fungsional untuk mengakui. |
| AK102 | Wajib, mengidentifikasi nomor grup fungsional (GS06 dan GE02) untuk grup fungsional untuk mengakui. |
| AK103 | Opsional, mengidentifikasi versi implementasi EDI yang dikirim di GS08 dari transaksi asli. AK103 mendukung ACK 997 yang patuh dengan 5010. |
AK2
Segmen AK2 opsional berisi pengakuan untuk kumpulan transaksi yang ditetapkan dalam grup fungsional yang diterima. Jika beberapa segmen AK2 ada, segmen tersebut dikirim sebagai serangkaian loop. Setiap loop AK2 mengidentifikasi kumpulan transaksi menggunakan pesanan yang diterima. Jika kumpulan transaksi salah, loop AK2 berisi segmen AK3, AK4, dan AK5. Untuk informasi lebih lanjut, tinjau deskripsi segmen nanti dalam topik ini.
Segmen AK2 mengidentifikasi kumpulan transaksi yang ditetapkan dengan menggunakan elemen data berikut:
| Elemen | Deskripsi |
|---|---|
| AK201 | Wajib, mengidentifikasi ID kumpulan transaksi (ST01) dari kumpulan transaksi yang ditetapkan untuk pengakuan. |
| AK202 | Wajib, mengidentifikasi nomor kontrol kumpulan transaksi (ST02 dan SE02) dari transaksi yang ditetapkan untuk pengakuan. |
| AK203 | Opsional, mengidentifikasi versi implementasi EDI yang dikirim di ST03 dari transaksi asli. AK203 mendukung 997 yang patuh dengan 5010 masuk. |
Menghasilkan segmen AK2
Anda dapat menentukan segmen AK2 yang dihasilkan untuk semua kumpulan transaksi yang diterima dan ditolak, atau khusus untuk kumpulan transaksi yang ditolak. Sebaliknya, Azure Logic Apps menghasilkan loop AK2 khusus untuk kumpulan transaksi yang ditolak. Jika perjanjian tidak menyelesaikan pertukaran yang ditanggapi, pengaturan generasi 997 secara default menjadi pengaturan perjanjian fallback, dan segmen AK2 tidak dihasilkan untuk kumpulan transaksi yang diterima.
Agar Azure Logic Apps menghasilkan segmen AK2 untuk kumpulan transaksi yang diterima ketika AK501 == A, ikuti langkah-langkah berikut:
Di portal Azure, buka akun integrasi Anda, lalu buka artefak perjanjian X12 antara mitra dagang X12 Anda.
Buka panel Pengaturan Penerimaan, pastikan FA yang Diharapkan yang muncul dipilih. Anda lalu dapat memilih Sertakan Loop IK2/AK2.
AK3
Segmen AK3 opsional melaporkan kesalahan di segmen data dan mengidentifikasi lokasi segmen data. Segmen AK3 dibuat untuk setiap segmen dalam kumpulan transaksi yang memiliki satu atau banyak kesalahan. Jika terdapat beberapa segmen AK3, segmen dikirim sebagai rangkaian loop dengan satu segmen per loop. Segmen AK3 menentukan lokasi setiap segmen dalam kesalahan dan melaporkan jenis kesalahan sintaksis yang ditemukan di lokasi tersebut dengan menggunakan elemen data berikut:
| Elemen | Deskripsi |
|---|---|
| AK301 | Wajib, mengidentifikasi segmen yang salah dengan ID segmen X12, misalnya NM1. |
| AK302 | Wajib, mengidentifikasi jumlah segmen dari segmen dalam kesalahan. Segmen ST adalah 1, dan setiap segmen meningkatkan jumlah segmen satu per satu. |
| AK303 | Wajib, mengidentifikasi perulangan terikat, yang merupakan perulangan yang dikelilingi oleh segmen Loop Start (LS) dan segmen Loop End (LE). AK303 berisi nilai-nilai segmen LS dan LE yang mengikat segmen dalam kesalahan. |
| AK304 | Opsional, menentukan kode untuk kesalahan di segmen data. Meskipun AK304 bersifat opsional, elemen diperlukan ketika ada kesalahan untuk segmen yang diidentifikasi. Untuk kode kesalahan AK304, tinjau Kode kesalahan ACK 997 - Catatan Segmen Data. |
AK4
Segmen AK4 opsional melaporkan kesalahan dalam elemen data atau struktur data komposit, dan mengidentifikasi lokasi elemen data. Segmen AK4 dikirim ketika elemen data AK304 adalah "8", "Segment has data element errors" dan dapat diulang hingga 99 kali dalam setiap segmen AK3. Segmen AK4 menentukan lokasi setiap struktur data komposit atau elemen data dalam kesalahan dan melaporkan jenis kesalahan sintaksis yang ditemukan di lokasi tersebut dengan menggunakan elemen data berikut:
| Elemen | Deskripsi |
|---|---|
| AK401 | Wajib, elemen data komposit dengan bidang berikut: AK41.1, AK41.2, dan AK41.3 - AK401.1: Mengidentifikasi elemen data atau struktur data komposit dalam kesalahan menggunakan jumlah numeriknya. Misalnya, jika elemen data kedua di segmen memiliki kesalahan, AK401 sama dengan |
| AK402 | Opsional, mengidentifikasi nomor elemen data X12 sederhana dari elemen dalam kesalahan. Misalnya, NM101 adalah elemen data X12 sederhana nomor 98. |
| AK403 | Wajib, melaporkan kesalahan elemen yang diidentifikasi. Untuk kode kesalahan AK403, tinjau Kode kesalahan ACK 997 - Catatan Segmen Data. |
| AK404 | Opsional, berisi salinan elemen data yang diidentifikasi dalam kesalahan. AK404 tidak digunakan jika kesalahan menunjukkan karakter yang tidak valid. |
AK5
Segmen AK5 melaporkan apakah set transaksi yang diidentifikasi di segmen AK2 diterima atau ditolak, serta menjelaskannya. Segmen AK5 adalah wajib ketika loop AK2 opsional disertakan dalam pengakuan. Segmen AK4 menentukan status kumpulan transaksi menggunakan elemen data wajib tunggal dan menyediakan kode kesalahan menggunakan antara satu hingga lima elemen data opsional, berdasarkan pengeditan sintaks dari kumpulan transaksi.
| Elemen | Deskripsi |
|---|---|
| AK501 | Wajib, menentukan apakah kumpulan transaksi yang diidentifikasi diterima atau ditolak. Untuk kode kesalahan AK501, tinjau Kode kesalahan ACK 997 - Ekor Respons Transaksi. |
| AK502 - AK506 | Opsional, menunjukkan sifat kesalahan. Untuk kode kesalahan AK502, tinjau Kode kesalahan ACK 997 - Ekor Respons Kumpulan Transaksi. |
AK9
Segmen AK9 wajib menentukan apakah grup fungsional yang diidentifikasi di segmen AK1 diterima atau ditolak, serta memberikan alasannya. Segmen AK9 menentukan status kumpulan transaksi dan sifat semua kesalahan dengan menggunakan empat elemen data wajib. Segmen menentukan kesalahan yang dicatat dengan menggunakan antara satu hingga lima elemen opsional.
| Elemen | Deskripsi |
|---|---|
| AK901 | Wajib, menentukan apakah grup fungsional yang diidentifikasi dalam segmen AK1 diterima atau ditolak. Untuk kode kesalahan AK901, tinjau Kode kesalahan ACK 997 - Ekor Respons Grup Fungsional. |
| AK902 | Wajib, menentukan jumlah kumpulan transaksi yang termasuk dalam ujung grup fungsional yang diidentifikasi (GE01). |
| AK903 | Wajib, menentukan jumlah kumpulan transaksi yang diterima. |
| AK904 | Wajib, menentukan jumlah kumpulan transaksi yang diterima dalam grup fungsional yang diidentifikasi. |
| AK905 - AK909 | Opsional, menunjukkan antara satu hingga lima kesalahan yang dicatat dalam kelompok fungsional yang diidentifikasi. Untuk kode kesalahan AK905 hingga AK909, tinjau Kode kesalahan ACK 997 - Ekor Respons Grup Fungsional. |
Kode kesalahan ACK 997
Bagian ini mencakup kode kesalahan yang digunakan dalam segmen ACK 997. Setiap tabel mencantumkan kode kesalahan yang didukung dan tidak didukung, seperti yang didefinisikan oleh spesifikasi X12, untuk pemrosesan pesan X12 dalam Azure Logic Apps.
Kode kesalahan AK304 - Catatan Segmen Data
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK304 dari segmen AK3 (Catatan Segmen Data):
| Kode kesalahan | Kondisi | Didukung? |
|---|---|---|
| 1 | ID segmen tidak dikenal | Ya |
| 2 | Segmen tidak terduga | Ya |
| 3 | Segmen wajib tidak ada | Ya |
| 4 | Loop terjadi dalam waktu maksimum | Ya |
| 5 | Segmen melebihi penggunaan maksimum | Ya |
| 6 | Segmen tidak dalam kumpulan transaksi yang ditentukan | Ya |
| 7 | Segmen tidak dalam urutan yang tepat | Ya |
| 8 | Segmen memiliki kesalahan elemen data | Ya |
| 511 | Pemisah belakang yang ditemui (mode kustom) | Ya |
Kode kesalahan AK403 - Catatan Elemen Data
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK403 dari segmen AK4 (Catatan Elemen Data):
| Kode kesalahan | Kondisi | Didukung? |
|---|---|---|
| 1 | Elemen data wajib tidak ada | Ya |
| 2 | Elemen data yang diperlukan secara bersyarat tidak ada | Ya |
| 3 | Terlalu banyak elemen data | Ya |
| 4 | Elemen data terlalu pendek | Ya |
| 5 | Elemen data terlalu panjang | Ya |
| 6 | Karakter tidak valid dalam elemen data | Ya |
| 7 | Nilai kode tidak valid | Ya |
| 8 | Tanggal tidak valid | Ya |
| 9 | Waktu tidak valid | Ya |
| 10 | Kondisi pengecualian dilanggar | Ya |
Kode kesalahan AK501 - Ekor Respons Kumpulan Transaksi
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK501 dari segmen AK5 (Ekor Respons Kumpulan Transaksi):
| Kode kesalahan | Kondisi | Didukung? |
|---|---|---|
| A | Diterima | Ya |
| E | Diterima tapi kesalahannya dicatat | Ya
Catatan: Tidak ada kode kesalahan yang menghasilkan status |
| M | Ditolak, kode autentikasi pesan (MAC) gagal | Tidak |
| P | Diterima sebagian, setidaknya satu kumpulan transaksi ditolak | Ya |
| R | Ditolak | Ya |
| W | Ditolak, jaminan gagal melewati pengujian validitas | Tidak |
| X | Ditolak, konten setelah dekripsi tidak dapat dianalisis | Tidak |
Kode kesalahan AK502 hingga AK506 - Ekor Respons Kumpulan Transaksi
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK502 hingga AK506 dari segmen AK5 (Ekor Respons Kumpulan Transaksi):
| Kode kesalahan | Kondisi | Didukung atau terkait dengan AK501? |
|---|---|---|
| 1 | Transaksi yang tidak didukung | Ya, R |
| 2 | Ekor kumpulan transaksi tidak ada | Ya, R |
| 3 | Nomor kontrol kumpulan transaksi di kepala dan ekor tidak cocok | Ya, R |
| 4 | Jumlah segmen yang disertakan tidak sesuai dengan jumlah aktual | Ya, R |
| 5 | Satu atau beberapa segmen yang salah | Ya, R |
| 6 | Pengidentifikasi kumpulan transaksi yang tidak ada atau tidak valid | Ya, R |
| 7 | Nomor kontrol kumpulan transaksi hilang atau tidak valid, nomor transaksi duplikat mungkin telah terjadi | Ya, R |
| 8 sampai 27 | - | Tidak |
Kode kesalahan AK901 - Ekor Respons Grup Fungsional
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK901 dari segmen AK9 (Ekor Respons Grup Fungsional):
| Kode kesalahan | Kondisi | Didukung atau terkait dengan AK501? |
|---|---|---|
| A | Diterima | Ya |
| E | Diterima tapi kesalahannya dicatat | Ya |
| M | Ditolak, kode autentikasi pesan (MAC) gagal | Tidak |
| P | Diterima sebagian, setidaknya satu kumpulan transaksi ditolak | Ya |
| R | Ditolak | Ya |
| W | Ditolak, jaminan gagal melewati pengujian validitas | Tidak |
| X | Ditolak, konten setelah dekripsi tidak dapat dianalisis | Tidak |
Kode kesalahan AK905 hingga AK909 - Ekor Respons Grup Fungsional
Tabel berikut mencantumkan kode kesalahan yang digunakan dalam elemen data AK905 hingga AK909 dari segmen AK9 (Ekor Respons Grup Fungsional):
| Kode kesalahan | Kondisi | Didukung atau terkait dengan AK501? |
|---|---|---|
| 1 | Grup fungsional tidak didukung | Tidak |
| 2 | Versi grup fungsional tidak didukung | Tidak |
| 3 | Ekor grup fungsional tidak ada | Ya |
| 4 | Nomor kontrol grup di kepala dan ekor grup fungsional tidak setuju | Ya |
| 5 | Jumlah kumpulan transaksi yang disertakan tidak sesuai dengan jumlah aktual | Ya |
| 6 | Nomor kontrol grup melanggar sintaks, nomor kontrol grup duplikat mungkin telah terjadi | Ya |
| 7 hingga 26 | - | Tidak |