Uyumsoft e-Invoice सेटअप

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

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

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

API key बनाम username / password

एकीकरण REST userInfo object उपयोग करता है। Convord में दो फ़ील्ड Username और Password से मैप होते हैं। अतिरिक्त Bearer token या secret-key फ़ील्ड नहीं।

वैकल्पिक रूप से server .env में tenant-wide fallback के लिए UYUMSOFT_USERNAME / UYUMSOFT_PASSWORD सेट करें; dashboard में company-specific मान मौजूद होने पर प्राथमिकता।

Server (.env) सेटिंग

Hosting / DevOps को सत्यापित करना चाहिए:

• UYUMSOFT_BASE_URL — उदा. production https://efatura.uyumsoft.com.tr/api या test https://efatura-test.uyumsoft.com.tr/api (config में path settings के साथ)।
• वैकल्पिक full URLs: UYUMSOFT_INVOICE_API_URL, UYUMSOFT_DESPATCH_API_URL।
• Deploy के बाद smoke test: php artisan uyumsoft:test

ग्राहक tax number

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

E-waybill (DespatchApi)

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

• EINVOICE_PROVIDER=uyumsoft
• UYUMSOFT_DISPATCH_ENABLED=true — इस mode में buyer VKN/TCKN भी आवश्यक।

Uyumsoft account और invoice series

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

Test environment

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

अधिक जानकारी

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