KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN

NASIONAL REPUBLIK INDONESIA

Versi 3.01

PEDOMAN INTEGRASI APLIKASI (PIA) – DRAFT BPN - K/L/D

Oleh :

TIM TEKNIS BPN

PERHATIAN
Segala informasi yang tersaji di dalam dokumen ini adalah milik
KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN
PERTANAHAN NASIONAL Republik Indonesia dan bersifat
rahasia untuk kalangan perusahaan. Penggunaan dokumen yang
tidak sesuai dengan non-disclosure agreement adalah tidak
diperbolehkan

KEMENTERIAN AGRARIA DAN TATA RUANG/

BADAN PERTANAHAN NASIONAL
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

A. BACKGROUND
Pedoman Integrasi Aplikasi (PIA) merupakan salah satu referensi dalam pembentukan program
Application Programming Interface (API) antara Portal BPN dan aplikasi K/L/D. Didalam pedoman
ini dijelaskan hal-hal yang perlu diketahui dalam mengintegrasikan modul-modul pada OSS
Application Programming Interface (API), khususnya menyangkut struktur elemen data yang perlu
dipersiapkan disisi K/L yang akan dikirimkan ke API Services BPN.
Dokumen Pedoman Integrasi Aplikasi (PIA) ini dibuat dengan tujuan :
- Mempermudah masing-masing pihak yang terkait dengan sistem BPN melakukan integrasi
sistem yang standart & terstruktur
- Sebagai pedoman untuk pengiriman data transaksi secara realtime

- Mengurangi potensi human-error akibat adanya entry data maupun double entry data
secara manual

- Penyajian data yang lebih cepat, tepat dan akurat di sistem aplikasi BPN maupun yang
terkait dengan BPN
Secara umum dokumen PIA ini memuat:
- Bisnis Proses Integrasi
- Teknis Integrasi BPN
- Contoh Elemen Data
- Contoh Jsonfile

Integrasi Aplikasi/ pertukaran data antara sistem BPN Services dengan sistem K/L/D dilakukan
secara host to host, menggunakan protokol komunikasi dan format data yang disepakati yaitu
protokol HTTP (APPLICATION PROGRAMMING INTERFACE) dengan format Dokumen JSON.

Pedoman Integrasi Aplikasi Draft PIA BPN

2
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

B. PROCESS SPECIFICATION

1. Protokol Application Program Interface

Pertukaran data (host to host) yang digunakan antara system internal di K/L/D dengan system Web
Api Service adalah dengan mengunakan format data JSON, dan REST API sebagai protocol
komunikasinya. Untuk END POINT/ alamat URL untuk rest api oss adalah
https://103.49.37.84:8080/BPNApiService/Api/ : Production
http:// 103.49.37.84:8080/BPNDevApi/Api/ : Development / Simulasi
Berikut ini daftar Method dalam Web Api Services).

NO Fungsi Method Locate

Inquery Data Pembayaran BPHTB Terpusat (NTPD) di

1 Sistem Pemda Daerah getBPHTBService Server (Pemda)
Client (Pusdatin)

Inquery Data PBB Terpusat (NOP) di Sistem Pemda

2 Daerah getPBBService Server (Pemda)
Client (Pusdatin)

Pengiriman Data BPHTB dari Pemda Daerah ke

3 Pusdatin AddBPHTB Server (Pusdatin)
Client (Pemda Daerah)

Server (Pemda
4 Pengiriman Data Transaksi Peralihan dari Pusdatin ke Daerah)
Pemerintah Daerah PostDataBPN Client (Pusdatin)

Inquery Data PPAT yang disediakan BPN untuk Pemda

5 Daerah getPPAT Server (Pusdatin)
Client (Pemda)

Pedoman Integrasi Aplikasi Draft PIA BPN

3
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Method Name http://ipadress/Api/getBPHTBService

Method Type Post

Method Header Content-Type:application/json

Description Inquery Data Pembayaran BPHTB dari BPN ke Pemkot/Pemda

Input Parameters
Parameters Type Length Repeat Description

NOP String 20 1 Nomor Obyek Pajak

NTPD String 100 1 Nomor Tanda Pembayaran
Daerah
Return
NOP String 20 1 Nomor Obyek Pajak

NIK String 100 1 NIK Subyek Pajak

NAMA String 100 1 Nama Subyek Pajak
ALAMAT String 300 1 Alamat Subyek Pajak
KELURAHAN_OP String 200 1 Kelurahan Obyek Pajak
KECAMATAN _OP String 200 1 Kecamatan Obyek Pajak
KOTA_OP String 200 1 Kota Obyek Pajak
LUASTANAH Decimal 16,2 1 Luas Tanah Obyek Pajak
Decimal 16,2 1 Luas Bangunan Obyek
LUASBANGUNAN Pajak
PEMBAYARAN Decimal `16,2 1 Jumlah Bayar BPHB
STATUS String 1 Status Bayar BPHTB
(Y/T)
String 1 Tanggal Bayar BPHTB
TANGGAL_PEMBAYARAN
NTPD String 100 1 Nomor Bukti Bayar
BPHTB
JENISBAYAR String 1 Jenis Pembayaran (L/H)
SERVER Pemda Client BPN Pusdatin

Contoh Format JSON (Parameter):

{
"NOP": "317405000800700210",
"NTPD": "3191031171329574"
}

Pedoman Integrasi Aplikasi Draft PIA BPN

4
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Contoh Format JSON (Return):

{
"result": {
"NOP": "317405000800700210",
"NIK": null,
"NAMA": "FARIDA ",
"ALAMAT": " BLOK/KAV/NO. RT. RW.",
"KELURAHAN_OP": "PINANGSIA",
"KECAMATAN_OP": "TAMAN SARI",
"KOTA_OP": "JAKARTA BARAT",
"LUASTANAH": "0",
"LUASBANGUNAN": "0",
"PEMBAYARAN": "114315260",
"STATUS": "”Y",
"TANGGAL_PEMBAYARAN": "30/11/2017",
"NTPD": "3191031171329574",
"JENISBAYAR": "L"
},
"respon_code": "OK"
}

Pedoman Integrasi Aplikasi Draft PIA BPN

5
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Method Name http://IP Adress/getPBBService

Method Type Get

Method Header Content-Type:application/json

Description Inquery Data Pembayaran BPHTB dari BPN ke Pemda

Input Parameters
Parameters Type Length Repeat Description

NOP String 20 1 Nomor Obyek Pajak

Return
NOP String 20 1 Nomor Obyek Pajak

NIK String 100 1 NIK Subyek Pajak

NAMA_WP String 100 1 Nama Subyek Pajak
ALAMAT_OP String 300 1 Alamat Subyek Pajak
KELURAHAN_OP String 200 1 Kelurahan Obyek Pajak
KECAMATAN _OP String 200 1 Kecamatan Obyek Pajak
KOTA_OP String 200 1 Kota Obyek Pajak
LUASTANAH_OP Decimal 16,2 1 Luas Tanah Obyek Pajak
Decimal 16,2 1 Luas Bangunan Obyek
LUASBANGUNAN_OP Pajak
NJOP_TANAH_OP Decimal `16,2 1 NJOP Tanah
NJOP_BANGUNAN_OP Decimal 1 NJOP Bangunan
STATUS_TUNGGAKAN String 100 1 Status Bayar
SERVER Pemda Client BPN Pusdatin

Contoh Format JSON (Parameter):

{
"nopd": "317405000800700210",
}

Pedoman Integrasi Aplikasi Draft PIA BPN

6
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Contoh Format JSON (Return):

{
"NOP": "317405000600924660",
"NIK": "317405000600924660 ",
"NAMA_WP": "CITRA GEMILANG NUSANTARA PT",
"ALAMAT_OP": "JL HAYAM WURUK BLOK/KAV/NO K UG A5-2 RT 000 RW 06",
"KECAMATAN_OP": "TAMAN SARI",
"KELURAHAN_OP": "MANGGA BESAR",
"KOTA_KAB_OP": "JAKARTA BARAT",
"LUAS_TANAH_OP": 0,
"LUAS_BANGUNAN_OP": 7,
"NJOP_TANAH_OP": 0,
"NJOP_BANGUNAN_OP": 48650000,
"STATUS_TUNGGAKAN": "100% Lunas"
}

Pedoman Integrasi Aplikasi Draft PIA BPN

7
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Method Name http://103.49.37.84:8080/BPNApiService/

Api/BPHTB/AddBPHTB

Method Type Post

Method Header Content-Type:application/json

Description Posting Data BPHTB dari Pemda seluruh daerah ke BPN

Input Parameters
Parameters Type Length Repeat Description

USERNAME String 100 1 Username pengguna

PASSWORD String 100 1 Password pengguna
TRANSNO String 20 1 Nomor Bukti Bayar
TANGGAL String 32 1 Tanggal Bayar
NOP String 20 1 Nomor Obyek Pajak
WP_NAME String 100 1 Nama Wajib Pajak
BAYAR Decimal 16,2 1 Jumlah Bayar
LUAS Decimal 16,2 1 Luas Tanah

Return
RESULT String 20 1 Kode Response

SERVER BPN Pusdatin Client Pemkot/Pemda

Contoh Format JSON (Parameter):

{
"username": "userpemda",
"password": "a",
"transno": "67C10412B4E27AA6E053131D0B0A5E53",
"tanggal": "78b8ac9dfe9742cfb46e4e12de7609ae",
"nop": "317405000800700210",
"wp_nama": "3191031171329574"
"bayar": "3191031171329574"
"luas": "3191031171329574"
}

Contoh Format JSON (Return):

{ "result": "OK" }

Pedoman Integrasi Aplikasi Draft PIA BPN

8
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Method Name http://ipaddress/PostDataBPN

Method Type Post

Method Header Content-Type:application/json

Description Post Data Transaksi Peralihan dari Aplikasi BPN ke

Pemda/Pemkot

Input Parameters
Parameters Type Length Repeat Description

AKTAID String 100 1 ID Akta

TGL_AKTA String 100 1 Tanggal Akta
NOP String 20 1 Nomor Obyek Pajak
NIK String 32 1 NIK
NIB String 15 1 Nomor Induk Bidang
NPWP String 50 1 NPWP
NAMA_WP String 100 1 Nama Wajib Pajak
ALAMAT_OP String 200 1 Alamat Wajaib Pajak
KELURAHAN_OP String 100 1 Nama Kelurahan
KECAMATAN_OP String 100 1 Nama Kecamatan
KOTA_OP String 100 1 Kota
LUASBANGUNAN_OP Decimal 16,2 1 Luas Bangunan
LUASTANAH_OP Decimal 16,2 1 Luas Tanah
NO_SERTIPIKAT String 50 1 Nomor Sertipikat
NO_AKTA String 100 1 Nomor Akta
PPAT String 100 1 Nama PPAT
Return
STATUS String 1 1 Status Proses
1= Sukses Kirim
0= Gagal Kirim
SERVER Pemda Client BPN Pusdatin

Contoh Format JSON (Parameter):

{
"AKTAID": "E52C9518EB8ABF51E043031D0B0AE301",
"TGL_AKTA": "31/10/2018",
"NOP": "317405000800700210",
"NIK": null,
"NPWP": null,
"NAMA_WP": "FARIDA ",
"ALAMAT": " BLOK/KAV/NO. RT. RW.",
"KELURAHAN_OP": "PINANGSIA",
"KECAMATAN_OP": "TAMAN SARI",
"KOTA_OP": "JAKARTA BARAT",
"LUASBANGUNAN_OP": "0",

Pedoman Integrasi Aplikasi Draft PIA BPN

9
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

"LUASTANAH_OP": "0",
"NO_SERTPIKAT": "114315100260",
"NO_AKTA": "IV/JAN/AJB/2006",
"PPAT ": "JMILAH, SH"

Contoh Format JSON (Return):

{ "status": "1" }

Pedoman Integrasi Aplikasi Draft PIA BPN

10
 KEMENTERIAN AGRARIA DAN TATA RUANG/ BADAN PERTANAHAN
NASIONAL REPUBLIK INDONESIA

Method Name http://103.49.37.84:8080/BPNApiService/

Api/BPHTB/GetPPAT

Method Type Post

Method Header Content-Type:application/json

Description Inquery Data PPAT dari Aplikasi BPN ke Pemda seluruh

daerah

Input Parameters
Parameters Type Length Repeat Description

USERNAME String 100 1 Username pengguna

PASSWORD String 100 1 Password pengguna
NAMA String 20 1 Nama PPAT
EMAIL String 32 1 Email PPAT
Return
RESULT
NAMA String 20 1 Nama PPAT

NOID String 100 1 ID PPAT

ALAMAT String 300 1 Alamat PPAT
NOSK String 200 1 Nomor SK
RESPON_CODE String 100 1 Status Respon
SERVER BPN Pusdatin Client Pemkot/Pemda/Dispenda

Contoh Format JSON (Parameter):

{
"username": "userpemda",
"password": "a",
"nama": "JAMILAH%",
"email": "Jamillah@gmail.com"
}

Contoh Format JSON (Return):

{
"result": {
"NAMA": "TOKO POTERT TOKYO",
"NOID": "317405000800700210",
"ALAMAT_OP": "JL PANGERAN JAYAKARTA BLOK/KAV/NO 63 F RT 002 RW 02",
"NOSK": "XX/SK/PPAT/2018"
},
"respon_code": "OK"
}

Pedoman Integrasi Aplikasi Draft PIA BPN

11