Fiskalisasi

Menghubungkan mesin kasir fiskal dan gateway cloud untuk mematuhi peraturan perpajakan.

1. Ikhtisar#

Fiskalisasi adalah persyaratan hukum di banyak negara: setiap transaksi dengan pembeli harus dicatat dalam sistem pajak dan dikonfirmasi dengan struk fiskal.

Cenaly menangani hal ini melalui dua jalur:

Yang didukung saat ini:

Kontur yang terkait tetapi berbeda — pertukaran dokumen elektronik dengan pemerintah (bukan struk untuk pembeli):

Kasa fiskalna ≠ KSeF: yang pertama adalah struk untuk perorangan, yang kedua adalah faktur untuk badan hukum. Satu tidak menggantikan yang lain.

2. Cara kerjanya#

Tamu membayar pesanan
       ↓
Kasir Cenaly mengumpulkan item, tarif pajak dan metode pembayaran
       ↓
Struk dikirim ke mesin kasir fiskal (melalui bridge) atau ke gateway cloud
       ↓
Perangkat/layanan mencatat transaksi di kantor pajak
       ↓
Tamu menerima struk fiskal

Detail penting: mesin kasir milik Anda dan terdaftar atas data Anda. Cenaly adalah transportasi dan antrean, bukan operator data fiskal.

3. Menghubungkan mesin kasir fiskal melalui bridge#

Keluarga yang didukung#

Printer struk biasa (non-fiskal) yang kompatibel dengan ESC/POS dihubungkan melalui bridge yang sama sebagai perangkat terpisah dan mencetak pra-struk, tiket dapur dan struk barang.

Jika tidak ada printer struk di cabang, tagihan tamu (pra-struk) dicetak oleh mesin kasir fiskal itu sendiri — lebar baris diambil dari perangkat agar kolom jumlah tidak terpotong. Daisy, ATOL dan SHTRIH-M mampu melakukan ini; Thermal Polandia tidak mencetak teks bebas dan menolak dengan jujur. Mesin kasir fiskal tetap menjadi mesin kasir: dokumen biasa kami (tiket dapur, salinan struk) tidak dikirim ke sana — hanya uji cetak dan pra-struk.

Langkah-langkah koneksi#

Langkah 1. Pasang bridge#

Buka Perangkat Keras di panel: jika bridge belum dipasang, halaman akan menawarkan unduhan sesuai OS Anda — penginstal untuk Windows atau arsip portabel, untuk Linux x64/ARM — satu baris perintah pemasangan layanan. Bridge berjalan di komputer yang sama tempat mesin kasir terhubung.

Langkah 2. Hubungkan mesin kasir ke komputer#

Didukung port serial (COM/USB-COM), koneksi jaringan dan printer-spooler sistem — tergantung model. Bridge dapat menemukan perangkat sendiri: tombol pemindaian otomatis menawarkan perangkat yang ditemukan, dan dapat ditambahkan ke konfigurasi dengan satu klik.

Langkah 3. Periksa#

Pada kartu mesin kasir fiskal terlihat model, nomor seri, tarif pajak, status kertas dan nomor laporan Z terakhir. Di sini juga ada tombol uji cetak, membuka laci uang dan mengambil laporan X.

Untuk mesin kasir Daisy, panduan terpisah tersedia di panel: cara mengalihkan mesin kasir ke mode printer fiskal dan apa yang harus dilakukan dengan kesalahan umum.

Langkah 4. Atur klise dan tarif#

Tombol "Pengaturan mesin kasir" membuka editor baris demi baris untuk header dan footer struk, flag (baris kosong, pemisah, logo, struk detail), mode potong, tarif pajak dan data operator (nomor, kata sandi, nama).

4. Pengaturan per negara#

🇬🇪 Georgia — Revenue Service#

Persyaratan:

• mesin kasir fiskal yang terdaftar di rs.ge, dengan modul fiskal (diuji pada Daisy eXpert SX);
• nomor identifikasi (საიდენტიფიკაციო ნომერი).

Pengaturan:

1. Alihkan mesin kasir fiskal ke mode serial "Fiscal printer" (di panel tersedia panduan dengan urutan persis pada keyboard).
2. Tambahkan di bagian Perangkat Keras sebagai mesin kasir fiskal.
3. Cetak struk uji dan ambil laporan Z — jumlahnya harus cocok.

Terpisah dari struk, di Georgia terdapat bagian rs.ge: faktur pajak elektronik masuk dari pemasok, konfirmasi dan penolakannya, direktori, pemeriksaan INN dan status wajib pajak PPN.

🇵🇱 Polandia — kasa fiskalna online#

Sejak 2021, restoran, bar, dan kafe wajib memiliki mesin kasir online yang mengirimkan data ke CRK (Centralne Repozytorium Kas). Menulis mesin kasir virtual sendiri tanpa sertifikat GUM tidak diperbolehkan, jadi ada dua jalur:

1. Printer fiskal sendiri melalui protokol POSNET Thermal — dihubungkan dengan bridge (lihat bagian 3). Satu driver mencakup sebagian besar perangkat: Posnet, Emar, Innova, Torell, Elzab Mera. Saat ini di Polandia hanya jalur ini yang berfungsi.
2. API mesin kasir tersertifikasi pihak lain — 🛠 dalam pengembangan. Gateway sudah ditulis, tetapi bagian servernya belum di-deploy, dan adaptor untuk mesin kasir tersertifikasi tertentu belum ada: mesin kasir virtual Polandia tidak memiliki spesifikasi publik, dan adaptor (XKasa, WKF, Aclas) ditambahkan seiring diterimanya dokumentasi mereka. Kartu koneksi di integrasi lokasi tidak tersedia.

Tarif PPN tidak dikarang oleh gateway: matriks kanal (makanan 8 %, bawa pulang 5 %, kopi dan alkohol 23 %) dihitung oleh platform sendiri, gateway hanya mengubah persentase menjadi huruf PTU mesin kasir tertentu.

KSeF (faktur B2B) — kontur terpisah di bagian Rekan Bisnis: XML format FA(3) dibangun dari dokumen yang diterbitkan, dienkripsi, dan dikirim ke sistem Kementerian Keuangan, status dan nomor UPO dikembalikan ke kartu.

🇰🇿 Kazakhstan — KKM#

Sejak 01.01.2026, pasal 110–111 NK RK mewajibkan struk KKM pada hari pembelian untuk setiap transaksi moneter — termasuk kartu di situs web, Kaspi Pay/QR, dan Apple/Google Pay.

🛠 Koneksi belum tersedia. Gateway ke operator KKM (driver pertama — Webkassa) sudah ditulis, tetapi bagian servernya belum di-deploy: kartu koneksi di integrasi lokasi tidak tersedia, dan mengisi kredensial saat ini tidak dimungkinkan. Saat gateway dibuka, cara kerjanya: kredensial operator KKM → pemeriksaan koneksi → struk terkirim otomatis, dan PPN dihitung berdasarkan rezim pajak lokasi. Butuh Kazakhstan — hubungi dukungan, prioritas ditetapkan berdasarkan permintaan.

🇷🇺 Rusia — 54-FZ#

Dua cara, dapat dikombinasikan:

• KKT sendiri melalui bridge — ATOL, Mercury, SHTRIH-M, Pirit/Viki Print. Didukung FFD 1.05 dan 1.2, struk koreksi, pelabelan "Chestny ZNAK", EGAIS UTM.
• Mesin kasir cloud — bagian API mesin kasir (Rusia): HTTP-API, kompatibel dengan protokol ATOL Online (v5 = FFD 1.2, v4 = FFD 1.05). Situs web atau CMS Anda mengirim struk JSON, layanan memasukkannya ke antrean, struk dicetak pada KKT Anda sendiri. Mesin kasir tetap milik Anda dan terdaftar atas INN Anda — platform hanya transportasi dan antrean.

Kontur Rusia terkait: pemeriksaan status kode pelabelan "Chestny ZNAK" dan pembatalan VSD masuk di FGIS "Mercury" (tab "VSD Masuk" di gudang).

5. Pencetakan struk dan laporan#

Di Kasir (POS)#

Struk dicetak saat pembayaran di bagian Kasir. Di sana juga: cetak ulang (di bawah PIN manajer), pengembalian — penuh atau sebagian, penukaran dengan penjualan ulang, pencarian riwayat struk, dan pra-struk ("tagihan tamu" sebelum pembayaran).

Pra-struk dicetak pada printer struk, atau jika tidak ada di cabang — pada mesin kasir fiskal itu sendiri (lihat bagian 3). Tugas ini tidak masuk ke antrean printer offline: tamu menunggu tagihan sekarang, bukan "saat printer kembali".

Dari bagian "Pesanan"#

Untuk pesanan online, struk dapat diterbitkan langsung dari kartu pesanan — perintah dikirim melalui kanal cloud ke bridge cabang yang dituju, bahkan jika Anda sedang di komputer lain.

Laporan X dan Z#

• Laporan X — sementara, tanpa menutup perubahan kas. Tombolnya ada di bagian Perangkat Keras dan di kasir.
• Laporan Z — penutupan perubahan kas dengan konfirmasi; di kasir digabungkan dengan penutupan perubahan kas dan rekonsiliasi fakta/ekspektasi (kekurangan dan kelebihan langsung terlihat).

Jurnal perubahan kas yang ditutup — kasir, dana kembalian, penjualan tunai dan kartu, uang tunai yang diharapkan dan aktual, selisih — ada di bagian Keuangan, tab "Kasir".

Jika struk tidak tercetak#

Mesin kasir adalah perangkat keras, dan bisa gagal: kertas habis, perubahan kas belum ditutup, struk belum ditutup di perangkat, sudah lebih dari sehari tanpa laporan Z. Sebelumnya, dalam kasus seperti itu muncul tooltip sementara dengan teks driver — dari situ tidak bisa dipahami penyebabnya maupun apa yang harus dilakukan.

Sekarang, sebagai gantinya, terbuka jendela "Struk tidak tercetak": di sana tertulis apa yang sebenarnya terjadi, dan langkah demi langkah — apa yang harus dilakukan. Mesin kasir dipercaya berdasarkan kode errornya sendiri, bukan berdasarkan rumusan driver: driver sering menyarankan hal yang salah (pada beberapa model, petunjuk "ganti mode" muncul bersama kode "sehari tanpa laporan Z", padahal mode baik-baik saja).

• Jika penyebabnya terlihat dari cloud — jendela memberikan tombol "Ambil laporan Z" dan "Ulangi struk".
• Jika perbaikannya harus di perangkat itu sendiri (tidak ada kertas, struk belum ditutup, error perlu direset dengan tombol di mesin kasir), jendela mengatakan demikian dan memandu langkah demi langkah.
• Jika ini kerusakan untuk teknisi servis (modem, SIM, memori), pengulangan tidak ditawarkan — tidak akan membantu.
• Detail teknis disembunyikan di baris "detail" — berguna untuk dilampirkan pada permintaan dukungan.

Jendela dapat ditutup kapan saja: penjualan sudah tercatat di riwayat struk dan pembayaran sudah diproses, dan struk fiskal dapat dicetak ulang dari sana juga, saat mesin kasir siap. Antrean tidak boleh menunggu.

6. Apa yang dicetak pada struk#

Isi struk fiskal ditentukan oleh hukum negara, sedangkan semua yang dapat diatur dikumpulkan di "Pengaturan registrar" pada bagian Perangkat Keras:

• baris header dan footer (editor per baris);
• logo, pemisah, baris kosong;
• struk detail atau ringkas;
• mode pemotongan;
• tarif pajak dan keterkaitannya dengan grup;
• data operator.

7. Struk elektronik#

• Di Rusia, struk elektronik dikirim ke pembeli oleh OFD — melalui telepon atau e-mail yang dimasukkan saat pembayaran; ini bagian dari 54-FZ, bukan fitur terpisah pada panel.
• Terlepas dari fiskalisasi, Cenaly sendiri mengirim konfirmasi pesanan dan notifikasi pembayaran ke e-mail tamu, dan tautan ke layar pesanan dapat disimpan tamu sebagai bookmark.
• E-mail tamu dikumpulkan di checkout, jika Anda mengaktifkan kolom ini di pengaturan etalase.

8. Pelaporan untuk akuntansi#

Register struk dikelola per cabang, dan darinya disusun:

• Keuangan → Kasir — jurnal perubahan kas, uang tunai, selisih;
• Keuangan → Ringkasan / Penjualan — pendapatan, pajak, metode pembayaran, kanal;
• Keuangan → P&L — laporan laba sederhana dengan pengeluaran manual;
• Pengaturan → Ekspor data — arsip ZIP berisi semua data akun, termasuk pesanan dan katalog dalam CSV (dapat dibuka di Excel dan "Google Spreadsheet") — lihat Ekspor data.

Platform tidak menghasilkan ekspor dalam format DSFinV-K dan SAF-T — itu bagian dari kontur Jerman dan Eropa secara umum, yang untuk saat ini belum ada.

9. Pertanyaan umum#

Apakah fiskalisasi wajib?#

Tergantung pada negara dan jenis kegiatan: di Polandia dan Rusia, kasir online untuk usaha makanan wajib, di Kazakhstan sejak 2026 struk mesin kasir fiskal diperlukan untuk setiap transaksi uang. Untuk persyaratan yang tepat bagi bisnis Anda, tanyakan kepada akuntan atau kantor pajak.

Bisakah beroperasi tanpa printer fisik?#

Saat ini — tidak: gateway cloud Kazakhstan (Webkassa) dan Polandia (kasa online via API) belum dibuka untuk koneksi, sehingga di semua negara yang didukung diperlukan perangkat sendiri. Di Rusia, KKT fisik tetap diperlukan, tetapi dapat dikelola dari cloud melalui bagian "API kasir" — komputer dengan kasir berada di satu tempat, dan struk dikirim ke sana baik dari situs web maupun dari 1C.

Apa yang harus dilakukan jika kasir rusak?#

Bridge dengan jujur menampilkan status perangkat dan teks kesalahan, bukan diam-diam "menelan" kegagalan. Selama kasir tidak tersedia, pesanan dan pembayaran tetap berjalan di sistem — tetapi dokumen fiskal tidak akan muncul tanpa KKT yang berfungsi, dan di sebagian besar negara ini menjadi alasan untuk menghentikan pembayaran dan memberi tahu kantor pajak.

Bagaimana menghubungkan beberapa kasir?#

Perangkat Keras dikelola per cabang: di setiap lokasi ada bridge sendiri (atau beberapa — universal, untuk perangkat, untuk kamera, untuk telepon), dan di register perangkat akun terlihat semua bridge dan semua perangkat dari semua cabang sekaligus, dengan penugasan bridge ke lokasi tambahan.

Apa perbedaan kasa fiskalna dengan KSeF?#

Kasa fiskalna adalah struk untuk perorangan, regulator GUM dan KAS, repositori CRK. KSeF adalah faktur elektronik untuk badan hukum, sistem Kementerian Keuangan. Dokumen dan kewajiban yang berbeda; keberadaan salah satu tidak menghapus yang lain.

10. Dukungan#

• Cenaly: support@cenaly.com → subjek "Fiskalisasi"
• Untuk pertanyaan pendaftaran kasir — hubungi kantor pajak negara Anda
• Bagian terkait: Perangkat Keras, Kasir (POS), Struk, rs.ge