Setup e-Invoice Uyumsoft

Convord berkomunikasi dengan Uyumsoft menggunakan permintaan JSON ke BasicIntegrationApi untuk e-Invoice / e-Archive dan, opsional, DespatchApi untuk e-Waybill. Autentikasi sesuai contoh resmi: setiap permintaan menyertakan userInfo dengan Username dan Password. Tidak ada alur OAuth atau API key terpisah; yang Anda masukkan di dashboard persis pasangan itu.

Where to go Open Settings → Integrations (integration settings).

Buka portal Uyumsoft →

Konfigurasi di dashboard

Aktifkan billing di Pengaturan → Integrasi.
Pilih Uyumsoft sebagai penyedia faktur.
Isi NPWP (VKN/TCKN) dan kantor pajak perusahaan Anda; harus cocok dengan akun Uyumsoft Anda.
Masukkan username integrasi dan password integrasi yang disediakan Uyumsoft dan simpan.
Pastikan pelanggan yang Anda fakturkan memiliki VKN (10 digit) atau TCKN (11 digit) yang valid; jika tidak, pengiriman diblokir dengan pesan jelas.

What to request from Uyumsoft

Get these from Uyumsoft support or your Uyumsoft account:

e-Invoice integration username and password
Confirm your company is registered in Uyumsoft (tax ID must match)
Invoice series / prefix configured in Uyumsoft

Nomor pajak pelanggan

NPWP pembeli yang valid diperlukan untuk pengiriman Uyumsoft. Convord memvalidasi sebelum create/send dan menampilkan error eksplisit; perbarui record pelanggan dan coba lagi.

Lingkungan test

Gunakan dokumentasi Uyumsoft untuk URL test dan kredensial contoh. Perintah Artisan uyumsoft:test melakukan smoke test konektivitas BasicIntegrationApi.

E-waybill (DespatchApi)

Mode waybill PDF/XML lokal tidak memerlukan flag server tambahan. e-waybill Uyumsoft / GİB nyata memerlukan:

Akun Uyumsoft & seri faktur

Meskipun wiring API benar, proyek Uyumsoft Anda harus memiliki <strong>seri / prefix</strong> faktur dan pengaturan akun yang lengkap. Jika tidak, Anda mungkin melihat error seperti seri hilang. Hubungi dukungan Uyumsoft untuk setup akun.

Common issues

Symptom	What to do
Connection test fails	Check username, password, and tax ID; confirm the Uyumsoft account is active.
Invoice cannot be sent	Check customer VKN/TCKN; verify series settings in Uyumsoft.
E-waybill not reaching GİB	Local PDF output is normal; GİB e-waybill needs an extra service — contact support.

Informasi lebih lanjut

Untuk konteks integrasi yang lebih luas, lihat Panduan integrasi.