Pedoman Integrasi Aplikasi

(PIA)
IBS NASIONAL: MODULE E-BILLING

Antara
IBS NASIONAL
dengan
PT PELABUHAN INDONESIA I, II, III dan IV

Versi 1.1

Page 1​ of 9
Revision History

Date Version Description Author

TIM IT
26 November 2018 1.0 Initial
Pelindo 3
TIM IT
15 Februari 2019 1.1 Update Parameter
Pelindo 3

Page 2​ of 9
1. ARSITEKTUR SISTEM

● Setiap PELINDO mengirimkan data header dan detil terkait nota invoice,
receipt ataupun batal.
● IBS NASIONAL akan mengirimkan informasi data yang sudah di proses ke
masing-masing PELINDO, untuk data yang sukses dan tertolak.

Page 3​ of 9
2. KONEKSI

2.1. Alamat API IBS NASIONAL

Setiap PELINDO mengirimkan request ke IBS NASIONAL dengan mengakses alamat

dibawah ini:

Development:
https://ibs-xapi.pelindo.co.id/

Production:
https://ibs-unicorn.pelindo.co.id/

3. CONTOH JSON
1.1. REQUEST​ untuk mengirimkan Header Nota Belum Lunas :

{
"KD_PELABUHAN" : "1" / "2" / "3" / "4", ​MANDATORY
"KD_KUSTO" : "00362", ​MANDATORY
"KD_OBYEK" : "I000000097",
"KAPAL" : "MERATUS PALEMBANG",
"KD_VALUTA" : "IDR", ​MANDATORY
"NO_NOTA_JUAL" : "",
"NO_REF3" : "1810020550", ​MANDATORY
"TGL_TRANS" : "23-10-2018 11:30:00", ​MANDATORY
"KETERANGAN" : "PELAYANAN KAPAL : MERATUS PALEMBANG",
"TGL_JT_TEMPO" : "26-10-2018 11:30:00", ​MANDATORY
"TAGIHAN" : "3125000", ​MANDATORY
"TIPE_TRANS" : "1C", ​MANDATORY
"JENIS_TAGIHAN" : "KAPAL", ​MANDATORY
"MPLG_NAMA" : "MERATUS LINE, PT", ​MANDATORY
"NO_NOTA" : "7300060742/2018",
"KD_CABANG" : "02" / "02", ​MANDATORY
"NO_KONTRAK" : "",
"NO_SAMBUNG" : "",
"KD_PEMBAYARAN" : "21810020047415", ​MANDATORY
"NO_FAKT_PAJAK" : "",
"JNS_PELAYARAN" : "",
"SISA_BAYAR" : "3125000",
"NPWP" : "3125000" ​MANDATORY,
"KEY_ID" : "XXXXXXX"
}

URL : http://domain:port​ ​/api/InboundNota/NotaBelumLunas

Method : POST
Content-Type : application/json

Page 4​ of 9
 tipe data :

KD_KUSTO VARCHAR2(20 BYTE),

KD_OBYEK VARCHAR2(50 BYTE),
KAPAL VARCHAR2(80 BYTE),
KD_VALUTA VARCHAR2(10 BYTE),
NO_NOTA_JUAL VARCHAR2(50 BYTE),
NO_REF3 VARCHAR2(50 BYTE),
TGL_TRANS DATE,
KETERANGAN VARCHAR2(150 BYTE),
TGL_JT_TEMPO DATE,
TAGIHAN NUMBER(15,2),
TIPE_TRANS VARCHAR2(20 BYTE),
JENIS_TAGIHAN VARCHAR2(50 BYTE),
MPLG_NAMA VARCHAR2(50 BYTE),
NO_NOTA VARCHAR2(50 BYTE),
KD_CABANG NUMBER(3),
NO_KONTRAK CHAR(1 BYTE),
NO_SAMBUNG CHAR(1 BYTE),
KD_PEMBAYARAN NUMBER(38),
NO_FAKT_PAJAK VARCHAR2(30 BYTE),
JNS_PELAYARAN VARCHAR2(50 BYTE),
SISA_BAYAR NUMBER(15,2),
KD_PELABUHAN NUMBER(1),
NPWP VARCHAR2(50 BYTE),
KEY_ID VARCHAR2(200 BYTE)

1.2. REQUEST​ untuk mengirimkan Header Nota Lunas :

{
"KD_PELABUHAN" : "1" / "2" / "3" / "4", ​MANDATORY
"TAHUN" : "2018", ​MANDATORY
"BLN_BUKU" : "09", ​MANDATORY
"KD_KUSTO" : "08158", ​MANDATORY
"KD_OBYEK" : "I000000225",
"KD_VALUTA" : "IDR", ​MANDATORY
"NO_NOTA_JUAL" : "070.001.18.00034645",
"NO_REF3" : "1808022329", ​MANDATORY
"NO_FAKT_PAJAK" : "070.001.18.00034645", ​MANDATORY
"TGL_TRANS" : "05-09-2018 00:00:00", ​MANDATORY
"KETERANGAN" : "PELAYANAN KAPAL : GULF MAS",
"TGL _JT_TEMPO" : "08-09-2018 00:00:00",
"TIPE_TRANS" : "1C", ​MANDATORY
"JENIS_TAGIHAN" : "KAPAL", ​MANDATORY
"MPLG_NAMA" : "TEMPURAN EMAS, PT", ​MANDATORY
"NO_NOTA" : "7300050135/2018",
"TAGIHAN" : "7461556", ​MANDATORY
"KODE" : "I000000225",
"KAPAL" : "GULF MAS",
"NO_KONTRAK" : "",
"NO_SAMBUNG" : "",

Page 5​ of 9
 "KD_PEMBAYARAN" : "21809020039482", ​MANDATORY
"KD_CABANG" : "302" / "402", ​MANDATORY
"JNS_PELAYARAN" : "",
"SISA_UPER" : "",
"FLAG_STAGING" : "",
"TGL_LUNAS" : "08-09-2018 09:01:32",
"NPWP" : "3125000" ​MANDATORY,
"KEY_ID" : "XXXXXXX"

URL : http://domain:port​ ​/api/InboundNota/​ ​NotaLunas

Method : POST
Content-Type : application/json

tipe data :

TAHUN VARCHAR2(10 BYTE),

BLN_BUKU VARCHAR2(5 BYTE),
KD_KUSTO VARCHAR2(20 BYTE),
KD_OBYEK VARCHAR2(50 BYTE),
KD_VALUTA VARCHAR2(10 BYTE),
NO_NOTA_JUAL VARCHAR2(50 BYTE),
NO_REF3 VARCHAR2(50 BYTE),
NO_FAKT_PAJAK VARCHAR2(30 BYTE),
TGL_TRANS DATE,
KETERANGAN VARCHAR2(150 BYTE),
TGL_JT_TEMPO DATE,
TIPE_TRANS VARCHAR2(20 BYTE),
JENIS_TAGIHAN VARCHAR2(25 BYTE),
MPLG_NAMA VARCHAR2(50 BYTE),
NO_NOTA VARCHAR2(50 BYTE),
TAGIHAN NUMBER,
KODE VARCHAR2(100 BYTE),
KAPAL VARCHAR2(80 BYTE),
NO_KONTRAK CHAR(1 BYTE),
NO_SAMBUNG CHAR(1 BYTE),
KD_PEMBAYARAN NUMBER,
KD_CABANG NUMBER(10),
JNS_PELAYARAN VARCHAR2(20 BYTE),
SISA_UPER NUMBER,
FLAG_STAGING NUMBER,
CREATED_DATE DATE,
KD_PELABUHAN NUMBER(1),
NPWP VARCHAR2(50 BYTE),
TGL_LUNAS DATE,
KEY_ID VARCHAR2(200 BYTE)

1.3. REQUEST​ untuk mengirimkan Header Nota Batal :

{
"KD_PELABUHAN" : "1" / "2" / "3" / "4", ​MANDATORY
Page 6​ of 9
 "TAHUN" : "2018", ​MANDATORY
"BLN_BUKU" : "08", ​MANDATORY
"KD_KUSTO" : "00362", ​MANDATORY
"KD_OBYEK" : "I000000810",
"KD_VALUTA" : "IDR", ​MANDATORY
"NO_NOTA_JUAL" : "",
"NO_REF3" : "950118080138", ​MANDATORY
"NO_FAKT_PAJAK" : "", ​MANDATORY
"TGL_TRANS" : "08-08-2018 00:00:00", ​MANDATORY
"KETERANGAN" : "PELAYANAN APBS - Masuk : MERATUS SABANG",
"TGL_JT_TEMPO" : "18-08-2018 00:00:00",
"TIPE_TRANS" : "1K", ​MANDATORY
"JENIS_TAGIHAN" : "APBS", ​MANDATORY
"MPLG_NAMA" : "MERATUS LINE, PT", ​MANDATORY
"NO_NOTA" : "8100004699/2018",
"TAGIHAN" : "5363606", ​MANDATORY
"KODE" : "I000000810",
"KAPAL" : "MERATUS SABANG",
"NO_KONTRAK" : "",
"NO_SAMBUNG" : "",
"KD_PEMBAYARAN" : "21808020035000", ​MANDATORY
"KD_CABANG" : "2", ​MANDATORY
"JNS_PELAYARAN" : "",
"SISA_BAYAR" : "",
"TGL_BATAL" : "08-09-2018 09:01:32",
"NPWP" : "3125000" ​MANDATORY

URL : http://domain:port​ ​/api/InboundNota/​ ​NotaBatal

Method : POST
Content-Type : application/json

tipe data :

TAHUN VARCHAR2(4 BYTE),

BLN_BUKU VARCHAR2(2 BYTE),
KD_KUSTO VARCHAR2(10 BYTE),
KD_OBYEK VARCHAR2(50 BYTE),
KD_VALUTA VARCHAR2(3 BYTE),
NO_NOTA_JUAL VARCHAR2(25 BYTE),
NO_REF3 VARCHAR2(25 BYTE),
NO_FAKT_PAJAK VARCHAR2(30 BYTE),
TGL_TRANS DATE,
KETERANGAN VARCHAR2(150 BYTE),
TGL_JT_TEMPO DATE,
TIPE_TRANS VARCHAR2(10 BYTE),
JENIS_TAGIHAN VARCHAR2(25 BYTE),
MPLG_NAMA VARCHAR2(50 BYTE),
NO_NOTA VARCHAR2(25 BYTE),
TAGIHAN NUMBER,
KODE VARCHAR2(70 BYTE),
KAPAL VARCHAR2(70 BYTE),
NO_KONTRAK CHAR(1 BYTE),
Page 7​ of 9
NO_SAMBUNG CHAR(1 BYTE),
KD_PEMBAYARAN NUMBER,
KD_CABANG NUMBER(2),
JNS_PELAYARAN VARCHAR2(10 BYTE),
SISA_BAYAR NUMBER,
KD_PELABUHAN NUMBER(1),
NPWP VARCHAR2(50 BYTE),
TGL_BATAL DATE

Page 8​ of 9
1.4. RESPONSE​ untuk data SUCCESS

{
"Status": "S",
"Message": "Berhasil Menyimpan Data"
}

1.5. RESPONSE​ dengan 1 data error

{
"Status": "E",
"Message": "Data Header Nota NO_REF3 = 1808022329 Data Tidak Ditemukan."
}
1.6. REQUEST​ untuk mengirimkan Display list monitoring nota : #

{
"Holding" : "1" / "2" / "3" / "4", ​MANDATORY (informasi pelindo)
"Tipe" : "0/1", ​MANDATORY (0 : blm lunas / 1: lunas)
"NoNota" : "00000", ​(nomor nota)
"KodePelanggan" : "00000", ​(kode pelanggan)
"PeriodeAwal" : "dd-mm-yyyy",
"PeriodeAkhir" : "dd-mm-yyyy"

URL : http://domain:port​ ​/api/InboundNota/​ ​DaftarNota

Method : POST
Content-Type : application/json

Page 9​ of 9