Persediaan e-Invois Uyumsoft

Convord berkomunikasi dengan Uyumsoft menggunakan permintaan JSON ke BasicIntegrationApi untuk e-Invois / e-Arkib dan, pilihan, DespatchApi untuk e-Waybill. Pengesahan sepadan dengan sampel rasmi: setiap permintaan termasuk userInfo dengan Username dan Password. Tiada aliran OAuth atau kunci API berasingan; apa yang anda masukkan dalam papan pemuka ialah pasangan itu.

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

Buka portal Uyumsoft →

Konfigurasi dalam papan pemuka

Hidupkan pengebilan di bawah Tetapan → Integrasi.
Pilih Uyumsoft sebagai penyedia invois.
Isi ID cukai (VKN/TCKN) dan pejabat cukai syarikat anda; mesti sepadan dengan akaun Uyumsoft anda.
Masukkan nama pengguna integrasi dan kata laluan integrasi yang disediakan Uyumsoft dan simpan.
Pastikan pelanggan yang anda invois ada VKN (10 digit) atau TCKN (11 digit) yang sah; jika tidak penghantaran disekat dengan mesej 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

Nombor cukai pelanggan

ID cukai pembeli sah diperlukan untuk penyerahan Uyumsoft. Convord sahkan sebelum cipta/hantar dan tunjuk ralat eksplisit; kemas kini rekod pelanggan dan cuba semula.

Persekitaran ujian

Gunakan dokumentasi Uyumsoft untuk URL ujian dan kredensial sampel. Perintah Artisan uyumsoft:test uji asap sambungan BasicIntegrationApi.

E-waybill (DespatchApi)

Mod waybill PDF/XML tempatan tidak memerlukan bendera pelayan tambahan. e-waybill Uyumsoft / GİB sebenar memerlukan:

Akaun Uyumsoft & siri invois

Walaupun dengan pendawaian API betul, projek Uyumsoft anda mesti ada <strong>siri / awalan</strong> invois dan tetapan akaun lengkap. Jika tidak anda mungkin nampak ralat seperti siri hilang. Hubungi sokongan Uyumsoft untuk persediaan akaun.

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.

Maklumat lanjut

Untuk konteks integrasi lebih luas, lihat Panduan integrasi.