# Get Saldo Pita Cukai (by id P3C detail)

## Introduction

* Purpose   : API ini digunakan untuk mendapatkan informasi saldo pita cukai berdasarkan parameter ID detail P3C yang diberikan
* Overview : Proses ini membutuhkan otentikasi menggunakan Bearer Token dan harus dikirim dengan metode GET



## Path API

<mark style="color:blue;">`GET`</mark> `{API_URL}/be/host-to-host/saldo-pita-cukai/getSaldoPitaCukaiById?idNppbkc={idNppbkc}&idP3cDetail={idP3cDetail}&page={page}`



## Authorization

<table><thead><tr><th width="181">Name</th><th width="126">Type </th><th>Description</th></tr></thead><tbody><tr><td>Authorization</td><td>String</td><td>Bearer Token yang didapatkan dari hasil otorisasi</td></tr></tbody></table>



## Parameter

<table><thead><tr><th width="197">Name</th><th width="117">Type</th><th width="233">Description</th><th>Example Value</th></tr></thead><tbody><tr><td>idNppbkc</td><td>String</td><td>Identifikasi unik untuk NPPBKC (Nomor Pokok Pengusaha Barang Kena Cukai)</td><td>111e2222-e89b-12d3-a456-426614174001</td></tr><tr><td>idP3cDetail</td><td>String</td><td>Identifikasi unik untuk detail P3C</td><td>fe8acc9c-3818-802c-e054-90e2ba68fe24</td></tr><tr><td>page</td><td>Integer</td><td>Nomor Halaman</td><td>1</td></tr></tbody></table>



## Parameter Example

<mark style="color:blue;">`GET`</mark> `{API_URL}/be/host-to-host/saldo-pita-cukai/getSaldoPitaCukaiById?idNppbkc=111e2222-e89b-12d3-a456-426614174001&idP3cDetail=fe8acc9c-3818-802c-e054-90e2ba68fe24&page=1`



## Response

{% tabs %}
{% tab title="200" %}
```json
{
  "message": "Success",
  "status": true,
  "data": {
    "header": {
      "nomorObc": "30007",
      "kodeKantor": "070600",
      "namaKantor": "KPPBC TMC MALANG",
      "nppbkc": "0028079515623000070623",
      "tanggalP3c": "2023-09-03",
      "kodeWarna": "AB",
      "warna": "ABU-ABU",
      "namaSeripita": "III TP",
      "idP3cDetail": "fe8acc9c-3818-802c-e054-90e2ba68fe24",
      "idJenisBkc": "3",
      "idSeripita": 3,
      "isiVolume": 4.8,
      "tarif": 6,
      "hje": 37,
      "idP3cHeader": "fe8acc9c-3809-802c-e054-90e2ba68fe24",
      "nomorP3c": "000693",
      "namaPerusahaan": "BENTOEL DISTRIBUSI UTAMA, PT",
      "kodeJenisProduksiBkc": "REL",
      "idNppbkc": "111e2222-e89b-12d3-a456-426614174001",
      "ambilPitaCukai": "KP",
      "personalisasi": "-",
      "tahunPita": 2023,
      "tanggalOBC": "0008-03-15"
    },
    "detail": []
  }
}
```
{% endtab %}
{% endtabs %}

## Potential Error

<table><thead><tr><th width="188">Status Code</th><th width="210">Description</th><th>Reason</th></tr></thead><tbody><tr><td>400 Bad Request</td><td>Permintaan tidak valid</td><td>Parameter tidak lengkap atau format tidak sesuai</td></tr><tr><td>401 Unauthorized</td><td>Otentikasi gagal</td><td>Bearer Token tidak valid atau tidak disertakan dalam header permintaan</td></tr><tr><td>404 Not Found</td><td>Dokumen tidak ditemukan</td><td>Data tidak ditemukan berdasarkan parameter yang diberikan</td></tr></tbody></table>

