# Rekam MMEA

## Introduction

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

## Path API

<mark style="color:green;">`POST`</mark> `{API_URL}/portal/ck4/rekam-mmea`

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

<table><thead><tr><th width="208">Parameter Name</th><th width="145">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>npwp</td><td>String</td><td>Nomor Pokok Wajib Pajak (NPWP)</td><td>14539407415000</td></tr><tr><td>idNppbkc</td><td>String</td><td>ID unik NPPBKC</td><td>0499af9b-f53b-40c7-b1f8-9b16c9f89b76</td></tr><tr><td>nppbkc</td><td>String</td><td>Nomor Pokok Pengusaha Barang Kena Cukai (NPPBKC)</td><td>0014539407415000150312</td></tr><tr><td>namaPerusahaan</td><td>String</td><td>Nama perusahaan yang terkait</td><td>PANJANG JIWO PT</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>jenisLaporan</td><td>String</td><td>Jenis laporan yang dibuat</td><td>HARIAN</td></tr><tr><td>nomorPemberitahuan</td><td>String</td><td>Nomor pemberitahuan</td><td>1223232</td></tr><tr><td>tanggalPemberitahuan</td><td>Date</td><td>Tanggal pemberitahuan</td><td>2024-08-21</td></tr><tr><td>tanggalJamProduksiAwal</td><td>Date Time</td><td>Tanggal dan waktu dimulainya produksi</td><td>2024-08-21 13:26:45</td></tr><tr><td>tanggalJamProduksiAkhir</td><td>Date Time</td><td>Tanggal dan waktu berakhirnya produksi</td><td>2024-08-22 13:26:47</td></tr><tr><td>periodeBulan</td><td>String</td><td>Periode bulan produksi</td><td>Agustus</td></tr><tr><td>periodeTahun</td><td>String</td><td>Periode tahun produksi</td><td>2024</td></tr><tr><td>totalJumlahKemasan</td><td>Integer</td><td>Total jumlah kemasan yang diproduksi</td><td>12</td></tr><tr><td>totalJumlahProduksi</td><td>Integer</td><td>Total jumlah barang yang diproduksi</td><td>60000</td></tr><tr><td>namaPengusaha</td><td>String</td><td>Nama pengusaha yang terkait</td><td>HENDRY</td></tr><tr><td>namaKota</td><td>String</td><td>Nama kota tempat perusahaan berada</td><td>TANGERANG</td></tr><tr><td>idSpl</td><td>String </td><td>ID unik SPL</td><td>2</td></tr></tbody></table>

### Detail Section

<table><thead><tr><th width="212">Parameter Name</th><th width="108">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>nomorProduksi</td><td>String</td><td>Nomor produksi</td><td>3433</td></tr><tr><td>tanggalProduksi</td><td>Date</td><td>Tanggal produksi</td><td>2024-08-21</td></tr><tr><td>jumlahKemasan</td><td>String</td><td>Jumlah kemasan</td><td>12</td></tr><tr><td>jumlahProduksi</td><td>Integer</td><td>Jumlah barang yang diproduksi</td><td>60000</td></tr><tr><td>idMerkMmea</td><td>String</td><td>ID unik merk MMEA (Minuman Mengandung Etil Alkohol)</td><td>8e219058-d4b6-4998-8ea4-ce93e62580ee</td></tr><tr><td>merkMmea</td><td>String</td><td>Nama merk MMEA</td><td>MMEA</td></tr><tr><td>isi</td><td>Integer</td><td>Isi per kemasan</td><td>5000</td></tr><tr><td>tarif</td><td>Integer</td><td>Tarif yang dikenakan per satuan</td><td>8000000</td></tr><tr><td>kodeSatuan</td><td>String</td><td>Kode satuan untuk ukuran volume barang</td><td>ltr</td></tr><tr><td>namaGolongan</td><td>String</td><td>Nama golongan barang kena cukai</td><td>MMEA GOLONGAN A</td></tr><tr><td>keterangan</td><td>String</td><td>Keterangan tambahan</td><td>test</td></tr><tr><td>idJenisProduksiBkc</td><td>Integer</td><td>ID jenis produksi barang kena cukai</td><td>13</td></tr></tbody></table>

## JSONSchema Rekam MMEA

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Rekam MMEA",
  "description": "JSON Schema untuk Rekam MMEA.",
  "properties": {
    "npwp": {
      "type": "string",
      "description": "NPWP, harus terdiri dari 15 digit."
    },
    "idNppbkc": {
      "type": "string",
      "format": "uuid",
      "description": "ID NPPBKC."
    },
    "nppbkc": {
      "type": "string",
      "description": "NPPBKC, harus terdiri dari 22 digit."
    },
    "namaPerusahaan": {
      "type": "string",
      "description": "Nama perusahaan."
    },
    "alamatPerusahaan": {
      "type": "string",
      "description": "Alamat perusahaan."
    },
    "jenisLaporan": {
      "type": "string",
      "enum": ["HARIAN", "MINGGUAN", "BULANAN"],
      "description": "Jenis laporan."
    },
    "nomorPemberitahuan": {
      "type": "string",
      "description": "Nomor pemberitahuan."
    },
    "tanggalPemberitahuan": {
      "type": "string",
      "format": "date",
      "description": "Tanggal pemberitahuan."
    },
    "tanggalJamProduksiAwal": {
      "type": "string",
      "format": "date-time",
      "description": "Tanggal dan jam produksi awal."
    },
    "tanggalJamProduksiAkhir": {
      "type": "string",
      "format": "date-time",
      "description": "Tanggal dan jam produksi akhir."
    },
    "periodeBulan": {
      "type": "string",
      "description": "Periode bulan."
    },
    "periodeTahun": {
      "type": "string",
      "description": "Periode tahun."
    },
    "totalJumlahKemasan": {
      "type": "integer",
      "description": "Total jumlah kemasan."
    },
    "totalJumlahProduksi": {
      "type": "integer",
      "description": "Total jumlah produksi."
    },
    "details": {
      "type": "array",
      "description": "Data detail produksi.",
      "items": {
        "type": "object",
        "properties": {
          "nomorProduksi": {
            "type": "string",
            "description": "Nomor produksi."
          },
          "tanggalProduksi": {
            "type": "string",
            "format": "date",
            "description": "Tanggal produksi."
          },
          "jumlahKemasan": {
            "type": "string",
            "description": "Jumlah kemasan."
          },
          "jumlahProduksi": {
            "type": "integer",
            "description": "Jumlah produksi."
          },
          "idMerkMmea": {
            "type": "string",
            "format": "uuid",
            "description": "ID Merk MMEA."
          },
          "merkMmea": {
            "type": "string",
            "description": "Merk MMEA."
          },
          "isi": {
            "type": "integer",
            "description": "Isi produk."
          },
          "tarif": {
            "type": "integer",
            "description": "Tarif."
          },
          "kodeSatuan": {
            "type": "string",
            "description": "Kode satuan."
          },
          "namaGolongan": {
            "type": "string",
            "description": "Nama golongan."
          },
          "keterangan": {
            "type": "string",
            "description": "Keterangan."
          },
          "idJenisProduksiBkc": {
            "type": "integer",
            "description": "ID jenis produksi BKC."
          }
        },
        "required": [
          "nomorProduksi",
          "tanggalProduksi",
          "jumlahKemasan",
          "jumlahProduksi",
          "idMerkMmea",
          "merkMmea",
          "isi",
          "tarif",
          "kodeSatuan",
          "namaGolongan",
          "keterangan",
          "idJenisProduksiBkc"
        ]
      }
    },
    "namaPengusaha": {
      "type": "string",
      "description": "Nama pengusaha."
    },
    "namaKota": {
      "type": "string",
      "description": "Nama kota."
    },
    "idSpl": {
      "type": "string",
      "description": "ID SPL"
    }
  },
  "required": [
    "npwp",
    "idNppbkc",
    "nppbkc",
    "namaPerusahaan",
    "alamatPerusahaan",
    "jenisLaporan",
    "nomorPemberitahuan",
    "tanggalPemberitahuan",
    "tanggalJamProduksiAwal",
    "tanggalJamProduksiAkhir",
    "periodeBulan",
    "periodeTahun",
    "totalJumlahKemasan",
    "totalJumlahProduksi",
    "details",
    "namaPengusaha",
    "namaKota",
    "idSpl"
  ]
}

```

## JSON Example : Rekam MMEA

```json
{
    "npwp": "0014539407415000",
    "idNppbkc": "0499af9b-f53b-40c7-b1f8-9b16c9f89b76",
    "nppbkc": "0014539407415000150312",
    "namaPerusahaan": "PANJANG JIWO PT",
    "alamatPerusahaan": "Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten",
    "jenisLaporan": "HARIAN",
    "nomorPemberitahuan": "1223232",
    "tanggalPemberitahuan": "2024-08-21",
    "tanggalJamProduksiAwal": "2024-08-21T13:26:45",
    "tanggalJamProduksiAkhir": "2024-08-22T13:26:47",
    "periodeBulan": "Agustus",
    "periodeTahun": "2024",
    "totalJumlahKemasan": 12,
    "totalJumlahProduksi": 60000,
    "details": [
        {
            "nomorProduksi": "3433",
            "tanggalProduksi": "2024-08-21",
            "jumlahKemasan": "12",
            "jumlahProduksi": 60000,
            "idMerkMmea": "8e219058-d4b6-4998-8ea4-ce93e62580ee",
            "merkMmea": "MMEA",
            "isi": 5000,
            "tarif": 8000000,
            "kodeSatuan": "ltr",
            "namaGolongan": "MMEA GOLONGAN A",
            "keterangan": "test",
            "idJenisProduksiBkc": 13
        }
    ],
    "namaPengusaha": "HENDRY",
    "namaKota": "TANGERANG",
    "idSpl": null
}
```

## Validation Rules

## 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/produksi/rekam-mmea.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.