> For the complete documentation index, see [llms.txt](https://ceisa40.gitbook.io/pia-ceisa40/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ceisa40.gitbook.io/pia-ceisa40/api-service-cukai/cukai-portal-service/simpan-p3c-pengecualian.md).

# Simpan P3C Pengecualian

## Introduction

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

## Path API

<mark style="color:green;">`POST`</mark> `{API_URL}/perekaman-p3c-pengecualian/h2h/simpanP3cPengecualian`

## 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 (saveHeaderPojo)

<table><thead><tr><th width="219">Parameter Name</th><th width="113">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>alamatPerusahaan</td><td>String</td><td>Alamat dari perusahaan</td><td>-</td></tr><tr><td>ambilPitaCukai</td><td>String</td><td>Tipe pengambilan pita cukai</td><td>KP</td></tr><tr><td>bulanPersediaan</td><td>String</td><td>Bulan persediaan barang kena cukai</td><td>82023</td></tr><tr><td>idJenisBkc</td><td>String</td><td>ID jenis barang kena cukai</td><td>3</td></tr><tr><td>idJenisPeriodeP3c</td><td>String</td><td>ID jenis periode pelaporan P3C</td><td>1</td></tr><tr><td>idNppbkc</td><td>String</td><td>ID NPPBKC (Nomor Pokok Pengusaha Barang Kena Cukai)</td><td>fe3c9198-1065-05e6-e054-0021f60abd54</td></tr><tr><td>kodeKantor</td><td>String</td><td>Kode kantor</td><td>70600</td></tr><tr><td>namaJenisBkc</td><td>String</td><td>Nama jenis barang kena cukai</td><td>HT</td></tr><tr><td>namaJenisPeriodeP3C</td><td>String</td><td>Nama jenis periode pelaporan P3C</td><td>Awal</td></tr><tr><td>namaKantor</td><td>String</td><td>Nama kantor</td><td>KPPBC TMC MALANG</td></tr><tr><td>namaPejabat</td><td>String</td><td>Nama pejabat yang berwenang</td><td>ALOYSIUS RADJA SINGAL BBPS</td></tr><tr><td>namaPerusahaan</td><td>String</td><td>Nama perusahaan yang melaporkan</td><td>BENTOEL PRIMA, PT</td></tr><tr><td>nomorP3C</td><td>String</td><td>Nomor P3C</td><td>123</td></tr><tr><td>nppbkc</td><td>String</td><td>Nomor Pokok Pengusaha Barang Kena Cukai</td><td>0015866924651000070623</td></tr><tr><td>npwp</td><td>String</td><td>Nomor Pokok Wajib Pajak</td><td>15866924651000</td></tr><tr><td>status</td><td>String</td><td>Status pelaporan</td><td>-</td></tr><tr><td>tanggalP3C</td><td>Date</td><td>Tanggal pelaporan P3C</td><td>2023-08-21</td></tr><tr><td>tanggalPermohonan</td><td>Date</td><td>Tanggal permohonan pelaporan</td><td>2023-08-21</td></tr></tbody></table>

### Detail Section (savePitaCukaiDto)

<table><thead><tr><th width="223">Parameter Name</th><th width="124">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>hje</td><td>String</td><td>Harga Jual Eceran</td><td>25101</td></tr><tr><td>idGolonganBkc</td><td>String</td><td>ID golongan barang kena cukai</td><td>3</td></tr><tr><td>idJenisPitaCukai</td><td>String</td><td>ID jenis pita cukai</td><td>c9a4e440-811b-4073-81e8-f85d0bc85560</td></tr><tr><td>idJenisProduksiBkc</td><td>String</td><td>ID jenis produksi barang kena cukai</td><td>6</td></tr><tr><td>idSeripita</td><td>String</td><td>ID seri pita</td><td>3</td></tr><tr><td>isiVolume</td><td>String</td><td>Volume isi per kemasan</td><td>25</td></tr><tr><td>jumlahCukai</td><td>String</td><td>Jumlah cukai yang dikenakan</td><td>0</td></tr><tr><td>jumlahPesan</td><td>String</td><td>Jumlah pesan pita cukai</td><td>212</td></tr><tr><td>jumlahRekomendasi</td><td>String</td><td>Jumlah rekomendasi pengambilan pita cukai</td><td>0</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>maksimalPesan</td><td>String</td><td>Jumlah maksimal pesan pita cukai</td><td>0</td></tr><tr><td>namaGolonganBkc</td><td>String</td><td>Nama golongan barang kena cukai</td><td>III</td></tr><tr><td>namaSeripita</td><td>String</td><td>Nama seri pita</td><td>-</td></tr><tr><td>personalisasi</td><td>String</td><td>Kode personalisasi untuk produk</td><td>BINSAYIN00</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>669</td></tr><tr><td>warna</td><td>String</td><td>Warna pita cukai</td><td>JINGGA</td></tr><tr><td>flagKawasanBebas</td><td>String</td><td>Indikator apakah kawasan bebas</td><td>N</td></tr><tr><td>kodeSatuan</td><td>String</td><td>Satuan volume barang kena cukai</td><td>btg</td></tr></tbody></table>

## JSONSchema Simpan P3C Pengecualian

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Simpan P3C Pengecualian",
  "description": "JSON Schema untuk Simpan P3C Pengecualian.",
  "properties": {
    "saveHeaderPojo": {
      "type": "object",
      "description": "Data header dokumen pabean.",
      "properties": {
        "alamatPerusahaan": {
          "type": "string",
          "description": "Alamat perusahaan."
        },
        "ambilPitaCukai": {
          "type": "string",
          "description": "Ambil pita cukai."
        },
        "bulanPersediaan": {
          "type": "string",
          "description": "Bulan persediaan, format MMYYYY."
        },
        "idJenisBkc": {
          "type": "integer",
          "description": "ID jenis BKC."
        },
        "idJenisPeriodeP3c": {
          "type": "integer",
          "description": "ID jenis periode P3C."
        },
        "idNppbkc": {
          "type": "string",
          "format": "uuid",
          "description": "ID NPPBKC."
        },
        "kodeKantor": {
          "type": "string",
          "description": "Kode kantor."
        },
        "namaJenisBkc": {
          "type": "string",
          "description": "Nama jenis BKC."
        },
        "namaJenisPeriodeP3C": {
          "type": "string",
          "description": "Nama jenis periode P3C."
        },
        "namaKantor": {
          "type": "string",
          "description": "Nama kantor."
        },
        "namaPejabat": {
          "type": "string",
          "description": "Nama pejabat."
        },
        "namaPerusahaan": {
          "type": "string",
          "description": "Nama perusahaan."
        },
        "nomorP3C": {
          "type": "string",
          "description": "Nomor P3C."
        },
        "nppbkc": {
          "type": "string",
          "description": "NPPBKC, harus terdiri dari 22 digit."
        },
        "npwp": {
          "type": "string",
          "description": "NPWP, harus terdiri dari 15 digit."
        },
        "status": {
          "type": "string",
          "description": "Status."
        },
        "tanggalP3C": {
          "type": "string",
          "format": "date",
          "description": "Tanggal P3C."
        },
        "tanggalPermohonan": {
          "type": "string",
          "format": "date",
          "description": "Tanggal permohonan."
        }
      },
      "required": [
        "alamatPerusahaan",
        "ambilPitaCukai",
        "bulanPersediaan",
        "idJenisBkc",
        "idJenisPeriodeP3c",
        "idNppbkc",
        "kodeKantor",
        "namaJenisBkc",
        "namaJenisPeriodeP3C",
        "namaKantor",
        "namaPejabat",
        "namaPerusahaan",
        "nomorP3C",
        "nppbkc",
        "npwp",
        "status",
        "tanggalP3C",
        "tanggalPermohonan"
      ],
      "message": {
        "required": "Wajib mengisi semua field pada saveHeaderPojo."
      }
    },
    "savePitaCukaiDto": {
      "type": "array",
      "description": "Data pita cukai.",
      "items": {
        "type": "object",
        "properties": {
          "hje": {
            "type": "integer",
            "description": "HJE."
          },
          "idGolonganBkc": {
            "type": "integer",
            "description": "ID golongan BKC."
          },
          "idJenisPitaCukai": {
            "type": "string",
            "format": "uuid",
            "description": "ID jenis pita cukai."
          },
          "idJenisProduksiBkc": {
            "type": "integer",
            "description": "ID jenis produksi BKC."
          },
          "idSeripita": {
            "type": "integer",
            "description": "ID seripita."
          },
          "isiVolume": {
            "type": "integer",
            "description": "Isi volume."
          },
          "jumlahCukai": {
            "type": "number",
            "description": "Jumlah cukai."
          },
          "jumlahPesan": {
            "type": "integer",
            "description": "Jumlah pesan."
          },
          "jumlahRekomendasi": {
            "type": "integer",
            "description": "Jumlah rekomendasi."
          },
          "kodeJenisProduksiBkc": {
            "type": "string",
            "description": "Kode jenis produksi BKC."
          },
          "kodeWarna": {
            "type": "string",
            "description": "Kode warna."
          },
          "maksimalPesan": {
            "type": "integer",
            "description": "Maksimal pesan."
          },
          "namaGolonganBkc": {
            "type": "string",
            "description": "Nama golongan BKC."
          },
          "namaSeripita": {
            "type": "string",
            "description": "Nama seripita."
          },
          "personalisasi": {
            "type": "string",
            "description": "Personalisasi."
          },
          "tahunPita": {
            "type": "integer",
            "description": "Tahun pita."
          },
          "tarif": {
            "type": "integer",
            "description": "Tarif."
          },
          "warna": {
            "type": "string",
            "description": "Warna."
          },
          "flagKawasanBebas": {
            "type": "string",
            "description": "Flag kawasan bebas."
          },
          "kodeSatuan": {
            "type": "string",
            "description": "Kode satuan."
          }
        },
        "required": [
          "hje",
          "idGolonganBkc",
          "idJenisPitaCukai",
          "idJenisProduksiBkc",
          "idSeripita",
          "isiVolume",
          "jumlahCukai",
          "jumlahPesan",
          "jumlahRekomendasi",
          "kodeJenisProduksiBkc",
          "kodeWarna",
          "maksimalPesan",
          "namaGolonganBkc",
          "namaSeripita",
          "personalisasi",
          "tahunPita",
          "tarif",
          "warna",
          "flagKawasanBebas",
          "kodeSatuan"
        ],
        "message": {
          "required": "Wajib mengisi semua field pada savePitaCukaiDto."
        }
      }
    }
  },
  "required": [
    "saveHeaderPojo",
    "savePitaCukaiDto"
  ],
  "message": {
    "required": "Wajib mengisi data saveHeaderPojo dan savePitaCukaiDto."
  }
}

```

## JSON Example : Simpan P3C Pengecualian

```json
{
    "saveHeaderPojo": {
        "alamatPerusahaan": "-",
        "ambilPitaCukai": "KP",
        "bulanPersediaan": "082023",
        "idJenisBkc": 3,
        "idJenisPeriodeP3c": 1,
        "idNppbkc": "fe3c9198-1065-05e6-e054-0021f60abd54",
        "kodeKantor": "070600",
        "namaJenisBkc": "HT",
        "namaJenisPeriodeP3C": "Awal",
        "namaKantor": "KPPBC TMC MALANG",
        "namaPejabat": "ALOYSIUS RADJA SINGAL BBPS",
        "namaPerusahaan": "BENTOEL PRIMA, PT",
        "nomorP3C": "123",
        "nppbkc": "0015866924651000070623",
        "npwp": "015866924651000",
        "status": "-",
        "tanggalP3C": "2023-08-21",
        "tanggalPermohonan": "2023-08-21"
    },
    "savePitaCukaiDto": [
        {
            "hje": 25101,
            "idGolonganBkc": 3,
            "idJenisPitaCukai": "c9a4e440-811b-4073-81e8-f85d0bc85560",
            "idJenisProduksiBkc": 6,
            "idSeripita": 3,
            "isiVolume": 25,
            "jumlahCukai": 0,
            "jumlahPesan": 212,
            "jumlahRekomendasi": 0,
            "kodeJenisProduksiBkc": "SKM",
            "kodeWarna": "JI",
            "maksimalPesan": 0,
            "namaGolonganBkc": "III",
            "namaSeripita": "-",
            "personalisasi": "BINSAYIN00",
            "tahunPita": 2023,
            "tarif": 669,
            "warna": "JINGGA",
            "flagKawasanBebas": "N",
            "kodeSatuan" : "btg" 
        }
    ]
}
```

## Validation Rules

<table><thead><tr><th width="277">Field</th><th>Rules</th></tr></thead><tbody><tr><td>idNppbkc</td><td>Harus merupakan UUID yang valid.</td></tr><tr><td>tanggalP3C</td><td>Harus dalam format YYYY-MM-DD</td></tr><tr><td>tanggalPermohonan</td><td>Harus dalam format YYYY-MM-DD</td></tr><tr><td>idJenisPitaCukai</td><td>Harus merupakan UUID yang valid</td></tr><tr><td>jumlahCukai</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahPesan</td><td>Harus berupa angka positif</td></tr><tr><td>jumlahRekomendasi</td><td>Harus berupa angka positif</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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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-p3c-pengecualian.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.