Dokumentasi API CekFaktur · Cek Faktur Pajak

Selamat datang di halaman dokumentasi Layanan API Cek Faktur.

Pendahuluan

Dokumentasi ini berisi cara integrasi layanan API Cek Faktur untuk keperluan development website atau aplikasi Anda yang akan diintegrasikan dengan Cek Faktur.

Environment

Kami memiliki 2 (dua) buah environment yang dapat Anda gunakan agar dapat terhubung dengan platform kami dalam melakukan validasi terhadap berkas faktur pajak.

Hostname	Keterangan
`sandbox.cekfaktur.com`	Gunakan hostname ini jika aplikasi Anda masih pada tahap pengembangan
`api.cekfaktur.com`	Gunakan hostname ini jika aplikasi Anda sudah pada tahap production (Go Live)

Respon Balik

Kami akan memberikan respon balik pada saat Anda mencoba untuk melakukan validasi berkas faktur pajak atau SK Kemenkumham. Apabila sukses, akan ada 2 (dua) bagian respon, yaitu info dan data.

Bagian info berisi data sebagai berikut:

Objek	Nilai
`requestID`	ID unik permintaan Anda
`fileName`	Nama berkas eFaktur/SK Kemenkumham yang diperiksa
`validationDate`	Waktu pemeriksaan (dalam format UNIX Timestamp)
`creditRemaining`	Jumlah kredit yang tersisa untuk akun Anda

Bagian data berisi data dari Dirjen Pajak / Kemenkumham yang berisi data-data eFaktur/SK Kemenkumham yang telah diperiksa.

Kode Respon

Berikut adalah kode respon yang akan kami berikan jika pemeriksaan gagal dilakukan :

Kode	Keterangan
`400`	`documentURL Not Valid`
`401`	`Unauthorized`
`402`	`Payment Required`
`404`	`Not Found`
`405`	`Method Not Allowed`
`422`	`documentURL Not Host`
`422`	`documentURL Not Valid PDF`
`422`	`QRCode Not Found`
`422`	`QRCode Not (eFaktur/SK Kemenkumham) Valid`
`500`	`Internal Server Error`
`503`	`Service Unavailable`

Validasi Faktur Pajak

validate-tax-invoice digunakan untuk melakukan validasi terhadap berkas faktur pajak asli dari sebuah URL yang telah ditentukan.

Method	API endpoint
`POST`	/validate-tax-invoice

Contoh Permintaan Cek Faktur

Contoh Respon Sukses Cek Faktur

{
    "info": {
        "requestID": "6026a5acecbe6d246ab350ca",
        "fileName": "Faktur SAS Februari 2020.pdf",
        "validationDate": "1581058487",
        "creditRemaining": 9992
    },
    "data": {
        "kdJenisTransaksi": "01",
        "fgPengganti": "0",
        "nomorFaktur": "0088359404431",
        "tanggalFaktur": "04/02/2020",
        "npwpPenjual": "021758366211053",
        "namaPenjual": "PT SELALU ADA SOLUSI",
        "alamatPenjual": "TALI BUILDING 10TH FLOOR KOTA BAMBU SELATAN, JAKARTA BARAT",
        "npwpLawanTransaksi": "094928448938980",
        "namaLawanTransaksi": "PT. GILANG GEMILANG",
        "alamatLawanTransaksi": "TANPA TOWER LT 11 UNIT MAWAR, JL HR. RASUNA SAID Blok 12 KAV No.80 Kel.KARET KUNINGAN Kec.SETIABUDI Kota/Kab.JAKARTA SELATAN DKI JAKARTA 12910",
        "jumlahDpp": 78650000,
        "jumlahPpn": 7865000,
        "jumlahPpnBm": 0,
        "statusApproval": "Faktur Valid, Sudah Diapprove oleh DJP",
        "statusFaktur": "Faktur Pajak Normal",
        "referensi": "Nomor Invoice : INV-123/SAS/II/2020",
        "detailTransaksi": [
            {
                "nama": "RSVP dan DB Rental",
                "hargaSatuan": "78650000",
                "jumlahBarang": "1",
                "hargaTotal": "78650000",
                "diskon": "0",
                "dpp": "78650000",
                "ppn": "7865000",
                "tarifPpnbm": "0",
                "ppnbm": "0"
            }
        ]
    }
}

Validasi SK Kemenkumham

validate-loe digunakan untuk melakukan validasi terhadap berkas SK Kemenkumham asli dari sebuah URL yang telah ditentukan.

Method	API endpoint
`POST`	/validate-loe

Contoh Permintaan Cek SK Kemenkumham

Contoh Respon Sukses Cek SK Kemenkumham

{
    "info": {
        "requestID": "60e9d0f134e73e03b4710569",
        "fileName": "SK-Kemenkumham.pdf",
        "validationDate": "1625936113",
        "creditRemaining": 307
    },
    "data": {
        "namaPerseroan": "PT NAMA PERSEROAN",
        "nomorSK": "AHU-0000000.AA.00.00.Tahun 2000",
        "notarisPembuat": "Nama Notaris, SH",
        "nomorAkta": "00",
        "tanggalAkta": "1 Januari 2000",
        "tanggalDitetapkan": "1 Januari 2000",
        "tanggalDicetak": "1 Januari 2000",
        "keterangan": "Keterangan"
    }
}

Contoh Respon Gagal

QRCode tidak berhasil ditemukan pada dokumen PDF

{
    "requestID": "6034a520cb204477b3b4aa1a",
    "error": 422,
    "message": "QRCode Not Found"
}

URL dokumen PDF faktur pajak yang akan diperiksa tidak valid

{
    "requestID": "6034a520cb204477b3b4aa1a",
    "error": 400,
    "message": "documentURL Not Valid"
}