Cara mengintegrasikan pemeriksaan VAT VIES untuk onboarding bisnis

Pada hari Jumat, Anda sedang meninjau pengajuan yang ditolak di perusahaan pembiayaan usaha kecil ketika beberapa pengajuan dari Jerman muncul berdekatan. Semuanya diberi alasan “nomor VAT tidak terdaftar”. Salah satu pemilik usaha sudah menelepon. Ia mengatakan nomor tersebut tercantum di setiap faktur yang dikirim perusahaannya dan ingin tahu mengapa pengajuan itu terhenti. Bulan lalu, Anda menambahkan pemeriksaan VAT setelah seorang perantara mengajukan permohonan dengan nomor milik perusahaan lain. Kini alasan yang sama muncul pada bisnis dengan situasi yang sangat berbeda, sementara pengajuan hari Senin segera masuk. Apa arti respons itu sebelum menjadi keputusan?

Respons VIES tidak hanya valid atau tidak valid

Respons VIES dapat memuat status pendaftaran, nama terdaftar, atau pesan kesalahan dari registri. Layanan VIES Komisi Eropa mengonfirmasi apakah nomor VAT terdaftar, dan responsnya dapat menyertakan nama terdaftar. Dalam pengujian yang kami lakukan dari mesin kami pada 30 Oktober 2026, kami menemukan nomor terdaftar dengan nama, nomor terdaftar tanpa nama, nomor yang tidak terdaftar, serta kesalahan registri.

Satu nomor dari Jerman berstatus valid dengan nama “---”, lalu dua menit kemudian menghasilkan MS_UNAVAILABLE. Aturan yang hanya membaca valid akan meloloskan respons pertama tanpa nama untuk dibandingkan. Jika nilai valid yang tidak ada dianggap tidak valid, gangguan registri sementara bisa berujung pada penolakan.

jawabancontohstatus HTTPvalidnama terdaftaraturan yang hanya membaca valid
terdaftar, nama tersediaIE6388047V200trueGOOGLE IRELAND LIMITEDlolos
terdaftar, nama tidak diberikanDE811569869, ESB82846825200true---lolos, tanpa ada yang bisa dibandingkan
tidak terdaftarIE1234567X200false---decline
basis data tidak merespons, RESTDE811569869200tidak adatidak ada, error MS_UNAVAILABLEtidak menemukan valid
basis data tidak merespons, SOAPDE811569869200tidak adafault MS_UNAVAILABLEtidak menemukan valid
basis data sibuk, endpoint browserLV40003009497200false---, error MS_MAX_CONCURRENT_REQdecline

Jenis respons menentukan artinya. Status pendaftaran menunjukkan apakah nomor tercatat di basis data nasional, sedangkan nama dapat membantu memeriksa apakah pemohon adalah bisnis yang terdaftar.

Halaman status tidak menentukan hasil setiap permintaan

Tentukan hasil setiap panggilan dari responsnya. Gunakan halaman status hanya sebagai informasi tambahan. Dalam pengujian kami, endpoint browser mengembalikan isValid false dengan MS_MAX_CONCURRENT_REQ saat registri sibuk. Jika hanya membaca nilai false tersebut, masalah pada registri terlihat seperti nomor yang tidak terdaftar.

Endpoint browser digunakan oleh situs web VIES. Kontrak REST yang dipublikasikan mendokumentasikan antarmuka yang berbeda. Hasil di halaman status juga tidak selalu sesuai dengan pengujian kami. Halaman itu menyatakan Jerman tersedia saat respons dari Jerman menunjukkan MS_UNAVAILABLE, dan menyatakan Latvia tidak tersedia saat nomor dari Latvia menghasilkan respons valid beserta nama.

Komisi Eropa menyatakan bahwa VIES mengambil informasi dari basis data negara anggota yang tidak berada di bawah kendalinya. Ketersediaan bisa berbeda antarregistri dan antarpanggilan.

Tangani kesalahan layanan sebelum menentukan status pendaftaran

Hubungkan kode negara dan nomor VAT dari pengajuan ke layanan VIES yang dipublikasikan, lalu buat hasil khusus untuk kesalahan layanan. Antarmuka yang dipublikasikan tersedia melalui REST dan SOAP. REST menyediakan POST /check-vat-number, sedangkan SOAP menyediakan checkVat. Kedua antarmuka dapat digunakan tanpa kunci atau akun.

Di sumber data, teruskan kode negara dan nomor dari pengajuan melalui alur keputusan. Sumber data menambahkan respons ke data keputusan agar dapat diklasifikasikan oleh aturan. Periksa kesalahan sebelum membaca valid. Dalam pengujian kami untuk Jerman, REST mengembalikan HTTP 200 dengan MS_UNAVAILABLE tanpa kolom valid. Pengaturan pengulangan REST yang didokumentasikan mencakup masalah koneksi dan beberapa status HTTP tertentu. Respons HTTP 200 dengan MS_UNAVAILABLE tetap harus ditangani oleh alur keputusan.

Contohnya, respons kesalahan dapat menghasilkan status tidak tersedia, seperti diteruskan untuk ditinjau atau dicoba lagi nanti. Respons dengan valid false berarti nomor tidak terdaftar, sedangkan respons dengan valid true berarti nomor terdaftar. Uji setiap cabang dan pastikan hasilnya sesuai sebelum integrasi dirilis.

Jalankan pemeriksaan ini dalam alur keputusan

Buat aturan untuk kredit, fraud, atau penagihan, lalu jalankan pada keputusan nyata.

Periksa nama terdaftar secara terpisah

Nomor valid bisa terdaftar atas nama perusahaan lain. Bandingkan nama terdaftar dengan nama perusahaan dalam pengajuan, lalu gunakan nilai terpisah untuk status pendaftaran dan pemeriksaan nama di tabel keputusan.

Dalam pengujian kami untuk Jerman dan Spanyol, nomor valid menghasilkan nama dan alamat “---”. Nilai pencocokan nama pemilik usaha adalah NOT_PROCESSED, sehingga tidak ada nama untuk dibandingkan. Klasifikasikan “---” sebagai nama yang tidak diungkapkan.

Sebagai contoh aturan, tetapkan pemeriksaan nama menjadi cocok jika nama yang dikembalikan memuat nama perusahaan pemohon, tidak diungkapkan jika nama kosong atau “---”, dan tidak cocok jika berbeda dari nama perusahaan pemohon. Teruskan ketidakcocokan kepada staf untuk ditinjau. Jika VIES tidak mengungkapkan nama, cari nama perusahaan terdaftar di registri perusahaan terkait. Untuk pemohon dari Inggris, pemeriksaan melalui Companies House adalah salah satu contoh pemeriksaan registri.

status VATpemeriksaan namahasilalasan
tidak tersediaapa punreferVAT_CHECK_UNAVAILABLE
tidak validapa pundeclineVAT_NOT_REGISTERED
validtidak cocokreferVAT_NAME_MISMATCH
validtidak diungkapkanreferVAT_NAME_NOT_DISCLOSED
validcocokpassOK

Teruskan ketidakcocokan kepada staf untuk ditinjau, dan cari nama di registri perusahaan terkait jika nama tidak diungkapkan. VIES menjadi salah satu sumber informasi di antara pemeriksaan lain dalam pembiayaan usaha kecil dan menengah.

Tinjau ketentuan sebelum menyimpan respons dalam cache

Minta penasihat hukum meninjau ketentuan VIES untuk penggunaan yang direncanakan sebelum mengaktifkan cache. Ketentuan tersebut membatasi pengiriman ulang dan penggunaan lainnya, serta secara tegas melarang penyalinan atau reproduksi konten. Minta penasihat hukum memastikan apakah integrasi dan penyimpanan yang direncanakan diperbolehkan.

Ada risiko teknis yang perlu diperhatikan. Dokumentasi cache sumber data menjelaskan bahwa respons yang dapat diurai dan memiliki status HTTP di bawah 400 dapat disimpan dalam cache. Karena itu, respons REST dengan HTTP 200 dan isi yang dapat diurai bisa menyimpan kesalahan seperti MS_UNAVAILABLE layaknya respons biasa.

Tetapkan hasil sebelum pengajuan hari Senin masuk

Sebelum pengajuan hari Senin masuk, tetapkan hasil untuk pemeriksaan ini:

  1. Panggil kontrak REST yang dipublikasikan atau layanan SOAP dengan kode negara dan nomor VAT dari aplikasi. Halaman web VIES menggunakan endpoint browser yang terpisah.
  2. Periksa error sebelum membaca valid. Arahkan error ke hasil tersendiri, misalnya refer atau coba lagi nanti. Gunakan decline hanya untuk nomor yang dipastikan tidak terdaftar.
  3. Periksa jawaban dari setiap panggilan untuk mengetahui apakah panggilan berhasil. Halaman status memberi konteks tentang kondisi layanan.
  4. Bandingkan nama terdaftar dengan nama perusahaan pemohon. Jika nomor valid terdaftar atas nama lain, tetapkan hasil tersendiri agar dapat ditinjau oleh petugas.
  5. Klasifikasikan “---” sebagai nama yang tidak diberikan. Periksa nama perusahaan di registri perusahaan terkait.
  6. Minta penasihat hukum meninjau ketentuan dan menyetujui tujuan penggunaan sebelum menyimpan jawaban VIES dari REST dalam cache. Perhitungkan bahwa respons error dengan status HTTP 200 dapat tersimpan sebagai jawaban di cache.
  7. Simpan jawaban validasi bersama keputusan dalam bentuk yang disetujui penasihat hukum, sesuai rekomendasi Komisi untuk pemeriksaan pajak.

Pertanyaan yang sering diajukan tentang pemeriksaan VAT VIES

Apakah tersedia API gratis untuk validasi nomor VAT Uni Eropa?

Pengujian kami tidak memerlukan kunci atau akun. Komisi Eropa tidak mencantumkan harga layanan tersebut. Periksa ketentuannya untuk mengetahui penggunaan yang diperbolehkan.

Apa arti MS_UNAVAILABLE dan bagaimana keputusan harus menanganinya?

MS_UNAVAILABLE berarti aplikasi negara anggota tidak merespons atau sedang tidak tersedia. Dalam pengujian kami untuk Jerman, kesalahan ini muncul dengan HTTP 200. Arahkan ke hasil tersendiri, seperti diteruskan untuk ditinjau atau dicoba lagi nanti, bukan ke penolakan.

Apakah hasil VIES yang valid membuktikan identitas perusahaan?

Tidak. Nomor valid bisa terdaftar atas nama perusahaan lain. Bandingkan nama terdaftar dengan nama perusahaan pemohon, lalu teruskan ketidakcocokan kepada staf untuk ditinjau.

VIES menggunakan REST atau SOAP, dan mana yang sebaiknya digunakan?

VIES menyediakan antarmuka REST dan SOAP. Gunakan kontrak yang didukung integrasi Anda, lalu uji cara kesalahannya ditangani dalam alur keputusan.

Bisakah respons VIES disimpan dan digunakan kembali?

Hanya setelah penasihat hukum meninjau ketentuan dan menyetujui penggunaan yang direncanakan. Ketentuan tersebut membatasi pengiriman ulang dan penggunaan lainnya, serta melarang penyalinan atau reproduksi konten. Sepakati dengan penasihat hukum catatan validasi seperti apa yang boleh disimpan untuk penggunaan tersebut sebelum menyimpan atau menggunakan kembali respons.

Berapa lama panggilan VIES berlangsung?

Dalam pengujian kami pada 30 Oktober 2026, sebagian besar respons memerlukan waktu 0.4 hingga 0.8 detik, dan beberapa lebih lama. Pengukuran tersebut berasal dari satu sore dan bukan jaminan layanan. Pastikan panggilan yang lambat atau gagal diarahkan ke hasil tersendiri.

Jalankan pemeriksaan ini dalam alur keputusan

Buat aturan untuk kredit, fraud, atau penagihan, lalu jalankan pada keputusan nyata.