Nordlet

← All features

ऐप डेवलपर्स के लिए Nordlet

एक JSON API, टाइप किए गए SDK, वेबहुक, MCP सर्वर और सैंडबॉक्स कंपनियों के ज़रिए अपने सॉफ़्टवेयर में इनवॉइसिंग, बहीखाता (bookkeeping) और यूरोपीय संघ के कर रिटर्न (EU tax filings) जोड़ें।

कई ऐप्स वित्तीय गतिविधियाँ (money events) बनाते हैं: किसी ऑर्डर का भुगतान होता है, सब्सक्रिप्शन का नवीनीकरण (renew) होता है, या रिफंड जारी होता है। इन सभी गतिविधियों को किसी कंपनी की बहियों (books) में दर्ज होना ज़रूरी है।

Nordlet एक ऐसा अकाउंटिंग सॉफ़्टवेयर है जिसे विशेष रूप से API-फ़र्स्ट अप्रोच के साथ बनाया गया है। वेब ऐप जो कुछ भी करता है, वह सब एक एकल JSON API के माध्यम से भी उपलब्ध है। आपका ऐप इन गतिविधियों को भेजता है, और Nordlet बहियों को व्यवस्थित रखता है और कर रिटर्न (tax filings) तैयार करता है।

Nordlet क्या करता है

  • JSON बॉडी के साथ प्रत्येक क्रिया (action) को POST /v1/{module}/{resource}/{action} के रूप में प्रस्तुत करता है, उदाहरण के लिए /v1/sales/invoices/create।
  • किसी कंपनी से संबंधित API कुंजी (API key) के साथ प्रत्येक अनुरोध (request) को प्रमाणित (authenticate) करता है। प्रत्येक कुंजी में sales:read या sales:write जैसे स्कोप होते हैं, जो इसकी कार्यक्षमता को सीमित करते हैं।
  • राशि (amounts) को फ़्लोटिंग-पॉइंट नंबर के रूप में नहीं, बल्कि हमेशा दशमलव स्ट्रिंग (decimal strings) के रूप में स्वीकार करता है, ताकि राउंडिंग के कारण एक भी सेंट का नुकसान न हो।
  • हर बदलाव पर Idempotency-Key हेडर स्वीकार करता है। एक ही कुंजी के साथ दोबारा प्रयास करने (retry) पर, दोबारा काम करने के बजाय पहला उत्तर ही प्राप्त होता है। इडपोटेंसी (idempotency) का अर्थ है कि बार-बार किया गया अनुरोध एक ही अनुरोध के समान प्रभाव डालता है।
  • प्रत्येक त्रुटि (error) को एक साझा प्रारूप (shared format) में वापस लौटाता है।
  • प्रति API कुंजी, प्रति मिनट 300 अनुरोधों की अनुमति देता है।
  • ऑडिट लॉग में हर बदलाव को रिकॉर्ड करता है।

API कन्वेंशन गाइड इन सभी नियमों को विस्तार से बताती है।

ऐसी बहीखाता प्रणाली जो हमेशा सही रहती है

  • इनवॉइस जारी करने पर एक क्रमिक और अंतरालहीन (gapless) नंबर असाइन होता है, यह जाँच की जाती है कि लेखांकन अवधि (accounting period) खुली है या नहीं, और उसी डेटाबेस ट्रांजेक्शन में जर्नल प्रविष्टि (journal entry) दर्ज की जाती है।
  • प्रत्येक प्रविष्टि का संतुलित (balance) होना अनिवार्य है। ट्रांजेक्शन सहेजे जाने पर डेटाबेस स्वयं इसकी जाँच करता है।
  • जारी किए गए और दर्ज किए गए दस्तावेज़ों को हटाया नहीं जा सकता। बैंक के किसी गलत मिलान को पुराने दस्तावेज़ में बदलाव करके नहीं, बल्कि एक विपरीत प्रविष्टि (reversing entry) के ज़रिए ठीक किया जाता है। इम्यूटेबल लेज़र (immutable ledger) का यही अर्थ है।

SDK, MCP और वेबहुक

  • TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift और Rust के लिए एक ही OpenAPI विवरण से टाइप किए गए SDK जनरेट किए जाते हैं। जब तक कोई SDK प्रकाशित नहीं होता, आप उसे उसके सोर्स रिपॉजिटरी से इंस्टॉल कर सकते हैं। SDK गाइड देखें।
  • हर एंडपॉइंट के साथ एक Postman कलेक्शन उपलब्ध है।
  • MCP सर्वर की मदद से Claude Code जैसा AI सहायक API को खोज सकता है और आपकी API कुंजी के साथ उसे कॉल कर सकता है। प्रत्येक कॉल एक सामान्य API अनुरोध होता है जिसमें समान स्कोप और सीमाएँ होती हैं।
  • वेबहुक आपके ऐप को सूचित करते हैं जब कोई घटना घटती है, उदाहरण के लिए sale_invoice.issued या sale_invoice.paid। प्रत्येक डिलीवरी पर HMAC हस्ताक्षर होता है ताकि आप यह जाँच सकें कि वह Nordlet से आई है या नहीं। विफल डिलीवरी के लिए लगभग 24 घंटे तक दोबारा प्रयास किया जाता है।

सैंडबॉक्स कंपनियों के साथ परीक्षण

  • isSandbox: true के साथ एक कंपनी बनाएँ, या ऐप में कंपनी सेट अप करते समय सैंडबॉक्स बॉक्स पर टिक करें।
  • एक सैंडबॉक्स कंपनी वास्तविक कंपनी की तरह ही काम करती है: वही मॉड्यूल, वही API।
  • इसे स्पष्ट रूप से परीक्षण डेटा (test data) के रूप में चिह्नित किया जाता है, और आप किसी वास्तविक कंपनी को सैंडबॉक्स में या इसके विपरीत नहीं बदल सकते।
  • सैंडबॉक्स कंपनी के रिटर्न और ई-इनवॉइस प्रशासन की परीक्षण सेवाओं (test services) में जाते हैं।
  • सैंडबॉक्स कंपनी में उपयोग (usage) को वास्तविक कंपनी की तरह ही मापा और बिल किया जाता है।

शुरुआत कैसे करें गाइड पहली API कुंजी, पहले इनवॉइस और पूरे चक्र (cycle) के बारे में बताती है।

FAQ

क्या एक ऐप कई कंपनियों को सेवा दे सकता है?

हाँ। प्रत्येक API कुंजी एक कंपनी से संबंधित होती है, इसलिए आप प्रति कंपनी एक कुंजी बनाते हैं। प्रत्येक वेबहुक डिलीवरी में उस कंपनी की companyId होती है जिससे वह संबंधित है, इसलिए एक रिसीवर कई कंपनियों को सेवा दे सकता है।

क्या मुझे कर रिटर्न खुद तैयार करना होगा?

नहीं। Nordlet बहियों से कर रिटर्न तैयार करता है। प्रत्येक रिटर्न के लिए, यह देश के आधार पर या तो इसे भेजता है, अपलोड करने के लिए एक फ़ाइल बनाता है, या आपके द्वारा दर्ज करने के लिए आंकड़े दिखाता है। फाइलिंग सपोर्ट टेबल प्रत्येक मामले की सूची देती है।

संबंधित