# Get Saldo CK-1C (by Id Header)

## Introduction

* Purpose   : API ini digunakan untuk mendapatkan informasi saldo CK-1C berdasarkan parameter 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}/ck1c/portal/getSaldoCk1cById?idSaldoCk1cHeader={idSaldoCk1cHeader}`

## 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="129">Name</th><th width="117">Type</th><th width="268">Description</th><th>Example Value</th></tr></thead><tbody><tr><td>idSaldoCk1cHeader</td><td>String</td><td>Identifikasi unik untuk saldo header CK-1C</td><td>f7f0a0f4-6b15-4d11-824f-0df8a03abf22</td></tr></tbody></table>

## Parameter Example

<mark style="color:blue;">`GET`</mark> `{API_URL}/ck1c/portal/getSaldoCk1cById?idSaldoCk1cHeader=f7f0a0f4-6b15-4d11-824f-0df8a03abf22`

## Response

{% tabs %}
{% tab title="200" %}

```json
{
  "message": "Success",
  "status": true,
  "data": {
    "header": {
      "saldoLiter": 15,
      "namaMerk": "Merk A",
      "jumlahKemasan": 100,
      "isiMililiter": 200,
      "namaJenisKemasan": "Jenis Kemasan A",
      "isiLiter": 0,
      "tarifCukai": 1000,
      "nomorCk1c": "000101",
      "tanggalCk1c": "2023-08-10T09:59:31.843+00:00",
      "namaKantor": "KPPBC Jakarta",
      "nppbkc": "0026722918048000040422",
      "idSaldoCk1cHeader": "f7f0a0f4-6b15-4d11-824f-0df8a03abf22",
      "namaPerusahaan": "PANTJA ARTHA NIAGA, PT.",
      "kodeKantor": "050600"
    },
    "details": [
      {
        "idSaldoCk1cHeader": "f7f0a0f4-6b15-4d11-824f-0df8a03abf22",
        "tanggalDokumen": "2023-08-13T01:30:00.000+00:00",
        "nomorDokumen": "DOK987",
        "saldo": 15,
        "namaJenisDokumen": "CK-5",
        "idCk1cDetail": "10762b58-7a34-4a62-867f-65dba0ef1275",
        "idSaldoCk1cDetail": "4b5c6d7e-8f9a-0b1c-2d3e-4f5a6b7c8d9e",
        "kodeTransaksi": "K",
        "jumlahTransaksi": 5
      }
    ]
  }
}
```

{% 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>