API

API 01 - Get list BL

GET https://nlehub.kemenkeu.go.id/V1/NLE/NoBL20/NPWP_CARGO_OWNER}

URL Development : https://esbbcext01.beacukai.go.id:9081//NLEMICROAPI-1.0/webresources/ceisa/noblbc20/{NPWP_CARGO_OWNER}

Path Parameters

Name	Type	Description
noblbc20	string	Nomor BL
npwp_cargo_owner	string	npwp cargo owner

Headers

Name	Type	Description
beacukai-api-key	string	beacukai-api-key dapat didapatkan ke tim teknis nle

200 Successfully

{
    "Data BL BC 2.0": [
        {
            "bl_no": "ABCDEFGH",
            "bl_date": "2020-11-26"
        }
    ]
}
e

Daftar Lengkap REST API GET BL By NPWP Untuk Tipe Dokumen Lainnya

TIPE DOKUMEN	PRODUCTION	DEVELOPMENT
BC 2.0	/V1/NLE/NoBL20/	/noblbc20/
BC 1.6	/V1/NLE/NoBL16/	/noblbc16/
BC 2.3	/V1/NLE/NoBL23/	/noblbc23/

API 02 - Get list container

GET https://nlehub.kemenkeu.go.id/V1/NLE/ContainerBC20/{BL_NO}/{BL_DATE}

URL Development: https://esbbcext01.beacukai.go.id:9081/NLEMICROAPI-1.0/webresources/ceisa/kontainerbc20/{BL_NO}/{BL_DATE}

Path Parameters

Name	Type	Description
BL_NO	string	nomor BL
BL_DATE	number	[date] tanggal BL

Headers

Name	Type	Description
beacukai-api-key	string	beacukai-api-key dapat didapatkan dengan menghubungi tim nle

200 successfully

{
    "Data Kontainer BC20": [
        {
            "container_size": "40",
            "bl_no": "HDMUSGWB0596002",
            "bl_date": "2020-10-28",
            "seriContainer": "1",
            "noSeal": "B221188",
            "container_no": "HMMU6132869",
            "jenisMuat": "FCL",
            "container_type": "Isotank"
        },
        {
            "container_size": "40",
            "bl_no": "HDMUSGWB0596002",
            "bl_date": "2020-10-28",
            "seriContainer": "2",
            "noSeal": "B221024",
            "container_no": "KOCU4481620",
            "jenisMuat": "FCL",
            "container_type": "Isotank"
        }
    ]
}

Daftar Lengkap REST API GET Container By BL Untuk Tipe Dokumen Lainnya

TIPE DOKUMEN	PRODUCTION	DEVELOPMENT
BC 1.6	/V1/NLE/ContainerBC20/	/kontainerbc16/
SP3B	/V1/NLE/ContainerSp3b/	/kontainersp3b/
BC 2.3	/V1/NLE/ContainerBC23/	/kontainerbc23/
BC 2.7	/V1/NLE/ContainerBC27/	/kontainerbc27/
BC 3.0	/V1/NLE/ContainerBC30/	/kontainerbc30/
BC 2.5	/V1/NLE/ContainerBC25/	/kontainerbc25/
BC 2.6.1	/V1/NLE/ContainerBC261/	/ kontainerbc261/
BC 2.6.2	/V1/NLE/ContainerBC262/	/kontainerbc262/
BC 2.8	/V1/NLE/ContainerBC28/	/kontainerbc28/

API 03 - Get Data SPPB By NO BL

GET https://nlehub.kemenkeu.go.id/V1/NLE/GetBC20ByBL

URL Development: https://esbbcext01.beacukai.go.id:9081/NLEMICROAPI-1.0/webresources/ceisa/BC20ByNoBL/{NPWP_CARGO_OWNER}/{BL_NO}/{BL_DATE}

Path Parameters

Name	Type	Description
NPWP_CARGO_OWNER	string	npwp cargo owner
BL_NO	string	nomor BL
BL_DATE	string	tanggal BL

Headers

Name	Type	Description
beacukai-api-key	string	beacukai-api-key dapat didapatkan dengan menghubungi tim nle

200 successfully

{
    "    ": [
        {
            "tgl_bl": "2020-10-28 00:00:00.0",
            "nm_ff": "PT. ABC PRATAMA",
            "npwp_cargoowner": "018235353559000",
            "tgl_sppb": "2020-11-02 00:00:00.0",
            "car": "00000000561345435023706106",
            "no_pib": "476236",
            "no_sppb": "476718/KPU.01/2020",
            "tgl_pib": "2020-11-02 00:00:00.0",
            "npwp_ff": "02503454357042000",
            "host_bl": "HDMUSSDDD96002",
            "nm_cargoowner": "PT. ABC INDONESIA",
            "status": "SPPB"
        }
    ]
}

API 04 - Save SP2 to NLE

POST https://api.beacukai.go.id/NLE-DEV/document_sp2/final/

Headers

Name	Type	Description
beacukai-api-key	string	token authentifikasi API
Authorization	string	token from login

Request Body

Name	Type	Description
kd_document_type	integer	lihat referensi
npwp_cargo_owner	string	[30] npwp pemilik kargo
nm_cargo_owner	string	[255] nama pemilik kargo
npwp_ppjk	string	[30] npwp ff/ ppjk
nm_ppjk	string	[255] nama ff/ ppjk
document_no	string	[255] nomor dokumen
document_date	number	[date] tanggal dokumen
no_doc_release	string	[255] nomor sppb
date_doc_release	number	[date] tanggal sppb
document_status	string	[255] status dokumen
bl_no	string	[60] nomor BL
bl_date	number	[date] tanggal BL
id_platform	string	[5] kode platform
terminal	string	[255] nama terminal
paid_thrud_date	number	[date] tanggal pembayaran sp2
proforma	string	[255] nomor proforma
proforma_date	number	[date] tanggal proforma
price	number	[(numeric, 14,2)] biaya penebusan sp2
status	string	[255] status permintaan sp2 (proses, selesai)
is_finished	string	[1] jika proses selesai
container	array	berisi list kontainer
container_no	string	[255] nomor kontainer
container_type	string	[255] tipe kontainer
container_size	string	[255] ukuran kontainer
gate_pass	string	link dokumen gate pass (pdf)

200

{
    "status": "Success",
    "id_document”: 1,
    "id_document_sp2": “aoj8ou9-298aodj-ayysdn-2asdsad”
}

API 05a - Request Billing ke Sistem pembayaran NLE (step 1)

POST https://api.beacukai.go.id/NLE-DEV/invoice/

Headers

Name	Type	Description
beacukai-api-key	string	token authentifikasi API
Authorization	string	token from login

Request Body

Name	Type	Description
unique_id	number	billing id dari resporn API 04
module	string	[255] isi dengan documents
module_unique_id	string	[255] id_document dari response API 04
id_payment_services	string	[7] isi dengan kode metode pembayaran VA Bank Mandiri = PL009VA
order_amount	number	[numeric] biaya total penebusan sp2
customer_number	string	[20] NPWP pengguna jasa
customer_name	string	[255] nama pengguna jasa
currency_code	string	mata uang = IDR
open_period	number	[date] tanggal batas awal pembayaran
close_period	number	[date] tanggal batas akhir pembayaran
invoice_item	string	[ARRAY] list item pembayaran
id_platform	string	[5] kode platform
amount	string	[numeric] biaya penebusan sp2
quantity	string	jumlah item
id_service	string	isi dengan = 2
service_unique_id	string	id_document_sp2 dari response API 01
item_info	string	informasi item pembayaran (ex: "penebusan kontainer sp2")

200

{
    "responseCode": "200",
    "responseMessage": "success",
    "order_number": "00000000000000000003"
}

API 05b - Request Billing ke Sistem Pembayaran NLE (step 2)

POST https://api.beacukai.go.id/NLE-DEV/mandiri/getVirtualAccount

Path Parameters

Name	Type	Description
orderNumber	string	nomor order dari response API 05a

Headers

Name	Type	Description
beacukai-api-key	string	token authentifikasi API
Authorization	string	token form login

200

{
    "responseCode": "2000200",
    "responseMessage": "Success",
    "data": {
        "mandiriVirtualAccount": "8823420111800001",
        "orderNumber": "00000000000000000101"
    }
}

API 06 - Update status pembayaran SP2 di NLE

PUT https://api.beacukai.go.id/NLE-DEV/document_sp2/paidThrudDate

Path Parameters

Name	Type	Description
documentSp2ID	string	id_document_sp2 yang didapat dari API-04

Headers

Name	Type	Description
beacukai-api-key	string	Token authentifikasi API
Authorization	string	Token from login

Request Body

Name	Type	Description
paid_thrud_date	number	[datetime] Tanggal pembayaran diterima platform / terminal operator
status	string	[255] Status proses SP2

200

Success.

API 07 - Update link dokumen GATE PASS SP2 di NLE

PUT https://api.beacukai.go.id/NLE-DEV/document_sp2_container/gate_pass/

Path Parameters

Name	Type	Description
id_document_sp2	string	id_document_sp2 yang didapat dari API-04
container_no	string	Nomor container terkait yang dikirim ke API-04

Headers

Name	Type	Description
beacukai-api-key	string	Token authentifikasi API
Authorization	string	Token from login

Request Body

Name	Type	Description
gate_pass	string	Link dokumen GATE PASS SP2

200

Success.