# Simpan P3C

## Introduction

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

## Path API

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

## 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="232">Parameter Name</th><th width="89">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>idJenisP3c</td><td>Integer</td><td>ID jenis P3C</td><td>1</td></tr><tr><td>alamatPerusahaan</td><td>String</td><td>Alamat lengkap perusahaan</td><td>Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten</td></tr><tr><td>ambilPitaCukai</td><td>String</td><td>Kode pengambilan pita cukai</td><td>KC</td></tr><tr><td>bulanPersediaan</td><td>String</td><td>Bulan dan tahun persediaan dalam format MMYYYY</td><td>92024</td></tr><tr><td>idJenisBkc</td><td>Integer</td><td>ID jenis BKC</td><td>2</td></tr><tr><td>idJenisPeriodeP3c</td><td>Integer</td><td>ID jenis periode P3C</td><td>1</td></tr><tr><td>idNppbkc</td><td>String</td><td>ID NPPBKC</td><td>0499af9b-f53b-40c7-b1f8-9b16c9f89b76</td></tr><tr><td>kodeKantor</td><td>String</td><td>Kode kantor</td><td>150300</td></tr><tr><td>namaJenisBkc</td><td>String</td><td>Nama jenis BKC</td><td>-</td></tr><tr><td>namaJenisPeriodeP3C</td><td>String</td><td>Nama jenis periode P3C</td><td>Awal</td></tr><tr><td>namaPejabat</td><td>String</td><td>Nama pejabat yang bertanggung jawab</td><td>HENDRY</td></tr><tr><td>namaPerusahaan</td><td>String</td><td>Nama perusahaan</td><td>PANJANG JIWO PT</td></tr><tr><td>nppbkc</td><td>String</td><td>Nomor pokok perusahaan barang kena cukai</td><td>0014539407415000150312</td></tr><tr><td>npwp</td><td>String</td><td>Nomor pokok wajib pajak</td><td>14539407415000</td></tr><tr><td>idJenisUsaha</td><td>Integer</td><td>ID jenis usaha</td><td>1</td></tr><tr><td>tanggalPermohonan</td><td>String</td><td>Tanggal permohonan dalam format YYYY-MM-DD</td><td>2024-08-01</td></tr></tbody></table>

### Detail Section >> savePitaCukaiDto

<table><thead><tr><th width="233">Parameter Name</th><th width="86">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>hje</td><td>Integer</td><td>Harga Jual Eceran</td><td>100</td></tr><tr><td>idGolonganBkc</td><td>Integer</td><td>ID golongan BKC</td><td>4</td></tr><tr><td>idJenisPitaCukai</td><td>String</td><td>ID jenis pita cukai</td><td>dcc40afb-ff8b-4443-898d-22dde87b9e2c</td></tr><tr><td>idJenisProduksiBkc</td><td>Integer</td><td>ID jenis produksi BKC</td><td>13</td></tr><tr><td>idSeripita</td><td>Integer</td><td>ID seri pita</td><td>5</td></tr><tr><td>isiVolume</td><td>Integer</td><td>Isi volume pita cukai dalam ml</td><td>600</td></tr><tr><td>jumlahCukai</td><td>Integer</td><td>Jumlah cukai</td><td>5400000</td></tr><tr><td>jumlahPesan</td><td>Integer</td><td>Jumlah pesanan</td><td>10</td></tr><tr><td>jumlahRekomendasi</td><td>Integer</td><td>Jumlah rekomendasi</td><td>0</td></tr><tr><td>kodeJenisProduksiBkc</td><td>String</td><td>Kode jenis produksi BKC</td><td>A</td></tr><tr><td>kodeWarna</td><td>String</td><td>Kode warna pita cukai</td><td>HI</td></tr><tr><td>maksimalPesan</td><td>Integer</td><td>Maksimal jumlah pesanan</td><td>0</td></tr><tr><td>namaGolonganBkc</td><td>String</td><td>Nama golongan BKC</td><td>IMPORTIR</td></tr><tr><td>namaSeripita</td><td>String</td><td>Nama seri pita</td><td>I</td></tr><tr><td>personalisasi</td><td>String</td><td>Personalisasi pita</td><td>-</td></tr><tr><td>tahunPita</td><td>Integer</td><td>Tahun pita cukai</td><td>2023</td></tr><tr><td>tarif</td><td>Integer</td><td>Tarif cukai per satuan</td><td>15000</td></tr><tr><td>warna</td><td>String</td><td>Warna pita cukai</td><td>Hijau</td></tr><tr><td>flagKawasanBebas</td><td>String</td><td>Flag kawasan bebas</td><td>N</td></tr><tr><td>kodeSatuan</td><td>String</td><td>Kode satuan</td><td>btg</td></tr></tbody></table>

## JSONSchema Simpan P3C

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Simpan P3C",
  "description": "JSON Schema untuk Simpan P3C.",
  "properties": {
    "saveHeaderPojo": {
      "type": "object",
      "properties": {
        "idJenisP3c": {
          "type": "integer",
          "description": "ID Jenis P3C."
        },
        "alamatPerusahaan": {
          "type": "string",
          "description": "Alamat perusahaan."
        },
        "ambilPitaCukai": {
          "type": "string",
          "description": "Ambil pita cukai."
        },
        "bulanPersediaan": {
          "type": "string",
          "description": "Bulan persediaan dalam 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."
        },
        "namaPejabat": {
          "type": "string",
          "description": "Nama pejabat."
        },
        "namaPerusahaan": {
          "type": "string",
          "description": "Nama perusahaan."
        },
        "nppbkc": {
          "type": "string",
          "description": "NPPBKC."
        },
        "npwp": {
          "type": "string",
          "description": "NPWP."
        },
        "idJenisUsaha": {
          "type": "integer",
          "description": "ID Jenis usaha."
        },
        "tanggalPermohonan": {
          "type": "string",
          "format": "date",
          "description": "Tanggal permohonan."
        }
      },
      "required": [
        "idJenisP3c",
        "alamatPerusahaan",
        "ambilPitaCukai",
        "bulanPersediaan",
        "idJenisBkc",
        "idJenisPeriodeP3c",
        "idNppbkc",
        "kodeKantor",
        "namaJenisBkc",
        "namaJenisPeriodeP3C",
        "namaPejabat",
        "namaPerusahaan",
        "nppbkc",
        "npwp",
        "idJenisUsaha",
        "tanggalPermohonan"
      ]
    },
    "savePitaCukaiDto": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "hje": {
            "type": "integer",
            "description": "Harga jual eceran."
          },
          "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 Seri Pita."
          },
          "isiVolume": {
            "type": "integer",
            "description": "Isi volume."
          },
          "jumlahCukai": {
            "type": "integer",
            "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 seri pita."
          },
          "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"
        ]
      }
    }
  },
  "required": [
    "saveHeaderPojo",
    "savePitaCukaiDto"
  ]
}

```

## JSON Example : Simpan P3C

```json
{
    "saveHeaderPojo": {
        "idJenisP3c": 1,
        "alamatPerusahaan": "Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten",
        "ambilPitaCukai": "KC",
        "bulanPersediaan": "092024",
        "idJenisBkc": 2,
        "idJenisPeriodeP3c": 1,
        "idNppbkc": "0499af9b-f53b-40c7-b1f8-9b16c9f89b76",
        "kodeKantor": "150300",
        "namaJenisBkc": "-",
        "namaJenisPeriodeP3C": "Awal",
        "namaPejabat": "HENDRY",
        "namaPerusahaan": "PANJANG JIWO PT",
        "nppbkc": "0014539407415000150312",
        "npwp": "014539407415000",
        "idJenisUsaha": 1,
        "tanggalPermohonan": "2024-08-01"
    },
    "savePitaCukaiDto": [
        {
            "hje": 100,
            "idGolonganBkc": 4,
            "idJenisPitaCukai": "dcc40afb-ff8b-4443-898d-22dde87b9e2c",
            "idJenisProduksiBkc": 13,
            "idSeripita": 5,
            "isiVolume": 600,
            "jumlahCukai": 5400000,
            "jumlahPesan": 10,
            "jumlahRekomendasi": 0,
            "kodeJenisProduksiBkc": "A",
            "kodeWarna": "HI",
            "maksimalPesan": 0,
            "namaGolonganBkc": "IMPORTIR",
            "namaSeripita": "I",
            "personalisasi": "-",
            "tahunPita": 2023,
            "tarif": 15000,
            "warna": "Hijau",
            "flagKawasanBebas": "N",
            "kodeSatuan": "btg"
        }
    ]
}

```

## Validation Rules

| Field             | Rules                            |
| ----------------- | -------------------------------- |
| bulanPersediaan   | Harus dalam format MMYYYY        |
| idNppbkc          | Harus merupakan UUID yang valid. |
| tanggalPermohonan | Harus dalam format YYYY-MM-DD    |
| idJenisPitaCukai  | Harus merupakan UUID yang valid. |
| isiVolume         | Harus berupa angka positif       |
| jumlahCukai       | Harus berupa angka positif       |
| jumlahPesan       | Harus berupa angka positif       |
| jumlahRekomendasi | Harus berupa angka positif       |
| tarif             | Harus berupa angka positif       |

## Response

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

```json
{
  "message": "Success",
  "status": true,
  "data": null
}
```

{% 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-pita-service/simpan-p3c.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.