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
Transaction time
Airport code
Terminal
Store sequence
Item sequence
Unit
Price per unit
Discount
Price amount
VAT(PPN)
Other tax
Currency
Rate
Payment type
Paid by
Username
Buyer's bar-code
Item name/ desc Total discou nt Buyer's name
Item code
Barcode
Category name
Category code
Quantity
Total price amount Buyer's flight no
Total VAT
Total other tax
Service charge
Transaction amount
Buyer's airport destination
Nationality
Remark
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 diluar pajak (exclude tax) 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 Buyer's barcode (O) : Barcode boarding pass pembeli Buyer's name (O) : Nama pembeli Buyer's flight no (O) : Nomor penerbangan pembeli Buyer's destination (O) : Kode bandara tujuan pembeli Buyer's 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.
