Anda di halaman 1dari 74

PEDOMAN INTEGRASI2015

APLIKASI
TPS ONLINE
Versi 3.0

DIREKTORAT JENDERAL BEA DAN CUKAI


2015
PEDOMAN INTEGRASI
APLIKASI

TPS ONLINE

Disiapkan
Dalam Rangka Implementasi Sistem TPS Online

Versi 3.0

DIREKTORAT JENDERAL BEA DAN CUKAI


2015

ii
DAFTAR ISI

TPS ONLINE .........................................................................................................................ii

PENDAHULUAN ................................................................................................................... 5

DASAR HUKUM ................................................................................................................... 6

TPS ONLINE ........................................................................................................................ 7

A. Definisi ......................................................................................................................... 7
B. Tujuan Pengembangan ................................................................................................ 7
C. Cara Koneksi Web Service ........................................................................................... 8
D. Kebutuhan Sistem ........................................................................................................ 9
DAFTAR WEB SERVICE .................................................................................................... 10

A. Service Untuk Mengganti Password ........................................................................... 10


B. Service Untuk Mengirim Data Uji Coba Coarri - Codeco ............................................. 10
1. Uji coba kirim data Coarri-Codeco Container ......................................................... 10
2. Uji coba kirim data Coarri-Codeco Kemasan .......................................................... 10
C. Service Untuk Mengirim Data Coarri - Codeco ........................................................... 11
1. Jenis Transaksi Container ...................................................................................... 11
2. Jenis Transaksi Kemasan ...................................................................................... 16
3. Jenis Transaksi Tangki penimbunan ...................................................................... 21
4. Jenis Transaksi Car Terminal ................................................................................. 24
D. Service Untuk Cek Data ............................................................................................. 28
1. Cek Data Reject ..................................................................................................... 28
2. Service Cek Data Gagal Terkirim ........................................................................... 28
3. Service Cek Data Berhasil Terkirim ........................................................................ 29
4. Service Cek Data SPPB ......................................................................................... 29
E. Service Terkait Pindah Lokasi Penimbunan (PLP) ..................................................... 30
1. Service Untuk Mengirimkan Data Permohonan PLP .............................................. 30
2. Service Untuk Mengunduh Respon Persetujuan Permohonan PLP Oleh Pengusaha
TPS Asal ................................................................................................................ 33
3. Service Untuk Mengunduh Respon Persetujuan PLP Oleh Pengusaha TPS Tujuan
34
4. Service untuk mendapatkan detail dari PLP ........................................................... 35
5. Service untuk Mengirimkan Data Pembatalan PLP ................................................ 35
6. Service untuk Mengunduh Respon Persetujuan Pembatalan PLP oleh Pengusaha
TPS Asal yang mengajukan pembatalan PLP ........................................................ 38
7. Service Untuk Mengunduh Respon Persetujuan Pembatalan PLP Oleh Pengusaha
TPS Tujuan ............................................................................................................ 39
F. Service Untuk Mendapatkan Dokumen Perijinan Pemasukan/Pengeluaran Barang
Impor. ......................................................................................................................... 40
1. Service Untuk Mengunduh Data SPPB PIB (BC 2.0) ............................................. 40
a. Parameter Per SPPB......................................................................................... 40
b. Parameter Per Gudang ..................................................................................... 40
c. Parameter Per Kode TPS .................................................................................. 41
2. Service Untuk Mengunduh Data SPPB BC23 ........................................................ 44
a. Parameter Per SPPB......................................................................................... 44
b. Parameter Per Gudang ..................................................................................... 44
c. Parameter Per Kode TPS .................................................................................. 45
3. Service Mengunduh Data SPJM ............................................................................ 48
a. Parameter Per Kode TPS .................................................................................. 48
b. Parameter Per Nomor SPJM ............................................................................. 48
G. Service Untuk Mendapatkan Dokumen Perijinan Pemasukan/Pengeluaran Barang
Ekspor. ....................................................................................................................... 49
1. Service Mengunduh Data NPE (Nota Pelayanan Ekspor) ...................................... 49
a. Service NPE 1 (GetNPE) ................................................................................... 49
b. Service NPE 2 (GetEksporPermit_FNPE) ......................................................... 50
c. Service NPE 3 (GetEkspor_NPE) ...................................................................... 50
d. Service NPE 4 (GetEkspor_PEB) ...................................................................... 51
2. Service Mengunduh Data PKBE ............................................................................ 54
H. Service Dokumen Manual........................................................................................... 54
1. GetDokumenManual .............................................................................................. 54
2. GetDokumenManual_OnDemand .......................................................................... 54
LAMPIRAN ............................................................................................................................ i

A. Penjelasan Skema Pertukaran Data Coarri-Codeco ...................................................... i


B. Penjelasan Skema PLP .............................................................................................. viii
C. Keterangan String XML GetDataOB ............................................................................. x
D. Kode Referensi Dokumen TPS Online.......................................................................... x
E. Kode Jenis Kemasan..................................................................................................... i
F. Tabel Kode Jenis Satuan.............................................................................................. iii
G. Tabel Kode Respon ...................................................................................................... v
Contact Persons ...................................................................................................................vi

4
PENDAHULUAN

Pedoman Integrasi Aplikasi (PIA) TPS Online merupakan salah satu referensi utama
dalam pertukaran data antara DJBC dengan pengusaha TPS (Tempat Penimbunan
Sementara) menggunakan teknologi web service melalui media komunikasi Internet.
Di dalam pedoman ini dijelaskan hal-hal yang perlu diketahui dalam
mengintegrasikan sistem web service. Sehubungan dengan pertukaran data antara Bea &
Cukai dengan TPS, khususnya menyangkut struktur String XML yang perlu disiapkan di sisi
TPS.
Di dalam pedoman ini dijelaskan pula fungsi-fungsi didalam portal Bea Cukai Web
Services (BCWS) yang dapat diakses oleh pengelola TPS.
Pedoman Integrasi Aplikasi ini disusun untuk membantu system integrator dalam
mengembangkan aplikasi interface / konverter format yang diperlukan. Dengan mengacu
kepada buku pedoman ini, diharapkan system integrator dapat menyelesaikan aplikasi
interface dengan lebih cepat.

5
DASAR HUKUM

Yang menjadi dasar pengembangan Web Service TPS Online yaitu :

1. Berdasarkan peraturan Menteri Keuangan Nomor 23/PMK.04/2015 pasal 19 yang


berbunyi sebagai berikut :
(1) Dalam hal TPS berada dibawah pengawasan Kantor Pabean yang telah menerapkan
sistem komputer pelayanan TPS online secara mandatory, pengusaha TPS harus
memiliki sistem elektronik pengelolaan penimbunan barang di TPS dan menyediakan
media komunikasi data elektronik yang terhubung (on-line computer) dengan sistem
komputer pelayanan pada Kantor Pabean.
(2) Media komunikasi data elektronik sebagaimana dimaksud pada ayat (1) harus :
a. Secara real time menerima dan mengirim respon dan/atau data dari dan ke
sistem komputer pelayanan pada Kantor Pabean; dan
b. Terhubung dengan sistem komputer pelayanan pada Kantor Pabean selama 24
(dua puluh empat) jam setiap hari dan 7 (tujuh) hari dalam 1 (satu) minggu;
(3) Pengusaha TPS sebagaimana dimaksud pada ayat (1) dapat menerapkan sistem
pintu otomatis pada pintu masuk/keluar yang terintegrasi dengan sistem elektronik
pengelolaan penimbunan barang.

2. Peraturan Dirjen Bea dan Cukai Nomor PER-6/BC/2015 pasal 25 :


(1) Dalam hal TPS berada dibawah pengawasan Kantor Pabean yang telah menerapkan
Sistem computer Pelayanan TPS Online secara mandatory, Pengusaha TPS harus
memiliki sistem elektronik pengelolaan penimbunan barang di TPS dan menyediakan
media komunikasi data elektronik yang terhubung (on-line computer) dengan sistem
komputer pelayanan pada Kantor Pabean.
(2) Media komunikasi data elektronik sebagaimana dimaksud pada ayat (1) harus :
a) Secara realtime menerima dan mengirim respon dan/atau data dari dan ke
sistem komputer pelayanan pada Kantor Pabean; dan
b) Terhubung dengan sistem komputer pelayanan pada Kantor Pabean selama 24
(dua puluh empat) jam setiap hari dan 7 (tujuh) hari dalam 1 (satu) minggu.

3. Peraturan Dirjen Bea dan Cukai Nomor PER-6/BC/2015 pasal 16 :


(3) Pengusaha TPS Asal mengajukan permohonan PLP sebagaimana dimaksud pada
ayat (1) kepada Kepala Kantor Pabean u.p pejabat yang menangani administrasi
manifes dengan mencantumkan :
a. Alasan permohonan PLP sebagaimana dimaksud pada ayat (1);
b. Nama TPS Asal dan nama TPS Tujuan;
c. Keterangan atau data mengenai YOR atau SOR TPS Asal dan TPS Tujuan;
d. Nomor dan tanggal BC 1.1; dan
e. Nomor, ukuran, dan jumlah peti kemas atau jenis dan jumlah kemasan.
(6) Dalam hal Kantor Pabean telah menerapkan Sistem TPS Online, permohonan
sebagaimana dimaksud pada ayat (3) harus disampaikan dalam bentuk data
elektronik.

6
TPS ONLINE

A. Definisi
TPS Online adalah media atau sarana untuk melakukan pertukaran data secara
elektronik antara DJBC dengan TPS, dan juga untuk memantau pergerakan barang
yang ada didalam TPS. Sistem yang digunakan dalam pertukaran data adalah dengan
menggunakan teknologi web service.

Web Services adalah sebuah komponen layanan aplikasi yang dapat diakses melalui
protokol terbuka yang memanfaatkan Web melalui Simple Object Access Protocol
(SOAP) dengan bahasa Web Services Description Language (WSDL) dan teregistrasi
dalam Universal Discovery Description and Integration (UDDI). Web services
mendukung komunikasi antar aplikasi dan integrasi aplikasi dengan menggunakan XML
dan Web. XML (eXtensible Markup Language) adalah sebuah standar untuk
mendefinisikan data dalam format yang sederhana dan fleksibel.

Web service TPS Online merupakan suatu web service yang dishare yang bertujuan
untuk menjembatani penyamaan format informasi antara masukan/keluaran SAP Bea
dan Cukai dengan keluaran/masukan aplikasi in-house masin-masing TPS. Dalam hal ini
integrasi sistem perlu didukung oleh suatu aplikasi interface, sehingga transasksi
dokumen, pengiriman maupun penerimaan akan berlangsung transparan.

B. Tujuan Pengembangan
Web Service TPS Online mempunyai fungsi sebagai berikut:
1. Untuk melakukan pertukaran data antara TPS dan DJBC.
2. TPS dapat melihat respon dokumen yang dikeluarkan DJBC sebagai monitoring
arus barang
3. DJBC dapat memonitor pergerakan barang dan Container di dalam TPS,
diantaranya :
4. Daftar timbun, daftar bongkar,
5. Posisi lokasi container,
6. Proses pengeluaran container,
7. Proses pemasukan container,
8. Dokumen yang digunakan dalam rangka pemasukan dan pengeluaran container
ke/dari dalam TPS,
9. Mengetahui pergerakan dokumen dan pergerakan barang,
10. Mengetahui posisi barang yang telah lewat 30 hari

7
C. Cara Koneksi Web Service
Untuk dapat mengintegrasikan sistem yang ada di TPS dengan DJBC, maka sistem
yang ada di TPS harus mengakses Portal Bea Cukai Web Services, yang dapat diakses
di alamat https://tpsonline.beacukai.go.id/
Tampilan awal dari portal ini sebagai berikut :

Sedangkan untuk melihat fungsi apa saja yang disediakan untuk integarasi TPS dengan
Bea Cukai dapat diakses pada alamat berikut :
https://tpsonline.beacukai.go.id/tps/service.asmx.
Untuk Web Service Definition Language (WSDL) dari service ini dapat dilihat pada
alamat : https:// tpsonline.beacukai.go.id/tps/service.asmx?WSDL
Koneksi ke Web Service TPS menggunakan versi aman dari HTTP yaitu https, sehingga
untuk terkoneksi dengan alamat ini perlu meng-instal sertifikat yang diminta oleh portal
BCWS. Konfirmasi untuk meng-install sertifikat yang dibutuhkan ditampilkan pada
gambar berikut:

8
Pada window diatas dapat dilihat, ketika ingin mengakses portal BCWS perlu menginstal
sertificate, klik tombol Yes, maka setificate telah terinstal dan web service dapat dilihat.

D. Kebutuhan Sistem
Sistem minimum requirement yang dibutuhkan untuk mengakses TPS web service yaitu
Windows 98/2000/XP Prof/NT 4.0.
Hardware requirement untuk sistem operasi Windows adalah sebagai berikut :
 PC Pentium min 133 MHz, tetapi yang direkomendasikan adalah Pentium III dengan
CPU speed lebih besar dari 450 MHz,
 Space hardisk minimal 50 Mb Free (+ space untuk software),
 Memory minimum 128 Mb. Rekomendasi adalah lebih dari 256 Mb,
 Mouse,
 Monitor 17 inch dengan VGA card 256 warna pada resolusi 1024 x 768,
 CD-ROM drive 4X atau lebih,
 Printer.
 Aplikasi integrasi yang telah di bangun sendiri oleh TPS

9
DAFTAR WEB SERVICE

A. Service Untuk Mengganti Password

Nama Service : GantiPassword


Service ini berfungsi untuk melakukan konfirmasi penggantian password.
Parameter yang dikirimkan yaitu : username, password, password baru, konfirmasi
password baru.
Hasil/Kembalian dari service ini adalah :
1. User Name/Password salah
2. Perubahan password berhasil

B. Service Untuk Mengirim Data Uji Coba Coarri - Codeco

1. Uji coba kirim data Coarri-Codeco Container


Nama Service : CoCoCont_Tes
Service ini berfungsi untuk mengirim data Coarri (Data bongkar/timbun dan muat)
dan data Codeco (data pengeluaran atau pemasukan barang dari gate) yang berupa
container.
Parameter yang dikirimkan yaitu : username, password dan fstream merupakan
string XML.
Format dan skema XML lihat service CoarriCodeco_Container.

2. Uji coba kirim data Coarri-Codeco Kemasan


Nama Service : CoCoKms_Tes
Service ini berfungsi untuk mengirim data Coarri dan Codeco barang Impor dan
Ekspor yang berupa kemasan.
Parameter yang dikirimkan yaitu : username, password dan fstream merupakan
string XML.
Format dan skema XML lihat service CoarriCodeco_Kemasan.

10
C. Service Untuk Mengirim Data Coarri - Codeco

Service ini digunakan untuk melaporkan data barang impor yang di bongkar/timbun dan
pengeluarannya, serta laporan data barang ekspor yang masuk ke TPS dan data
muat/loading nya. Adapun service yang dapat digunakan adalah per jenis transaksi
barang, berikut services nya :

1. Jenis Transaksi Container


Nama Service : CoarriCodeco_Container
Service ini berfungsi untuk mengirim data Coarri (Data bongkar/timbun dan muat)
dan data Codeco (data pengeluaran atau pemasukan barang dari gate) yang berupa
container.
Bentuk skema XML nya menjadi :
<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT xmlns="cococont.xsd">
<COCOCONT>
<HEADER>
<KD_DOK></KD_DOK>
<KD_TPS></KD_TPS>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<CALL_SIGN></CALL_SIGN>
<TGL_TIBA></TGL_TIBA>
<KD_GUDANG></KD_GUDANG>
<REF_NUMBER></REF_NUMBER>
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
<NO_SEGEL></NO_SEGEL>
<JNS_CONT></JNS_CONT>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<NO_MASTER_BL_AWB></NO_MASTER_BL_AWB>
<TGL_MASTER_BL_AWB></TGL_MASTER_BL_AWB>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE></CONSIGNEE>
<BRUTO></BRUTO>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<KD_TIMBUN></KD_TIMBUN>
<KD_DOK_INOUT></KD_DOK_INOUT>
<NO_DOK_INOUT></NO_DOK_INOUT>
<TGL_DOK_INOUT></TGL_DOK_INOUT>
<WK_INOUT></WK_INOUT>
<KD_SAR_ANGKUT_INOUT></KD_SAR_ANGKUT_INOUT>
<NO_POL></NO_POL>
<FL_CONT_KOSONG></FL_CONT_KOSONG>
<ISO_CODE></ISO_CODE>
<PEL_MUAT></PEL_MUAT>
<PEL_TRANSIT></PEL_TRANSIT>
<PEL_BONGKAR></PEL_BONGKAR>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<KODE_KANTOR></KODE_KANTOR>
<NO_DAFTAR_PABEAN></NO_DAFTAR_PABEAN>
<TGL_DAFTAR_PABEAN ></TGL_DAFTAR_PABEAN>

11
<NO_SEGEL_BC></NO_SEGEL_BC>
<TGL_SEGEL_BC></TGL_SEGEL_BC>
<NO_IJIN_TPS></NO_IJIN_TPS>
<TGL_IJIN_TPS></TGL_IJIN_TPS>
</CONT>
</DETIL>
</COCOCONT>
</DOCUMENT>

Dari schema diatas dapat dijelaskan sebagai berikut :


Xml namenya yaitu xmlns="cococont.xsd", ini wajib dideklarasikan karena
merupakan nama schema, diperlukan pada saat melakukan validasi schema xml,
web service di DJBC akan mengecek apakah schemanya sama dengan file schema
cococont.xsd yang ada di service DJBC.
Keterangan dari Isi element sebagai berikut :
Panjang
Nama Element Keterangan
Karakter
KD_DOK 1 Element yang berisi kode dokumen. Kode
terlampir
KD_TPS 4 Element yang berisi data kode TPS, kode
TPS adalah kode yang didapatkan setelah
registrasi TPS Online ke Kantor Pusat
DJBC.
NM_ANGKUT 25 Element yang berisi nama sarana
pengangkut
NO_VOY_FLIGHT 20 Element yang berisi nomor pelayaran atau
penerbangan
CALL_SIGN 8 Element yang berisi kode unik dari sarana
pengangkut
TGL_TIBA 8 Element yang berisi data tanggal tiba
kapal, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
KD_GUDANG 10 Element yang berisi kode
gudang/lapangan dari TPS
REF_NUMBER 16 Element yang berisi data referensi number
sebagai primary key, ref number
merupakan nilai yang dibuat oleh system
di masing-masing TPS ketika mengirimkan
daftar bongkar ataupun daftar

12
pengeluaran.
Format : AAAAYYMMDDNNNNNN (AAAA
: Kode TPS, YY : tahun dua digit belakang,
MM : bulan dua digit, DD : tanggal, NNNN
: nomor referensi)

Element-element yang berada dibawah <DETIL> sebagai berikut :


Panjang
Nama Element Keterangan
Karakter
NO_CONT 11 Element yang berisi data nomor container,
format AAAANNNNNN (A = huruf, N
=angka). Wajib diisi bila melalui
laut(Terminal Container)
UK_CONT 2 Element yang berisi data ukuran container.
NO_SEGEL 20 Element yang berisi data nomor segel
pelayaran yang melekat di container.
JNS_CONT 1 Element yang berisi data Jenis Container
Load.
NO_BL_AWB 30 Element yang berisi data Nomor BL/AWB
TGL_BL_AWB 8 Element yang berisi data tanggal BL/AWB,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_MASTER_BL_AWB 30 Element yang berisi data nomor master
BL/AWB
TGL_MASTER_BL_AWB 8 Element yang berisi data tanggal master
BL/AWB penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
ID_CONSIGNEE 15 Element yang berisi data Identitas (NPWP)
Pemilik barang, tanpa format NPWP
CONSIGNEE 60 Element yang berisi data Nama Pemilik
barang
BRUTO 20 Element yang berisi data Bruto. Ditulis
tanpa format ribuan, hanya angka dan
decimalnya saja bila ada. Dengan
ketentuan 4 angka dibelakang tanda

13
decimal.
NO_BC11 6 Element yang berisi data nomor BC 1.1
(Manifest)
TGL_BC11 8 Element yang berisi data tanggal BC 1.1,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_POS_BC11 12 Element yang berisi data 4 digit nomor
Pos dan 8 digit sub pos BC1.1
KD_TIMBUN 10 Element yang berisi data kode posisi
container. Dengan ketentuan sebagai
berikut :
Coarri loading : posisi di kapal
Coarri bongkar : posisi di
lapangan/gudang
Codeco in : posisi di lapangan/gudang
Codeco out : tidak ada posisi lapangan
/gudang
KD_DOK_INOUT 1 Element yang berisi data kode dokumen
untuk pengeluaran / pemasukan barang.
Kode lihat lampiran
NO_DOK_INOUT 30 Element yang berisi data nomor dokumen
untuk pengeluaran / pemasukan barang.
TGL_DOK_INOUT 8 Element yang berisi data tanggal dokumen
untuk pengeluaran / pemasukan
barang,penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
WK_INOUT 16 Element yang berisi data Waktu dokumen
untuk pengeluaran/pemasukan barang.
Format penulisan yyyymmddHHMMSSSS
(y = tahun , m=bulan , d=tanggal, H=Jam,
M=menit, S=detik)
KD_SAR_ANGKUT_INOUT 5 Element yang berisi data Kode sarana
pengangkut dalam rangka
pengeluaran/pemasukan barang.
NO_POL 10 Element yang berisi data Nomor Polisi

14
Sarana Pengangkut dalam rangka
pengeluaran/pemasukkan barang
FL_CONT_KONSONG 1 Element yang berisi data Tanda (flag)
status container kosong, kode lihat
lampiran
ISO_CODE 30 Element yang berisi data ISO Container
PEL_MUAT 5 Element yang berisi data Pelabuhan Muat
PEL_TRANSIT 5 Element yang berisi data Pelabuhan
Transit
PEL_BONGKAR 5 Element yang berisi data Pelabuhan
Bongkar
GUDANG_TUJAN 4 Element yang berisi data Kode Gudang
Tujuan, wajib diisi jika transaksi OB/PLP
(Pindah Lapangan Penimbunan)
KODE_KANTOR 6 Element yang berisi kode kantor yang
menerbitkan dokumen pabean
NO_DAFTAR_PABEAN 6 Element yang berisi no daftar pabean.
TGL_DAFTAR_PABEAN 8 Element yang berisi tanggal daftar
pabean.
NO_SEGEL_BC 30 Element yang berisi nomor segel dari
DJBC
TGL_SEGEL_BC 8 Element yang berisi tanggal pemberian
segel DJBC
NO_IJIN_TPS 30 Element yang berisi nomor ijin
pengeluaran/pemuatan dari TPS, contoh
nomor SP2/KE.
TGL_IJIN_TPS 8 Element yang berisi tanggal pemberian ijin
pengeluaran/pemuatan dari TPS, contoh
tanggal SP2/KE.

Respon yang di keluarkan


Respon-respon yang diterima oleh TPS setelah pengiriman data sebagai berikut :
1. Respon “User Tidak Dikenal” : jika username dan password tidak sesuai dengan
data user pada DJBC.
2. Respon “Validasi XML anda tidak benar” : jika string XML yang dikirimkan tidak
sesuai dengan schema XML yang ada pada DJBC.

15
3. Respon “Proses Berhasil” : jika string XML yang dikirimkan benar secara schema
dan data dapat masuk ke dalam database DJBC.
4. Respon “Gagal Insert “ & Kode TPS & Kode Element & Ref_Number : jika string
XML yang dikirimkan tidak dapat masuk ke dalam database DJBC.

2. Jenis Transaksi Kemasan


Nama Service : CoarriCodeco_Kemasan.
Service ini berfungsi untuk meng-unggah data Coarri, Codeco, Loading, Gate In
Impor, dan Gate In Ekspor berdasarkan kemasan.
Parameter yang dikirimkan yaitu : username, password dan fstream merupakan
string XML
Bentuk skema XML nya menjadi :
<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT xmlns="cocokms.xsd">
<COCOKMS>
<HEADER>
<KD_DOK></KD_DOK>
<KD_TPS></KD_TPS>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<CALL_SIGN></CALL_SIGN>
<TGL_TIBA></TGL_TIBA>
<KD_GUDANG></KD_GUDANG>
<REF_NUMBER></REF_NUMBER>
</HEADER>
<DETIL>
<KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<NO_MASTER_BL_AWB></NO_MASTER_BL_AWB>
<TGL_MASTER_BL_AWB></TGL_MASTER_BL_AWB>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE></CONSIGNEE>
<BRUTO></BRUTO>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<CONT_ASAL></CONT_ASAL>
<SERI_KEMAS></SERI_KEMAS>
<KD_KEMAS></KD_KEMAS>
<JML_KEMAS></JML_KEMAS>
<KD_TIMBUN></KD_TIMBUN>
<KD_DOK_INOUT></KD_DOK_INOUT>
<NO_DOK_INOUT></NO_DOK_INOUT>
<TGL_DOK_INOUT></TGL_DOK_INOUT>
<WK_INOUT></WK_INOUT>
<KD_SAR_ANGKUT_INOUT></KD_SAR_ANGKUT_INOUT>
<NO_POL></NO_POL>
<PEL_MUAT></PEL_MUAT>
<PEL_TRANSIT></PEL_TRANSIT>
<PEL_BONGKAR></PEL_BONGKAR>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<KODE_KANTOR></KODE_KANTOR>
<NO_DAFTAR_PABEAN></NO_DAFTAR_PABEAN>
<TGL_DAFTAR_PABEAN ></TGL_DAFTAR_PABEAN>
<NO_SEGEL_BC></NO_SEGEL_BC>

16
<TGL_SEGEL_BC></TGL_SEGEL_BC>
<NO_IJIN_TPS></NO_IJIN_TPS>
<TGL_IJIN_TPS></TGL_IJIN_TPS>
</KMS>
</DETIL>
</COCOKMS>
</DOCUMENT>
Dari String XML diatas dapat dijelaskan sebagai berikut :
Xml namenya yaitu xmlns="cocokms.xsd",ini wajib dideklarasikan karena merupakan
nama schema, diperlukan pada saat melakukan validasi schema xml, web service di
DJBC akan mengecek apakah schemanya sama dengan file schema cocokms.xsd
yang ada di service DJBC.
Keterangan dari Isi element sebagai berikut :
Panjang
Nama Element Keterangan
Karakter
KD_DOK 1 Element yang berisi kode dokumen. Kode
lihat lampiran
KD_TPS 4 Element yang berisi data kode TPS, kode
TPS adalah kode yang didapatkan setelah
registrasi TPS Online ke Kantor Pusat
DJBC.
NM_ANGKUT 25 Element yang berisi nama sarana
pengangkut
NO_VOY_FLIGHT 20 Element yang berisi nomor pelayaran atau
penerbangan
CALL_SIGN 8 Element yang berisi kode unik dari sarana
pengangkut
TGL_TIBA 8 Element yang berisi data tanggal tiba
kapal, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
KD_GUDANG 4 Element yang berisi kode
gudang/lapangan dari TPS
REF_NUMBER 16 Element yang berisi data referensi number
sebagai primary key, ref number
merupakan nilai yang dibuat oleh system
di masing-masing TPS ketika mengirimkan
daftar bongkar ataupun daftar
pengeluaran.

17
Format : AAAAYYMMDDNNNNNN (AAAA
: Kode TPS, YY : tahun dua digit
belakang, MM : bulan dua digit, DD :
tanggal, NNNNNN : nomor referensi)

Element-element yang berada dibawah <DETIL> sebagai berikut :


Panjang
Nama Element Keterangan
Karakter
NO_BL_AWB 30 Element yang berisi data Nomor BL/AWB
TGL_BL_AWB 8 Element yang berisi data tanggal BL/AWB,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_MASTER_BL_AWB 30 Element yang berisi data nomor master
BL/AWB
TGL_MASTER_BL_AWB 8 Element yang berisi data tanggal master
BL/AWB, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
ID_CONSIGNEE 15 Element yang berisi data Identitas/NPWP
Pemilik barang, diisi tanpa format
CONSIGNEE 60 yang berisi data Nama Pemilik
BRUTO 20 Element yang berisi data Bruto. Ditulis
tanpa format ribuan, hanya angkanya dan
decimalnya saja bila ada. Dengan
ketentuan 4 angka dibelakang tanda
decimal.
NO_BC11 6 Element yang berisi data nomor BC 1.1
(Manifest)
TGL_BC11 8 Element yang berisi data tanggal BC 1.1,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_POS_BC11 12 Element yang berisi data 4 digit nomor
Pos dan 8 digit sub pos BC1.1
CONT_ASAL 20 Element yang berisi data Nomor Asal
Container (jika kemasan hasil dari
Stripping). Sifat Mandatory (waib diisi –

18
jika kemasan hasil dari Stripping). Format :
AAAANNNNNNN (A = huruf, N=angka)
SERI_KEMAS 10 Element yang berisi data seri kemasan.
Sifat Mandatory (waib diisi – bila Non
Container dan Ex. Stripping)
KODE_KEMAS Element yang berisi data kode jenis
kemasan. Mandatory (waib diisi – bila
Non Container dan Ex. Stripping)
JML_KEMAS 8 Element yang berisi data jumlah kemasan
KD_TIMBUN 10 Element yang berisi data kode posisi
container. Dengan ketentuan sebagai
berikut :
Coarri loading : posisi di kapal
Coarri bongkar : posisi di
lapangan/gudang
Codeco in : posisi di lapangan/gudang
Codeco out : tidak ada posisi lapangan
KD_DOK_INOUT 2 Element yang berisi data kode dokumen
untuk pengeluaran / pemasukan barang.
Kode lihat lampiran
NO_DOK_INOUT 30 Element yang berisi data nomor dokumen
untuk pengeluaran / pemasukan barang.
TGL_DOK_INOUT 8 Element yang berisi data tanggal dokumen
untuk pengeluaran / pemasukan barang,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
WK_INOUT 16 Element yang berisi data Waktu dokumen
untuk pengeluaran/pemasukan barang.
Format penulisan yyyymmddHHMMSSSS
(y = tahun , m=bulan , d=tanggal, H=Jam,
M=menit, S=detik)
KD_SAR_ANGKUT_INOUT 1 Element yang berisi data Kode sarana
pengangkut dalam rangka
pengeluaran/pemasukan barang.
NO_POL 10 Element yang berisi data Nomor Polisi
Sarana Pengangkut dalam rangka

19
pengeluaran/pemasukkan barang
ISO_CODE 30 Element yang berisi data ISO Container
PEL_MUAT 5 Element yang berisi data Pelabuhan Muat
PEL_TRANSIT 5 Element yang berisi data Pelabuhan
Transit
PEL_BONGKAR 5 Element yang berisi data Pelabuhan
Bongkar
GUDANG_TUJAN 4 Element yang berisi data Kode Gudang
Tujuan, wajib diisi jika transaksi OB/PLP
(Pindah Lapangan Penimbunan)
KODE_KANTOR 6 Element yang berisi kode kantor yang
menerbitkan dokumen pabean
NO_DAFTAR_PABEAN 6 Element yang berisi no daftar pabean.
TGL_DAFTAR_PABEAN 8 Element yang berisi tanggal daftar
pabean.
NO_SEGEL_BC 30 Element yang berisi nomor segel dari
DJBC
TGL_SEGEL_BC 8 Element yang berisi tanggal pemberian
segel DJBC
NO_IJIN_TPS 30 Element yang berisi nomor ijin
pengeluaran/pemuatan dari TPS, contoh
nomor SP2/KE.
TGL_IJIN_TPS 8 Element yang berisi tanggal pemberian ijin
pengeluaran/pemuatan dari TPS, contoh
tanggal SP2/KE.

Respon yang Di Keluarkan


Respon-respon yang diterima oleh TPS setelah pengiriman data Coarri-Codeco
adalah sebagai berikut :
1. Respon “User Tidak Dikenal” : jika username dan password tidak sesuai dengan
data user pada DJBC.
2. Respon “Validasi XML anda tidak benar” : jika string XML yang dikirimkan tidak
sesuai schema XML yang diberitahukan.
3. Respon “Proses Berhasil” : jika string XML yang dikirimkan benar secara schema
dan data dapat masuk ke dalam database DJBC.

20
4. Respon “Gagal Insert “ & Kode TPS & Kode Element & Ref_Number : jika string
XML yang dikirimkan tidak dapat masuk ke dalam database DJBC.

3. Jenis Transaksi Tangki penimbunan


Nama service : CoCoTangki
Service ini berfungsi untuk melaporkan data Coarri dan Codeco dari barang curah
yang di timbun dalam tangki penimbunan/silo.
Parameter yang dikirimkan yaitu : username, password dan fstream merupakan
string XML yang memiliki schema seperti keterangan dibawah ini, dan hasil keluaran
dari service ini yaitu dalam bentuk respon.
String xml :
<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT xmlns="cocotangki.xsd">
<COCOTANGKI>
<HEADER>
<KD_DOK></KD_DOK>
<KD_TPS></KD_TPS>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<CALL_SIGN></CALL_SIGN>
<TGL_TIBA></TGL_TIBA>
<KD_GUDANG></KD_GUDANG>
<REF_NUMBER></REF_NUMBER>
</HEADER>
<DETIL>
<TANGKI>
<SERI_OUT></SERI_OUT>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE></CONSIGNEE>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<NO_TANGKI></NO_TANGKI>
<JML_SATUAN></JML_SATUAN>
<JNS_SATUAN></JNS_SATUAN>
<KD_DOK_INOUT></KD_DOK_INOUT>
<NO_DOK_INOUT></NO_DOK_INOUT>
<TGL_DOK_INOUT></TGL_DOK_INOUT>
<WK_INOUT></WK_INOUT>
<KD_SAR_ANGKUT_INOUT></KD_SAR_ANGKUT_INOUT>
<NO_POL></NO_POL>
<PEL_MUAT></PEL_MUAT>
<PEL_TRANSIT></PEL_TRANSIT>
<PEL_BONGKAR></PEL_BONGKAR>
</TANGKI>
</DETIL>
</COCOTANGKI>
</DOCUMENT>

Berikut keterangan dari bentuk struktur xml diatas :


Nama Element Panjang Keterangan
Karakter

21
KD_DOK 1 Element yang berisi kode dokumen. Kode
lihat lampiran
KD_TPS 4 Element yang berisi data kode TPS, kode
TPS adalah kode yang didapatkan setelah
registrasi TPS Online ke Kantor Pusat
DJBC.
NM_ANGKUT 25 Element yang berisi nama sarana
pengangkut
NO_VOY_FLIGHT 20 Element yang berisi nomor pelayaran atau
penerbangan
CALL_SIGN 8 Element yang berisi kode unik dari sarana
pengangkut
TGL_TIBA 8 Element yang berisi data tanggal tiba
kapal, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
KD_GUDANG 4 Element yang berisi kode
gudang/lapangan dari TPS
REF_NUMBER 16 Element yang berisi data referensi number
sebagai primary key, ref number
merupakan nilai yang dibuat oleh system
di masing-masing TPS ketika mengirimkan
daftar bongkar ataupun daftar
pengeluaran.
Format : AAAAYYMMDDNNNNNN (AAAA
: Kode TPS, YY : tahun dua digit
belakang, MM : bulan dua digit, DD :
tanggal, NNNNNN : nomor referensi)
DETIL
TANGKI
SERI_OUT 11 Urutan pengeluaran barang curah, diisi
per sekali pengeluaran
NO_BL_AWB 30 Element yang berisi data Nomor BL/AWB
TGL_BL_AWB 8 Element yang berisi data tanggal BL/AWB,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)

22
ID_CONSIGNEE 15 Element yang berisi data Identitas/NPWP
Pemilik barang, diisi tanpa format
CONSIGNEE 60 yang berisi data Nama Pemilik
NO_BC11 6 Element yang berisi data nomor BC 1.1
(Manifest)
TGL_BC11 8 Element yang berisi data tanggal BC 1.1,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_POS_BC11 12 Element yang berisi data 4 digit nomor
Pos
dan 8 digit sub pos BC11
NO_TANGKI 20 Nomor tangki penimbunan
JML_SATUAN 8 Element yang berisi data jumlah satuan
JNS_SATUAN 2 Element yang berisi data jenis satuan
KD_DOK_INOUT 2 Element yang berisi data kode dokumen
untuk pengeluaran / pemasukan barang.
Kode lihat lampiran
NO_DOK_INOUT 30 Element yang berisi data nomor dokumen
untuk pengeluaran / pemasukan barang.
TGL_DOK_INOUT 8 Element yang berisi data tanggal dokumen
untuk pengeluaran / pemasukan barang,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
WK_INOUT 16 Element yang berisi data Waktu dokumen
untuk pengeluaran/pemasukan barang.
Format penulisan yyyymmddHHMMSSSS
(y = tahun , m=bulan , d=tanggal, H=Jam,
M=menit, S=detik)
KD_SAR_ANGKUT_INOUT 1 Element yang berisi data Kode sarana
pengangkut dalam rangka
pengeluaran/pemasukan barang.
NO_POL 10 Element yang berisi data Nomor Polisi
Sarana Pengangkut dalam rangka
pengeluaran/pemasukkan barang
PEL_MUAT 5 Element yang berisi data Pelabuhan Muat
PEL_TRANSIT 5 Element yang berisi data Pelabuhan

23
Transit
PEL_BONGKAR 5 Element yang berisi data Pelabuhan
Bongkar

Respon yang Di Keluarkan


Respon-respon yang diterima oleh pihak TPS setelah pengiriman data sebagai
berikut :
1. Respon “User Tidak Dikenal” : jika username dan password tidak sesuai dengan
data user pada DJBC.
2. Respon “Validasi XML anda tidak benar” : jika string XML yang dikirimkan tidak
sesuai schema XML yang diberitahukan.
3. Respon “Proses Berhasil” : jika string XML yang dikirimkan benar secara schema
dan data dapat masuk ke dalam database DJBC.
4. Respon “Gagal Insert “ & Kode TPS & Kode Element & Ref_Number : jika string
XML yang dikirimkan tidak dapat masuk ke dalam database DJBC.

4. Jenis Transaksi Car Terminal


Service ini berfungsi untuk mengirim data Coarri dan Codeco dari barang yang
berupa mobil atau sejenisnya yang ditimbun di TPS.
Nama service : CoCoCarTer
Parameter yang dikirimkan yaitu : username, password dan fstream merupakan
string XML yang memiliki schema seperti keterangan dibawah ini, dan hasil keluaran
dari service ini yaitu dalam bentuk respon.
String xml :
<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT xmlns="cococar.xsd">
<COCOCAR>
<HEADER>
<KD_DOK></KD_DOK>
<KD_TPS></KD_TPS>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<CALL_SIGN></CALL_SIGN>
<TGL_TIBA></TGL_TIBA>
<KD_GUDANG></KD_GUDANG>
<REF_NUMBER></REF_NUMBER>
<DETIL>
<CAR>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE></CONSIGNEE>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<VIN_NUMBER></VIN_NUMBER>

24
<NO_RANGKA></NO_RANGKA>
<NO_MESIN></NO_MESIN>
<TIPE></TIPE>
<WARNA></WARNA>
<MERK></MERK>
<BRUTO></BRUTO>
<KD_TIMBUN></KD_TIMBUN>
<KD_DOK_INOUT></KD_DOK_INOUT>
<NO_DOK_INOUT></NO_DOK_INOUT>
<TGL_DOK_INOUT></TGL_DOK_INOUT>
<WK_INOUT></WK_INOUT>
<KD_SAR_ANGKUT_INOUT></KD_SAR_ANGKUT_INOUT>
<NO_POL></NO_POL>
<PEL_MUAT></PEL_MUAT>
<PEL_TRANSIT></PEL_TRANSIT>
<PEL_BONGKAR></PEL_BONGKAR>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
</CAR>
</DETIL>
</COCOCAR>
</DOCUMENT>

Berikut keterangan dari bentuk struktur xml diatas :


Nama Element Panjang Keterangan
Karakter
KD_DOK 1 Element yang berisi kode dokumen. Kode
lihat lampiran
KD_TPS 4 Element yang berisi data kode TPS, kode
TPS adalah kode yang didapatkan setelah
registrasi TPS Online ke Kantor Pusat
DJBC.
NM_ANGKUT 25 Element yang berisi nama sarana
pengangkut
NO_VOY_FLIGHT 20 Element yang berisi nomor pelayaran atau
penerbangan
CALL_SIGN 8 Element yang berisi kode unik dari sarana
pengangkut
TGL_TIBA 8 Element yang berisi data tanggal tiba
kapal, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
KD_GUDANG 4 Element yang berisi kode
gudang/lapangan dari TPS
REF_NUMBER 16 Element yang berisi data referensi number
sebagai primary key, ref number

25
merupakan nilai yang dibuat oleh system
di masing-masing TPS ketika
mengirimkan daftar bongkar ataupun
daftar pengeluaran.
Format : AAAAYYMMDDNNNNNN (AAAA
: Kode TPS, YY : tahun dua digit
belakang, MM : bulan dua digit, DD :
tanggal, NNNNNN : nomor referensi)
DETIL
CAR
NO_BL_AWB 30 Element yang berisi data Nomor BL/AWB
TGL_BL_AWB 8 Element yang berisi data tanggal BL/AWB,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
ID_CONSIGNEE 15 Element yang berisi data Identitas/NPWP
Pemilik barang, diisi tanpa format
CONSIGNEE 60 yang berisi data Nama Pemilik
NO_BC11 6 Element yang berisi data nomor BC 1.1
(Manifest)
TGL_BC11 8 Element yang berisi data tanggal BC 1.1,
penulisan dengan format “yyyymmdd”
(yyyy: tahun, mm : bulan, dd : tanggal)
NO_POS_BC11 12 Element yang berisi data 4 digit nomor
Pos
dan 8 digit sub pos BC11
VIN_NUMBER 20 Vehicle Identifier Number
NO_RANGKA 20 Nomor Rangka
NO_MESIN 20 Nomor Mesin
TIPE 20 Tipe Mobil
WARNA 20 Warna Dasar Mobil
MERK 20 Merk Mobil
BRUTO 20 Element yang berisi data Bruto. Ditulis
tanpa format ribuan, hanya angkanya dan
decimalnya saja bila ada. Dengan
ketentuan 4 angka dibelakang tanda
decimal.

26
KD_TIMBUN 10 Kode posisi mobil di lapangan/gudang
penimbunan
KD_DOK_INOUT 2 Element yang berisi data kode dokumen
untuk pengeluaran / pemasukan barang.
Kode lihat lampiran
NO_DOK_INOUT 30 Element yang berisi data nomor dokumen
untuk pengeluaran / pemasukan barang.
TGL_DOK_INOUT 8 Element yang berisi data tanggal
dokumen untuk pengeluaran / pemasukan
barang, penulisan dengan format
“yyyymmdd” (yyyy: tahun, mm : bulan, dd :
tanggal)
WK_INOUT 16 Element yang berisi data Waktu dokumen
untuk pengeluaran/pemasukan barang.
Format penulisan yyyymmddHHMMSSSS
(y = tahun , m=bulan , d=tanggal, H=Jam,
M=menit, S=detik)
KD_SAR_ANGKUT_INOUT 1 Element yang berisi data Kode sarana
pengangkut dalam rangka
pengeluaran/pemasukan barang.
NO_POL 10 Element yang berisi data Nomor Polisi
Sarana Pengangkut dalam rangka
pengeluaran/pemasukkan barang
PEL_MUAT 5 Element yang berisi data Pelabuhan Muat
PEL_TRANSIT 5 Element yang berisi data Pelabuhan
Transit
PEL_BONGKAR 5 Element yang berisi data Pelabuhan
Bongkar
GUDANG_TUJUAN 4 Gudang Tujuan (Jika di PLP/OB)

27
D. Service Untuk Cek Data

1. Cek Data Reject


Nama Service : GetRejectData
Service ini berfungsi untuk mengetahui data reject hasil validasi dari sistem TPS
Online DJBC. Hasil keluaran dari service ini yaitu file string dengan format XML, data
yang ditampilkan adalah :
<?xml version=""1.0""?>
<!--BC-Doc.Reject-->
<DOCUMENT>
<REJECT>
<REF_NUMBER></REF_NUMBER>
<NO_CONT></NO_CONT>
<KD_REJECT></KD_REJECT>
<TGL_REJECT></TGL_REJECT>
</REJECT>
</DOCUMENT>

* Kode Reject lihat lampiran E

2. Service Cek Data Gagal Terkirim


Nama Service : CekDataGagalKirim
Service ini berfungsi untuk mengetahui data Coarri-codeco yang gagal terkirim ke
DJBC. Hasil keluaran dari service ini yaitu file string dengan format XML, data yang
ditampilkan adalah jumlah dan REF_NUMBER yang tidak berhasil masuk ke dalam
database DJBC. Parameter yang digunakan yaitu :
 Username : format free text dengan lebar maksimum 50 character.
 Password : format free text dengan lebar maksimum 50 character.
 Tanggal Awal : teks dengan format “dd-mm-yyyy”
 Tanggal Akhir : teks dengan format “dd-mm-yyyy”
Contoh XML yang dihasilkan
<?xml version="1.0" encoding="utf-8" ?>
<string xmlns="http://services.beacukai.go.id/">
<RESPON>
<JUMLAH>75</JUMLAH>
<REF_NO>
<RN>KOJA0809231002</RN>
<RN>KOJA0809231003</RN>
<RN>KOJA0809231004</RN>
</REF_NO>
</RESPON>
</string>
Dari schema diatas dapat dijelaskan sebagai berikut :
 <JUMLAH> : jumlah data yang tidak berhasil masuk dan valid.
 <RN> : nilai REF NUMBER, <RN> ini akan berulang sebanyak jumlah yang telah
dideklarasikan.

28
3. Service Cek Data Berhasil Terkirim
Nama Service : CekDataTerkirim
Service ini berfungsi untuk mengetahui, data Coarri dan codeco yang telah berhasil
terkirim ke aplikasi TPS Online. Hasil keluaran dari service ini yaitu file string dengan
format XML, data yang ditampilkan adalah jumlah dan REF_NUMBER yang berhasil
masuk ke dalam database DJBC. Parameter yang digunakan yaitu :
 Username : format free text dengan lebar maksimum 50 character
 Password : format free text dengan lebar maksimum 50 character
 Tanggal Awal : format “dd-mm-yyyy”
 Tanggal Akhir : format “dd-mm-yyyy”
Contoh XML yang dihasilkan :
<?xml version="1.0" encoding="utf-8" ?>
<string xmlns="http://services.beacukai.go.id/">
<RESPON>
<JUMLAH>11</JUMLAH>
<REF_NO>
<RN>MTI00801119102</RN>
<RN>MTI00801119103</RN>
<RN>MTI00801119104</RN>
<RN>MTI00801119105</RN>
<RN>MTI00801119106</RN>
<RN>MTI00801119107</RN>
<RN>MTI00801119108</RN>
<RN>MTI00801119109</RN>
<RN>MTI00801119110</RN>
<RN>MTI00801119111</RN>
<RN>MTI00801119101</RN>
</REF_NO>
</RESPON>
</string>

Dari schema diatas dapat dijelaskan sebagai berikut :


 <JUMLAH> : jumlah data yang berhasil masuk dan valid.
 <RN> : nilai REF NUMBER, <RN> ini akan berulang sebanyak jumlah yang telah
dideklarasikan.

4. Service Cek Data SPPB


Nama Service : CekDataSPPB
Service ini berfungsi untuk mengecek jumlah data SPPB yang telah diunduh oleh
TPS.
Contoh XML yang dihasilkan :
a) Respon tidak ada data.
<RESPON>Tidak ada data dalam rentang tanggal tersebut</RESPON>
b) Respon ada data SPPB.
<RESPON>
<JUMLAH>61</JUMLAH>
<SPPB_NO>
<DT>261726/KPU.01/2014</DT>

29
<DT>261824/KPU.01/2014</DT>
<DT>262386/KPU.01/2014</DT>
<DT>262362/KPU.01/2014</DT>
<DT>261294/KPU.01/2014</DT>
<DT>262484/KPU.01/2014</DT>
<DT>263087/KPU.01/2014</DT>
<DT>263018/KPU.01/2014</DT>
</SPPB_NO>
</RESPON>

E. Service Terkait Pindah Lokasi Penimbunan (PLP)


Sesuai dengan Peraturan Dirjen Bea dan Cukai Nomor PER-6/BC/2015 pasal 16
ayat (3) dan ayat (6) yang bisa diartikan bahwa "dalam hal Kantor Pabean telah
menerapkan Sistem TPS Online, maka untuk permohonan PLP harus disampaikan
dalam bentuk data elektronik".
Dari dasar hukum diatas maka setiap pengajuan permohonan ataupun pembatalan
PLP harus disampaikan secara data elektronik. Berikut adalah services yang dapat
digunakan untuk pertukaran data PLP Online :

1. Service Untuk Mengirimkan Data Permohonan PLP


 Fungsi : untuk mengirimkan data permohonan PLP Peti Kemas dan Kemasan
oleh pengusaha TPS.
 Nama Service : uploadMohonPLP
 Parameter : Username, password, String XML.
 Struktur Schema XML :
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns="loadplp.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="loadplp.xsd" elementFormDefault ="qualified
">
<xs:element msdata:IsDataSet="true" msdata:Locale="en-US" name="DOCUMENT">
<xs:complexType>
<xs:choice minOccurs="1" maxOccurs="1">
<xs:element name="LOADPLP">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="HEADER">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" name="KD_KANTOR" type="xs:string" />
<xs:element minOccurs="1" name="TIPE_DATA" type="xs:string" />
<xs:element minOccurs="1" name="KD_TPS_ASAL" type="xs:string" />
<xs:element minOccurs="1" name="REF_NUMBER" type="xs:string" />
<xs:element minOccurs="1" name="NO_SURAT" type="xs:string" />
<xs:element minOccurs="1" name="TGL_SURAT" type="xs:string" />
<xs:element minOccurs="1" name="GUDANG_ASAL" type="xs:string" />
<xs:element minOccurs="1" name="KD_TPS_TUJUAN" type="xs:string" />
<xs:element minOccurs="1" name="GUDANG_TUJUAN" type="xs:string" />
<xs:element minOccurs="1" name="KD_ALASAN_PLP" type="xs:string" />
<xs:element minOccurs="1" name="YOR_ASAL" type="xs:string" />
<xs:element minOccurs="1" name="YOR_TUJUAN" type="xs:string" />
<xs:element minOccurs="1" name="CALL_SIGN" type="xs:string" />
<xs:element minOccurs="1" name="NM_ANGKUT" type="xs:string" />
<xs:element minOccurs="1" name="NO_VOY_FLIGHT" type="xs:string" />
<xs:element minOccurs="1" name="TGL_TIBA" type="xs:string" />
<xs:element minOccurs="1" name="NO_BC11" type="xs:string" />
<xs:element minOccurs="1" name="TGL_BC11" type="xs:string" />
<xs:element minOccurs="1" name="NM_PEMOHON" type="xs:string" />

30
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="unbounded" name="DETIL">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="unbounded" name="CONT">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="NO_CONT" type="xs:string" />
<xs:element minOccurs="0" name="UK_CONT" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="unbounded" name="KMS">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="JNS_KMS" type="xs:string" />
<xs:element minOccurs="0" name="JML_KMS" type="xs:string" />
<xs:element minOccurs="0" name="NO_BL_AWB" type="xs:string" />
<xs:element minOccurs="0" name="TGL_BL_AWB" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>

* Penjelasan Skema PLP lihat lampiran B

Contoh Format :

1. Contoh Format String Permohonan PLP untuk Peti Kemas, sebagai berikut :

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT xmlns="loadplp.xsd">
<LOADPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<TIPE_DATA><TIPE_DATA>
<KD_TPS_ASAL></KD_TPS_ASAL >
<REF_NUMBER></REF_NUMBER>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>
<GUDANG_ASAL></GUDANG_ASAL>
<KD_TPS_TUJUAN></KD_TPS_TUJUAN>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<KD_ALASAN_PLP></KD_ALASAN_PLP>
<YOR_ASAL></YOR_ASAL>
<YOR_TUJUAN></YOR_TUJUAN>
<CALL_SIGN></CALL_SIGN>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<TGL_TIBA></TGL_TIBA>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NM_PEMOHON></NM_PEMOHON>
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>

31
<UK_CONT></UK_CONT>
</CONT>
</DETIL>
</LOADPLP>
</DOCUMENT>

2. Contoh Format String Permohonan PLP untuk Kemasan, sebagai berikut :

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT xmlns="loadplp.xsd">
<LOADPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<TIPE_DATA></TIPE_DATA>
<KD_TPS_ASAL></KD_TPS_ASAL >
<REF_NUMBER></REF_NUMBER>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>
<GUDANG_ASAL></GUDANG_ASAL>
<KD_TPS_TUJUAN></KD_TPS_TUJUAN>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<KD_ALASAN_PLP></KD_ALASAN_PLP>
<YOR_ASAL></YOR_ASAL>
<YOR_TUJUAN></YOR_TUJUAN>
<CALL_SIGN></CALL_SIGN>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<TGL_TIBA></TGL_TIBA>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NM_PEMOHON></NM_PEMOHON>
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
</KMS>
</DETIL>
</LOADPLP>
</DOCUMENT>

 Respon yang diterima, sebagai berikut :


<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPON>
<KD_RES></KD_RES>
</RESPON>
</DOCUMENT>

Keterangan :
- REF_NUMBER : Referensi Number yang diajukan
- KD_RES : berisi kode respon. keterangan uraian dari kode respon tersebut
ada pada lampiran.

32
2. Service Untuk Mengunduh Respon Persetujuan Permohonan PLP Oleh
Pengusaha TPS Asal
 Fungsi : untuk mengunduh data Respon persetujuan permohonan PLP Peti
Kemas dan Kemasan oleh pengusaha TPS Asal yang mengajukan permohonan
PLP.
 Nama Service : GetResponPLP
 Parameter : Username, password, kode ASP.
 Struktur String XML :
a. String XML Respon Persetujuan PLP untuk Peti Kemas
<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPONPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<REF_NUMBER></REF_NUMBER>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
< ALASAN_TOLAK ></ALASAN_TOLAK>
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
<FL_SETUJU></FL_SETUJU>
<JNS_CONT></JNS_CONT>
</CONT>
</DETIL>
</RESPONPLP>
</DOCUMENT>

b. String XML Respon Persetujuan PLP untuk Kemasan


<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPONPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<REF_NUMBER></REF_NUMBER>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
< ALASAN_TOLAK ></ALASAN_TOLAK>
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<FL_SETUJU></FL_SETUJU>
</KMS>
</DETIL>
</RESPONPLP>
</DOCUMENT>

33
3. Service Untuk Mengunduh Respon Persetujuan PLP Oleh Pengusaha
TPS Tujuan
 Fungsi : untuk mengunduh data Respon persetujuan permohonan PLP Peti
Kemas dan Kemasan oleh pengusaha TPS Tujuan.
 Nama Service : GetResponPLP_Tujuan
 Parameter : Username, password, kode ASP.
 Struktur String XML :
a. String XML Respon Persetujuan PLP untuk Peti Kemas

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT>
<RESPONPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<KD_TPS_ASAL></KD_TPS_ASAL>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<CALL_SIGN></CALL_SIGN>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<TGL_TIBA></TGL_TIBA>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
<JNS_CONT></JNS_CONT>
<NO_POS_BC11></NO_POS_BC11>
<CONSIGNEE></CONSIGNEE>

</CONT>
</DETIL>
</RESPONPLP>
</DOCUMENT>

b. String XML Respon Persetujuan PLP untuk Kemasan

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT>
<RESPONPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<KD_TPS_ASAL></KD_TPS_ASAL>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<CALL_SIGN></CALL_SIGN>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<TGL_TIBA></TGL_TIBA>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>

34
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
</KMS>
</DETIL>
</RESPONPLP>
</DOCUMENT>

4. Service untuk mendapatkan detail dari PLP


 Fungsi : untuk mendapatkan detail dari data PLP
 Nama Service : GetDataOB
 Parameter : Username, password, Kode ASP
 Struktur String XML :

<!--BC-Doc.OB-->
<DOCUMENT>
<OB>
<REF_NUMBER></REF_NUMBER>
<NO_SURAT_PLP></NO_SURAT_PLP>
<TGL_SURAT_PLP></TGL_SURAT_PLP>
<KODE_KANTOR></KODE_KANTOR>
<KD_DOK></KD_DOK>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<KD_TPS_ASAL> </KD_TPS_ASAL>
<GUDANG_TUJUAN></GUDANG_TUJUAN>
<NM_ANGKUT> </NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<CALL_SIGN></CALL_SIGN>
<TGL_TIBA></TGL_TIBA>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE></CONSIGNEE>
<NO_CONT> </NO_CONT>
<UK_CONT></UK_CONT>
<JNS_CONT></JNS_CONT>
<NO_SEGEL></NO_SEGEL>
<BRUTO></BRUTO>
<PEL_MUAT></PEL_MUAT>
<PEL_TRANSIT></PEL_TRANSIT>
<PEL_BONGKAR></PEL_BONGKAR>
</OB>
</DOCUMENT>

5. Service untuk Mengirimkan Data Pembatalan PLP


 Fungsi : untuk mengirimkan data pembatalan PLP Peti Kemas dan Kemasan
oleh pengusaha TPS Asal.
 Nama Service : uploadBatalPLP
 Parameter : Username, password, String XML.
 Struktur Schema XML :

35
<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" xmlns=" loadbatalplp.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="loadbatalplp.xsd" elementFormDefault
="qualified ">
<xs:element msdata:IsDataSet="true" msdata:Locale="en-US" name="DOCUMENT">
<xs:complexType>
<xs:choice minOccurs="1" maxOccurs="1">
<xs:element name="BATALPLP">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" name="HEADER">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" name="KD_KANTOR" type="xs:string" />
<xs:element minOccurs="1" name="TIPE_DATA" type="xs:string" />
<xs:element minOccurs="1" name="KD_TPS" type="xs:string" />
<xs:element minOccurs="1" name="REF_NUMBER" type="xs:string" />
<xs:element minOccurs="1" name="NO_SURAT" type="xs:string" />
<xs:element minOccurs="1" name="TGL_SURAT" type="xs:string" />
<xs:element minOccurs="1" name="NO_PLP" type="xs:string" />
<xs:element minOccurs="1" name="TGL_PLP" type="xs:string" />
<xs:element minOccurs="1" name="ALASAN" type="xs:string" />
<xs:element minOccurs="1" name="NO_BC11" type="xs:string" />
<xs:element minOccurs="1" name="TGL_BC11" type="xs:string" />
<xs:element minOccurs="1" name="NM_PEMOHON" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="1" maxOccurs="unbounded" name="DETIL">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="unbounded" name="CONT">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="NO_CONT" type="xs:string" />
<xs:element minOccurs="0" name="UK_CONT" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="unbounded" name="KMS">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" name="JNS_KMS" type="xs:string" />
<xs:element minOccurs="0" name="JML_KMS" type="xs:string" />
<xs:element minOccurs="0" name="NO_BL_AWB" type="xs:string" />
<xs:element minOccurs="0" name="TGL_BL_AWB" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:complexType>
</xs:element>
</xs:schema>

 Contoh Format String.


a. Pembatalan PLP untuk Kontainer/Peti Kemas, sebagai berikut :
<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT xmlns=" loadbatalplp.xsd">
<BATALPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<TIPE_DATA><TIPE_DATA>
<KD_TPS></KD_TPS >
<REF_NUMBER></REF_NUMBER>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>

36
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<ALASAN></ALASAN>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NM_PEMOHON></NM_PEMOHON>
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
</CONT>
</DETIL>
</ BATALPLP >
</DOCUMENT>

b. Pembatalan PLP untuk Kemasan, sebagai berikut :


<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT xmlns=" loadbatalplp.xsd">
<BATALPLP>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<TIPE_DATA><TIPE_DATA>
<KD_TPS></KD_TPS >
<REF_NUMBER></REF_NUMBER>
<NO_SURAT></NO_SURAT>
<TGL_SURAT></TGL_SURAT>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<ALASAN></ALASAN>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NM_PEMOHON></NM_PEMOHON>
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
</KMS>
</DETIL>
</ BATALPLP >
</DOCUMENT>

c. Respon keluaran yang diterima, sebagai berikut :


<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPON>
<KD_RES></KD_RES>
</RESPON>
</DOCUMENT>

Keterangan :
 REF_NUMBER : Referensi Number yang diajukan
 KD_RES : berisi kode respon. keterangan uraian dari kode respon tersebut ada pada
lampiran.

37
6. Service untuk Mengunduh Respon Persetujuan Pembatalan PLP oleh
Pengusaha TPS Asal yang mengajukan pembatalan PLP
 Fungsi : untuk mengunduh data Respon Persetujuan Pembatalan PLP Peti
Kemas dan Kemasan oleh pengusaha TPS Asal.
 Nama Service : GetResponBatalPLP
 Parameter : Username, password, Kode ASP.
 Struktur String XML :
a. String XML Respon Persetujuan Pembatalan PLP untuk Peti Kemas

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT>
<RESPON_BATAL>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<REF_NUMBER></REF_NUMBER>
<NO_BATAL_PLP></NO_BATAL_PLP >
<TGL_ BATAL_PLP></TGL_ BATAL_PLP >
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
<FL_SETUJU></FL_SETUJU>
</CONT>
</DETIL>
</ RESPON_BATAL >
</DOCUMENT>

b. String XML Respon Persetujuan Pembatalan PLP untuk Kemasan

<?xml version="1.0" encoding="UTF-8" ?>


<DOCUMENT>
<RESPON_BATAL>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<REF_NUMBER></REF_NUMBER>
<NO_BATAL_PLP></NO_BATAL_PLP >
<TGL_ BATAL_PLP></TGL_ BATAL_PLP >
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<FL_SETUJU></FL_SETUJU>
</KMS>
</DETIL>
</ RESPON_BATAL >
</DOCUMENT>

38
7. Service Untuk Mengunduh Respon Persetujuan Pembatalan PLP Oleh
Pengusaha TPS Tujuan
 Fungsi : untuk mengunduh data Respon Persetujuan Pembatalan PLP Peti
Kemas dan Kemasan oleh pengusaha TPS Tujuan.
 Nama Service : GetResponBatalPLPTujuan
 Parameter : Username, password, Kode ASP.
 Struktur String XML :
a. String XML Respon Persetujuan Pembatalan PLP untuk Peti Kemas
<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPON_BATAL>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<KD_TPS_ASAL></KD_TPS_ASAL>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<NO_BATAL_PLP></NO_BATAL_PLP >
<TGL_ BATAL_PLP></TGL_ BATAL_PLP >
</HEADER>
<DETIL>
<CONT>
<NO_CONT></NO_CONT>
<UK_CONT></UK_CONT>
</CONT>
</DETIL>
</ RESPON_BATAL>
</DOCUMENT>

b. String XML Respon Persetujuan Pembatalan PLP untuk Kemasan


<?xml version="1.0" encoding="UTF-8" ?>
<DOCUMENT>
<RESPON_BATAL>
<HEADER>
<KD_KANTOR></KD_KANTOR>
<KD_TPS></KD_TPS>
<KD_TPS_ASAL></KD_TPS_ASAL>
<NO_PLP></NO_PLP>
<TGL_PLP></TGL_PLP>
<NO_BATAL_PLP></ NO_BATAL_PLP >
<TGL_ BATAL_PLP></TGL_ BATAL_PLP >
</HEADER>
<DETIL>
<KMS>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
<NO_BL_AWB></NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
</KMS>
</DETIL>
</ RESPON_BATAL >
</DOCUMENT>

39
F. Service Untuk Mendapatkan Dokumen Perijinan Pemasukan/Pengeluaran
Barang Impor.
Beberapa serivce berikut digunakan untuk mendapatkan dokumen perijinan
pengeluaran/pemasukan barang impor yang diterbitkan oleh DJBC.

1. Service Untuk Mengunduh Data SPPB PIB (BC 2.0)


Tujuan melakukan pengunduhan data SPPB adalah untuk melakukan
pengecekan pada saat barang akan keluar dari gate dengan dokumen pengeluaran,
sehingga untuk memastikan apakah dokumen yang dibawa oleh importir adalah
dokumen asli yang terbit dari Kantor Pelayanan dan Pengawasan Bea dan Cukai,
selain itu data SPPB ini diharapkan menjadi dokumen acuan untuk melakukan
proses billing dan penerbitan SP2. Untuk mengunduh data SPPB dapat
menggunakan beberapa service seperti berikut :

a. Parameter Per SPPB


Service ini digunakan untuk mengunduh data SPPB dengan parameter no_sppb,
tgl_sppb dan npwp importir.
Nama Service : GetImpor_SPPB
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.
- No_SPPB adalah nomor SPPB yang lengkap sesuai format penomoran yang
dikeluarkan dari SAP Impor Kantor Pelayanan dan Pengawasan Bea dan
Cukai.
- Tgl_sppb dengan format “ddmmyyyy”.
- NPWP Impotir dituliskan hanya angkanya saja tanpa format.

b. Parameter Per Gudang


Service ini digunakan untuk melakukan pengunduhan data SPPB dengan
parameter kode gudang, untuk masing-masing TPS dapat memiliki beberapa
gudang dan atau lapangan. Jika menggunakan service ini maka data yang
diambil adalah data SPPB untuk gudang dimaksud.
Nama Service : GetImporPermit
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.
- Kode Gudang adalah kode yang terdaftar pada kantor pelayanan dan
pengawasan bea dan cukai.

40
c. Parameter Per Kode TPS
Service ini berfungsi untuk mengunduh data SPPB dengan parameter pencarian
yang digunakan kode ASP. Jika menggunakan service ini maka data yang ditarik
adalah semua data SPPB yang pemberitahuan gudangnya dibawah otoritas kode
TPS tersebut.
Nama Service : GetImporPErmit_FASP
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.
- Kode ASP adalah kode TPS yang didapat ketika mendaftar di TPS Online
Kantor Pusat Bea dan Cukai.
Hasil pengunduhan data yaitu dalam bentuk string XML dengan struktur sebagai
berikut :
<?xml version="1.0" encoding="utf-8" ?>
<string xmlns="http://services.beacukai.go.id/">
<?xml version="1.0" ?>
<!--
BC-Doc.SPPB
-->
<DOCUMENT>
<SPPB>
<HEADER>
<CAR> </CAR>
<NO_SPPB> </NO_SPPB>
<TGL_SPPB> </TGL_SPPB>
<KD_KPBC> </KD_KPBC>
<NO_PIB> </NO_PIB>
<TGL_PIB> </TGL_PIB>
<NPWP_IMP> </NPWP_IMP>
<NAMA_IMP> </NAMA_IMP>
<ALAMAT_IMP> </ALAMAT_IMP>
<NPWP_PPJK> </NPWP_PPJK>
<NAMA_PPJK> </NAMA_PPJK >
<ALAMAT_PPJK> </ALAMAT_PPJK >
<NM_ANGKUT> </NM_ANGKUT>
<NO_VOY_FLIGHT> </NO_VOY_FLIGHT>
<BRUTO> </BRUTO>
<NETTO> </NETTO>
<GUDANG> </GUDANG>
<STATUS_JALUR> </STATUS_JALUR>
<JML_CONT></JML_CONT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<NO_BL_AWB> </NO_BL_AWB>
<TG_BL_AWB></TG_BL_AWB>
<NO_MASTER_BL_AWB />
<TG_MASTER_BL_AWB />
</HEADER><DETIL>
<CONT>
<CAR></CAR>
<NO_CONT></NO_CONT>
<SIZE></SIZE>
<JNS_MUAT></JNS_MUAT>
</CONT>
<KMS>

41
<CAR></CAR>
<JNS_KMS> </JNS_KMS>
<MERK_KMS> </MERK_KMS>
<JML_KMS></JML_KMS>
</KMS>
</DETIL>
</SPPB>
</DOCUMENT>
</string>
Dari struktur diatas dapat dilihat, hasil keluaran berupa string xml dengan format
sebagai berikut:
Nama Element Tipe Keterangan
Element yang membatasi satu file yang
Document
diunduh, dapat berisi beberapa file SPPB.
Element yang membatasi satu file SPPB,
SPPB
yang berisi element Header dan Detil
Header Element yang berisi informasi Header.
Element yang berada dibawah header yang
CAR String(26)
berisi data nomor pengajuan.
Element yang berada dibawah element
NO_SPPB String(30)
Header yang berisi data Nomor SPPB.
Element yang berisi tanggal SPPB dengan
TGL_SPPB Date
format “dd/mm/yyyy”
Element yang berisi data Kode KPPBC,
KD_KPBC String(6)
dimana dokumen SPPB itu dikeluarkan
NO_PIB String(6) Element yang berisi No. Pendaftaran PIB
Element yang berisi tanggal pendaftaran
TGL_PIB Date
PIB
Element yang beisi dataNPWP Importir,
NPWP_IMP String(15)
tanpa format hanya nomornya saja
ALAMAT_IMP String(70) Element yang berisi alamat importir
Element yang berisi data NPWP PPJK,
NPWP_PPJK 15
tanpa format hanhya nomornya saja
ALAMAT_PPJK 70 Element yang berisi data alamat PPjk
Element yang berisi nama sarana
NM_ANGKUT 30
pengangkut.
NO_VOY_FLIGHT 10 Element yang berisi no vayage atau flight
BRUTO Element yang berisi data bruto
NETTO Element yang berisi data Netto
GUDANG 4 Element yang berisi data gudang tempat

42
penimbunan
STATUS_JALUR 1 Element yang berisi data status jalur PIB
JML_CONT Number Element yang berisi data jumlah container.
NO_BC11 6 Element yang berisi data nomor BC11
TGL_BC11 Date Element yang berisi data tanggal BC11
Element yang berisi data 4 digit nomor Pos
NO_POS_BC11 12
dan 8 digit sub pos BC11
NO_BL_AWB 30 Element yang berisi data nomer BL/AWB
TG_BL_AWB Date Element yang berisi data tanggal BL/AWB
Element yang berisi data nomor master
NO_MASTER_BL_AWB 4
BL/AWB
Element yang berisi data tanggal master
TG_MASTER_BL_AWB Date
BL/AWB
Element yang membatasi detil dari SPPB,
DETIL detil beisi data container dan kemasan
yang bias berulang
CONT Element yang membatasi data container
Element yang berisi no aju yang
CAR 26 merupakan primary key seusai dengan
headernya
NO_CONT 15 Element yang berisi nomor container
SIZE 1 Element yang berisi data ukuran container
Element yang beisi data jenis container,
JNS_MUAT 1
isinya FCL/LCL
KMS Element yang membatasi data kemasan
Element yang berisi no aju yang
CAR 26 merupakan primary key seusai dengan
headernya
Element yang berisi kode jenis kemasan
JNS_KMS 2
(kode standard dari DJBC)
MERK_KMS 30 Element yang berisi data merk kemasan
JML_KMS Number Element yang berisi data jumlah kemasan

Respon yang diterima


Dalam mengakses service ini, jika isian parameter tidak sesuai akan tampil respon
sebagai berikut :

43
1. Respon “Anda tidak berhak mengambil data ini…!!!” : Jika username dan
password tidak sesuai dengan data user yang ada pada database DJBC.
2. Respon “Belum ada data baru” : Jika belum ada data yang dapat didownload.
3. Respon “Anda tidak mempunyai hak akses terhadap gudang …….“ : jika
username dan password valid tetapi kode gudang salah.
4. Respon “Maaf coba cek kembali Nomor SPPB, Tanggal SPPB dan NPWP anda
!” : Jika Nomor SPPB atau tanggal SPPB atau NPWP tidak sesuai.

2. Service Untuk Mengunduh Data SPPB BC23


Tujuan melakukan pengunduhan data SPPB adalah untuk melakukan
pengecekan pada saat barang akan keluar dari gate dengan dokumen pengeluaran,
sehingga untuk memastikan apakah dokumen yang dibawa oleh importir adalah
dokumen asli yang terbit dari Kantor Pelayanan dan Pengawasan Bea dan Cukai.
Untuk mengunduh data SPPB dapat menggunakan beberapa service dibawah ini :

a. Parameter Per SPPB


Service ini digunakan untuk melakukan pengunduhan data SPPB dengan
parameter no_sppb, tgl_sppb dan npwp importer.
Nama Service :GetSppb_Bc23
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.
- No_SPPB adalah nomor SPPB yang lengkap sesuai format penomoran yang
dikeluarkan dari SAP BC23 Kantor Pelayanan dan Pengawasan Bea dan
Cukai.
- Tgl_sppb dengan format “ddmmyyyy”.
- NPWP Im-potir dituliskan hanya angkanya saja tanpa format.

b. Parameter Per Gudang


Service ini digunakan untuk melakukan pengunduhan data SPPB dengan
parameter kode gudang, untuk masing-masing TPS dapat memiliki beberapa
gudang dan atau lapangan. Jika menggunakan service ini maka data yang
diambil hanyalah per gudang.
Nama Service : GetBC23Permit
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.

44
- Kode gudang adalah kode yang terdaftar pada kantor pelayanan dan
pengawasan bea dan cukai.

c. Parameter Per Kode TPS


Service ini berfungsi untuk mengunduh data SPPB dengan parameter pencarian
yang digunakan kode ASP. Jika menggunakan service ini maka data yang ditarik
adalah semua data SPPB yang pemberitahuan gudangnya dibawah otoritas kode
TPS tersebut.
Nama Service : GetBC23PErmit_FASP
Parameter :
- Username dan password yang didapat dari kantor pusat DJBC, bila telah
terdaftar mengikuti TPS Online di Kantor Pusat DJBC.
- Kode ASP adalah kode TPS yang didapat ketika mendaftar di TPS Online
Kantor Pusat Bea dan Cukai.
Hasil pengunduhan data yaitu dalam bentuk string XML dengan struktur sebagai
berikut :
<?xml version="1.0" encoding="utf-8" ?>
<string xmlns="http://services.beacukai.go.id/">
<?xml version="1.0" ?>
<!--
BC-Doc.SPPB BC23
-->
<DOCUMENT>
<SPPB>
<HEADER>
<CAR> </CAR>
<NO_SPPB> </NO_SPPB>
<TGL_SPPB> </TGL_SPPB>
<KD_KANTOR_PENGAWAS> </ KD_KANTOR_PENGAWAS >
<KD_KANTOR_BONGKAR> </ KD_KANTOR_ BONGKAR >
<NO_PIB> </NO_PIB>
<TGL_PIB> </TGL_PIB>
<NPWP_IMP> </NPWP_IMP>
<NAMA_IMP> </NAMA_IMP>
<ALAMAT_IMP> </ALAMAT_IMP>
<NPWP_PPJK> </NPWP_PPJK>
<NAMA_PPJK> </NAMA_PPJK >
<ALAMAT_PPJK> </ALAMAT_PPJK >
<NM_ANGKUT> </NM_ANGKUT>
<NO_VOY_FLIGHT> </NO_VOY_FLIGHT>
<BRUTO> </BRUTO>
<NETTO> </NETTO>
<GUDANG> </GUDANG>
<STATUS_JALUR> </STATUS_JALUR>
<JML_CONT></JML_CONT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<NO_BL_AWB> </NO_BL_AWB>
<TGL_BL_AWB></TGL_BL_AWB>
<NO_MASTER_BL_AWB />
<TGL_MASTER_BL_AWB />
</HEADER>
<DETIL>

45
<CONT>
<CAR></CAR>
<NO_CONT></NO_CONT>
< SIZE ></ SIZE >
<JNS_MUAT></JNS_MUAT>
</CONT>
<KMS>
<CAR></CAR>
<JNS_KMS> </JNS_KMS>
<MERK_KMS> </MERK_KMS>
<JML_KMS></JML_KMS>
</KMS>
</DETIL>
</SPPB>
</DOCUMENT>
</string>
Dari struktur diatas dapat dilihat, hasil keluaran berupa string xml dengan format
sebagai berikut:
Panjang
Nama Element Keterangan
Karakter
Element yang membatasi satu file yang
Document
diunduh, dapat berisi beberapa file SPPB.
Element yang membatasi satu file SPPB, yang
SPPB
berisi element Header dan Detil
Header Element yang berisi informasi Header.
Element yang berada dibawah header yang
CAR 26
berisi data nomor pengajuan.
Element yang berada dibawah element Header
NO_SPPB 30
yang berisi data Nomor SPPB.
Element yang berisi tanggal SPPB dengan
TGL_SPPB 8
format “dd/mm/yyyy”
Element yang berisi data Kode Kantor
KD_KANTOR_PENGAW
6 Pengawas dimana dokumeb BC23 diajukan
AS
dan mendapat respon SPPB.
Element yang berisi data Kode Kantor Bongkar
KD_KANTOR_BONGKAR 6
dimana data akan dikeluarkan.
NO_PIB 6 Element yang berisi No. Pendaftaran PIB
Element yang berisi tanggal pendaftaran PIB.
TGL_PIB 8 penulisan dengan format “yyyymmdd” (yyyy:
tahun, mm : bulan, dd : tanggal)
Element yang beisi data NPWP Importir, tanpa
NPWP_IMP 15
format hanya nomornya saja
ALAMAT_IMP 70 Element yang berisi alamat importer

46
Element yang berisi data NPWP PPJK, tanpa
NPWP_PPJK 15
format hanhya nomornya saja
ALAMAT_PPJK 70 Element yang berisi data alamat PPjk
NM_ANGKUT 25 Element yang berisi nama sarana pengangkut.
NO_VOY_FLIGHT 20 Element yang berisi no vayage atau flight
BRUTO Element yang berisi data Bruto.
NETTO Element yang berisi data Netto.
Element yang berisi data gudang tempat
GUDANG 4
penimbunan
STATUS_JALUR 1 Element yang berisi data status jalur PIB
JML_CONT 8 Element yang berisi data jumlah container.
NO_BC11 6 Element yang berisi data nomor BC11
Element yang berisi data tanggal BC11.
TGL_BC11 8 penulisan dengan format “yyyymmdd” (yyyy:
tahun, mm : bulan, dd : tanggal)
Element yang berisi data 4 digit nomor Pos
NO_POS_BC11 12
dan 8 digit sub pos BC11
NO_BL_AWB 30 Element yang berisi data nomer BL/AWB
Element yang berisi data tanggal BL/AWB.
TGL_BL_AWB 8 penulisan dengan format “yyyymmdd” (yyyy:
tahun, mm : bulan, dd : tanggal)
Element yang berisi data nomor master
NO_MASTER_BL_AWB 4
BL/AWB
Element yang berisi data tanggal master
TGL_MASTER_BL_AWB 8
BL/AWB
Element yang membatasi detil dari SPPB, detil
DETIL beisi data container dan kemasan yang bisa
berulang
CONT Element yang membatasi data container
Element yang berisi no aju yang merupakan
CAR 26
primary key seusai dengan headernya
NO_CONT 11 Element yang berisi nomor container
SIZE 2 Element yang berisi data ukuran container.
JNS_MUAT 1 Element yang berisi data Jenis Muat Container
KMS Element yang membatasi data kemasan
CAR 26 Element yang berisi no aju yang merupakan

47
primary key seusai dengan headernya
JNS_KMS 2 Element yang berisi data jenis kemasan
MERK_KMS 30 Element yang berisi data merk kemasan
JML_KMS 8 Element yang berisi data jumlah kemasan

Respon yang diterima


Dalam mengakses service ini, jika isian parameter tidak sesuai akan tampil respon
sebagai berikut :
1. Respon “Anda tidak berhak mengambil data ini…!!!” : Jika username dan
password tidak sesuai dengan data user yang ada pada database DJBC.
2. Respon “Belum ada data baru” : Jika belum ada data yang dapat didownload.
3. Respon “Anda tidak mempunyai hak akses terhadap gudang …….“ : jika
username dan password valid tetapi kode gudang salah.
4. Respon “Maaf coba cek kembali Nomor SPPB, Tanggal SPPB dan NPWP anda !”
: Jika Nomor SPPB atau tanggal SPPB atau NPWP tidak sesuai.

3. Service Mengunduh Data SPJM


Service ini digunakan untuk mengunduh data container/barang yang terkena
SPJM (pemeriksaan fisik barang). Adapun service yang dapat digunakan adalah
sebagai berikut :

a. Parameter Per Kode TPS


Nama Service : GetSPJM
Parameter yang digunakan adalah :
- User dan Password TPS
- Kode TPS

b. Parameter Per Nomor SPJM


Nama Service : GetSPJM_onDemand
Parameter yang digunakan adalah :
- User dan Password TPS
- Nomor PIB dan Tanggal PIB dengan format "ddmmyyyy"

Hasil pengunduhan data yaitu dalam bentuk string XML dengan struktur sebagai
berikut :
<?xml version="1.0"?><!--BC-Doc.SPJM->
<DOCUMENT>
<SPJM>
<HEADER>

48
<CAR></CAR>
<KD_KANTOR></KD_KANTOR>
<NO_PIB></NO_PIB>
<TGL_PIB></TGL_PIB>
<NPWP_IMP></NPWP_IMP>
<NAMA_IMP> </NAMA_IMP>
<NPWP_PPJK></NPWP_PPJK>
<NAMA_PPJK> </NAMA_PPJK>
<GUDANG> </GUDANG>
<JML_CONT></JML_CONT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<FL_KARANTINA></FL_KARANTINA>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
</HEADER>
<DETIL>
<CONT>
<CAR></CAR>
<NO_CONT> </NO_CONT>
<SIZE></SIZE>
</CONT>
</DETIL>
</SPJM>
</DOCUMENT>

G. Service Untuk Mendapatkan Dokumen Perijinan Pemasukan/Pengeluaran


Barang Ekspor.
Beberapa serivce berikut digunakan untuk mendapatkan dokumen perijinan
pengeluaran/pemasukan barang impor yang diterbitkan oleh DJBC.

1. Service Mengunduh Data NPE (Nota Pelayanan Ekspor)


Services yang berkaitan dengan fungsi untuk mengunduh data NPE yang
dikeluarkan oleh DJBC adalah :

a. Service NPE 1 (GetNPE)


Service ini berfungsi untuk mendapatkan data nomor dan tanggal NPE.
Nama Service : GetNPE
Parameter yang digunakan untuk mendapatkan data NPE adalah :
Username : format free text dengan lebar maksimum 50 character.
Password : format free text dengan lebar maksimum 50 character.
NPWP Eksportir : NPWP eksportir (tanpa format)
Nomor NPE : format number dengan lebar maksimum 6 character.
Kode Kantor : kode kantor pelayanan Bea dan Cukai yang menerbitkan
NPE, 6 character.
Contoh respon yang didapat apabila data ditemukan :
<RESPON>
<NPE>000333/KPU.01/ 2014</NPE>
<TGLNPE>1/10/2014</TGLNPE>

49
</RESPON>

b. Service NPE 2 (GetEksporPermit_FNPE)


Service ini berfungsi untuk mengunduh data NPE sesuai dengan nomor NPE dan
Kantor Pelayanan yang menerbitkan NPE.
Nama Service : GetEksporPermit_FNPE
Parameter yang digunakan untuk mendapatkan data NPE adalah :
Username : format free text dengan lebar maksimum 50 character.
Password : format free text dengan lebar maksimum 50 character.
NPWP Eksportir : NPWP eksportir (tanpa format)
Nomor NPE : format number dengan lebar maksimum 6 character.
Kode Kantor : kode kantor pelayanan Bea dan Cukai yang menerbitkan
NPE, 6 character.
Contoh respon yang didapat apabila data ditemukan :
<?xml version="1.0"?>
<!--BC-Doc.NPE-->
<DOCUMENT>
<NPE>
<HEADER>
<NO_DAFTAR>123456</NO_DAFTAR>
<TGL_DAFTAR>20140114</TGL_DAFTAR>
<NONPE>000333/KPU.01/ 2014</NONPE>
<TGLNPE>20140114</TGLNPE>
<NPWP_EKS>123456789012345</NPWP_EKS>
<NAMA_EKS>PT. TES JAYA ABADI</NAMA_EKS>
<FL_SEGEL>Y</FL_SEGEL>
</HEADER>
<DETIL>
<CONT>
<SERI_CONT>1</SERI_CONT>
<NO_CONT>TCLU8841123</NO_CONT>
<SIZE>40</SIZE>
</CONT>
</DETIL>
</NPE>
</DOCUMENT>

c. Service NPE 3 (GetEkspor_NPE)


Service ini berfungsi untuk mengunduh data NPE sesuai dengan nomor NPE dan
Kantor Pelayanan yang menerbitkan NPE.
Nama Service : GetEkspor_NPE
Parameter yang digunakan untuk mendapatkan data NPE adalah :
Username : format free text dengan lebar maksimum 50 character.
Password : format free text dengan lebar maksimum 50 character.
NPWP Eksportir : NPWP eksportir (tanpa format)
Nomor NPE : format number dengan lebar maksimum 6 character.
Kode Kantor : kode kantor pelayanan Bea dan Cukai yang menerbitkan
NPE, 6 character.

50
Contoh respon yang didapat apabila data ditemukan :
<?xml version="1.0"?>
<!--BC-Doc.NPE-->
<DOCUMENT>
<NPE>
<HEADER>
<NO_DAFTAR>123456</NO_DAFTAR>
<TGL_DAFTAR>20140114</TGL_DAFTAR>
<NONPE>123459/KPU.01/2014</NONPE>
<TGLNPE>20140116</TGLNPE>
<NPWP_EKS>123456789012345</NPWP_EKS>
<NAMA_EKS>PT. TES JAYA ABADI</NAMA_EKS>
<FL_SEGEL>Y</FL_SEGEL>
</HEADER>
<DETIL>
<CONT>
<SERI_CONT>1</SERI_CONT>
<NO_CONT>TCLU8841123</NO_CONT>
<SIZE>40</SIZE>
</CONT>
</DETIL>
</NPE>
</DOCUMENT>

d. Service NPE 4 (GetEkspor_PEB)


Service ini berfungsi untuk mengunduh data NPE dengan parameter nomor dan
tanggal PEB.
Nama Service : GetEkspor_PEB
Parameter yang digunakan untuk mendapatkan data NPE adalah :
Username : format free text dengan lebar maksimum 50 character.
Password : format free text dengan lebar maksimum 50 character.
Nomor PEB : NPWP eksportir (tanpa format)
Tanggal PEB : dengan format “ddmmyyyy”
Kode Kantor : kode kantor pelayanan Bea dan Cukai yang menerbitkan
NPE, 6 character.

Service diatas akan menghasilkan keluaran string dengan struktur XML sebagai
berikut :
<?xml version="1.0" encoding="utf-8" ?>
<string xmlns="http://services.beacukai.go.id/">
<?xml version="1.0"?>
<!--BC-Doc.NPE-->
<DOCUMENT>
<NPE>
<HEADER>
<CAR></CAR>
<NO_PEB></NO_PEB>
<TG_PEB></TG_PEB>
<NO_NPE></NO_NPE>
<TG_NPE></TG_NPE>
<KD_KPBC></KD_KPBC>
<NPWP_EKS></NPWP_EKS>
<NAMA_EKS></NAMA_EKS>
<NPWP_PPJK></NPWP_PPJK>
<NAMA_PPJK></NAMA_PPJK>

51
<ALAMAT_PPJK></ALAMAT_PPJK>
<JNS_ANGKUT></JNS_ANGKUT>
<NM_ANGKUT></NM_ANGKUT>
< NO_VOY_FLIGHT ></ NO_VOY_FLIGHT >
<JML_CONT></JML_CONT>
<JML_KMS></JML_KMS>
<BRUTO></BRUTO>
<KD_KANTOR_MUAT></KD_KANTOR_MUAT>
<TPS_TUJUAN></TPS_TUJUAN>
</HEADER>
<DETIL>
<CONT>
<CAR</CAR>
<SERI_CONT></SERI_CONT>
<NO_CONT></NO_CONT>
<SIZE></SIZE>
</CONT>
<KMS>
<CAR></CAR>
<JNS_KMS></JNS_KMS>
<JML_KMS></JML_KMS>
</KMS>
</DETIL>
</NPE>
</DOCUMENT>
</string>

Panjang
Nama Element Keterangan
Karakter
DOCUMENT Element yang membatasi satu file yang
didownload, yang dapat berisi beberapa file NPE.
NPE Element yang membatasi satu file NPE, yang berisi
Header dan detil.
HEADER Element yang berisi informasi data header sebagai
berikut
CAR 26 Element yang berisi data Nomor Pengajuan.
NO_PEB 6 Element yang berisi data Nomor PEB.
TGL_PEB 8 Element yang berisi data Tanggal PEB. . Penulisan
dengan format “yyyymmdd” (yyyy: tahun, mm :
bulan, dd : tanggal)
NO_NPE 30 Element yang berisi data Nomor Daftar PEB
TGL_NPE 8 Element yang berisi data Tanggal Daftar PEB.
Penulisan dengan format “yyyymmdd” (yyyy:
tahun, mm : bulan, dd : tanggal)
KD_KPBC 6 Element yang berisi data Kode Kantor.
NPWP_EKS 15 Element yang berisi data NPWP Eksportir.
NAMA_EKS 60 Element yang berisi data Nama Eksportir.

52
NPWP_PPJK 15 Element yang berisi data NPWP PPJK.
NAMA_PPJK 60 Element yang berisi data Nama PPJK.
ALAMAT_PPJK 70 Element yang berisi data Alamat PPJK.
JNS_ANGKUT 1 Element yang berisi Kode Pengangkutan.
NM_ANGKUT 25 Element yang berisi data Nama Kapal.
NO_VOY_FLIGHT 20 Element yang berisi data Nomor Voy/Flight.
JML_CONT 8 Element yang berisi Jumlah Container
JML_KMS 8 Element yang berisi Jumlah Kemasan
BRUTO 20 Element yang berisi data Bruto.
KD_KANTOR_MUAT 6 Element yang berisi Kode Kantor Muat Ekspor
TPS_TUJUAN 4 Element yang berisi Kode TPS Tujuan setelah dari
KPPT.
DETIL Element yang berisi informasi data container
dan/atau kemasan.
CONT Element yang berisi informasi data container,
sebagai berikut
CAR 26 Element yang berisi data Nomor Pengajuan sama
dengan Header.
SERI_CONT 11 Element yang berisi Nomor Urut Container
NO_CONT 11 Element yang berisi data Nomor Container.
SIZE 2 Element yang berisi data Ukuran Container.
KMS Element yang berisi informasi data kemasan,
sebagai berikut
CAR 26 Element yang berisi data Nomor Pengajuan sama
dengan Header.
JNS_KMS 2 Element yang berisi data Jenis Kemasan.
JML_KMS 8 Element yang berisi data Jumlah Kemasan.

Respon yang di Terima


1. Respon “Anda tidak berhak mengambil data ini…!!!” : Jika username dan
password tidak sesuai dengan data user yang ada pada database DJBC.
2. Respon “Belum ada data baru” : Jika belum ada data yang dapat didownload.
3. Respon "Jika ingin mengambil data Beda Kantor gunakan service
'GetEksporPermit_onDemand_BedaKantor'...!!!" : jika menjalankan service
GetEksporPermit_onDemand tetapi kode kantor nya berbeda dengan kode
kantor pengawas TPS.

53
4. Respon “Maaf coba cek kembali Nomor PEB dan Tanggal PEB anda!" : Jika
Nomor Pendaftaran PEB atau Tanggal Pendaftaran PEB tidak sesuai.

2. Service Mengunduh Data PKBE


Service ini digunakan untuk mengunduh dokumen PKBE (pemasukan barang
ekspor) yang diterbitkan oleh Kantor Pelayanan Bea dan Cukai
String XML Dok. PKBE :
<?xml version="1.0"?>
<!--BC-Doc.PKBE-->
<DOCUMENT>
<PKBE>
<CAR></CAR>
<NOPKBE></NOPKBE>
<TGLPKBE></TGLPKBE>
<NPWP_EKS></NPWP_EKS>
<NAMA_EKS> </NAMA_EKS>
<NO_CONT></NO_CONT>
<SIZE></SIZE>
</PKBE>
</DOCUMENT>

H. Service Dokumen Manual


Service ini digunakan untuk mengunduh dokumen pengeluaran/pemasukan yang
diterbitkan oleh Kantor Pelayanan Bea dan Cukai tidak secara sistem atau diterbitkan
secara manual. Namun datanya bisa di unduh oleh TPS dengan mengakses service
berikut :

1. GetDokumenManual
Parameter yang digunakan adalah :
- User dan Password TPS
- Kode TPS

2. GetDokumenManual_OnDemand
Parameter yang digunakan adalah :
- User dan Password TPS
- Kode Dokumen : Kode dokumen pengeluaran/pemasukan
- Nomor Dokumen : Nomor dokumen pengeluaran/pemasukan
- Tanggal Dokumen : Tanggal dokumen pengeluaran/pemasukan (format tanggal
"ddMMyyyy")

Hasil unduhan data yaitu dalam bentuk string XML dengan struktur sebagai berikut :
<?xml version="1.0"?>
<!--BC-Doc.Manual->

54
<DOCUMENT>
<MANUAL>
<HEADER>
<ID></ID>
<KD_KANTOR></KD_KANTOR>
<KD_DOK_INOUT></KD_DOK_INOUT>
<NO_DOK_INOUT></NO_DOK_INOUT>
<TGL_DOK_INOUT></TGL_DOK_INOUT>
<ID_CONSIGNEE></ID_CONSIGNEE>
<CONSIGNEE> </CONSIGNEE>
<NPWP_PPJK></NPWP_PPJK>
<NAMA_PPJK></NAMA_PPJK>
<NM_ANGKUT></NM_ANGKUT>
<NO_VOY_FLIGHT></NO_VOY_FLIGHT>
<KD_GUDANG></KD_GUDANG>
<JML_CONT></JML_CONT>
<NO_BC11></NO_BC11>
<TGL_BC11></TGL_BC11>
<NO_POS_BC11></NO_POS_BC11>
<NO_BL_AWB></NO_BL_AWB>
<TG_BL_AWB></TG_BL_AWB>
<FL_SEGEL></FL_SEGEL>
</HEADER>
<DETIL>
<CONT>
<ID></ID>
<NO_CONT> </NO_CONT>
<SIZE></SIZE>
<JNS_MUAT></JNS_MUAT>
</CONT>
</DETIL>
</MANUAL>
</DOCUMENT>

55
LAMPIRAN
A. Penjelasan Skema Pertukaran Data Coarri-Codeco
HEADER
Elemen Data Uraian Mandatory Value Keterangan
KD_DOK : Kode Dokumen Coari-Codeco Y 1 = Coari Discarge Daftar Timbun Impor
2 = Coari Loading Daftar Muat Ekspor
3 = Codeco Impor Gate Out Impor Lini 1
4 = Codeco Ekspor Gate In Ekspor Lini 1
5 = Gate In Impor (Lini 2) Gate In Impor Lini 2
6 = Gate Out Impor (Lini 2) Gate Out Impor Lini 2
7 = Gate In Ekspor (Lini 2) Gate In Ekspor Lini 2
8 = Gate Out Ekspor (Lini 2) Gate Out Ekspor Lini 2
9 = Codeco Out Ekspor (Lini 1) Gate Out Ekspor Lini 1 (Batal Ekspor)
KD_TPS : Kode TPS Y Contoh : JICT, KOJA, MAL0, … Diberikan oleh DJBC setelah terdaftar di TPS Online
NM_ANGKUT : Nama alat angkut Y Free text (25)
NO_VOY_FLIGHT : Nomor Voy/Flight Y Free text (20)
CALL_SIGN : Call Sign Y format : AN(5)
TGL_TIBA : Perkiraan Tanggal Tiba / Tanggal Perkiraan Ekspor Y format : yyyymmdd
Kode Lapangan/Gudang yang diberikan oleh
KD_GUDANG : Y Standar BC (4 digit) Kode Gudang ke TPS
KPU/KPPBC
REF_NUMBER : REF_NUMBER Y Format : AAAAYYMMDDNNNNNN PrimaryKey (TPS Lini 1, TPS Lini 2)
DETIL CONTAINER-KEMASAN
Elemen Data Uraian Mandatory Value Keterangan
NO_CONT : Nomor Container Y (laut-Terminal Cont) Format : AAAANNNNNNN
UK_CONT : Ukuran Container Y (laut-Terminal Cont) 20; 40; 45
NO_SEGEL : Nomor Segel Pelayaran Y Free text
JNS_CONT : Jenis Container Load Y (laut-Terminal Cont) F = FCL; L = LCL
NO_BL_AWB : Nomor BL/AWB Y Free text (30) Mandatory : Non Container, Codeco Container
TGL_BL_AWB : Tanggal BL/AWB Y format : yyyymmdd Mandatory : Non Container, Codeco Container
NO_MASTER_BL_AWB : Nomor Master BL/AWB - Free text (30)
TGL_MASTER_BL_AWB : Tanggal Master BL/AWB - format : yyyymmdd
ID_CONSIGNEE : Identitas Pemilik Barang / NPWP Y (opt:Coari Bongkar) Format : AN(20) NPWP Importir/Eksportir Tanpa Format
CONSIGNEE : Nama Pemilik Barang Y Free text (100) Nama Importir/eksportir
Untuk decimal gunakan tanda "." (titik); 4
BRUTO : Bruto Y Format : N Sat:Kg
angka dibelakang tanda decimal
NO_BC11 : Nomor BC1.1 (Manifest) Y format : AN(6)
TGL_BC11 : Tanggal BC1.1 (Manifest) Y format : yyyymmdd
NO_POS_BC11 : Nomor Pos BC1.1 (Manifest) - Format : AN(12)
CONT_ASAL : Asal Container (jika Kemasan hasil dari Stripping) Y (Ex. Hasil Stripping) Format : AAAANNNNNNN
SERI_KEMAS : Seri Kemasan Y (Non.Cont&Ex.Stripping) Format : N
Format : AA (Un/Edifact
KD_KEMAS : Kode Kemasan Y (Non.Cont&Ex.Stripping)
format)
JML_KEMAS : Jumlah Kemasan Y (Non.Cont&Ex.Stripping) Format : N
KD_TIMBUN : Kode posisi Container di terminal cont. (lapangan) Y format : AN(10) coari loading = posisi di kapal
coari bongkar = posisi di lapangan
codeco in (lini2) = posisi di lapangan/gudang
Kode dokumen untuk pengeluaran/pemasukkan
KD_DOK_INOUT : Y (Codeco) Contoh : 1 = SPPB BC 2.0
barang
2 = SPPB BC 2.3
3 = SPPB PLP

ii
4 = SPPB BC 1.2
5 = BCF 2.6(pemeriksaan
dilokasi imp)
6 = NPE
7 = PKBE
8 = PPB
dan seterusnya… (lihat kode
referensi)
Nomor dokumen untuk pengeluaran/pemasukkan
NO_DOK_INOUT : Y (Codeco) Free text (30)
barang
Tanggal dokumen untuk pengeluaran/pemasukkan
TGL_DOK_INOUT : Y (Codeco) format : yyyymmdd
barang
Waktu dokumen untuk pengeluaran/pemasukkan Format =
WK_INOUT : Y (Codeco)
barang yyyymmddHHMMSS
Kode Sarana Pengangkut dalam rangka
KD_SAR_ANGKUT_INOUT : Y (Codeco) 1 = Truck
pengeluaran/pemasukkan barang
2 = Kereta Api
3 = Kapal
4 = Pesawat Udara
Nomor Polisi Sarana Pengangkut dalam rangka
NO_POL : Y (Codeco) Free text (10)
pengeluaran/pemasukkan barang
FL_CONT_KOSONG : Tanda (flag) status container kosong Y (Codeco) 1 = Kosong; 2 = Isi
ISO_CODE : Kode ISO Container Y (Codeco) Format: AN(20)
PEL_MUAT : Pelabuhan Muat Y Un Locode (5 Digit)
PEL_TRANSIT : Pelabuhan Transit - Un Locode (5 Digit)
PEL_BONGKAR : Pelabuhan Bongkar Y Un Locode (5 Digit)
GUDANG_TUJUAN : Gudang Tujuan (Untuk Pindah Lokasi Penimbunan) Y (OB/PLP) Standar BC (4 digit)
Kode Kantor Pelayanan BC yang menerbitkan
KD_KANTOR_PABEAN : Y Standar BC (6 digit)
nomor dokumen pabean
Nomor pendaftaran yang diberikan BC atas
NO_DAFTAR_PABEAN : Y (untuk codeco) 6 digit
dokumen pabean
TGL_DAFTAR_PABEAN : Tanggal pendaftaran atas dokumen pabean format : yyyymmdd

iii
NO_SEGEL_BC : Nomor Segel BC Y (jika ada segel dari BC) Free text (30)
TGL_SEGEL_BC : Tanggal Segel BC Y (jika ada segel dari BC) format : yyyymmdd
Nomor dokumen pengeluaran/pemuatan yang
NO_DOK_IJIN_TPS : diterbitkan oleh TPS Lini 1; Impor : Nomor SP2; Y Free text (30) Impor : Nomor SP2; Ekspor : Kartu Ekspor
Ekspor : Kartu Ekspor
Tanggal dokumen pengeluaran/pemuatan yang
TGL_DOK_IJIN_TPS : Y format : yyyymmdd Tanggal SP2 / Kartu Ekspor
diterbitkan oleh TPS Lini 1

TPS TANGKI PENIMBUNAN


Elemen Data Uraian Mandatory Value Keterangan
SERI_OUT : Nomor urut per pengeluaran barang Y (Codeco) Number
NO_BL_AWB : Nomor BL/AWB Y Free text (30)
TGL_BL_AWB : Tanggal BL/AWB - format : yyyymmdd
ID_CONSIGNEE : Identitas Pemilik Barang / NPWP Y (opt:Coari Bongkar) Format : AN(20) NPWP Importir/Eksportir Tanpa Format
CONSIGNEE : Nama Pemilik Barang Y Free text (100) Nama Importir/eksportir
NO_BC11 : Nomor BC1.1 (Manifest) Y format : AN(6)
TGL_BC11 : Tanggal BC1.1 (Manifest) Y format : yyyymmdd
NO_POS_BC11 : Nomor Pos BC1.1 (Manifest) - Format : AN(4)
NO_TANGKI : Nomor Tangki Y Free text (20)
JML_SATUAN : Jumlah Satuan Y Number
Format : AAA (Un/Edifact format,
JNS_SATUAN : Jenis Satuan Y
lihat lampiran)
Kode dokumen untuk pengeluaran/pemasukkan
KD_DOK_INOUT : Y (Codeco) Contoh : 1 = SPPB PIB (BC 2.0)
barang
2 = SPPB BC 2.3
6 = NPE
dan seterusnya… (lihat kode
referensi)
Nomor dokumen untuk pengeluaran/pemasukkan
NO_DOK_INOUT : Y (Codeco) Free text (30)
barang
TGL_DOK_INOUT : Tanggal dokumen untuk pengeluaran/pemasukkan Y (Codeco) format : yyyymmdd

iv
barang
Waktu dokumen untuk pengeluaran/pemasukkan
WK_INOUT : Y Format = yyyymmddHHMMSS
barang
Kode Sarana Pengangkut dalam rangka
KD_SAR_ANGKUT_INOUT : Y (Codeco) 1 = Truck
pengeluaran/pemasukkan barang
2 = Kereta Api
3 = Kapal
4 = Pesawat Udara
Nomor Polisi Sarana Pengangkut dalam rangka
NO_POL : Y (Codeco) Free text (10)
pengeluaran/pemasukkan barang
PEL_MUAT : Pelabuhan Muat Y Un Locode (5 Digit)
PEL_TRANSIT : Pelabuhan Transit - Un Locode (5 Digit)
PEL_BONGKAR : Pelabuhan Bongkar Y Un Locode (5 Digit)
GUDANG_TUJUAN : Gudang Tujuan (Untuk OB) Y (OB/PLP) Standar BC (4 digit)
Kode Kantor Pelayanan BC yang menerbitkan
KD_KANTOR_PABEAN : Y Standar BC (6 digit)
nomor dokumen pabean
Nomor pendaftaran yang diberikan BC atas
NO_DAFTAR_PABEAN : Y (untuk codeco) 6 digit
dokumen pabean
TGL_DAFTAR_PABEAN : Tanggal pendaftaran atas dokumen pabean Y (untuk codeco)
NO_SEGEL_BC : Nomor Segel Bea dan Cukai Y (jika ada segel dari BC) Free text (30)
TGL_SEGEL_BC : Tanggal Segel Bea dan Cukai
Nomor dokumen pengeluaran/pemuatan yang
NO_DOK_IJIN_TPS : diterbitkan oleh TPS Lini 1; Impor : Nomor SP2; Y Free text (30) Impor : Nomor SP2; Ekspor : Kartu Ekspor
Ekspor : Kartu Ekspor
Tanggal dokumen pengeluaran/pemuatan yang
TGL_DOK_IJIN_TPS : Y format : yyyymmdd Tanggal SP2 / Kartu Ekspor
diterbitkan oleh TPS Lini 1

v
DETILCAR TERMINAL
Elemen Data Uraian Mandatory Value Keterangan
NO_BL_AWB : Nomor BL/AWB Y Free text (30)
TGL_BL_AWB : Tanggal BL/AWB - format : yyyymmdd
ID_CONSIGNEE : Identitas Pemilik Barang / NPWP Y (opt:Coarri Bongkar) Format : AN(20) NPWP Importir/Eksportir Tanpa Format
CONSIGNEE : Nama Pemilik Barang Y Free text (20)
NO_BC11 : Nomor BC1.1 (Manifest) Y format : AN(6)
TGL_BC11 : Tanggal BC1.1 (Manifest) Y format : yyyymmdd
NO_POS_BC11 : Nomor Pos dan Sub pos BC1.1 (Manifest) - Format : AN(12)
VIN_NUMBER : Vehicle Identifier Number Y Free text (20)
NO_RANGKA : Nomor Rangka Y Free text (20)
NO_MESIN : Nomor Mesin Y Free text (20)
TIPE : Tipe Mobil Y Free text (20)
MERK : Merk Mobil Y Free text (20)
WARNA : Warna Dasar Mobil Y Free text (20)
Untuk decimal gunakan tanda "." (titik); 4
BRUTO Bruto Y Format : N Satuan : Kilogram
: angka dibelakang tanda decimal
KD_TIMBUN : Kode posisi mobil di lapangan/gudang penimbunan Y (Terminal Cont.) format : AN(10)
Kode dokumen untuk pengeluaran/pemasukkan
KD_DOK_INOUT Y (Codeco) Contoh : 1 = SPPB PIB Coarri loading = posisi di kapal
: barang
2 = SPPB BC 2.3 Coarri bongkar = posisi di lapangan
3 = A11 / ijin PLP codeco = tdk ada posisi lapangan
4 = BC 1.2
dan seterusnya… (lihat lampiran
kode referensi)
Nomor dokumen untuk pengeluaran/pemasukkan
NO_DOK_INOUT Y (Codeco) Free text (30) (untuk empty cont --> tidak ada nomor surat)
: barang
Tanggal dokumen untuk pengeluaran/pemasukkan
TGL_DOK_INOUT Y (Codeco) format : yyyymmdd (untuk empty cont --> tidak ada nomor surat)
: barang
Waktu dokumen untuk pengeluaran/pemasukkan
WK_INOUT Y (Codeco) Format = yyyymmddHHMMSS
: barang
: Kode Sarana Pengangkut dalam rangka
KD_SAR_ANGKUT_INOUT Y (Codeco) 1 = Truck
pengeluaran/pemasukkan barang

vi
: Nomor Polisi Sarana Pengangkut dalam rangka
NO_POL Y (Codeco) Free text (10)
pengeluaran/pemasukkan barang
PEL_MUAT : Pelabuhan Muat Y Un Locode (5 Digit)
PEL_TRANSIT : Pelabuhan Transit - Un Locode (5 Digit)
PEL_BONGKAR : Pelabuhan Bongkar Y Un Locode (5 Digit)
GUDANG_TUJUAN : Gudang Tujuan (Jika di PLP/OB) Y (PLP/OB) Standar BC (4 digit)
: Kode Kantor Pelayanan BC yang menerbitkan
KD_KANTOR_PABEAN Y Standar BC (6 digit)
nomor dokumen pabean
: Nomor pendaftaran yang diberikan BC atas
NO_DAFTAR_PABEAN Y (untuk codeco) 6 digit
dokumen pabean
TGL_DAFTAR_PABEAN : Tanggal pendaftaran atas dokumen pabean Y (untuk codeco)
NO_SEGEL_BC : Nomor Segel BC Y (jika ada segel dari BC) Free text (30)
TGL_SEGEL_BC : Tanggal Segel BC
: Nomor dokumen pengeluaran/pemuatan yang
NO_DOK_IJIN_TPS diterbitkan oleh TPS Lini 1; Impor : Nomor SP2; Y Free text (30) Impor : Nomor SP2; Ekspor : Kartu Ekspor
Ekspor : Kartu Ekspor
: Tanggal dokumen pengeluaran/pemuatan yang
TGL_DOK_IJIN_TPS format : yyyymmdd Tanggal SP2 / Kartu Ekspor
diterbitkan oleh TPS Lini 1

vii
B. Penjelasan Skema PLP
HEADER
Elemen Data Uraian Mandatory Value Keterangan
KD_KANTOR : Kode Kantor tempat pengajuan PLP Standar BC (6 digit)
TIPE_DATA : Tipe data yang dikirimkan 1 : Baru
2 : Manual
NO_PLP : Nomor Persetujuan PLP Y Free text (30)
TGL_PLP : Tanggal Persetujuan PLP Y format : yyyymmdd
NO_BATAL_PLP : Nomor Persetujuan Pembatalan PLP Y Free text (30)
TGL_BATAL_PLP : Tanggal Persetujuan Pembatalan PLP Y format : yyyymmdd
KD_TPS_ASAL : Kode TPS Asal Y Standar BC (4 digit)
REF_NUMBER : Nomor Aju Referensi setiap pengiriman string xml Y
NO_SURAT : Nomor Surat Permohonan/Pembatalan PLP Y Free text (30)
TGL_SURAT : Tanggal Surat Permohonan/Pembatalan PLP Y format : yyyymmdd
GUDANG_ASAL : Kode Gudang/Lapangan Asal PLP Y Standar BC (4 digit)
KD_TPS_TUJUAN Kode TPS TUJUAN Y Standar BC (4 digit)
GUDANG_TUJUAN : Kode Gudang/Lapangan Tujuan PLP Y Standar BC (4 digit)
KD_ALASAN_PLP : kode alasan PLP Y 1 = YOR/SOR TPS sama dengan atau lebih tinggi dari batas standar utilisasi fasilitas yang
ditetapkan oleh instansi teknis yang bertanggung jawab di bidang pelabuhan.
2 = pada TPS asal tidak tersedia tempat penimbunan barang impor konsolidasi, yaitu
pengangkutan barang impor menggunakan satu peti kemas untuk lebih dari satu penerima
barang atau menggunakan satu peti kemas untuk lebih dari satu house bill of lading dengan
penerima barang yang sama (Less than container load = LCL).
3 = pada TPS asal tidak tersedia tempat penimbunan barang impor yang karena sifatnya
membutuhkan sarana dan prasarana penyimpanan atau penumpukan khusus yang tersedia
mencapai sama dengan atau lebih tinggi dari batas standar utilisasi fasilitas;
4 = barang impor berupa barang kena cukai yang akan dilekati pita cukai di TPS tujuan;
5 = barang impor konsolidasi dalam 1(satu) masterairway bill atau master bill of lading;
: 6 = berdasarkan pertimbangan Kepala Kantor Pabean dimungkinkan terjadi stagnasi setelah
mendapatkan masukan dari pengusaha TPS Asal.
YOR_ASAL : Nilai YOR di TPS Asal Number
YOR_TUJUAN : Nilai YOR di TPS Tujuan Number

viii
CALL_SIGN : Call Sign Y (laut) format : AN(5)
NM_ANGKUT : Nama sarana pengangkut Y Free text (25)
NO_VOY_FLIGHT : Nomor Voy/Flight Y Free text (20)
TGL_TIBA : Perkiraan Tanggal Tiba Y format : yyyymmdd
NO_BC11 : Nomor BC1.1 (Manifest) Y format : AN(6)
TGL_BC11 : Tanggal BC1.1 (Manifest) Y format : yyyymmdd
NM_PEMOHON : Nama Pemohon PLP Free text (30)
ALASAN : Alasan Pembatalan PLP Freetext (200)

DETIL
Elemen Data Uraian Mandatory Value Keterangan
NO_CONT : Nomor Container Y (laut- Format : AAAANNNNNNN
Terminal
Cont)
UK_CONT : Ukuran Container Y (laut- 20; 40; 45
Terminal
Cont)

JNS_KMS : Jenis Kemasan Y Free text


JML_KMS : Jumlah Kemasan Y Number
NO_BL_AWB : Nomor BL/AWB Y Free text
TGL_BL_AWB : Tanggal BL/AWB Y Format : yyyymmdd
FL_SETUJU : Flag persetujuan permohonan/ pembatalan Y/T Respon :
Jika Y : setuju dipindahkan atau dibatalkan
Jika T : ditolak untuk dipindahkan atau dibatalkan

ix
C. Keterangan String XML GetDataOB
Elemen Data Uraian Mandatory Value Keterangan
KD_KANTOR : Kode Kantor tempat pengajuan PLP Standar BC (6 digit)
TIPE_DATA : Tipe data yang dikirimkan 1 : Baru
2 : Manual
NO_PLP : Nomor Persetujuan PLP Y Free text (30)
TGL_PLP : Tanggal Persetujuan PLP Y format : yyyymmdd
NO_BATAL_PLP : Nomor Persetujuan Pembatalan PLP Y Free text (30)
TGL_BATAL_PLP : Tanggal Persetujuan Pembatalan PLP Y format : yyyymmdd
KD_TPS_ASAL : Kode TPS Asal Y Standar BC (4 digit)

D. Kode Referensi Dokumen TPS Online


HEADER
Value
Elemen Data Uraian Keterangan
Kode Uraian
KD_DOK : Kode Dokumen Coari-Codeco 1 Coari Discarge Daftar Timbun Impor
2 Coari Loading Daftar Muat Ekspor
3 Codeco Impor Gate Out Impor Lini 1
4 Codeco Ekspor Gate In Ekspor Lini 1
5 Gate In Impor (Lini 2) Gate In Impor Lini 2
6 Gate Out Impor (Lini 2) Gate Out Impor Lini 2
7 Gate In Ekspor (Lini 2) Gate In Ekspor Lini 2
8 Gate Out Ekspor (Lini 2) Gate Out Ekspor Lini 2
9 Codeco Out Ekspor (Lini 1) Gate Out Ekspor Lini 1

x
DETIL
Value
Elemen Data Uraian Keterangan Segel
Kode Uraian
KD_DOK_INOUT : Kode dokumen untuk 1 SPPB PIB (BC 2.0) Impor
pengeluaran/pemasukkan barang 2 SPPB BC 2.3 Impor Y
3 Persetujuan PLP Impor
4 SPPB BC 1.2 Impor Y
5 BCF 2.6 A (pemeriksaan dilokasi importir / SPPF) Impor Y
6 NPE Ekspor Y
7 PKBE Ekspor
8 PPB Ekspor
9 BCF 1.5 (Pindah lokasi dari TPS ke TPP untuk Kontainer > 30 hari) Impor Y
10 Empty Container (Impor) Impor Y
11 SPPBE (Batal Ekspor Container Sdh Masuk TPS) Ekspor Y
12 SPPBE (Pindah Muat Barang Ekspor) Ekspor Y
13 PIBK Impor
14 Returnable Package (RP) Impor Y
15 Penimbunan di Luar Kawasan Pabean Impor Y
16 Persetujuan Short Shipp Impor Y
17 Persetujuan Part of (Impotir Mita) Impor Y
18 Persetujuan Part of (Importir Non-Mita) Impor Y
19 SPJM Impor
20 Dokumen BC 1.1.A / SP3B Impor Impor Y
21 Pengeluaran dengan PIB Manual (Cukai ) Impor
22 Paket Pos Impor Y
23 Pengeluaran Barang Untuk Dimusnahkan Impor Y

xi
24 Pengeluaran Barang Untuk Barang Bukti ke Pengadilan Impor Y

25 Pengeluaran Barang Hibah Impor Y


Pengeluaran Barang milik Negara dan Barang Tidak Dikuasai yang di
26 Impor
Lelang
27 Pengeluaran Barang Pers Release Impor Y
28 Re-Ekspor (BC 1.2) belum aju PIB Impor Y
29 Pengeluaran Barang eks Pergantian Kontainer Impor
30 Pengeluaran Barang Penegahan (Sebagian) Impor Y
31 Pengeluaran Barang Penegahan (Seluruhnya) Impor Y
32 Empty Container (Ekspor) Ekspor
33 Returnable Package (RP-Ekspor) Ekspor
34 Dokumen BC 1.1.B / SP3B Ekspor Ekspor Y
40 Pengeluaran Kontainer Eks Stripping Impor

xii
E. Kode Jenis Kemasan

KODE KODE KODE


URAIAN KEMASAN URAIAN KEMASAN URAIAN KEMASAN
KEMASAN KEMASAN KEMASAN
AE Aerosol CL Coil LG Log
AI Clamshell CM Card LT Lot
AJ Cone CN Container LZ Logs, in bundle/bunch/truss
AM Ampoule, non protected CO Carboy, non-protected MB Multiply bag
AP Ampoule, protected CP Carboy, protected MC milk crate
AT Atomizer CQ Cartridge MS Multiwall sack
AV Capsule CR Crate MT Mat
BA Barrel CS Case MX Macth box
BB Bobbin CT Carton NA Not available
BC Bottlecrate, bottlerack CU Cup NE Unpacked or unpackaged
BD Board CV Cover NS Nest
BE Bundle CW Cage, roll NT Net
BF Balloon, non-protected CX Can, cylindical OK Block
BG Bag CY Cylinder PA Packet
BH Bunch CZ Canvas PC Parcel
BI Bin DJ Demijohn, non-protected PF Pen
BJ Bucket DN Dispenser PG Plate
BK Basket DP Demijohn, protected PH Pitcher
BL Bale, compressed DR Drum PI Pipe
BM Basin EI Case, isothermic PJ Punnet
BN Bale, non -compressed EN Envelope PK Package
BO Bottle, non-protected, FC Fruit crate PL Pail
cylindrical
BP Balloon, protected FD Framed crate PN Plank
BQ Bottle, protected cylindrical FI Firkin PO Pouch
BR Bar FL Flask PR Receptacle
BS Bottle, non-protected, bulbous FO Footlocker PT Pot
BT Bolt FP Filmpack PU Tray pack
BU Butt FR Frame PX Pallet
BV Bottle, protected bulbous FT Foodtainer PY Plates, in bundle/bunch/truss
BX Box FW Cart, flatbed PZ Planks/Pipes, in
bundle/bunch/truss
BY Board, in bundle/bunch/truss GB Gas bottle RD Rod
BZ Bars, in bundle/bunch/truss GI Girder RG Ring
CA Can, rectangular GZ Girders, in RJ Rack, clothing hanger
bundle/bunch/truss
CB Beer crate HG Hogshead RK Rack
CC Churn HR Hamper RL Reel
CD Can, with handle and spout IN Ingot RO Roll
CE Creel IZ ingots, in bundle/bunch/truss RT Rednet
CF Coffer JC Jerrican, rectangular RZ Rods, in bundle/ bunch/truss
CG Cage JG Jug SA Sack
CH Chest JR Jar SB Slab
CI Canister JT Jutebag SC Shallow crate
CJ Coffin JY Jerrican, cylindrical SD Spindle
CK Cask KG Keg SE Sea-chest
KODE
URAIAN KEMASAN
KEMASAN
SH Sachet
SI Skid
SK Skeleton case
SL Slipsheet
SM Sheetmetal
SO Spool
ST Sheet
SU Suitcase
SW Shrinkwrapped
SY Sleeve
SZ Sheets, in bundle/bunch/truss
TB Tub
TC Tea-chest
TD Tube, collapsible
TI Tierce
TK Tank, rectangular
TN Tin
TO Tun
TP Tray
TR Trunk
TS Truss
TU Tube
TY Tank, cylindrical
TZ Tubes, in bundle/bunch/truss
UC Uncaged
VA Vat
VG Bulk, gas ( at 1031 mbar and 15C )
VI Vial
VK Vanpack
VL Bulk, liquid
VN Vehicle
VO Bulk, solid, large particles ("nodules")
VP Vacuumpacked
VQ Bulk, liquefied gas (at abnormal
temperature)
VR Bulk, solid, granular particles ("grains")
VY Bulk, solid, fine particles ("powders")
WB Wickerbottle

ii
F. Tabel Kode Jenis Satuan
Kode Kode Kode
Uraian Jenis Satuan Uraian Jenis Satuan Uraian Jenis Satuan
Satuan Satuan Satuan
AMP Ampere QTD Dry quart (1,101221 dm3) KTN Kilotonne
AMH Ampere-hour (3,6 kC) OZI Fluid ounce (29,5735 cm3) KVA Kilovolt - ampere
ARE Are (100m2) OZA Fluid ounce (29,5735 cm3) KWT Kilowatt
BAR Bar FOT Foot (0.3048 m) KWH Kilowatt-hour
BLL Barrel (petroleum) (458,987 dm3) GLI Gallon (4,546092 dm3) KNT Knot ( 1 n mile oer hour
BIL Billion GBQ Gigabecquerel GLL Liquid gallon (3,78541 dm3)
MLD Billion US GWH Gigawatt-hour (1 million KW/h) PTL Liquid Pint (0,473176 dm3)
BUA Bushel (35,2391 dm3) GII Gill (0,142065 dm3) QTL Liquid quart (0,946353 dm3)
BUI Bushel (36,36874 dm3) GIA Gill (11,8294 cm3) LTR Litre ( 1 dm3 )
CDL Candela GRN Grain GB,US (64,798910 mg) LPA Litre of pure alcohol
CCT Carrying capacity in metric GRM Gram LNT Long ton GB, US 2/ (1,0160469 t)
tonnes
CNT Cental GB (45,359237 kg) GGR Great gross (12 gross) CWI Long/ hundredweight GB (50,802345 kg)
CLT Centilitre GRO Gross LUM Lumen
CMT Centimetre GRT Gross (register) ton MAL Megalitre
DTN Centner, metric (100 kg) SAN Half year (six Months) MAM Megametre
WCD Cord (3,63 m3) HAR Hectare MVA Megavolt - ampere (1000 KVA)
COU Coulomb HBA Hectobar MAW Megawatt
CKG Coulomb per kilogram HGM Hectogram MW Megawatt-hour (1000 KW/h)
H
CMQ Cubic centimetre HLT Hectolitre MTR Metre
DMQ Cubic decimetre HPA Hectolitre of pure alcohol MSK Metre per second squared
FTQ Cubic foot HMT Hectometre CTM Metric carat (200 mg = 2.10-4 kg)
INQ Cubic inch HTZ Hertz TNE Metric ton (1000 kg)
MTQ Cubic metre HUR Hour MGM Milligram
MQH cubic metre per hour CEN Hundred MLT Millilitre
MMQ Cubic millimetre HIU Hundred intenational units MMT Millimetre
YDQ Cubic yard CNP Hundred packs MIO Million
DAY Day CWA Hundredweight, US (45,3592 kg) HMQ Million cubic metres
DBC Decade (ten years) INH Inch (2.54 mm) MIU Million international units
DAA Decare JOU Joule MIN Minute
DMT Decimetre KEL Kelvin MON Month
CEL Degree celcius KBA Kilobar NMI Nautical mile (1852 m)
FAH degree Fahrenheit KGM Kilogram NTT Net (regirter) ton
DPT Displecement tonnege KNS Kilogram of named substance NEW Newton
DZN Dozen KNI Kilogram of nitrogen NMB Number
DZP Dozen packs KPH Kilogram of potassium hydroxide NBB Number bobbins
(caustic potasn)
DPR Dozen pairs KPO Kilogram of potassium oxide NAR Number of articles
DRL Dozen rolls KSH Kilogram of sodium hydyoxide NIU Number of international units
(caustic soda)
DRM Drachm, GB (3,887935 g) KSD Kilogram of substance 90 per NMP Number of packs
cent dry
DRI Dram GB (1,771745 g) KUR Kilogram of uranium NPR number of pairs
DRA Dram US (3,887935 g) KMQ Kilogram per cubic meter NPL Number of parcels
BLD Dry barrel (115,627 dm3) KJO Kilojoule NPT Number of parts
GLD Dry gallon (4,404884 dm3) KMT Kilometre NRL Number of rolls
PTD Dry pint (0.55061 dm3) KMH Kilometre per hour OHM Ohm

iii
Kode Kode
Uraian Jenis Satuan Uraian Jenis Satuan
Satuan Satuan
ONZ Ounce GB,US (28,349523 g) LBT Troy pound, US 9373,242 g)
APZ Ounce GB,US (31,10348 g) VLT Volt
PAL Pascal WTT Watt
DWT Pennyweight GB,US (1,555174 g) WHR Watt-hour
PCE Piece WEB Weber
PTI Pint (0,568262 dm3) WEE Week
LBR Pound GB,US (0,45359237 kg) YRD Yard (0.9144 m)
PGL Proof gallon ANN Year
QTI Quart (1,136523 dm3) ACR Acre (4840 yd2)
QAN Quarter (of a year) KPP Kgm of phosphorus pentoxide(phosphoric anhydride
QTR Quarter GB (12,700586 kg) CUR Curie
RPM Revolution per minute BQL Becquerel
RPS Revolution per second KGS Kilogram Per Second
SCO Score
SCR Scruple GP,US (1,295982 g)
SEC Second
SET Set
SHT Shipping ton
SST Short standard (7200 matches )
STN Short ton GB, US 2/ (0,90718474 t)
SIE Siemens
CMK Square centimetre
DMK Square decimetre
FTK Square foot
INK Square inch
KMK Square kilometre
MTK Square metre
MIK Square mile
MMK Square millimetre
YDK Square yard
WSD Standard
ATM Standard atmosphere (101325 Pa)
SMI Statute mile (1609.344 m)
STI Stone GB (6,350293 kg)
ATT Technical atmosphere (98066,5
Pa)
DAD Ten day
TPR Ten pairs
MID Thousand
TAH Thousand ampere-hour
TQD thousand cubic metres per day
TSH Ton of steam per hour
TSD Tonne of subtance 90 per cent dry
TRL Trillion Eur

iv
G. Tabel Kode Respon

KD_RES URAIAN Keterangan


jika username dan password tidak sesuai dengan
001 User Tidak Dikenal
data user pada DJBC
Validasi XML anda jika string XML yang dikirimkan tidak sesuai dengan
002
tidak benar schema XML yang ada pada DJBC
jika string XML yang dikirimkan benar secara
003 Proses Berhasil schema dan data dapat masuk ke dalam database
DJBC
Jika Kode TPS yang diberitahukan tidak terdaftar
004 Kode TPS tidak benar
dalam database TPS Online
Kode Gudang/
Jika Kode Gudang TPS yang diberitahukan tidak
005 Lapangan TPS Asal
terdaftar dalam database TPS Online
tidak benar
Kode TPS Tujuan Jika Kode TPS Tujuan yang diberitahukan tidak
006
tidak Benar terdaftar dalam database TPS Online
Kode
Gudang/Lapangan Jika Kode Gudang TPS Tujuan yang diberitahukan
007
TPS Tujuan tidak tidak terdaftar dalam database TPS Online
benar
Data BC.1.1 Tidak Jika data BC.1.1 yang tidak diberitahukan tidak
008
Benar benar
Jika data tidak dapat disimpan kedalam database
009 Gagal Insert Detil
TPS Online
010 Data tidak ditemukan
User Tidak Berhak Jika User mengambil data yang bukan data
011
mengambil data ini lapangan atau gudang tujuannya.
012 Belum ada data baru
Jika Gate Out atau Gate In, informasi Kode
Dokumen Inout Tidak
013 dokumen, nomor dokumen dan tanggal dokumen
Lengkap
inout tidak terisi
Dokumen PLP tidak Untuk TPS Lini 2 jika gate in tidak memberitahukan
014
ditemukan nomor dan tanggal PLP dengan benar
015 Bruto kosong Informasi bruto tidak diisi
Waktu In Out tidak Waktu Inout lebih besar dari waktu rekam atau
016
valid kosong

v
Contact Persons

Jika ada yang tidak sesuai antara PIA TPS Online dengan Web Service silakan
hubungi kami di nomor berikut :
1. DIKC : 021-4890308
2. Fitria : 08561179879
e-mail : - fitria@customs.go.id
- fitri.humam@gmail.com
3. Adhiguno : 08156808935
e-mail : - ks.adhiguno@customs.go.id
- adhi2n2@gmail.com

vi

Anda mungkin juga menyukai