Simpan P3C Pengecualian

Introduction

  • Purpose: API ini digunakan untuk simpan P3C pengecualian

  • Overview: Proses simpan P3C pengecualian mensyaratkan 2 object data dalam bentuk JSON yaitu Header dan Detail

Path API

POST {API_URL}/perekaman-p3c-pengecualian/h2h/simpanP3cPengecualian

Authorization

Name
Type
Description

Authorization

String

Bearer Token yang didapatkan dari hasil otorisasi

Request Structure

Top-Level Object: Struktur data Dalam Bentuk Top Level JSON Schema

{
  "header": { ... },
  "details": [ ... ]
}

Header Section (saveHeaderPojo)

Parameter Name
Type
Description
Example Value

alamatPerusahaan

String

Alamat dari perusahaan

-

ambilPitaCukai

String

Tipe pengambilan pita cukai

KP

bulanPersediaan

String

Bulan persediaan barang kena cukai

82023

idJenisBkc

String

ID jenis barang kena cukai

3

idJenisPeriodeP3c

String

ID jenis periode pelaporan P3C

1

idNppbkc

String

ID NPPBKC (Nomor Pokok Pengusaha Barang Kena Cukai)

fe3c9198-1065-05e6-e054-0021f60abd54

kodeKantor

String

Kode kantor

70600

namaJenisBkc

String

Nama jenis barang kena cukai

HT

namaJenisPeriodeP3C

String

Nama jenis periode pelaporan P3C

Awal

namaKantor

String

Nama kantor

KPPBC TMC MALANG

namaPejabat

String

Nama pejabat yang berwenang

ALOYSIUS RADJA SINGAL BBPS

namaPerusahaan

String

Nama perusahaan yang melaporkan

BENTOEL PRIMA, PT

nomorP3C

String

Nomor P3C

123

nppbkc

String

Nomor Pokok Pengusaha Barang Kena Cukai

0015866924651000070623

npwp

String

Nomor Pokok Wajib Pajak

15866924651000

status

String

Status pelaporan

-

tanggalP3C

Date

Tanggal pelaporan P3C

2023-08-21

tanggalPermohonan

Date

Tanggal permohonan pelaporan

2023-08-21

Detail Section (savePitaCukaiDto)

Parameter Name
Type
Description
Example Value

hje

String

Harga Jual Eceran

25101

idGolonganBkc

String

ID golongan barang kena cukai

3

idJenisPitaCukai

String

ID jenis pita cukai

c9a4e440-811b-4073-81e8-f85d0bc85560

idJenisProduksiBkc

String

ID jenis produksi barang kena cukai

6

idSeripita

String

ID seri pita

3

isiVolume

String

Volume isi per kemasan

25

jumlahCukai

String

Jumlah cukai yang dikenakan

0

jumlahPesan

String

Jumlah pesan pita cukai

212

jumlahRekomendasi

String

Jumlah rekomendasi pengambilan pita cukai

0

kodeJenisProduksiBkc

String

Kode jenis produksi barang kena cukai

SKM

kodeWarna

String

Kode warna pita cukai

JI

maksimalPesan

String

Jumlah maksimal pesan pita cukai

0

namaGolonganBkc

String

Nama golongan barang kena cukai

III

namaSeripita

String

Nama seri pita

-

personalisasi

String

Kode personalisasi untuk produk

BINSAYIN00

tahunPita

String

Tahun pita cukai

2023

tarif

String

Tarif cukai

669

warna

String

Warna pita cukai

JINGGA

flagKawasanBebas

String

Indikator apakah kawasan bebas

N

kodeSatuan

String

Satuan volume barang kena cukai

btg

JSONSchema Simpan P3C Pengecualian

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": "Schema Simpan P3C Pengecualian",
  "description": "JSON Schema untuk Simpan P3C Pengecualian.",
  "properties": {
    "saveHeaderPojo": {
      "type": "object",
      "description": "Data header dokumen pabean.",
      "properties": {
        "alamatPerusahaan": {
          "type": "string",
          "description": "Alamat perusahaan."
        },
        "ambilPitaCukai": {
          "type": "string",
          "description": "Ambil pita cukai."
        },
        "bulanPersediaan": {
          "type": "string",
          "description": "Bulan persediaan, 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."
        },
        "namaKantor": {
          "type": "string",
          "description": "Nama kantor."
        },
        "namaPejabat": {
          "type": "string",
          "description": "Nama pejabat."
        },
        "namaPerusahaan": {
          "type": "string",
          "description": "Nama perusahaan."
        },
        "nomorP3C": {
          "type": "string",
          "description": "Nomor P3C."
        },
        "nppbkc": {
          "type": "string",
          "description": "NPPBKC, harus terdiri dari 22 digit."
        },
        "npwp": {
          "type": "string",
          "description": "NPWP, harus terdiri dari 15 digit."
        },
        "status": {
          "type": "string",
          "description": "Status."
        },
        "tanggalP3C": {
          "type": "string",
          "format": "date",
          "description": "Tanggal P3C."
        },
        "tanggalPermohonan": {
          "type": "string",
          "format": "date",
          "description": "Tanggal permohonan."
        }
      },
      "required": [
        "alamatPerusahaan",
        "ambilPitaCukai",
        "bulanPersediaan",
        "idJenisBkc",
        "idJenisPeriodeP3c",
        "idNppbkc",
        "kodeKantor",
        "namaJenisBkc",
        "namaJenisPeriodeP3C",
        "namaKantor",
        "namaPejabat",
        "namaPerusahaan",
        "nomorP3C",
        "nppbkc",
        "npwp",
        "status",
        "tanggalP3C",
        "tanggalPermohonan"
      ],
      "message": {
        "required": "Wajib mengisi semua field pada saveHeaderPojo."
      }
    },
    "savePitaCukaiDto": {
      "type": "array",
      "description": "Data pita cukai.",
      "items": {
        "type": "object",
        "properties": {
          "hje": {
            "type": "integer",
            "description": "HJE."
          },
          "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 seripita."
          },
          "isiVolume": {
            "type": "integer",
            "description": "Isi volume."
          },
          "jumlahCukai": {
            "type": "number",
            "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 seripita."
          },
          "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"
        ],
        "message": {
          "required": "Wajib mengisi semua field pada savePitaCukaiDto."
        }
      }
    }
  },
  "required": [
    "saveHeaderPojo",
    "savePitaCukaiDto"
  ],
  "message": {
    "required": "Wajib mengisi data saveHeaderPojo dan savePitaCukaiDto."
  }
}

JSON Example : Simpan P3C Pengecualian

{
    "saveHeaderPojo": {
        "alamatPerusahaan": "-",
        "ambilPitaCukai": "KP",
        "bulanPersediaan": "082023",
        "idJenisBkc": 3,
        "idJenisPeriodeP3c": 1,
        "idNppbkc": "fe3c9198-1065-05e6-e054-0021f60abd54",
        "kodeKantor": "070600",
        "namaJenisBkc": "HT",
        "namaJenisPeriodeP3C": "Awal",
        "namaKantor": "KPPBC TMC MALANG",
        "namaPejabat": "ALOYSIUS RADJA SINGAL BBPS",
        "namaPerusahaan": "BENTOEL PRIMA, PT",
        "nomorP3C": "123",
        "nppbkc": "0015866924651000070623",
        "npwp": "015866924651000",
        "status": "-",
        "tanggalP3C": "2023-08-21",
        "tanggalPermohonan": "2023-08-21"
    },
    "savePitaCukaiDto": [
        {
            "hje": 25101,
            "idGolonganBkc": 3,
            "idJenisPitaCukai": "c9a4e440-811b-4073-81e8-f85d0bc85560",
            "idJenisProduksiBkc": 6,
            "idSeripita": 3,
            "isiVolume": 25,
            "jumlahCukai": 0,
            "jumlahPesan": 212,
            "jumlahRekomendasi": 0,
            "kodeJenisProduksiBkc": "SKM",
            "kodeWarna": "JI",
            "maksimalPesan": 0,
            "namaGolonganBkc": "III",
            "namaSeripita": "-",
            "personalisasi": "BINSAYIN00",
            "tahunPita": 2023,
            "tarif": 669,
            "warna": "JINGGA",
            "flagKawasanBebas": "N",
            "kodeSatuan" : "btg" 
        }
    ]
}

Validation Rules

Field
Rules

idNppbkc

Harus merupakan UUID yang valid.

tanggalP3C

Harus dalam format YYYY-MM-DD

tanggalPermohonan

Harus dalam format YYYY-MM-DD

idJenisPitaCukai

Harus merupakan UUID yang valid

jumlahCukai

Harus berupa angka positif

jumlahPesan

Harus berupa angka positif

jumlahRekomendasi

Harus berupa angka positif

Response

{
  "message": "Tidak Boleh Lanjut Dikarenakan Perusahaan Mempunyai Hutang",
  "status": true,
  "data": {
    "hutangPerusahaan": 4
  }
}

Potential Error

Status Code
Description
Reason

400 Bad Request

Permintaan tidak valid

Parameter tidak lengkap atau format tidak sesuai

401 Unauthorized

Otentikasi gagal

Bearer Token tidak valid atau tidak disertakan dalam header permintaan

404 Not Found

Dokumen tidak ditemukan

Data tidak ditemukan berdasarkan parameter yang diberikan

Last updated