Regulasi dan Integrasi
Integrasi TAS dan TMS ke SAP: data yang dikirim dan cara menangani kegagalan
Integrasi TAS dan TMS ke SAP membawa order, hasil pengisian, dan stok tangki. Lihat data per transaksi dan cara antrean, retry, dan rekonsiliasi menjaganya tetap benar saat koneksi gagal.
- Topik
- Regulasi dan Integrasi
- Diperbarui
- 13 November 2026
- Waktu baca
- 6 menit
- Bagian
- 8

Integrasi terminal automation system (TAS) dan tank management system (TMS) ke SAP biasanya memindahkan tiga jenis data: order dan status pengiriman, hasil pengisian per kompartemen, dan stok tangki yang dikoreksi ke suhu standar. Yang menentukan keberhasilan adalah aturan antrean, retry, dan rekonsiliasi saat koneksi gagal.
TAS menjalankan pengisian di terminal (lihat pengertian terminal automation system), sedangkan TMS menyimpan level dan stok tangki. SAP adalah sistem bisnis yang memegang order, material, dan akuntansi. Pelaporan ke Bea Cukai adalah jalur terpisah, dibahas di TPS Online. Panduan ini membahas data, batas antarsistem, dan penanganan kegagalan, dengan pola yang terlihat dalam proyek terminal Citia sendiri.
Batas sistem
Batas antara OT dan IT
OT adalah peralatan dan perangkat lunak yang menjalankan terminal secara fisik. IT adalah sistem bisnis yang mencatat apa yang terjadi.
TAS, TMS, batch controller, dan PLC termasuk OT: semuanya harus tetap berjalan saat jaringan kantor mati. SAP termasuk IT, dengan siklus perubahan, target ketersediaan, dan pemilik yang berbeda. Integrasi adalah tempat kedua dunia itu bertemu, dan sebagian besar kegagalan muncul karena keduanya dianggap berperilaku sama.
Standar ISA-95 (IEC 62264) menggambarkan pembagian yang sama. Level 3 mencakup manajemen operasi, tempat TAS dan TMS berada, dan Level 4 mencakup perencanaan bisnis dan logistik, tempat SAP berada. Bagian 3 standar ini mendefinisikan aktivitas di Level 3, dan pertukaran antara kedua level itulah pokok bahasan panduan ini.
Prioritas OT
- Pengisian harus lanjut saat jaringan kantor gagal
- Perubahan diuji dan dijadwalkan mengikuti operasi
- Nilai yang salah bisa memengaruhi operasi fisik
Prioritas IT
- Catatan harus sesuai dengan akuntansi dan audit
- Sistem di-patch dan di-upgrade secara berkala
- Akses dikendalikan per pengguna dan peran
- Level 0 sampai 2
- Proses, sensor, dan kontrol: instrumen lapangan, meter, batch controller, PLC
- Level 3
- Manajemen operasi: TAS dan TMS
- Level 4
- Perencanaan bisnis dan logistik: SAP
Data
Tiga jenis data yang berpindah
Hampir semua koneksi TAS dan TMS ke SAP membawa tiga jenis data yang sama.
Order dan status pengiriman mengalir dari SAP, atau dari sistem order distribusi seperti SIOD, ke TAS, dan status setiap pengiriman kembali ke sana. Hasil pengisian mengalir dari TAS ke SAP setelah mobil tangki selesai mengisi, per kompartemen, dengan jumlah terukur. Stok tangki mengalir dari TMS ke SAP sebagai physical inventory.
Catatan proyek Citia sendiri menunjukkan polanya. Di terminal BBM Jambi, TAS menghubungkan pengiriman, gate-in, filling shed, dan gate-out dengan SAP dan SIOD, termasuk surat jalan dan Good Issue. Terminal LPG Pulau Layang melaporkan stok tangki ke SAP lewat physical inventory otomatis, dan TAS Padalarang memperbarui status distribusi di SAP secara otomatis.
Mengukur volume yang diisi dan level tangki.
Arahkan kursor, fokus, atau ketuk sebuah titik untuk melihat catatannya.Bidang data
Isi setiap jenis transaksi
Desain yang baik dimulai dari daftar bidang data untuk setiap transaksi, disusun bersama tim SAP, bukan ditebak.
Tabel menunjukkan isi yang lazim. Daftar bidang sebenarnya bergantung pada konfigurasi SAP dan kesepakatan di lokasi. Dua bidang lebih penting daripada yang lain: business key yang unik untuk setiap transaksi, dan stempel waktu beserta zona waktunya. Tanpa keduanya, retry membuat data ganda dan rekonsiliasi tidak bisa menyejajarkan kedua sisi.
Tuangkan kesepakatan itu dalam satu dokumen antarmuka: daftar bidang data, versi, kode kesalahan, kontak di masing-masing sisi, dan aturan untuk mengubah salah satunya. Bidang yang ditambahkan di satu sisi tanpa melalui dokumen adalah cara paling umum sebuah integrasi rusak berbulan-bulan setelah go-live.
Jaga satuan tetap eksplisit. Volume pada suhu terukur, volume pada suhu standar, densitas, dan suhu adalah nilai yang berbeda. SAP sebaiknya menerima nilai yang ditetapkan proses bisnis, dan nilai lainnya tetap di catatan terminal untuk audit. Baris terakhir tabel menunjukkan pilihan yang umum saat SAP tidak terjangkau, dan setiap lokasi menetapkan kebijakannya sendiri.
| Kriteria | Order dan status | Hasil pengisian | Stok tangki |
|---|---|---|---|
| Arah | SAP atau SIOD ke TAS; status kembali ke SAP | TAS ke SAP | TMS ke SAP |
| Bidang lazim | Nomor order, kendaraan, pengemudi, produk, jumlah rencana, rencana kompartemen | Nomor order, kompartemen, produk, jumlah aktual, waktu mulai dan selesai, meter | Tangki, produk, level, volume, suhu, waktu pembacaan |
| Pemicu | Order baru atau berubah; setiap perubahan status | Akhir transaksi pengisian | Posting terjadwal, penerimaan, atau penjualan |
| Kunci anti ganda | Nomor order ditambah versi | Nomor transaksi ditambah kompartemen | Tangki ditambah waktu posting atau nomor tiket |
| Jika SAP tidak terjangkau | Pengisian lanjut dengan order terakhir yang diterima; status diantrekan | Hasil diantrekan dan dikirim kemudian, berurutan | Posting diantrekan; stok tetap di TMS |
Kegagalan
Antrean, retry, dan posting tanpa ganda
Saat SAP atau jaringan mati, terminal tetap berjalan dan datanya mengantre.
Polanya terdiri dari empat bagian. Pengirim menyimpan setiap pesan di antrean yang tahan restart sebelum mencoba mengirimnya. Retry dilakukan dengan jeda yang makin panjang, bukan berputar rapat. Penerima memperlakukan pesan berulang dengan business key yang sama sebagai pesan yang sudah dimilikinya, sehingga retry tidak pernah membuat posting kedua. Pesan yang gagal berulang masuk ke daftar tinjauan dengan alarm, dan seseorang yang memutuskan.
Dokumentasi IDoc SAP menjelaskan separuh sisi penerima dari gagasan ini. Status record menelusuri sebuah IDoc melewati tahapannya, dan status error memicu penanganan pengecualian serta membuka kemungkinan kirim ulang. Sisi terminal harus mengerjakan bagiannya dengan menyimpan status untuk setiap pesan yang dikirim.
Tetapkan kebijakan pengisian secara tertulis. Sebagian lokasi mengizinkan mobil tangki mengisi berdasarkan order terakhir yang diterima selama SAP tidak terjangkau. Lokasi lain menghentikan otorisasi pengisian baru sampai order terkonfirmasi. Keduanya bisa benar. Pilihan yang berbahaya adalah tidak memutuskan.
Antrean tahan restart
Setiap pesan disimpan sebelum dikirim, sehingga restart tidak menghilangkan apa pun.
Retry dengan jeda
Jeda yang makin panjang melindungi SAP saat kembali aktif.
Business key
Pesan berulang dikenali dan diabaikan, bukan diposting dua kali.
Daftar tinjauan dan alarm
Kegagalan berulang sampai ke seseorang lengkap dengan buktinya.
Pengecekan
Rekonsiliasi harian antara terminal dan SAP
Rekonsiliasi adalah pengecekan bahwa kedua sistem sepakat, dilakukan setiap hari dan bukan hanya di akhir bulan.
Tentukan jam cut-off dan bandingkan apa yang dipegang kedua sisi pada saat itu. Tujuannya bukan nol selisih pada hari pertama. Tujuannya menemukan tiap selisih selagi orang yang memahami shift tersebut masih ada untuk menjelaskannya.
Tetapkan cut-off
Pakai jam dan zona waktu yang sama di kedua sisi.
Hitung transaksi
Order, hasil pengisian, dan posting stok di terminal dibanding yang diterima di SAP.
Bandingkan jumlah per produk
Total volume terisi per produk di kedua sisi.
Bandingkan stok tangki
Pembacaan TMS pada cut-off dibanding stok yang dipegang SAP.
Beri alasan untuk setiap selisih
Waktu, pesan dalam antrean, koreksi, atau tidak diketahui. Yang tidak diketahui didahulukan.
Kirim ulang hanya yang hilang
Jangan kirim ulang apa yang sudah diposting SAP.
Data acuan
Siapa memegang data acuan
Data master adalah kosakata bersama dalam integrasi: produk, pelanggan, plant, tangki, dan kendaraan.
Di kebanyakan terminal, SAP memegang kode material, pelanggan, dan data plant, sedangkan terminal memegang tangki, bay, dan peralatan. TAS menyimpan salinan data SAP yang dibutuhkannya, jadi pertanyaan sebenarnya adalah bagaimana sebuah perubahan merambat. Jika kode produk berubah di SAP dan TAS tidak diperbarui, mobil tangki mengisi satu produk dengan kode produk lain.
Pekerjaan Citia di Padalarang adalah contoh yang jelas. Peralihan dari B40 ke B50 berarti kode material baru di aplikasi pengisian. Pelajaran yang tercatat di halaman proyek singkat: validasi kode aktif sebelum pembaruan, jangan konfigurasikan kode yang masih pending sebagai produk operasional, dan uji serta dokumentasikan setiap perubahan produk. Artikel B50 di terminal BBM memuat daftar perubahan lengkapnya.
Beri setiap item data master satu pemilik dan satu arah perubahan. Dua sistem yang sama-sama boleh mengubah daftar produk akan saling menyimpang.
Penerimaan
Menguji integrasi sebelum go-live
Integrasi diuji dengan sengaja merusaknya, bukan hanya dengan menjalankannya ketika semuanya berfungsi.
Sepakati kasus uji bersama tim SAP dan jalankan di sistem uji dengan data master yang realistis. Daftar singkat sudah cukup jika setiap kasus punya hasil yang diharapkan secara tertulis:
- Satu order normal, dari pengisian sampai posting, dari awal sampai akhir.
- Pesan berulang dengan business key yang sama, yang tidak boleh membuat posting kedua.
- SAP tidak terjangkau saat pengisian, lalu pulih, dengan hasil yang tiba berurutan.
- Kode produk yang ada di terminal tetapi tidak ada di SAP, yang harus ditolak dengan alasan yang jelas.
- Restart server terminal di tengah antrean.
- Perbedaan jam atau zona waktu antara kedua sistem.
Catat setiap hasil di berita acara uji lapangan. Proyek B50 Citia mengikuti kebiasaan yang sama: transaksi uji dengan kode produk baru, lengkap dengan tangkapan layar dan hasil uji yang didokumentasikan.
Keamanan
Menjaga koneksi tetap aman
Koneksi antara SAP dan terminal juga merupakan jalur masuk ke jaringan kontrol, sehingga perlu dirancang tersendiri.
Pakai server atau layanan antarmuka khusus di antara kedua jaringan, dan biarkan ia hanya membuka koneksi yang dibutuhkan aliran data. Beri integrasi akun sendiri dengan hak minimum, supaya password yang bocor tidak bisa mengubah pengaturan terminal. Catat setiap pesan beserta key dan waktunya, karena log itu juga menjadi bukti saat ada perbedaan dalam rekonsiliasi.
Buletin Citia tentang integrasi sistem yang aman menjelaskan koneksi berbasis API dengan perlindungan berlapis, dan panduan keamanan siber OT di terminal BBM membahas langkah awal untuk jaringan kontrol.
- Posisi di jaringan
- Server antarmuka di antara jaringan OT dan IT
- Koneksi
- Hanya yang dibutuhkan aliran data, keluar dari terminal bila memungkinkan
- Akun
- Khusus untuk integrasi, dengan hak minimum
- Pencatatan
- Setiap pesan dengan key, waktu, dan hasil
Istilah yang perlu diketahui
- OT dan IT
- OT menjalankan operasi fisik (TAS, TMS, PLC). IT menjalankan catatan bisnis (SAP, email, jaringan kantor).
- SAP
- Sistem enterprise yang menyimpan order, material, stok, dan akuntansi perusahaan.
- IDoc
- Format dokumen SAP untuk bertukar data bisnis antarsistem, dengan status record yang menelusuri setiap dokumen.
- Business key
- Nilai yang mengidentifikasi sebuah transaksi secara unik, misalnya nomor order dengan kompartemen, dipakai untuk mengenali pengulangan.
- Physical inventory
- Stok yang terukur di tangki, berbeda dengan stok yang menurut buku besar seharusnya ada.
- Good Issue
- Posting SAP yang mencatat barang keluar dari stok, di sini dipicu oleh pengiriman yang selesai.
- SIOD
- Sistem order distribusi yang datanya dipertukarkan dengan terminal dalam proyek TAS Citia.
Pertanyaan yang sering diajukan
Apa yang terjadi pada transaksi saat SAP tidak tersedia?
Transaksi disimpan di antrean sisi terminal dan dikirim saat SAP kembali. Apakah mobil tangki boleh terus mengisi selama itu adalah kebijakan lokasi, biasanya berdasarkan order terakhir yang diterima. Antrean mengirim hasil secara berurutan, dan business key mencegah data ganda.
Siapa yang memegang data master, TAS atau SAP?
Biasanya SAP memegang data master bisnis seperti material, pelanggan, dan plant, sedangkan terminal memegang tangki, bay, dan peralatan. TAS menyimpan salinan yang dibutuhkannya. Beri setiap item satu pemilik dan satu arah perubahan.
Bagaimana mencegah posting ganda?
Beri setiap transaksi business key yang unik dan buat penerima mengabaikan key yang sudah dimilikinya. Simpan status untuk setiap pesan di sisi pengirim, sehingga retry menjadi keputusan berdasarkan keadaan yang diketahui.
Data apa yang dikirim TMS ke SAP?
INTEGRA TMS membaca level, suhu, dan volume dari gauge tangki, menyimpan tank ticket untuk penerimaan dan penjualan, dan memposting physical inventory ke SAP lewat intranet. Pembacaan mentah tetap di database TMS.
Apa arti konvergensi OT/IT?
Artinya menghubungkan operational technology, sistem yang menjalankan lokasi fisik, dengan information technology, sistem bisnis. Manfaatnya satu catatan untuk setiap transaksi. Biayanya, dua tim dengan prioritas berbeda harus sepakat soal antarmuka, akses, dan kontrol perubahan.
Haruskah SAP menerima setiap pembacaan tangki?
Tidak. SAP butuh stok pada titik yang ditetapkan proses bisnis, misalnya akhir hari atau setelah penerimaan. Pembacaan kontinu tetap di TMS, tempat ia melayani alarm dan tren, dan ringkasannya dikirim ke SAP.
Sumber dan bacaan lanjutan
- ISA-95 Standard: Enterprise-Control System Integration (tab baru)
- Status Processing (IDoc status records and exception handling) (tab baru)
- OData Version 4.0 Part 1: Protocol (tab baru)
- INTEGRA TMS (tab baru)
- Fuel Terminal Jambi distribution workflow (tab baru)
- Tank farm operations: TMS integration with SAP (tab baru)
- B50 product update, Padalarang fuel terminal (tab baru)
- Cover photo by Christopher Bowns, CC BY-SA 2.0 (cropped and colour graded) (tab baru)
Langkah berikutnya
Siapkan pembahasan teknis untuk fasilitas Anda.
Bawa daftar perangkat, diagram, dan gejala yang Anda miliki. Tim Citia membantu memetakan langkah berikutnya.
Produk dan solusi terkait
- PengetahuanTPS Online Bea Cukai: pengertian, siapa yang wajib, dan cara kerjanyaTPS Online adalah pertukaran data elektronik antara Bea Cukai dan pengusaha TPS untuk barang masuk dan keluar. Pelajari siapa yang wajib, apa yang dilaporkan, dan langkah saat respons tidak jelas.
- PengetahuanArsitektur TAS: lapisan lapangan, kontrol, aplikasi, dan enterpriseArsitektur TAS punya empat lapisan, dari perangkat lapangan sampai ERP. Pelajari sambungannya, gangguan di tiap lapisan, redundansi, dan segmentasi jaringan.
- PengetahuanJembatan timbang adalah: cara kerja, tiket timbang, dan tera ulangJembatan timbang menimbang truk utuh lewat load cell dan mencatat bruto, tara, neto di tiket. Komponen, isi tiket, tera ulang, dan pengendalian kecurangan.
- ProdukINTEGRA TMSMengumpulkan pembacaan ATG dari setiap tangki untuk level live, histori, tank ticket dan posting stok ke SAP.
- ProdukINTEGRA TASMenjalankan loading truk di terminal BBM dan LPG, dari order dan gate-in sampai pengisian dan dokumen gate-out.
- NewsIntegrasi TMS dan SAP untuk Inventory serta Otomasi TerminalMembahas pengumpulan data inventory, pemantauan level tangki, dan pelaporan stok melalui integrasi TMS dengan SAP.
- NewsPertamina LPG Pulau LayangReferensi TAS terminal LPG dengan pelaporan stok ke SAP, operasi dari control room, serta pembuatan tank ticket dan surat jalan.
- ProyekAlur distribusi Fuel Terminal JambiTAS, integrasi perangkat dan dukungan LTSA
- PengetahuanTAS, TMS, dan TPS Integration: apa yang dikelola masing-masing?Pisahkan proses distribusi, pengukuran inventory, dan pelaporan dokumen sebelum menentukan integrasi.