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.

Konfigurasi di dashboard

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

API key vs username / password

Integrasi menggunakan objek REST userInfo. Dua field di Convord dipetakan ke Username dan Password. Tidak ada Bearer token atau field secret-key tambahan.

Opsional setel UYUMSOFT_USERNAME / UYUMSOFT_PASSWORD di .env server sebagai fallback tenant-wide; nilai spesifik perusahaan di dashboard diutamakan jika ada.

Pengaturan server (.env)

Hosting / DevOps harus memverifikasi:

• UYUMSOFT_BASE_URL — mis. produksi https://efatura.uyumsoft.com.tr/api atau test https://efatura-test.uyumsoft.com.tr/api (dikombinasikan dengan pengaturan path di config).
• URL lengkap opsional: UYUMSOFT_INVOICE_API_URL, UYUMSOFT_DESPATCH_API_URL.
• Smoke test setelah deploy: php artisan uyumsoft:test

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.

E-waybill (DespatchApi)

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

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

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.

Lingkungan test

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

Informasi lebih lanjut

Untuk konteks integrasi yang lebih luas, lihat Panduan integrasi.