Uyumsoft e-Invoice सेटअप

Convord Uyumsoft से e-Invoice / e-Archive के लिए BasicIntegrationApi और वैकल्पिक रूप से e-Waybill के लिए DespatchApi पर JSON अनुरोधों से बात करता है। Authentication आधिकारिक नमूनों से मेल: प्रत्येक अनुरोध में userInfo Username और Password के साथ। OAuth flow या अलग API key नहीं; dashboard में जो दर्ज करते हैं वही pair है।

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

Uyumsoft पोर्टल खोलें →

Dashboard में कॉन्फ़िगर करें

Settings → Integrations के अंतर्गत billing चालू करें।
Invoice provider के रूप में Uyumsoft चुनें।
कंपनी tax ID (VKN/TCKN) और tax office भरें; Uyumsoft खाते से मेल होना चाहिए।
Uyumsoft द्वारा दिया गया integration username और integration password दर्ज कर सहेजें।
जिन ग्राहकों को invoice करते हैं उनके पास वैध VKN (10 अंक) या TCKN (11 अंक) हो; अन्यथा स्पष्ट संदेश के साथ भेजना अवरुद्ध।

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

ग्राहक tax number

Uyumsoft submission के लिए वैध buyer tax ID आवश्यक। Convord create/send से पहले validate करता है और स्पष्ट error दिखाता है; ग्राहक रिकॉर्ड अपडेट कर पुनः प्रयास करें।

Test environment

Test URLs और sample credentials के लिए Uyumsoft documentation उपयोग करें। uyumsoft:test Artisan command BasicIntegrationApi connectivity का smoke test करता है।

E-waybill (DespatchApi)

Local PDF/XML waybill mode में अतिरिक्त server flags नहीं। वास्तविक Uyumsoft / GİB e-waybill के लिए:

Uyumsoft account और invoice series

सही API wiring के बावजूद, Uyumsoft project में invoice <strong>series / prefix</strong> और account settings पूर्ण होने चाहिए। अन्यथा missing series जैसी errors। Account setup के लिए Uyumsoft support से संपर्क करें।

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.

अधिक जानकारी

व्यापक एकीकरण संदर्भ के लिए Integration guide देखें।