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
Lorong panjang di antara rak server di pusat data.
Ringkasan

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 antara OT dan IT

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
Tiga jenis data yang berpindah

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.

Jalur data antara lapangan, terminal, dan SAP
Lapangan
Kontrol
Aplikasi
Enterprise
Meter dan ATG

Mengukur volume yang diisi dan level tangki.

Arahkan kursor, fokus, atau ketuk sebuah titik untuk melihat catatannya.
Isi setiap jenis transaksi

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.

KriteriaOrder dan statusHasil pengisianStok tangki
ArahSAP atau SIOD ke TAS; status kembali ke SAPTAS ke SAPTMS ke SAP
Bidang lazimNomor order, kendaraan, pengemudi, produk, jumlah rencana, rencana kompartemenNomor order, kompartemen, produk, jumlah aktual, waktu mulai dan selesai, meterTangki, produk, level, volume, suhu, waktu pembacaan
PemicuOrder baru atau berubah; setiap perubahan statusAkhir transaksi pengisianPosting terjadwal, penerimaan, atau penjualan
Kunci anti gandaNomor order ditambah versiNomor transaksi ditambah kompartemenTangki ditambah waktu posting atau nomor tiket
Jika SAP tidak terjangkauPengisian lanjut dengan order terakhir yang diterima; status diantrekanHasil diantrekan dan dikirim kemudian, berurutanPosting diantrekan; stok tetap di TMS
Antrean, retry, dan posting tanpa ganda

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.

Rekonsiliasi harian antara terminal dan SAP

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.

  1. Tetapkan cut-off

    Pakai jam dan zona waktu yang sama di kedua sisi.

  2. Hitung transaksi

    Order, hasil pengisian, dan posting stok di terminal dibanding yang diterima di SAP.

  3. Bandingkan jumlah per produk

    Total volume terisi per produk di kedua sisi.

  4. Bandingkan stok tangki

    Pembacaan TMS pada cut-off dibanding stok yang dipegang SAP.

  5. Beri alasan untuk setiap selisih

    Waktu, pesan dalam antrean, koreksi, atau tidak diketahui. Yang tidak diketahui didahulukan.

  6. Kirim ulang hanya yang hilang

    Jangan kirim ulang apa yang sudah diposting SAP.

Siapa memegang data acuan

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.

Menguji integrasi sebelum go-live

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.

Menjaga koneksi tetap aman

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

  1. ISA-95 Standard: Enterprise-Control System Integration (tab baru)International Society of Automation (ISA) · isa.org
  2. Status Processing (IDoc status records and exception handling) (tab baru)SAP Help Portal · help.sap.com
  3. OData Version 4.0 Part 1: Protocol (tab baru)OASIS · docs.oasis-open.org · 2014
  4. INTEGRA TMS (tab baru)PT Citia Engineering Indonesia · citia-engineering.com
  5. Fuel Terminal Jambi distribution workflow (tab baru)PT Citia Engineering Indonesia · citia-engineering.com · 2026
  6. Tank farm operations: TMS integration with SAP (tab baru)PT Citia Engineering Indonesia · citia-engineering.com · 2025
  7. B50 product update, Padalarang fuel terminal (tab baru)PT Citia Engineering Indonesia · citia-engineering.com · 2026
  8. Cover photo by Christopher Bowns, CC BY-SA 2.0 (cropped and colour graded) (tab baru)Wikimedia Commons · commons.wikimedia.org

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

Baca juga