POST AI agent ready /v1/validate/vat

API Validasi Nomor PPN - Pemeriksaan PPN UE Gratis

Kirimkan nomor PPN dan terima kembali apakah sesuai dengan format yang diharapkan untuk negaranya. Mendukung semua negara anggota UE. Berguna untuk pembuatan faktur B2B, alur pembayaran bebas pajak, dan pemeriksaan kepatuhan. Nomor PPN diproses di sisi server dan tidak pernah disimpan.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

Verifikasi ID PPN pelanggan selama pembayaran B2B

Sebelum menerapkan pembebasan PPN tarif nol saat checkout, validasi ID PPN pembeli. Hal ini melindungi Anda dari penerbitan faktur yang salah dan potensi denda selama pemeriksaan pajak.

Mengisi otomatis aturan negara dan pajak dari nomor PPN

Ekstrak kode negara dari ID PPN untuk secara otomatis menerapkan tarif PPN, bahasa faktur, dan persyaratan pelaporan yang benar untuk setiap negara anggota UE.

Validasi batch nomor PPN di CRM Anda

Jalankan database pelanggan Anda melalui titik akhir secara berkala. Tandai akun dengan ID PPN yang tidak valid atau habis masa berlakunya sehingga tim keuangan Anda dapat meminta dokumen yang diperbarui sebelum siklus faktur berikutnya.

Frequently asked questions

Negara mana saja yang didukung?

Seluruh 27 negara anggota UE. Setiap negara memiliki format nomor PPN sendiri (misalnya DE + 9 digit untuk Jerman, FR + 11 karakter untuk Prancis). API memvalidasi berdasarkan pola yang benar untuk negara yang terdeteksi.

Apakah API ini memeriksa nomor PPN terhadap database VIES?

Titik akhir ini memvalidasi format dan struktur nomor PPN. Untuk pencarian VIES (Komisi UE) real-time guna mengonfirmasi status pendaftaran, pasangkan dengan layanan resmi VIES SOAP.

Apakah nomor PPN disimpan setelah validasi?

Tidak. Nomor tersebut diproses dalam memori dan dibuang setelah respons. Tidak ada data yang ditulis ke disk atau sistem eksternal apa pun.

Bisakah saya memvalidasi nomor PPN Inggris?

Nomor PPN Inggris (awalan GB) mengikuti format yang diketahui dan dapat divalidasi secara struktural. Sejak Inggris keluar dari UE, mereka tidak lagi menjadi bagian dari VIES, namun pemeriksaan format masih berfungsi.

Apa yang terjadi jika saya mengirim nomor tanpa awalan negara?

API memerlukan awalan negara yang terdiri dari dua huruf (misalnya, "DE", "FR", "NL"). Tanpanya, respons akan kembali valid: salah dengan alasan yang menjelaskan bahwa kode negara tidak ada.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.