# Simpan CK-1

## Introduction

* Purpose: API ini digunakan untuk simpan CK-1
* Overview: Proses simpan CK-1 mensyaratkan 2 object data dalam bentuk JSON yaitu Header dan Detail

## Path API

<mark style="color:green;">`POST`</mark> `{API_URL}/ck1/h2h/simpanCk1`

## 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>

## Request Structure

Top-Level Object: Struktur data Dalam Bentuk Top Level JSON Schema

```
{
  "header": { ... },
  "details": [ ... ]
}
```

### Header Section&#x20;

<table><thead><tr><th width="234">Parameter Name</th><th width="110">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>alamatPerusahaan</td><td>String</td><td>Alamat lengkap perusahaan</td><td>JALAN DEMANG JAYA 2 NOMOR 03 KREBET SENGGRONG KECAMATAN BULULAWANG KABUPATEN MALANG</td></tr><tr><td>ambilPitaCukai</td><td>String</td><td>Lokasi ambil pita cukai</td><td>KC</td></tr><tr><td>caraBayar</td><td>String</td><td>Cara pembayaran</td><td>T</td></tr><tr><td>idKuasa</td><td>String</td><td>ID kuasa</td><td>49202a82-4a42-4c08-9000-4d4c95f91016</td></tr><tr><td>idNppbkc</td><td>String</td><td>ID Nomor Pokok Pengusaha Barang Kena Cukai</td><td>fe3c9198-1af7-05e6-e054-0021f60abd54</td></tr><tr><td>jumlahCukaiDibayar</td><td>String</td><td>Jumlah cukai yang telah dibayar</td><td>385000</td></tr><tr><td>jumlahCukaiPengurang</td><td>String</td><td>Jumlah cukai yang dikurangkan</td><td>425000</td></tr><tr><td>kodeKantor</td><td>String</td><td>Kode kantor pengawasan</td><td>70600</td></tr><tr><td>komentar</td><td>String</td><td>Komentar tambahan</td><td>-</td></tr><tr><td>namaKantor</td><td>String</td><td>Nama kantor pengawasan</td><td>KPPBC TMC MALANG</td></tr><tr><td>namaKuasaPita</td><td>String</td><td>Nama kuasa pita</td><td>Ilham</td></tr><tr><td>namaPembohon</td><td>String</td><td>Nama pemohon</td><td>Zaeen</td></tr><tr><td>namaPerusahaan</td><td>String</td><td>Nama perusahaan</td><td>DEMANG JAYA, PR</td></tr><tr><td>nppbkc</td><td>String</td><td>Nomor Pokok Pengusaha Barang Kena Cukai</td><td>0669986374654000070613</td></tr><tr><td>npwp</td><td>String</td><td>Nomor Pokok Wajib Pajak</td><td>669986374654000</td></tr><tr><td>ppn</td><td>Number</td><td>Nilai Pajak Pertambahan Nilai (PPN)</td><td>891</td></tr><tr><td>tanggalCk1</td><td>Date</td><td>Tanggal CK-1</td><td>07-11-2023</td></tr><tr><td>idJenisBkc</td><td>Integer</td><td>ID jenis barang kena cukai</td><td>3</td></tr><tr><td>namaJenisBkc</td><td>String</td><td>Nama jenis barang kena cukai</td><td>HT</td></tr><tr><td>jumlahCukai</td><td>String</td><td>Total jumlah cukai</td><td>810000</td></tr><tr><td>nomorKuasa</td><td>String</td><td>Nomor kuasa</td><td>111111</td></tr></tbody></table>

### Detail Section

<table><thead><tr><th width="225">Parameter Name</th><th width="102">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>hje</td><td>String</td><td>Harga Jual Eceran per kemasan</td><td>20000</td></tr><tr><td>idGolonganBkc</td><td>Integer</td><td>ID golongan barang kena cukai</td><td>2</td></tr><tr><td>idMerk</td><td>String</td><td>ID merk produk</td><td>628a9946-e590-4201-a76c-efd299738184</td></tr><tr><td>idP3CDetail</td><td>String</td><td>ID detail P3C</td><td>052cc2b6-849b-4737-e064-0021f60abd54</td></tr><tr><td>idSeripita</td><td>Integer</td><td>ID seri pita cukai</td><td>3</td></tr><tr><td>isiVolume</td><td>String</td><td>Isi volume</td><td>12</td></tr><tr><td>jumlahCukai</td><td>String</td><td>Jumlah cukai yang dikenakan</td><td>810000</td></tr><tr><td>jumlahHje</td><td>String</td><td>Jumlah harga jual eceran</td><td>9000</td></tr><tr><td>jumlahLembar</td><td>String</td><td>Jumlah lembar pita cukai</td><td>3</td></tr><tr><td>jumlahLembarPending</td><td>String</td><td>Jumlah lembar pita cukai yang pending</td><td>0</td></tr><tr><td>jumlahSatuan</td><td>String</td><td>Jumlah satuan barang</td><td>12</td></tr><tr><td>jumlahPesan</td><td>String</td><td>Jumlah pesanan pita cukai</td><td>100</td></tr><tr><td>kodeJenisProduksiBkc</td><td>String</td><td>Kode jenis produksi barang kena cukai</td><td>SKM</td></tr><tr><td>kodeWarna</td><td>String</td><td>Kode warna pita cukai</td><td>JI</td></tr><tr><td>namaGolonganBkc</td><td>String</td><td>Nama golongan barang kena cukai</td><td>I</td></tr><tr><td>namaMerk</td><td>String</td><td>Nama merk produk</td><td>SEMBILAN CENGKEH</td></tr><tr><td>namaSeripita</td><td>String</td><td>Nama seri pita cukai</td><td>III TP</td></tr><tr><td>personalisasi</td><td>String</td><td>Kode personalisasi pita cukai</td><td>DEMAJAYA01</td></tr><tr><td>satuan</td><td>String</td><td>Satuan pengukuran barang</td><td>btg</td></tr><tr><td>tahunPita</td><td>String</td><td>Tahun pita cukai</td><td>2023</td></tr><tr><td>tarif</td><td>String</td><td>Tarif cukai</td><td>150</td></tr><tr><td>warna</td><td>String</td><td>Warna pita cukai</td><td>JINGGA</td></tr><tr><td>idJenisProduksiBkc</td><td>Integer</td><td>ID jenis produksi barang kena cukai</td><td>6</td></tr><tr><td>idJenisDokumen</td><td>Integer</td><td>ID jenis dokumen pengurang</td><td>7</td></tr><tr><td>jumlahCukaiPengurang</td><td>String</td><td>Jumlah cukai yang dikurangkan</td><td>425000</td></tr><tr><td>namaJenisDokumen</td><td>String</td><td>Nama jenis dokumen pengurang</td><td>CK-3</td></tr><tr><td>nomorDokumenPengurang</td><td>String</td><td>Nomor dokumen pengurang cukai</td><td>CK3-20230001</td></tr><tr><td>saldoPengurang</td><td>String</td><td>Saldo pengurang cukai</td><td>1000000</td></tr><tr><td>tanggalDokumenPengurang</td><td>Date</td><td>Tanggal dokumen pengurang cukai</td><td>20-09-2023</td></tr><tr><td>dokumenAsal</td><td>String</td><td>Nama dokumen asal pengurang SPPR</td><td>TESTINGDOC</td></tr><tr><td>jumlahPengurangSppr</td><td>String</td><td>Jumlah pengurang SPPR</td><td>9000</td></tr><tr><td>nomorDokumenAsal</td><td>String</td><td>Nomor dokumen asal</td><td>1221</td></tr><tr><td>nomorPr4</td><td>String</td><td>Nomor PR4</td><td>12345</td></tr><tr><td>pajakRokok</td><td>String</td><td>Pajak rokok yang dikenakan</td><td>1000</td></tr><tr><td>saldoPr4</td><td>String</td><td>Saldo PR4</td><td>10000</td></tr><tr><td>tanggalPr4</td><td>Date</td><td>Tanggal PR4</td><td>16-08-2023</td></tr></tbody></table>

## JSONSchema Simpan CK-1

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Simpan CK-1",
  "description": "JSON Schema untuk Simpan CK-1.",
  "properties": {
    "header": {
      "type": "object",
      "description": "Data header dokumen pabean.",
      "properties": {
        "alamatPerusahaan": {
          "type": "string",
          "description": "Alamat perusahaan."
        },
        "ambilPitaCukai": {
          "type": "string",
          "description": "Ambil pita cukai."
        },
        "caraBayar": {
          "type": "string",
          "description": "Cara bayar."
        },
        "idKuasa": {
          "type": "string",
          "format": "uuid",
          "description": "ID kuasa."
        },
        "idNppbkc": {
          "type": "string",
          "format": "uuid",
          "description": "ID NPPBKC."
        },
        "jumlahCukaiDibayar": {
          "type": "number",
          "description": "Jumlah cukai dibayar."
        },
        "jumlahCukaiPengurang": {
          "type": "number",
          "description": "Jumlah cukai pengurang."
        },
        "kodeKantor": {
          "type": "string",
          "description": "Kode kantor."
        },
        "komentar": {
          "type": "string",
          "description": "Komentar."
        },
        "namaKantor": {
          "type": "string",
          "description": "Nama kantor."
        },
        "namaKuasaPita": {
          "type": "string",
          "description": "Nama kuasa pita."
        },
        "namaPembohon": {
          "type": "string",
          "description": "Nama pemohon."
        },
        "namaPerusahaan": {
          "type": "string",
          "description": "Nama perusahaan."
        },
        "nppbkc": {
          "type": "string",
          "pattern": "^\\d{22}$",
          "description": "NPPBKC, harus terdiri dari 22 digit."
        },
        "npwp": {
          "type": "string",
          "pattern": "^\\d{15}$",
          "description": "NPWP, harus terdiri dari 15 digit."
        },
        "ppn": {
          "type": "number",
          "description": "PPN."
        },
        "tanggalCk1": {
          "type": "string",
          "format": "date",
          "description": "Tanggal CK1."
        },
        "idJenisBkc": {
          "type": "integer",
          "description": "ID jenis BKC."
        },
        "namaJenisBkc": {
          "type": "string",
          "description": "Nama jenis BKC."
        },
        "jumlahCukai": {
          "type": "number",
          "description": "Jumlah cukai."
        },
        "nomorKuasa": {
          "type": "string",
          "description": "Nomor kuasa."
        }
      },
      "required": [
        "alamatPerusahaan",
        "ambilPitaCukai",
        "caraBayar",
        "idKuasa",
        "idNppbkc",
        "jumlahCukaiDibayar",
        "jumlahCukaiPengurang",
        "kodeKantor",
        "namaKantor",
        "namaKuasaPita",
        "namaPembohon",
        "namaPerusahaan",
        "nppbkc",
        "npwp",
        "ppn",
        "tanggalCk1",
        "idJenisBkc",
        "namaJenisBkc",
        "jumlahCukai",
        "nomorKuasa"
      ],
      "message": {
        "required": "Wajib mengisi semua field pada header."
      }
    },
    "detail": {
      "type": "array",
      "description": "Data detail pita cukai.",
      "items": {
        "type": "object",
        "properties": {
          "hje": {
            "type": "integer",
            "description": "HJE."
          },
          "idGolonganBkc": {
            "type": "integer",
            "description": "ID golongan BKC."
          },
          "idMerk": {
            "type": "string",
            "format": "uuid",
            "description": "ID merk."
          },
          "idP3CDetail": {
            "type": "string",
            "format": "uuid",
            "description": "ID P3C detail."
          },
          "idSeripita": {
            "type": "integer",
            "description": "ID seripita."
          },
          "isiVolume": {
            "type": "integer",
            "description": "Isi volume."
          },
          "jumlahCukai": {
            "type": "number",
            "description": "Jumlah cukai."
          },
          "jumlahHje": {
            "type": "integer",
            "description": "Jumlah HJE."
          },
          "jumlahLembar": {
            "type": "integer",
            "description": "Jumlah lembar."
          },
          "jumlahLembarPending": {
            "type": "integer",
            "description": "Jumlah lembar pending."
          },
          "jumlahSatuan": {
            "type": "integer",
            "description": "Jumlah satuan."
          },
          "jumlahPesan": {
            "type": "integer",
            "description": "Jumlah pesan."
          },
          "kodeJenisProduksiBkc": {
            "type": "string",
            "description": "Kode jenis produksi BKC."
          },
          "kodeWarna": {
            "type": "string",
            "description": "Kode warna."
          },
          "namaGolonganBkc": {
            "type": "string",
            "description": "Nama golongan BKC."
          },
          "namaMerk": {
            "type": "string",
            "description": "Nama merk."
          },
          "namaSeripita": {
            "type": "string",
            "description": "Nama seripita."
          },
          "personalisasi": {
            "type": "string",
            "description": "Personalisasi."
          },
          "satuan": {
            "type": "string",
            "description": "Satuan."
          },
          "tahunPita": {
            "type": "integer",
            "description": "Tahun pita."
          },
          "tarif": {
            "type": "integer",
            "description": "Tarif."
          },
          "warna": {
            "type": "string",
            "description": "Warna."
          },
          "idJenisProduksiBkc": {
            "type": "integer",
            "description": "ID jenis produksi BKC."
          }
        },
        "required": [
          "hje",
          "idGolonganBkc",
          "idMerk",
          "idP3CDetail",
          "idSeripita",
          "isiVolume",
          "jumlahCukai",
          "jumlahHje",
          "jumlahLembar",
          "jumlahLembarPending",
          "jumlahSatuan",
          "jumlahPesan",
          "kodeJenisProduksiBkc",
          "kodeWarna",
          "namaGolonganBkc",
          "namaMerk",
          "namaSeripita",
          "personalisasi",
          "satuan",
          "tahunPita",
          "tarif",
          "warna",
          "idJenisProduksiBkc"
        ],
        "message": {
          "required": "Wajib mengisi semua field pada detail."
        }
      }
    },
    "pengurangCukai": {
      "type": "array",
      "description": "Data pengurang cukai.",
      "items": {
        "type": "object",
        "properties": {
          "idJenisDokumen": {
            "type": "integer",
            "description": "ID jenis dokumen."
          },
          "jumlahCukaiPengurang": {
            "type": "number",
            "description": "Jumlah cukai pengurang."
          },
          "namaJenisDokumen": {
            "type": "string",
            "description": "Nama jenis dokumen."
          },
          "nomorDokumenPengurang": {
            "type": "string",
            "description": "Nomor dokumen pengurang."
          },
          "saldoPengurang": {
            "type": "number",
            "description": "Saldo pengurang."
          },
          "tanggalDokumenPengurang": {
            "type": "string",
            "format": "date",
            "description": "Tanggal dokumen pengurang."
          }
        },
        "required": [
          "idJenisDokumen",
          "jumlahCukaiPengurang",
          "namaJenisDokumen",
          "nomorDokumenPengurang",
          "saldoPengurang",
          "tanggalDokumenPengurang"
        ],
        "message": {
          "required": "Wajib mengisi semua field pada pengurangCukai."
        }
      }
    },
    "pengurangSppr": {
      "type": "array",
      "description": "Data pengurang SPPR.",
      "items": {
        "type": "object",
        "properties": {
          "dokumenAsal": {
            "type": "string",
            "description": "Dokumen asal."
          },
          "jumlahPengurangSppr": {
            "type": "number",
            "description": "Jumlah pengurang SPPR."
          },
          "nomorDokumenAsal": {
            "type": "string",
            "description": "Nomor dokumen asal."
          },
          "nomorPr4": {
            "type": "string",
              "description": "Nomor PR4."
          },
          "pajakRokok": {
            "type": "number",
            "description": "Pajak rokok."
          },
          "saldoPr4": {
            "type": "string",
            "description": "Saldo PR4."
          }
          "tanggalPr4": {
            "type": "string",
            "format": "date",
            "description": "Tanggal PR4."
          }
        },
        "required": [
          "dokumenAsal",
          "jumlahPengurangSppr",
          "nomorDokumenAsal",
          "nomorPr4",
          "pajakRokok",
          "saldoPr4",
          "tanggalPr4""
        ],
        "message": {
          "required": "Wajib mengisi semua field pada pengurangSppr."
        }
      }
    }
  }
}
```

## JSON Example : Simpan CK-1

```json
{
  "header": {
    "alamatPerusahaan": "JALAN DEMANG JAYA 2 NOMOR 03 KREBET SENGGRONG KECAMATAN BULULAWANG KABUPATEN MALANG",
    "ambilPitaCukai": "KC",
    "caraBayar": "T",
    "idKuasa": "49202a82-4a42-4c08-9000-4d4c95f91016",
    "idNppbkc": "fe3c9198-1af7-05e6-e054-0021f60abd54",
    "jumlahCukaiDibayar": 385000,
    "jumlahCukaiPengurang": 425000,
    "kodeKantor": "070600",
    "komentar": "",
    "namaKantor": "KPPBC TMC MALANG",
    "namaKuasaPita": "Ilham",
    "namaPembohon": "Zaeen",
    "namaPerusahaan": "DEMANG JAYA, PR",
    "nppbkc": "0669986374654000070613",
    "npwp": "669986374654000",
    "ppn": 891,
    "tanggalCk1": "07-11-2023",
    "idJenisBkc": 3,
    "namaJenisBkc": "HT",
    "jumlahCukai": 810000,
    "nomorKuasa": "111111"
  },
  "detail": [
    {
      "hje": 20000,
      "idGolonganBkc": 2,
      "idMerk": "628a9946-e590-4201-a76c-efd299738184",
      "idP3CDetail": "052cc2b6-849b-4737-e064-0021f60abd54",
      "idSeripita": 3,
      "isiVolume": 12,
      "jumlahCukai": 810000,
      "jumlahHje": 9000,
      "jumlahLembar": 3,
      "jumlahLembarPending": 0,
      "jumlahSatuan": 12,
"jumlahPesan": 100,
      "kodeJenisProduksiBkc": "SKM",
      "kodeWarna": "JI",
      "namaGolonganBkc": "I",
      "namaMerk": "SEMBILAN CENGKEH",
      "namaSeripita": "III TP",
      "personalisasi": "DEMAJAYA01",
      "satuan": "btg",
      "tahunPita": 2023,
      "tarif": 150,
      "warna": "JINGGA",
      "idJenisProduksiBkc": 6
    }
  ],
  "pengurangCukai": [
    {
      "idJenisDokumen": 7,
      "jumlahCukaiPengurang": 425000,
      "namaJenisDokumen": "CK-3",
      "nomorDokumenPengurang": "CK3-20230001",
      "saldoPengurang": 1000000,
      "tanggalDokumenPengurang": "20-09-2023"
    }
  ],
  "pengurangSppr": [
    {
      "dokumenAsal": "TESTINGDOC",
      "jumlahPengurangSppr": 9000,
      "nomorDokumenAsal": "1221",
      "nomorPr4": "12345",
      "pajakRokok": 1000,
      "saldoPr4": 10000,
      "tanggalPr4": "16-08-2023"
    }
  ],
  "jumlahCukaiPengurang": 425000,
  "jumlahCukaiDibayar": 385000,
  "jumlahCukaiPembulatan": 385000
}
```

## Validation Rules

<table><thead><tr><th width="316">Field</th><th>Rules</th></tr></thead><tbody><tr><td>idKuasa</td><td>Harus merupakan UUID yang valid.</td></tr><tr><td>idNppbkc</td><td>Harus merupakan UUID yang valid.</td></tr><tr><td>jumlahCukaiDibayar</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahCukaiPengurang</td><td>Harus berupa angka positif</td></tr><tr><td>tanggalCk1</td><td>Harus dalam format DD-MM-YYYY</td></tr><tr><td>jumlahCukai</td><td>Harus berupa angka positif</td></tr><tr><td>hje</td><td>Harus berupa angka positif</td></tr><tr><td>idMerk</td><td>Harus merupakan UUID yang valid.</td></tr><tr><td>idP3CDetail</td><td>Harus merupakan UUID yang valid.</td></tr><tr><td>jumlahCukai</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahHje</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahLembar</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahLembarPending</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahSatuan</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahPesan</td><td>Harus berupa angka positif</td></tr><tr><td>tarif</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahCukaiPengurang</td><td>Harus berupa angka positif</td></tr><tr><td>saldoPengurang</td><td>Harus berupa angka positif</td></tr><tr><td>tanggalDokumenPengurang</td><td>Harus dalam format DD-MM-YYYY</td></tr><tr><td>jumlahPengurangSppr</td><td>Harus berupa angka positif</td></tr><tr><td>saldoPr4</td><td>Harus berupa angka positif</td></tr><tr><td>tanggalPr4</td><td>Harus dalam format DD-MM-YYYY</td></tr></tbody></table>

## Response

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

```json
{
  "message": "Tidak Boleh Lanjut, Dikarenakan Perusahaan Mempunyai Hutang",
  "status": true,
  "data": {
    "hutangPerusahaan": 4
  }
}
```

{% endtab %}
{% endtabs %}

## Potential Error

<table><thead><tr><th width="189">Status Code</th><th width="213">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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ceisa40.gitbook.io/pia-ceisa40/api-service-cukai/cukai-portal-service/simpan-ck-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.