# Rekam HT ## Introduction * Purpose: API ini digunakan untuk rekam HT * Overview: Proses rekam HT mensyaratkan 2 object data dalam bentuk JSON yaitu Header dan Detail ## Path API `POST` `{API_URL}/portal/ck4/rekam-ht` ## Authorization
NameType Description
AuthorizationStringBearer Token yang didapatkan dari hasil otorisasi
## Request Structure Top-Level Object: Struktur data Dalam Bentuk Top Level JSON Schema ``` { "header": { ... }, "details": [ ... ] } ``` ### Header Section | Parameter Name | Type | Description | Example Value | | ------------------------------ | --------- | ------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | namaPerusahaan | String | Nama perusahaan | DEMANG JAYA PR | | idNppbkc | String | ID unik NPPBKC (Nomor Pokok Pengusaha Barang Kena Cukai) perusahaan | fe3c9198-1af7-05e6-e054-0021f60abd54 | | nppbkc | String | Nomor Pokok Pengusaha Barang Kena Cukai | 0669986374654000070613 | | alamatPerusahaan | String | Alamat perusahaan | JALAN DEMANG JAYA 2 NOMOR 03 KREBET SENGGRONG KECAMATAN BULULAWANG KABUPATEN MALANG | | jenisLaporan | String | Jenis laporan | Bulanan | | nomorPemberitahuan | String | Nomor pemberitahuan terkait laporan | TEST/2024/01/22/03 | | tanggalPemberitahuan | Date | Tanggal pemberitahuan | 2023-11-22 | | tanggalProduksiAwal | Date Time | Tanggal awal periode produksi | 2023-10-01T00:00:00.000+07:00 | | tanggalProduksiAkhir | Date Time | Tanggal akhir periode produksi | 2023-10-31T23:59:59.999+07:00 | | periodeBulan | String | Bulan periode laporan | Nopember | | periodeTahun | String | Tahun periode laporan | 2023 | | totalJumlahKemasan | Integer | Total jumlah kemasan yang diproduksi | 120 | | totalJumlahKemasanDilekatiPita | Integer | Total jumlah kemasan yang dilekati pita cukai | 120 | | totalJumlahProduksiHtBtg | Integer | Total jumlah produksi dalam hitungan batang (Ht) | 1440 | | totalJumlahProduksiHtGr | Integer | Total jumlah produksi dalam hitungan gram (Ht) | 0 | | totalJumlahProduksiHtMl | Integer | Total jumlah produksi dalam hitungan mililiter (Ht) | 0 | | namaKota | String | Nama kota di mana perusahaan berlokasi | Kabupaten Malang | | namaPengusaha | String | Nama pengusaha yang mengelola perusahaan | intan | ### Detail Section | Parameter Name | Type | Description | Example Value | | ------------------------- | --------- | ----------------------------------------- | ------------------------------------ | | nomorProduksi | String | Nomor produksi terkait barang kena cukai | PRD/01/9 | | tanggalProduksi | Date Time | Tanggal produksi barang | 2023-10-01T17:00:00.000Z | | jumlahKemasan | Integer | Jumlah kemasan yang diproduksi | 120 | | jumlahProduksi | Integer | Jumlah barang yang diproduksi | 1440 | | idMerkHt | String | ID unik dari merk HT (Hasil Tembakau) | 77a71cf1-1afa-47c0-8dcf-6e166648c9ce | | namaMerkHt | String | Nama merk dari HT | SEMBILAN CENGKEH | | jenisProduksiHt | String | Jenis produksi HT | SKM | | hje | Integer | Harga Jual Eceran | 20000 | | tarif | Integer | Tarif cukai | 150 | | isiPerKemasan | Integer | Isi per kemasan dalam satuan | 12 | | bahanKemasan | String | Jenis bahan yang digunakan untuk kemasan | Kertas Biasa (Soft Pack) | | kodeSatuan | String | Kode satuan penghitungan barang | btg | | jumlahKemasanDilekatiPita | Integer | Jumlah kemasan yang dilekati pita cukai | 120 | | seriPita | String | Seri pita cukai yang digunakan | - | | idJenisKemasan | Integer | ID unik dari jenis kemasan yang digunakan | 1 | | idJenisProduksiBkc | Integer | ID unik dari jenis produksi BKC | 12 | ## JSONSchema Rekam HT ```json { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "title": "Schema Rekam HT", "description": "JSON Schema untuk Rekam HT.", "properties": { "namaPerusahaan": { "type": "string", "description": "Nama perusahaan." }, "idNppbkc": { "type": "string", "format": "uuid", "description": "ID NPPBKC." }, "nppbkc": { "type": "string", "description": "NPPBKC, harus terdiri dari 22 digit." }, "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." }, "tanggalProduksiAwal": { "type": "string", "format": "date-time", "description": "Tanggal dan jam produksi awal." }, "tanggalProduksiAkhir": { "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." }, "totalJumlahKemasanDilekatiPita": { "type": "integer", "description": "Total jumlah kemasan yang dilekati pita." }, "totalJumlahProduksiHtBtg": { "type": "integer", "description": "Total jumlah produksi HT dalam satuan botol." }, "totalJumlahProduksiHtGr": { "type": "integer", "description": "Total jumlah produksi HT dalam satuan gram." }, "totalJumlahProduksiHtMl": { "type": "integer", "description": "Total jumlah produksi HT dalam satuan mililiter." }, "namaKota": { "type": "string", "description": "Nama kota." }, "namaPengusaha": { "type": "string", "description": "Nama pengusaha." }, "details": { "type": "array", "description": "Data detail produksi.", "items": { "type": "object", "properties": { "nomorProduksi": { "type": "string", "description": "Nomor produksi." }, "tanggalProduksi": { "type": "string", "format": "date-time", "description": "Tanggal produksi." }, "jumlahKemasan": { "type": "string", "description": "Jumlah kemasan." }, "jumlahProduksi": { "type": "string", "description": "Jumlah produksi." }, "idMerkHt": { "type": "string", "format": "uuid", "description": "ID merk HT." }, "namaMerkHt": { "type": "string", "description": "Nama merk HT." }, "jenisProduksiHt": { "type": "string", "description": "Jenis produksi HT." }, "hje": { "type": "integer", "description": "HJE (Harga Jual Eceran)." }, "tarif": { "type": "integer", "description": "Tarif." }, "isiPerKemasan": { "type": "integer", "description": "Isi per kemasan." }, "bahanKemasan": { "type": "string", "description": "Bahan kemasan." }, "kodeSatuan": { "type": "string", "description": "Kode satuan." }, "jumlahKemasanDilekatiPita": { "type": "string", "description": "Jumlah kemasan yang dilekati pita." }, "seriPita": { "type": "string", "description": "Seri pita." }, "idJenisKemasan": { "type": "integer", "description": "ID jenis kemasan." }, "idJenisProduksiBkc": { "type": "integer", "description": "ID jenis produksi BKC." } }, "required": [ "nomorProduksi", "tanggalProduksi", "jumlahKemasan", "jumlahProduksi", "idMerkHt", "namaMerkHt", "jenisProduksiHt", "hje", "tarif", "isiPerKemasan", "bahanKemasan", "kodeSatuan", "jumlahKemasanDilekatiPita", "seriPita", "idJenisKemasan", "idJenisProduksiBkc" ] } } }, "required": [ "namaPerusahaan", "idNppbkc", "nppbkc", "alamatPerusahaan", "jenisLaporan", "nomorPemberitahuan", "tanggalPemberitahuan", "tanggalProduksiAwal", "tanggalProduksiAkhir", "periodeBulan", "periodeTahun", "totalJumlahKemasan", "totalJumlahKemasanDilekatiPita", "totalJumlahProduksiHtBtg", "totalJumlahProduksiHtGr", "totalJumlahProduksiHtMl", "namaKota", "namaPengusaha", "details" ] } ``` ## JSON Example :Rekam HT ```json { "namaPerusahaan": "DEMANG JAYA PR", "idNppbkc": "fe3c9198-1af7-05e6-e054-0021f60abd54", "nppbkc": "0669986374654000070613", "alamatPerusahaan": "JALAN DEMANG JAYA 2 NOMOR 03 KREBET SENGGRONG KECAMATAN BULULAWANG KABUPATEN MALANG", "jenisLaporan": "Bulanan", "nomorPemberitahuan": "TEST/2024/01/22/03", "tanggalPemberitahuan": "2023-11-22", "tanggalProduksiAwal": "2023-10-01T00:00:00.000+07:00", "tanggalProduksiAkhir": "2023-10-31T23:59:59.999+07:00", "periodeBulan": "Nopember", "periodeTahun": "2023", "totalJumlahKemasan": 120, "totalJumlahKemasanDilekatiPita": 120, "totalJumlahProduksiHtBtg": 1440, "totalJumlahProduksiHtGr": 0, "totalJumlahProduksiHtMl": 0, "namaKota": "Kabupaten Malang", "namaPengusaha": "intan", "details": [ { "nomorProduksi": "PRD/01/9", "tanggalProduksi": "2023-10-01T17:00:00.000Z", "jumlahKemasan": "120", "jumlahProduksi": "1440", "idMerkHt": "77a71cf1-1afa-47c0-8dcf-6e166648c9ce", "namaMerkHt": "SEMBILAN CENGKEH", "jenisProduksiHt": "SKM", "hje": 20000, "tarif": 150, "isiPerKemasan": 12, "bahanKemasan": "Kertas Biasa (Soft Pack)", "kodeSatuan": "btg", "jumlahKemasanDilekatiPita": "120", "seriPita": "", "idJenisKemasan": 1, "idJenisProduksiBkc": 12 } ] } ``` ## Validation Rules | Field | Rules | | ------------------------------ | -------------------------------------- | | idNppbkc | Harus merupakan UUID yang valid. | | tanggalPemberitahuan | Harus dalam format YYYY-MM-DD | | tanggalProduksiAwal | Harus dalam format YYYY-MM-DD HH:MM:SS | | tanggalProduksiAkhir | Harus dalam format YYYY-MM-DD HH:MM:SS | | totalJumlahKemasan | Harus berupa angka positif | | totalJumlahKemasanDilekatiPita | Harus berupa angka positif | | totalJumlahProduksiHtBtg | Harus berupa angka positif | | totalJumlahProduksiHtGr | Harus berupa angka positif | | totalJumlahProduksiHtMl | Harus berupa angka positif | | tanggalProduksi | Harus dalam format YYYY-MM-DD HH:MM:SS | | jumlahKemasan | Harus berupa angka positif | | jumlahProduksi | Harus berupa angka positif | | idMerkHt | Harus merupakan UUID yang valid. | | hje | Harus berupa angka positif | | tarif | Harus berupa angka positif | | isiPerKemasan | Harus berupa angka positif | | jumlahKemasanDilekatiPita | Harus berupa angka positif | ## Response {% tabs %} {% tab title="200" %} ```json { "message": "Success", "status": true, "data": null } ``` {% endtab %} {% endtabs %} ## Potential Error
Status CodeDescriptionReason
400 Bad RequestPermintaan tidak validParameter tidak lengkap atau format tidak sesuai
401 UnauthorizedOtentikasi gagalBearer Token tidak valid atau tidak disertakan dalam header permintaan
404 Not FoundDokumen tidak ditemukanData tidak ditemukan berdasarkan parameter yang diberikan
--- # 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-ht.md?ask= ``` 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.