DATA TRANSFER PROTOCOL POINT OF SALES PT ANGKASA PURA II Alamat FTP File manifest dapat dikirimkan ke FTP Angkasa Pura II dengan alamat: ftp://tenant.angkasapura2.co.id atau sftp://tenant.angkasapura2.co.id Username dan Password akan dikirimkan ke email masing-masing perwakilan tenant. Format Nama File File transaksi dikirim sekali per hari dengan format nama file NAMATENANT_BANDARA_STORESEQUENCE_YYYYMMDD NAMA TENANT: Nama tenant. Jika nama tenant lebih dari satu kata, nama disambung tanpa spasi. Contoh PERIPLUS, KFC, MCD, MEGAMENDUNG, ANANDABOOKSTORE BANDARA: Bandara lokasi tenant Contoh CGK, KNO, BTJ, DJB, BDO, HLP, PLM, PNK, PKU, PGK, PNK, DTB, TNJ STORESEQUENCE: Apabila terdapat lebih dari 1 toko di bandara yang sama, isi dengan nomor urut toko tersebut. Apabila hanya terdapat 1 toko di bandara yang sama, isi dengan angka 1. Contoh 1,2,3,... YYYYMMDD: Tanggal transaksi dengan format YYYYMMDD Contoh 20160124 untuk transaksi tanggal 24 Januari 2016 File yang dikirimkan dapat berupa file Excel (.xlsx), CSV (.csv) atau TEXT (.txt) tapi disarankan menggunakan format.txt dan isi filenya menggunakan delimiter semicolon (;). Contoh nama file: PERIPLUS_CGK_1_20160214.csv untuk data transaksi Periplus di bandara CGK pada tanggal 14 Februari 2016 dengan nomor store 1 (misal store 1 adalah store di terminal 1B). PERIPLUS_CGK_2_20160214.xlsx untuk data transaksi Periplus di bandara CGK pada tanggal 14 Februari 2016 dengan nomor store 2 (misal store 2 adalah store di terminal 2D). PERIPLUS_CGK_3_20160101.txt untuk data transaksi Periplus di bandara CGK pada tanggal 1 Januari 2016 dengan nomor store 3 (misal store 3 adalah store di terminal 2F). PERIPLUS_KNO_1_20160201.csv untuk data transaksi Periplus di bandara KNO pada tanggal 1 Februari 2016 dengan nomor store 1.
Format Isi File Isi file manifest adalah sebagai berikut Invoice number Unit Transaction time Price per unit Airport code Discount Currency Rate Payment type Terminal Price amount Paid by Store sequence Username Item sequence Other tax bar-code Item name/ desc Total discou nt name Item code Total price amount flight no Barcode Total VAT Category name Total other tax airport destination Nationality Category code Service charge Remark Quantity Transaction amount Ketentuan: File dapat disimpan dengan ekstensi.csv atau.txt. Untuk file csv atau txt, Masing-masing kolom dipisahkan dengan delimiter semicolon (;) Alternatif lain, file dapat disimpan dalam format Excel (.xls) dengan isi file sesuai kolomkolom di atas Invoice number (M) : Nomor invoice Transaction time (M) : Waktu transaksi dengan format YYYY-mm-dd HH:ii:ss Airport Code (M) : Bandara lokasi tenant berada Terminal (O) : Terminal lokasi tenant berada Store sequence (O) : Nomor urut toko di bandara tersebut (jika terdapat lebih dari satu toko di bandara yang sama) Item sequence (O) : Nomor urut barang dalam satu transaksi Item name/desc (M) : Nama atau deskripsi barang yang dibeli Item code (M) : Kode barang Barcode (O) : Barcode barang Category name (O) : Nama kategori item Category code (O) : Kode kategori Quantity (M) : Jumlah barang yang dibeli Unit (O) : Unit, misal kg, pcs Price per unit (M) : Harga barang per unit Discount (O) : Diskon per unit Price amount (O) : Harga barang per unit setelah dikurangi diskon VAT (M) : PPn Other tax (O) : Pajak lain-lain Total discount (O) : Quantity * Discount Total price amount (O) : Quantity * Price amount Total VAT (O) : Quantity * VAT Total other tax (O) : Quantity * Other tax Service charge (O) : Biaya service
Transaction amount (M): Total price amount + Total VAT + Total other tax + Service charge Currency (O) : Mata uang, misal IDR, USD, EUR, GBP Rate (O) : Kurs Payment type (O) : Metode pembayaran, misal Cash, Card Paid by (O) : Jenis pembayaran, misal Cash IDR, Mandiri Debit, BNI Visa Gold Username (O) : Username kasir barcode (O) : Barcode boarding pass pembeli name (O) : Nama pembeli flight no (O) : Nomor penerbangan pembeli destination (O) : Kode bandara tujuan pembeli nationality (O) : Kewarnanegaraan pembeli Remark (O) : Catatan Catatan (M) Mandatory (O) Optional Contoh file Contoh file ada di file terpisah dengan nama file PERIPLUS_KNO_1_20140404.csv (format file csv dengan delimiter koma) PERIPLUS_KNO_1_20140404.txt (format file txt dengan delimiter semicolon) PERIPLUS_KNO_1_20140404.xlsx (format file excel)
Cara Upload ke FTP Berikut cara upload file ke FTP Angkasa Pura II. Metode 1: Menggunakan Windows Explorer a. Copy file yang akan diupload b. Ketikkan alamat FTP ftp://tenant.angkasapura2.co.id di address bar
c. Masukkan username dan password d. Paste file yang akan diupload
Metode 2: Menggunakan Aplikasi Filezilla a. Buka aplikasi Filezilla b. Masukkan hostname (ftp://tenant.angkasapura2.co.id) dan username dan password
c. Drag and drop file yang akan diupload dari Local Site (sebelah kiri) ke Remote Site (sebelah kanan) Metode 3: Otomasi Pengiriman Data Menggunakan Web Services Tenant dapat membuat suatu aplikasi/web services yang dapat mengambil data transaksi (sesuai format) dari database untuk diupload ke alamat FTP yang ditentukan secara otomatis.