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