PEDOMAN INTEGRASI APLIKASI BARANG KIRIMAN. Disiapkan Dalam Rangka Implementasi Sistem Barang Kiriman. Versi 1.4

(1)

PEDOMAN INTEGRASI APLIKAS I

BARANG KIRIMAN

Disiapkan

Dalam Rangka Implementasi Sistem Barang Kiriman

Versi 1.4

DIREKTORAT JENDERAL BEA DAN CUKAI

2016

(2)

DAFTAR ISI

BARANG KIRIMAN ... 1

PENDAHULUAN ... 2

DASAR HUKUM ... 3

BARANG KIRIMAN ... 4

A. Definisi ... 4

B. Tujuan Pengembangan ... 4

C. Cara Koneksi Web Service ... 4

D. Kebutuhan Sistem ... 5

DAFTAR WEB SERVICE ... 6

A. Service Untuk Mengirim Data Dokumen Consignment Note dan PIBK ... 6

LAMPIRAN ... i

A. Penjelasan Skema Pertukaran Data Consignment Note (CN) - PIBK ... i

B. Kode Referensi Jenis AJU ... iv

C. Kode Referensi Jenis PIBK ... iv

D. Kode Referensi Kantor ... Error! Bookmark not defined.

E. Kode Referensi Gudang ... Error! Bookmark not defined.

F. Kode Referensi Jenis Pengangkut ... Error! Bookmark not defined.

G. Kode Pelabuhan Dalam Negeri ... Error! Bookmark not defined.

H. Kode Referensi Pungutan... i

I. Kode Referensi Jenis Tarif ... i

J. Kode Referensi Negara ... Error! Bookmark not defined.

L. Kode Referensi Jenis Identitas ... Error! Bookmark not defined.

M. Kode Referensi Jenis Kemasan... Error! Bookmark not defined.

N. Kode Referensi Valuta ... Error! Bookmark not defined.

Contact Persons ... ii

(3)

PENDAHULUAN

Pedoman Integrasi Aplikasi (PIA) Barang Kiriman merupakan salah satu referensi

utama dalam pertukaran data antara DJBC dengan Penyelenggara Pos 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

Penyelenggara Pos, khususnya menyangkut struktur String XML yang perlu disiapkan di sisi

Aplikasi Barang Kiriman.

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.

(4)

DASAR HUKUM

Yang menjadi dasar pengembangan Web Service Aplikasi Barang Kiriman yaitu :

1. Rancangan Peraturan Menteri Keuangan tentang Barang Kiriman;

(5)

BARANG KIRIMAN

A. Definisi

Aplikasi Barang Kiriman adalah media atau sarana untuk melakukan pertukaran data

secara elektronik antara DJBC dengan Penyelenggara Pos, memantau pergerakan

barang serta memantau penyelesaian impor barang kiriman. 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 Barang Kiriman merupakan suatu web service yang dishare dan

bertujuan untuk menjembatani penyamaan format informasi antara masukan/keluaran

Aplikasi Internal Pos/PJT dengan Application Server Barang Kiriman. Dalam hal ini

integrasi sistem perlu didukung oleh suatu aplikasi interface, sehingga transaksi dokumen,

pengiriman maupun penerimaan akan berlangsung transparan.

B. Tujuan Pengembangan

Web Service Barang Kiriman mempunyai fungsi sebagai berikut:

1. Untuk melakukan pertukaran data antara Penyelenggara Pos dan DJBC.

2. Sistem monitoring pelayanan impor barang kiriman.

3. Sistem Monitoring Pergerakan Barang.

C. Cara Koneksi Web Service

Untuk Web Service Definition Language (WSDL) dari service ini dapat dilihat pada alamat

: https://esbbcext01.beacukai.go.id:9082/WSBarangKiriman?wsdl

Koneksi ke Web Service Sistem Barang Kiriman 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:

(6)

Pada window diatas dapat dilihat, ketika ingin mengakses portal BCWS perlu menginstal

certificate, klik tombol Yes, maka certificate telah terinstal dan web service dapat dilihat.

Ada 3 parameter yang digunakan dalam web service barang kiriman ini, yaitu :

parameter 1 : XML dalam bentuk string

parameter 2 : String gabungan

Username^$Password

parameter 3 : Token yang diberikan oleh DJBC

Untuk sementara (dalam tahap uji coba), parameter ini belum di-hash / dilengkapi dengan

security yang memadai.

schemaLocation="[disesuaikan dengan path lokasi xsd]WSBarangKiriman.xsd"

soap:address location=

https://esbbcext01.beacukai.go.id:9082/BarangKirimanPublic/WSBarangKiriman?wsdl

*Contoh tester untuk Bahasa pemrograman JAVA dan PHP (PHP versi 5.6 dan

sebelumnya) ada di attachment email

respon balikan dalam bentuk string XML

D. Kebutuhan Sistem

Sistem minimum requirement yang dibutuhkan untuk mengakses Barang Kiriman 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,

(7)

 Memory minimum 128 Mb. Rekomendasi adalah lebih dari 256 Mb,

 Mouse,

 Monitor 17 inch dengan VGA card 256 warna pada resolusi 1024 x 768,

 Printer.

 Aplikasi integrasi yang telah di bangun sendiri oleh penyelenggara pos

DAFTAR WEB SERVICE

A. Service Untuk Mengirim Data Dokumen Consignment Note dan PIBK

Service ini digunakan untuk melaporkan data impor barang kiriman melalui dokumen

Consignment Note dan PIBK. Adapun service yang dapat digunakan adalah per jenis

transaksi barang, berikut services nya :

1. Nama Service : WSBarangKiriman

Nama Method : kirimData

Service ini berfungsi untuk mengirim data impor barang kiriman dengan dokumen

Consignment Note (CN) atau Pemberitahuan Impor Barang Khusus (PIBK).

Bentuk contoh skema XML REQUESTnya menjadi :

<CN_PIBK> <HEADER> <JNS_AJU></JNS_AJU> <KD_JNS_PIBK></KD_JNS_PIBK> <NO_BARANG></NO_BARANG> <KD_KANTOR>040600</KD_KANTOR> <KD_JNS_ANGKUT>2</KD_JNS_ANGKUT> <NM_PENGANGKUT>BATAVIA AIR</NM_PENGANGKUT> <NO_FLIGHT>GA795</NO_FLIGHT> <KD_PEL_MUAT>BRQJD</KD_PEL_MUAT> <KD_PEL_BONGKAR>IDPUM</KD_PEL_BONGKAR> <KD_GUDANG>CGK01</KD_GUDANG> <NO_INVOICE>040600150082871</NO_INVOICE> <TGL_INVOICE>2016/11/18</TGL_INVOICE> <KD_NEGARA_ASAL>CN</KD_NEGARA_ASAL> <JML_BRG>5500</JML_BRG> <NO_BC11>123456NBHE</NO_BC11> <TGL_BC11>2016/11/18</TGL_BC11> <NO_POS_BC11>4321</NO_POS_BC11> <NO_SUBPOS_BC11>4321</NO_SUBPOS_BC11> <NO_SUBSUBPOS_BC11>4321</NO_SUBSUBPOS_BC11> <NO_MASTER_BLAWB>123456NBHE</NO_MASTER_BLAWB> <TGL_MASTER_BLAWB>2016/11/18</TGL_MASTER_BLAWB> <NO_HOUSE_BLAWB>0123456NBHE</NO_HOUSE_BLAWB> <TGL_HOUSE_BLAWB>2016/11/18</TGL_HOUSE_BLAWB> <KD_NEG_PENGIRIM>HK</KD_NEG_PENGIRIM>

<NM_PENGIRIM>LATITUDE MACHINERY CORP.</NM_PENGIRIM>

<AL_PENGIRIM>NO.154, SECTION 1, SHIN-HWA ROAD, SHIN-WU SHIANG,</AL_PENGIRIM> <JNS_ID_PENERIMA>5</JNS_ID_PENERIMA>

<NO_ID_PENERIMA>064050127607500</NO_ID_PENERIMA> <NM_PENERIMA>ERWINSYAH GIRSANG</NM_PENERIMA>

<AL_PENERIMA>METRO ATOM PLAZA LT.3 BKS 10, PASAR BARU</AL_PENERIMA> <TELP_PENERIMA>012345679324</TELP_PENERIMA>

(8)

<NO_ID_PEMBERITAHU>640501276075000</NO_ID_PEMBERITAHU> <NM_PEMBERITAHU>ERWINSYAH GIRSANG</NM_PEMBERITAHU>

<AL_PEMBERITAHU>METRO ATOM PLAZA LT.3 BKS 10, PASAR BARU</AL_PEMBERITAHU> <NO_IZIN_PEMBERITAHU>12345679324</NO_IZIN_PEMBERITAHU> <TGL_IZIN_PEMBERITAHU>2016/11/18</TGL_IZIN_PEMBERITAHU> <KD_VAL>USD</KD_VAL> <NDPBM>13200.1234</NDPBM> <FOB>5500000000000000.22</FOB> <ASURANSI>2500000000.24</ASURANSI> <FREIGHT>3000000000.22</FREIGHT> <CIF>6500000000000.22</CIF> <NETTO>3000000000000.22</NETTO> <BRUTO>3250000000000.44</BRUTO> <TOT_DIBAYAR>5000000000000.22</TOT_DIBAYAR> <NPWP_BILLING>012345678901234</NPWP_BILLING> <NAMA_BILLING>ERNAWAN</NAMA_BILLING> <HEADER_PUNGUTAN> <PUNGUTAN_TOTAL> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>10000000000000000</NILAI> </PUNGUTAN_TOTAL> <PUNGUTAN_TOTAL> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>10000000000000000</NILAI> </PUNGUTAN_TOTAL> </HEADER_PUNGUTAN> <DETIL> <BARANG> <SERI_BRG>1</SERI_BRG> <HS_CODE>031011119999</HS_CODE> <UR_BRG>Amphetamine Sulfat</UR_BRG> <KD_NEG_ASAL>TH</KD_NEG_ASAL> <JML_KMS>120000</JML_KMS> <JNS_KMS>BX</JNS_KMS> <CIF>6500000000.22</CIF> <KD_SAT_HRG>KGM</KD_SAT_HRG> <JML_SAT_HRG>120000</JML_SAT_HRG> <FL_BEBAS></FL_BEBAS> <NO_SKEP></TGL_SKEP > <TGL_SKEP></TGL_SKEP> <DETIL_PUNGUTAN> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>1000000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>100022</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> <DETIL_PUNGUTAN> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>1000000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>105000</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> </BARANG> <BARANG> <SERI_BRG>2</SERI_BRG> <HS_CODE>031011119999</HS_CODE> <UR_BRG>Amphetamine Sulfat</UR_BRG> <KD_NEG_ASAL>TH</KD_NEG_ASAL> <JML_KMS>120000</JML_KMS> <JNS_KMS>BX</JNS_KMS> <CIF>6500000000.22</CIF> <KD_SAT_HRG>KGM</KD_SAT_HRG> <JML_SAT_HRG>12000000</JML_SAT_HRG>

(9)

<FL_BEBAS></FL_BEBAS> <NO_SKEP></TGL_SKEP > <TGL_SKEP></TGL_SKEP> <DETIL_PUNGUTAN> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>100000000.24</NILAI> <JNS_TARIF>1</JNS_TARIF> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>100022</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> <DETIL_PUNGUTAN> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>100000000.24</NILAI> <JNS_TARIF>1</JNS_TARIF> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>10500</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> </BARANG> </DETIL> </HEADER> <HEADER> <JNS_AJU></JNS_AJU> <KD_JNS_PIBK></KD_JNS_PIBK> <NO_BARANG></NO_BARANG> <KD_KANTOR>040600</KD_KANTOR> <KD_JNS_ANGKUT>2</KD_JNS_ANGKUT> <NM_PENGANGKUT>BATAVIA AIR</NM_PENGANGKUT> <NO_FLIGHT>GA795</NO_FLIGHT> <KD_PEL_MUAT>BRQJD</KD_PEL_MUAT> <KD_PEL_BONGKAR>IDPUM</KD_PEL_BONGKAR> <KD_GUDANG>CGK01</KD_GUDANG> <NO_INVOICE>040600150082871</NO_INVOICE> <TGL_INVOICE>2016/11/18</TGL_INVOICE> <KD_NEGARA_ASAL>CN</KD_NEGARA_ASAL> <JML_BRG>5500</JML_BRG> <NO_BC11>123456NBHE</NO_BC11> <TGL_BC11>2016/11/18</TGL_BC11> <NO_POS_BC11>4321</NO_POS_BC11> <NO_SUBPOS_BC11>4321</NO_SUBPOS_BC11> <NO_SUBSUBPOS_BC11>4321</NO_SUBSUBPOS_BC11> <NO_MASTER_BLAWB>123456NBHE</NO_MASTER_BLAWB> <TGL_MASTER_BLAWB>2016/11/18</TGL_MASTER_BLAWB> <NO_HOUSE_BLAWB>0123456NBHE</NO_HOUSE_BLAWB> <TGL_HOUSE_BLAWB>2016/11/18</TGL_HOUSE_BLAWB> <KD_NEG_PENGIRIM>HK</KD_NEG_PENGIRIM>

<NM_PENGIRIM>LATITUDE MACHINERY CORP.</NM_PENGIRIM>

<AL_PENGIRIM>NO.154, SECTION 1, SHIN-HWA ROAD, SHIN-WU SHIANG,</AL_PENGIRIM> <JNS_ID_PENERIMA>5</JNS_ID_PENERIMA>

<NO_ID_PENERIMA>064050127607500</NO_ID_PENERIMA> <NM_PENERIMA>ERWINSYAH GIRSANG</NM_PENERIMA>

<AL_PENERIMA>METRO ATOM PLAZA LT.3 BKS 10, PASAR BARU</AL_PENERIMA> <TELP_PENERIMA>012345679324</TELP_PENERIMA>

<JNS_ID_PEMBERITAHU>5</JNS_ID_PEMBERITAHU>

<NO_ID_PEMBERITAHU>640501276075000</NO_ID_PEMBERITAHU> <NM_PEMBERITAHU>ERWINSYAH GIRSANG</NM_PEMBERITAHU>

<AL_PEMBERITAHU>METRO ATOM PLAZA LT.3 BKS 10, PASAR BARU</AL_PEMBERITAHU> <NO_IZIN_PEMBERITAHU>12345679324</NO_IZIN_PEMBERITAHU> <TGL_IZIN_PEMBERITAHU>2016/11/18</TGL_IZIN_PEMBERITAHU> <KD_VAL>USD</KD_VAL> <NDPBM>13200.1234</NDPBM> <FOB>5500000000000000.22</FOB> <ASURANSI>2500000000.24</ASURANSI> <FREIGHT>3000000000.22</FREIGHT>

(10)

<CIF>6500000000000.22</CIF> <NETTO>3000000000000.22</NETTO> <BRUTO>3250000000000.44</BRUTO> <TOT_DIBAYAR>5000000000000.22</TOT_DIBAYAR> <NPWP_BILLING>012345678901234</NPWP_BILLING> <NAMA_BILLING>ERNAWAN</NAMA_BILLING> <HEADER_PUNGUTAN> <PUNGUTAN_TOTAL> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>10000000000000000</NILAI> </PUNGUTAN_TOTAL> <PUNGUTAN_TOTAL> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>10000000000000000</NILAI> </PUNGUTAN_TOTAL> </HEADER_PUNGUTAN> <DETIL> <BARANG> <SERI_BRG>1</SERI_BRG> <HS_CODE>031011119999</HS_CODE> <UR_BRG>Amphetamine Sulfat</UR_BRG> <KD_NEG_ASAL>TH</KD_NEG_ASAL> <JML_KMS>120000</JML_KMS> <JNS_KMS>BX</JNS_KMS> <CIF>6500000000.22</CIF> <KD_SAT_HRG>KGM</KD_SAT_HRG> <JML_SAT_HRG>120000</JML_SAT_HRG> <FL_BEBAS></FL_BEBAS> <NO_SKEP></TGL_SKEP > <TGL_SKEP></TGL_SKEP> <DETIL_PUNGUTAN> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>1000000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>100022</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> <DETIL_PUNGUTAN> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>1000000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>105000</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> </BARANG> <BARANG> <SERI_BRG>2</SERI_BRG> <HS_CODE>031011119999</HS_CODE> <UR_BRG>Amphetamine Sulfat</UR_BRG> <KD_NEG_ASAL>TH</KD_NEG_ASAL> <JML_KMS>120000</JML_KMS> <JNS_KMS>BX</JNS_KMS> <CIF>6500000000.22</CIF> <KD_SAT_HRG>KGM</KD_SAT_HRG> <JML_SAT_HRG>12000000</JML_SAT_HRG> <FL_BEBAS></FL_BEBAS> <NO_SKEP></TGL_SKEP > <TGL_SKEP></TGL_SKEP> <DETIL_PUNGUTAN> <KD_PUNGUTAN>1</KD_PUNGUTAN> <NILAI>100000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>100022</JML_SAT> <TARIF>7.5</TARIF>

(11)

</DETIL_PUNGUTAN> <DETIL_PUNGUTAN> <KD_PUNGUTAN>2</KD_PUNGUTAN> <NILAI>100000000.24</NILAI> <KD_TARIF>1</KD_TARIF> <KD_SAT_TARIF>1</KD_SAT_TARIF> <JML_SAT>10500</JML_SAT> <TARIF>7.5</TARIF> </DETIL_PUNGUTAN> </BARANG> </DETIL> </HEADER> </CN_PIBK>

Dari schema diatas dapat dijelaskan sebagai berikut :

Xml namenya yaitu xmlns="CN_PIBK.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 CN_PIBK.xsd

yang ada di service DJBC.

Keterangan dari Isi element <HEADER> sebagai berikut :

Nama Element Panjang

Karakter Keterangan

JNS_AJU 1 Element yang berisi kode jenis AJU. Kode

terlampir

KD_JNS_PIBK 1 Element yang berisi kode jenis PIBK. Kode terlampir

NO_BARANG 13 Element yang berisi Nomor Barang (Kombinasi

angka dan huruf)

KD_KANTOR 6 Element yang berisi Kode Kantor. Kode

terlampir

KD_JNS_ANGKUT 1 Element yang berisi Kode Jenis Angkut. Kode terlampir

NM_PENGANGKUT 100 Element yang berisi Nama Pengangkut

NO_FLIGHT 10 Element yang berisi Nomor Penerbangan

(Berubah dari sebelumnya 5 digit)

KD_PEL_MUAT 5 Element yang berisi Kode Pelabuhan Muat

KD_PEL_BONGKAR 5 Element yang berisi Kode Pelabuhan Bongkar

KD_GUDANG 4 Element yang berisi Kode Gudang

NO_INVOICE 20 Element yang berisi Nomor Invoice

KD_NEGARA_ASAL 5 Element yang berisi Kode Negara Asal

JML_BRG 8 Element yang berisi Jumlah Barang

NO_BC11 29 Element yang berisi Nomor Dokumen BC 1.1 (Manifest)

(12)

TGL_BC11 10

Element yang berisi data tanggal Dokumen BC 1.1 (Manifest). penulisan dengan format “yyyy/mm/dd” (yyyy: tahun, mm : bulan, dd : tanggal)

NO_POS_BC11 4 Element yang berisi data Nomor Pos BC 1.1 NO_SUBPOS_BC11 4 Element yang berisi data Nomor Sub Pos BC

1.1 (jika ada)

NO_SUBSUBPOS_BC11 4 Element yang berisi data Nomor Sub Sub Pos BC 1.1 (jika ada)

NO_MASTER_BLAWB 30 Element yang berisi data Nomor Master BL/AWB

TGL_MASTER_BLAWB 8 Element yang berisi data Tanggal Master BL/AWB

NO_HOUSE_BLAWB 30 Element yang berisi data Nomor House BL/AWB

TGL_HOUSE_BLAWB 8 Element yang berisi data tanggal House BL/AWB

KD_NEG_PENGIRIM 2 Element yang berisi data kode Negara Pengirim NM_PENGIRIM 60 Element yang berisi data Nama Pengirim AL_PENGIRIM 200 Element yang berisi data Alamat Pengirim JNS_ID_PENERIMA 1 Element yang berisi data Jenis ID Penerima NO_ID_PENERIMA 30 Element yang berisi data Nomor ID Penerima

NM_PENERIMA 60 Element yang berisi data Nama Penerima

AL_PENERIMA 200 Element yang berisi data Alamat Penerima TELP_PENERIMA 20 Element yang berisi data Telp Penerima JNS_ID_PEMBERITAHU 1 Element yang berisi data jenis ID Pemberitahu NO_ID_PEMBERITAHU 30 Element yang berisi data NPWP Penyelenggara

Pos / PJT

NM_PEMBERITAHU 200 Element yang berisi data Nama Penyelenggara Pos / PJT

AL_PEMBERITAHU 200 Element yang berisi data Alamat

Penyelenggara Pos / PJT

NO_IZIN_PEMBERITAHU 100 Element yang berisi data Nomor Izin Pemberitahu (NPPPJK)

TGL_IZIN_PEMBERITAHU 8 Element yang berisi data Tanggal Izin Pemberitahu (NPPPJK)

KD_VAL 3 Element yang berisi Kode Valuta Asing (Harus

(13)

NDPBM (9, 4) Element yang berisi data NDPBM kurs pada saat pengajuan

FOB (18, 2) Element yang berisi data Nilai total FOB

ASURANSI (14, 2) Element yang berisi data Nilai Asuransi FREIGHT (16, 2) Element yang berisi data Nilai Freight CIF (18, 2) Element yang berisi data Nilai total CIF NETTO (18, 4) Element yang berisi data Jumlah Berat Netto BRUTO (18, 4) Element yang berisi data Jumlah Berat Bruto

TOT_DIBAYAR (15, 2)

Element yang berisi data Total Pembayaran Bea Masuk dan Pajak – pajak dalam rangka impor

KD_GUDANG 8 Kode gudang tempat barang dibongkar /

ditimbun

NPWP_BILLING 15

Diisi NPWP penerima barang (dalam hal ada permintaan dari penerima / pemilik barang). Jika tidak ada diisi ‘000000000000000’

NAMA_BILLING 50

Diisi NPWP penerima barang (dalam hal ada permintaan dari penerima / pemilik barang). Jika tidak ada diisi ‘-‘

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

Karakter

Keterangan

KD_PUNGUTAN 1 Element yang berisi Kode Pungutan, kode terlampir (Berubah dari sebelumnya 8 karakter)

NILAI (22, 2) Element yang berisi Nilai Pungutan

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

Karakter Keterangan

SERI_BRG 6 Element yang berisi data Seri Barang ke-berapa dari total keseluruhan jenis barang

HS_CODE 12 Element yang berisi data Kode HS

UR_BRG 140 Element yang berisi data Uraian Barang

KD_NEG_ASAL 2 Element yang berisi Kode Negara Asal, Kode Terlampir

JML_KMS 6 Element yang berisi data Jumlah Kemasan atas

(14)

JNS_KMS 2 Element yang berisi data Jenis Kemasan, Kode Terlampir

CIF 12 Element yang berisi data CIF

KD_SAT_HRG 3 Element yang berisi Kode Satuan yang

menentukan harga (Satuan yang digunakan untuk perkalian harga satuan)

JML_SAT_HRG 6 Element yang berisi Harga Satuan Barang (jumlah satuan yang digunakan untuk perkalian harga satuan)

FL_BEBAS ₁ _{Elemen BOOLEAN sebagai flag pembebasan}

(0=Bayar, 1=Bebas)

NO_SKEP 30 Element yang berisi data nomor SKep Pembebasan (jika ada SKep Pembebasan)

TGL_SKEP 8 Tanggal SKep Pembebasan (jika ada SKep Pembebasan)

KD_TARIF = 1: advalorum, 2: spesifik

KD_SAT_TARIF = hanya diisi apabila spesifik (per-kilo, per-liter)

JML_SAT = hanya diisi apabila spesifik (jumlah kilo, jumlah liter)

TARIF = advalorum diisi prosentase BM (2.5%, 5% dll) , jika spesifik diisi nilai satuan

(1.000 rupiah per-kilo, 5.000 rupiah per liter)

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

Karakter Keterangan

KD_PUNGUTAN 1 Element yang berisi data Kode Pungutan, Kode Terlampir (Sebelumnya 8 digit String)

NILAI (22, 2) Element yang berisi data Nilai Pungutan

KD_TARIF 1 Element yang berisi Kode Tarif

KD_SAT_TARIF 20 Element yang berisi Kode Satuan Tarif

JML_SAT 6 Element yang berisi data Jumlah Satuan Tarif

(15)

Bentuk skema XML RESPONSE-nya dari method di atas adalah sebagai berikut

(Respon Umum) :

<CN_PIBK> <HEADER> <NO_BARANG> </NO_BARANG> <TGL_HOUSE_BLAWB> </TGL_HOUSE_BLAWB> <KD_RESPON> </KD_RESPON> <KET_RESPON> </KET_RESPON> <WK_REKAM> </WK_REKAM> </HEADER> </CN_PIBK>

2. Nama Method : updateBC11

Service ini berfungsi untuk mengupdate data BC1.1 yang pada pengajuan sebelumnya

masih kosong, khusus untuk pengajuan Pemberitahuan Impor Barang Khusus (PIBK).

Bentuk skema XML REQUESTnya adalah sebagai berikut :

<PIBK_UPDATE> <HEADER> <NO_BARANG>123456789012345</NO_BARANG> <TGL_HOUSE_BLAWB>2016/06/08</TGL_HOUSE_BLAWB> <NO_BC11>123456NBHE</NO_BC11> <TGL_BC11>2016/11/18</TGL_BC11> <NO_POS_BC11>0123</NO_POS_BC11> <NO_SUBPOS_BC11>0123</NO_SUBPOS_BC11> <NO_SUBSUBPOS_BC11>0123</NO_SUBSUBPOS_BC11> </HEADER> </PIBK_UPDATE>

dengan format XSD sebagai berikut :

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"

attributeFormDefault="unqualified" elementFormDefault="qualified"> <xs:element name="PIBK_UPDATE">

<xs:complexType> <xs:sequence>

<xs:element name="HEADER"> <xs:complexType>

<xs:sequence>

<xs:element type="xs:long" name="NO_BARANG"/>

<xs:element type="xs:string" name="TGL_HOUSE_BLAWB"/> <xs:element type="xs:string" name="NO_BC11"/>

<xs:element type="xs:string" name="TGL_BC11"/> <xs:element type="xs:byte" name="NO_POS_BC11"/> <xs:element type="xs:byte" name="NO_SUBPOS_BC11"/> <xs:element type="xs:byte" name="NO_SUBSUBPOS_BC11"/> </xs:sequence> </xs:complexType> </xs:element> </xs:sequence> </xs:complexType> </xs:element> </xs:schema>

(16)

Bentuk skema XML RESPONSE-nya dari method di atas adalah sebagai berikut :

<PIBK_UPDATE > <HEADER> <NO_BARANG> </NO_BARANG> <TGL_HOUSE_BLAWB> </TGL_HOUSE_BLAWB> <KD_RESPON> </KD_RESPON> <KET_RESPON> </KET_RESPON> <WK_REKAM> </WK_REKAM> </HEADER> </PIBK_UPDATE >

3. Nama Method : getSemuaRespon

Service ini berfungsi untuk request semua respon yang belum pernah diambil

sebelumnya dengan parameter NPWP penyelenggara pos data impor barang kiriman

dengan dokumen Consignment Note (CN) atau Pemberitahuan Impor Barang Khusus

(PIBK). Format request untuk method ini tidak menggunakan XML REQUEST tetapi

hanya

string

yang

digunakan

untuk

memanggil

method

yaitu

:

Username^$Password^$NPWP

Format response XML RESPONSE dari method ini adalah sebagai berikut :

Sedangkan elemen data yang akan terisi untuk setiap jenis respon adalah sebagai berikut

-

Secara umum, respon akan menampilkan data sebagai berikut :

(17)

-

Jika kode status 304 (NPBL) / 306 (SPBL) , tag XML yang terisi adalah sebagai

berikut :

-

Jika kode status 303 (Terbit Billing), tag XML yang terisi adalah sebagai berikut :

-

Jika kode status 404 & 403, tag XML yang terisi adalah sebagai berikut :

ELEMEN DATA Surat Persetujuan Pengeluaran Barang (SPPB) / Persetujuan

Keluar

(18)

-

Jika kode status 401 (SPPBMCP) tag, XML yang terisi adalah sebagai berikut :

-

Jika kode status SPTNP (402) tag, XML yang terisi adalah sebagai berikut :

Nama Elemen

Panjang

Karakter

Keterangan

NO_BARANG

₁₃

Element yang berisi Nomor Barang _{(Kombinasi angka dan huruf)}

TGL_HOUSE_BLAWB

10

Element yang berisi data tanggal House BL/AWB. penulisan dengan format

“yyyy/mm/dd” (yyyy: tahun, mm : bulan, dd : tanggal)

KD_RESPON

2 Element yang berisi data kode respon

mengenai status terakhir dari dokumen

pengajuan CN / PIBK (daftar kode respon

ada di PIA ini)

KET_RESPON

100 Element yang berisi keterangan detil atas

kode respon dokumen CN / PIBK

WK_REKAM

₁₆

Element yang berisi waktu respon tersebut _{dibuat oleh sistem atau pejabat bea dan cukai}

KD_KANTOR

₆

Element yang berisi Kode Kantor. Kode _terlampir

NO_PIBK

9

Nomor pendaftaran PIBK dari kantor

bersangkutan (hanya ada apabila BC11 sudah valid dan billing sudah dibayar)

TGL_PIBK

8

Tanggal pendaftaran PIBK dari kantor

bersangkutan (hanya ada apabila BC11 sudah valid dan billing sudah dibayar)

NO_SPBL

9

Nomor Surat Penetapan Barang

(19)

apabila PDTT/Kasubsi Hanggar menetapkan barang ybs sebagai barang yang terkena lartas

TGL_SPBL ₈ Tanggal SPBL

NO_SPPBMCP

9

Nomor Surat Penetapan Pembayaran Bea Masuk, Cukai dan/atau Pajak (hanya ada apabila CN telah ditetapkan oleh PDTT/Kasubsi Hanggar)

TGL_SPPBMCP ₈ Tanggal SPPBMCP

KODE_BILLING

9

Nomor Kode Billing (hanya terbit ketika CN sudah ada SPPBMCP dan PIBK pada saat selesai

divalidasi/selesai AP atau PIBK pada saat terbit SPTNP)

TOTAL_BILLING

(22, 2)

Nilai rupiah total billing yang harus dibayar atas barang kiriman sebelum tanggal jatuh tempo NO_SPTNP

9

Nomor Surat Penetapan Tarif dan/atau Nilai Pabean (untuk PIBK yang ditetapkan kurang/lebih bayar oleh PDTT/Kasubsi Hanggar)

TGL_SPTNP 8 Tanggal SPTNP

NO_SPPB ₉ Nomor Surat Persetujuan Pengeluaran Barang

TGL_SPPB ₈ Tanggal SPPB

SERI_BRG

₆

Element yang berisi data Seri Barang ke-_{berapa dari total keseluruhan jenis barang}

UR_BRG

140 Element yang berisi data Uraian Barang

KET_LARTAS

500 Element yang berisi keterangan mengenai

ketentuan lartas apa saja yang wajib

dipenuhi atas seri barang yang

bersangkutan

NILAI_SPTNP

_(22,2)

Nilai selisih total lebih semua jenis pungutan _{(antara yang diberitahukan dan ditetapkan)}

4. Nama Method : getResponseByNomorTanggal

Service ini berfungsi untuk request respon atas pengajuan CN / PIBK secara spesifik

dengan parameter NO_BARANG dan TGL_HOUSE_BLAWB.

Bentuk skema XML REQUESTnya adalah sebagai berikut :

<CEK_STATUS> <HEADER> <NO_BARANG>123456789012345</NO_BARANG> <TGL_HOUSE_BLAWB>2016/06/08</TGL_HOUSE_BLAWB> <NO_BC11>123456NBHE</NO_BC11> <TGL_BC11>2016/11/18</TGL_BC11> <NO_POS_BC11>0123</NO_POS_BC11> <NO_SUBPOS_BC11>0123</NO_SUBPOS_BC11> <NO_SUBSUBPOS_BC11>0123</NO_SUBSUBPOS_BC11> </HEADER> </CEK_STATUS>

Bentuk skema XML RESPONSE-nya dari method di atas adalah sebagai berikut :

<CEK_STATUS > <HEADER> <NO_BARANG> </NO_BARANG> <TGL_HOUSE_BLAWB> </TGL_HOUSE_BLAWB> <KD_RESPON> </KD_RESPON> <KET_RESPON> </KET_RESPON> <WK_REKAM> </WK_REKAM>

(20)

</HEADER> </CEK_STATUS >

(21)

(22)

A. Penjelasan Skema Pertukaran Data Consignment Note (CN) - PIBK

HEADER

Elemen Data Uraian Mandatory

CN / PIBK Value Keterangan

JNS_AJU _: _{Jenis AJU} _{Y / Y} _{1 = CN} _{Consignment Note}

2 = PIBK Pemberitahuan Impor Barang Khusus

3 = BC 1.4 Pemberitahuan pemindahan penimbunan Barang

Kiriman

4 = PIB Pemberitahuan Impor Barang

KD_JNS_PIBK _: _{Kode Jenis PIBK} _{Y / Y} _{1 = Barang Pindahan}

2 = Barang Kiriman Melalui PJT 3 = Barang Impor Sementara Dibawa Penumpang

4 = Barang Impor Tertentu 5 = Barang Pribadi Penumpang 6 = Lainnya

NO_BARANG _: _{Nomor Barang} _{Y / Y} _{Free text (13)}

KD_KANTOR _: _{Kode Kantor} _{Y / Y} _{Standar BC (6 Digit)}

KD_JNS_ANGKUT _: _{Kode Jenis Angkut} _{Y / Y} _Number

NM_PENGANGKUT _: _{Nama Pengangkut} _{Y / Y} _{Free text (100)}

NO_FLIGHT _: _{Nomor Penerbangan (Flight)} _{Y / Y} _{Un Locode (5 Digit)}

KD_PEL_MUAT _: _{Kode Pelabuhan Muat} _{Y / Y} _{Un Locode (5 Digit)}

KD_PEL_BONGKAR _: _{Kode pelabuhan Bongkar} _{Y / Y} _{Un Locode (5 Digit)}

KD_GUDANG _: _{Kode Gudang} _{Y / Y} _{Standar BC (4 Digit)}

NO_INVOICE _: _{Nomor Invoice} _{N / Y} _{Free text (20 Digit)}

KD_NEGARA_ASAL _: _{Kode Negara Asal} _{Y / Y} _{5 Digit}

(23)

NO_BC11 _: _{Nomor Dokumen BC 1.1 (Manifest)} _{Y / Y} _{Free text (29 Digit)}

TGL_BC11 _: _{Tanggal Dokumen BC 1.1 (Manifest)} _{Y / Y} _{Format : yyyy/mm/dd}

NO_POS_BC11 _: _{Nomor Pos Dokumen BC 1.1} _{Y / Y} _{Standar BC (4 Digit)}

NO_SUBPOS_BC11 _: _{Nomor Sub Pos BC 1.1} _{Jika ada Y} _{Standar BC (4 Digit)}

NO_SUBSUBPOS_BC11 _: _{Nomor Sub Sub Pos BC 1.1} _{Jika ada Y} _{Standar BC (4 Digit)}

NO_MASTER_BLAWB _: _{Nomor Master BL/AWB} _{Jika ada Y} _{Free text (30 Digit)}

TGL_MASTER_BLAWB _: _{Tanggal Master BL/AWB} _{Jika ada Y} _{Format : yyyy/mm/dd}

NO_HOUSE_BLAWB _: _{Nomor House BL/AWB} _{Jika ada Y} _{Free text (30 Digit)}

TGL_HOUSE_BLAWB _: _{Tanggal House BL/AWB} _{Jika ada Y} _{Format : yyyy/mm/dd}

KD_NEG_PENGIRIM _: _{Kode Negara Pengirim} _{Y / Y} _{2 Digit}

NM_PENGIRIM _: _{Nama Pengirim} _{Y / Y} _{Free test (60 Digit)}

AL_PENGIRIM _: _{Alamat Pengirim} _{Y / Y} _{Free text}

JNS_ID_PENERIMA _: _{Jenis ID Penerima} _{N / Y}

NO_ID_PENERIMA _: _{Nomor ID Penerima} _{N / Y} _Number

NM_PENERIMA _: _{Nama Penerima} _{Y / Y} _{Free text (60 Digit)}

AL_PENERIMA _: _{Alamat Penerima} _{Y / Y} _{Free text (200 Digit)}

TELP_PENERIMA _: _{Telp Penerima} _{N / N} _{Free text (20 Digit)}

ID_PEMBERITAHU _: _{Nomor ID Pemberitahu} _{Y / Y}

NM_PEMBERITAHU _: _{Nama Pemberitahu} _{Y / Y} _{Free text}

AL_PEMBERITAHU _: _{Alamat Pemberitahu} _{Y / Y} _{Free text}

NO_IZIN_PEMBERITAHU _: _{Nomor Izin Pemberitahu} _{Y / Y}

TGL_IZIN_PEMBERITAHU _: _{Tanggal Izin Pemberitahu} _{Y / Y} _{Format : yyyy/mm/dd}

KD_VAL _: _{Kode Valuta Asing} _{Y / Y} _{3 Digit}

NDPBM _: _{Nilai Dasar Perhitungan Bea Masuk} _{N / Y} _{Number (9, 4)}

FOB _: _{Free on Board} _{N / N} _{Number (18, 2)}

(24)

FREIGHT _: _Freight _{N / N} _{Number (16, 2)}

CIF _: _{Cost, Insurance and Freight} _{Y / Y} _{Number (18, 2)}

NETTO _: _Netto _{Y / Y} _{Number (18, 4)}

BRUTO _: _Bruto _{Y / Y} _{Number (18, 4)}

TOT_DIBAYAR _: _{Total Dibayar} _{N / Y} _{Number (15, 2)}

NPWP_BILLING _: _{NPWP Billing} _{Y / Y} _{Free text (15 Digit)}

NAMA_BILLING _: _{Nama Billing} _{N / N} _{Free text (15 Digit)}

KD_PUNGUTAN _: _{Kode Pungutan} _{N / Y} _Number

NILAI _: _Nilai _{N / Y} _{Number (22, 2)}

DETIL

Elemen Data Uraian Mandatory Value Keterangan

DETIL_BARANG

SERI_BRG _: _{Seri Barang} _{Y / Y} _Number

HS_CODE _: _{HS Code} _{N / Y} _{Free Text (12 Digit)}

UR_BRG _: _{Uraian Barang} _{Y / Y} _{Free text}

KD_NEG_ASAL _: _{Kode Negara Asal} _{N / Y} _{2 Digit}

JML_KMS _: _{Jumlah Kemasan} _{Y / Y} _Number

JNS_KMS _: _{Jenis Kemasan} _{N / Y} _{Standar BC (2 Digit)}

CIF _: _{Cost, Insurance and Freight} _{N / Y} _Number

DETIL_PUNGUTAN

KD_PUNGUTAN _: _{Kode Pungutan} _{N / Y} _{Number (1)}

NILAI _: _Nilai _{N / Y} _{Number (22, 2)}

JNS_TARIF _: _{Jenis Tarif} _{N / Y} _{Varchar (100)}

KD_TARIF _: _{Kode Tarif} _{N / Y} _{1 = PROSENTASE (ADVALORUM)}

(25)

KD_SAT_TARIF _: _{Kode Satuan Tarif} _{N / Y} _{Free Text (20 Digit)}

JML_SAT _: _{Jumlah Satuan} _{N / Y} _Number

TARIF _: _Tarif _{N / Y} _Number

B. Kode Referensi Jenis AJU

Elemen Data Uraian Value Keterangan Kode Uraian

JNS_AJU : Kode Jenis AJU 1 CN Consignment Note

2 PIBK Pemberitahuan Impor Barang Khusus

3 BC 1.4 Pemberitahuan pemindahan penimbunan Barang

Kiriman

4 PIB Pemberitahuan Impor Barang

C. Kode Referensi Jenis PIBK

KD_JNS_PIBK : Kode Jenis PIBK 1 Barang Pindahan

2 Barang Kiriman Melalui PJT

3 Barang Impor Sementara Dibawa Penumpang

4 Barang Impor Tertentu

5 Barang Pribadi Penumpang

(26)

D. Kode Referensi Pungutan

Elemen Data

Uraian Value Keterangan

Kode Uraian

KD_PUNGUTAN : Kode Jenis

PIBK 1 BM Bea Masuk Bayar

2 PPH Pajak Penghasilan Bayar

3 PPN Pajak Pertambahan Nilai Bayar

4 PPNBM Pajak Pertambahan Nilai Bea Masuk Bayar

E. Kode Referensi Jenis Tarif

KD_TARIF : Kode Jenis

Tarif 1 PROSENTASE (ADVALORUM)

(27)