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.

Konfigurasi dalam papan pemuka

1. Hidupkan pengebilan di bawah Tetapan → Integrasi.
2. Pilih Uyumsoft sebagai penyedia invois.
3. Isi ID cukai (VKN/TCKN) dan pejabat cukai syarikat anda; mesti sepadan dengan akaun Uyumsoft anda.
4. Masukkan nama pengguna integrasi dan kata laluan integrasi yang disediakan Uyumsoft dan simpan.
5. Pastikan pelanggan yang anda invois ada VKN (10 digit) atau TCKN (11 digit) yang sah; jika tidak penghantaran disekat dengan mesej jelas.

Kunci API vs nama pengguna / kata laluan

Integrasi menggunakan objek REST userInfo. Dua medan dalam Convord dipetakan ke Username dan Password. Tiada token Bearer atau medan kunci rahsia tambahan.

Pilihan tetapkan UYUMSOFT_USERNAME / UYUMSOFT_PASSWORD dalam .env pelayan sebagai sandaran seluruh tenant; nilai khusus syarikat dalam papan pemuka diutamakan apabila wujud.

Tetapan pelayan (.env)

Hosting / DevOps patut sahkan:

• UYUMSOFT_BASE_URL — cth. produksi https://efatura.uyumsoft.com.tr/api atau ujian https://efatura-test.uyumsoft.com.tr/api (digabung dengan tetapan laluan dalam config).
• URL penuh pilihan: UYUMSOFT_INVOICE_API_URL, UYUMSOFT_DESPATCH_API_URL.
• Ujian asap selepas deploy: php artisan uyumsoft:test

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.

E-waybill (DespatchApi)

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

• EINVOICE_PROVIDER=uyumsoft
• UYUMSOFT_DISPATCH_ENABLED=true — VKN/TCKN pembeli juga diperlukan dalam mod ini.

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.

Persekitaran ujian

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

Maklumat lanjut

Untuk konteks integrasi lebih luas, lihat Panduan integrasi.