# Rekam Dokumen LACK-11

## Introduction

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

## Path API

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

## 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="203">Parameter Name</th><th width="100">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>periode</td><td>String</td><td>Periode laporan</td><td>3</td></tr><tr><td>tahunLaporan</td><td>String</td><td>Tahun laporan</td><td>2024</td></tr><tr><td>idNppbkc</td><td>String</td><td>Identifikasi unik untuk NPPBKC (Nomor Pokok Pengusaha Barang Kena Cukai)</td><td>0499af9b-f53b-40c7-b1f8-9b16c9f89b76</td></tr><tr><td>kodeKantor</td><td>String</td><td>Kode kantor tempat laporan dibuat</td><td>150300</td></tr><tr><td>nppbkc</td><td>String</td><td>Nomor Pokok Pengusaha Barang Kena Cukai</td><td>0014539407415000150312</td></tr><tr><td>namaPerusahaan</td><td>String</td><td>Nama perusahaan yang melaporkan</td><td>PANJANG JIWO PT</td></tr><tr><td>npwp</td><td>String</td><td>Nomor Pokok Wajib Pajak</td><td>14539407415000</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>namaPengusaha</td><td>String</td><td>Nama pengusaha</td><td>yudi</td></tr><tr><td>noIdentitas</td><td>String</td><td>Nomor identitas yang digunakan untuk laporan</td><td>0014539407415000150312</td></tr><tr><td>tanggalLaporan</td><td>Date</td><td>Tanggal laporan</td><td>2024-08-22T00:00:00.000Z</td></tr><tr><td>alamatPemberitahu</td><td>String</td><td>Alamat pemberitahu</td><td>Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten</td></tr></tbody></table>

### Detail Section

<table><thead><tr><th width="196">Parameter Name</th><th width="103">Type</th><th>Description</th><th>Example Value</th></tr></thead><tbody><tr><td>jenisBkc</td><td>String</td><td>Jenis Barang Kena Cukai (BKC)</td><td>MMEA</td></tr><tr><td>namaMerk</td><td>String</td><td>Nama merk dari barang</td><td>Arak</td></tr><tr><td>isi</td><td>String</td><td>Isi per kemasan</td><td>200</td></tr><tr><td>hje</td><td>String</td><td>Harga Jual Eceran</td><td>20000</td></tr><tr><td>tarifSpesifik</td><td>Number</td><td>Tarif spesifik untuk barang</td><td>8000000</td></tr><tr><td>kadarEa</td><td>String</td><td>Kadar Etil Alkohol</td><td>90</td></tr><tr><td>seriPita</td><td>String</td><td>Seri pita</td><td>3</td></tr><tr><td>jenisProduksiBkc</td><td>String</td><td>Jenis produksi BKC</td><td>MMEA GOLONGAN A</td></tr><tr><td>keterangan</td><td>String</td><td>Keterangan tambahan</td><td>laporan baru</td></tr><tr><td>saldoAwal</td><td>Number</td><td>Saldo awal barang</td><td>10000</td></tr><tr><td>pemasukan</td><td>Number</td><td>Jumlah pemasukan</td><td>10</td></tr><tr><td>pengeluaran</td><td>Number</td><td>Jumlah pengeluaran</td><td>10</td></tr><tr><td>bkcMusnah</td><td>Number</td><td>Jumlah BKC yang dimusnahkan</td><td>10</td></tr><tr><td>saldoAkhir</td><td>Number</td><td>Saldo akhir barang</td><td>9980</td></tr><tr><td>sudahDilekati</td><td>Number</td><td>Jumlah kemasan yang sudah dilekati pita</td><td>10</td></tr><tr><td>belumDilekati</td><td>Number</td><td>Jumlah kemasan yang belum dilekati pita</td><td>10</td></tr><tr><td>idJenisBkc</td><td>String</td><td>ID jenis BKC</td><td>2</td></tr><tr><td>satuan</td><td>String</td><td>Satuan dari barang</td><td>bungkus</td></tr><tr><td>idMerk</td><td>String</td><td>ID merk dari barang</td><td>0ac3b880-03d9-42b5-9da6-c7f3ea65c6b3</td></tr><tr><td>idJenisProduksiBkc</td><td>Number</td><td>ID jenis produksi BKC</td><td>13</td></tr><tr><td>uuid</td><td>String</td><td>UUID unik untuk detail</td><td>f1489bb6-fe7f-4135-bf91-380c904b8798</td></tr></tbody></table>

## JSONSchema Rekam LACK-11

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Rekam LACK-11",
  "properties": {
    "periode": {
      "type": "string",
      "enum": ["1", "2", "3", "4"],
      "description": "Periode laporan dalam kuartal."
    },
    "tahunLaporan": {
      "type": "string",
      "description": "Tahun laporan dalam format 4 digit (YYYY)."
    },
    "idNppbkc": {
      "type": "string",
      "format": "uuid",
      "description": "UUID untuk ID NPPBKC."
    },
    "kodeKantor": {
      "type": "string",
      "description": "Kode kantor dengan 6 digit angka."
    },
    "nppbkc": {
      "type": "string",
      "description": "Nomor NPPBKC dengan 22 digit angka."
    },
    "namaPerusahaan": {
      "type": "string",
      "description": "Nama perusahaan."
    },
    "npwp": {
      "type": "string",
      "description": "NPWP perusahaan dengan 15 digit angka."
    },
    "alamatPerusahaan": {
      "type": "string",
      "description": "Alamat lengkap perusahaan."
    },
    "namaPengusaha": {
      "type": "string",
      "description": "Nama pengusaha yang terdaftar."
    },
    "noIdentitas": {
      "type": "string",
      "description": "Nomor identitas pengusaha dengan 22 digit angka."
    },
    "tanggalLaporan": {
      "type": "string",
      "format": "date-time",
      "description": "Tanggal laporan dalam format ISO 8601."
    },
    "alamatPemberitahu": {
      "type": "string",
      "description": "Alamat pemberitahu."
    },
    "details": {
      "type": "array",
      "description": "Detail dari laporan.",
      "items": {
        "type": "object",
        "properties": {
          "jenisBkc": {
            "type": "string",
            "description": "Jenis BKC (Barang Kena Cukai)."
          },
          "namaMerk": {
            "type": "string",
            "description": "Nama merk produk."
          },
          "isi": {
            "type": "string",
            "description": "Isi produk (volume atau berat)."
          },
          "hje": {
            "type": "string",
            "description": "Harga jual eceran."
          },
          "tarifSpesifik": {
            "type": "number",
            "description": "Tarif spesifik untuk produk."
          },
          "kadarEa": {
            "type": "string",
            "description": "Kadar alkohol dalam produk."
          },
          "seriPita": {
            "type": "string",
            "description": "Seri pita cukai."
          },
          "jenisProduksiBkc": {
            "type": "string",
            "description": "Jenis produksi BKC."
          },
          "keterangan": {
            "type": "string",
            "description": "Keterangan tambahan untuk laporan."
          },
          "saldoAwal": {
            "type": "integer",
            "description": "Saldo awal produk."
          },
          "pemasukan": {
            "type": "integer",
            "description": "Jumlah pemasukan produk."
          },
          "pengeluaran": {
            "type": "integer",
            "description": "Jumlah pengeluaran produk."
          },
          "bkcMusnah": {
            "type": "integer",
            "description": "Jumlah BKC yang musnah."
          },
          "saldoAkhir": {
            "type": "integer",
            "description": "Saldo akhir produk."
          },
          "sudahDilekati": {
            "type": "integer",
            "description": "Jumlah produk yang sudah dilekati pita cukai."
          },
          "belumDilekati": {
            "type": "integer",
            "description": "Jumlah produk yang belum dilekati pita cukai."
          },
          "idJenisBkc": {
            "type": "string",
            "description": "ID jenis BKC."
          },
          "satuan": {
            "type": "string",
            "description": "Satuan dari produk."
          },
          "idMerk": {
            "type": "string",
            "format": "uuid",
            "description": "ID merk."
          },
          "idJenisProduksiBkc": {
            "type": "integer",
            "description": "ID jenis produksi BKC."
          },
          "uuid": {
            "type": "string",
            "format": "uuid",
            "description": "UUID unik untuk detail laporan."
          }
        },
        "required": [
          "jenisBkc",
          "namaMerk",
          "tarifSpesifik",
          "jenisProduksiBkc",
          "saldoAwal",
          "pemasukan",
          "pengeluaran",
          "bkcMusnah",
          "saldoAkhir",
          "sudahDilekati",
          "belumDilekati",
          "idJenisBkc",
          "satuan",
          "idMerk",
          "idJenisProduksiBkc",
          "uuid"
        ]
      }
    }
  },
  "required": [
    "periode",
    "tahunLaporan",
    "idNppbkc",
    "kodeKantor",
    "nppbkc",
    "namaPerusahaan",
    "npwp",
    "alamatPerusahaan",
    "namaPengusaha",
    "noIdentitas",
    "tanggalLaporan",
    "alamatPemberitahu",
    "details"
  ]
}

```

## JSON Example : Rekam LACK-11

```json
{
    "periode": "3",
    "tahunLaporan": "2024",
    "idNppbkc": "0499af9b-f53b-40c7-b1f8-9b16c9f89b76",
    "kodeKantor": "150300",
    "nppbkc": "0014539407415000150312",
    "namaPerusahaan": "PANJANG JIWO PT",
    "npwp": "0014539407415000",
    "alamatPerusahaan": "Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten",
    "namaPengusaha": "yudi",
    "noIdentitas": "0014539407415000150312",
    "tanggalLaporan": "2024-08-22T00:00:00.000Z",
    "alamatPemberitahu": "Jalan Yos Sudarso No.147 RT 004 RW 002 Kel. Kebon Besar Kec. Batu Ceper Kota Tangerang, Banten",
    "details": [
        {
            "jenisBkc": "MMEA",
            "namaMerk": "Arak",
            "isi": "200",
            "hje": "",
            "tarifSpesifik": 8000000,
            "kadarEa": "",
            "seriPita": "",
            "jenisProduksiBkc": "MMEA GOLONGAN A",
            "keterangan": "laporan baru",
            "saldoAwal": 10000,
            "pemasukan": 10,
            "pengeluaran": 10,
            "bkcMusnah": 10,
            "saldoAkhir": 9980,
            "sudahDilekati": 10,
            "belumDilekati": 10,
            "idJenisBkc": "2",
            "satuan": "bungkus",
            "idMerk": "0ac3b880-03d9-42b5-9da6-c7f3ea65c6b3",
            "idJenisProduksiBkc": 13,
            "uuid": "f1489bb6-fe7f-4135-bf91-380c904b8798"
        }
    ]
}
```

## 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/perdagangan/rekam-dokumen-lack-11.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.