Logo और Mikro सेटअप

यह पेज व्यवसाय और संचालन उपयोगकर्ताओं के लिए है। तकनीकी आर्किटेक्चर और developer विवरण docs/ERP_INTEGRATION.md में हैं।

समग्र प्रवाह

1. Dashboard → Accounting integrations के अंतर्गत Logo या Mikro रिकॉर्ड खोलें, इसे Active सेट करें, और safe write mode चुनें (डिफ़ॉल्ट: manual CSV only)।
2. Dashboard → ERP product mappings पर SKU → ERP stock code, unit, और VAT मैपिंग पूरी करें (उत्पादों से sync या पंक्तियाँ जोड़ें)।
3. सुनिश्चित करें कि ग्राहकों के पास ledger/cari code या tax ID है; ऑर्डर बनने पर job ERP order queue में जाता है।
4. कतार या order detail से CSV डाउनलोड कर ERP में import करें। प्रक्रिया स्थिर होने के बाद ही auto-dispatch चालू करें।

पथ: /dashboard/accounting · /dashboard/integration-mapping?provider=logo या provider=mikro · /dashboard/integration-outbox।

साझा तैयारी

ERP पक्ष पर स्पष्ट करें

• ऑर्डर कैसे बनते हैं: manual CSV, watched import folder, stored procedure / local agent।
• क्या Convord उत्पाद / variant SKU फ़ील्ड ERP stock codes से मेल खाते हैं (या mapping table उपयोग करें)।
• ERP में ग्राहक कैसे resolve होते हैं (<strong>cari/ledger code</strong> पसंदीदा; अन्यथा tax ID)।

Convord में उत्पाद और variant SKU

हर उत्पाद के लिए SKU भरें। यदि weights/variants उपयोग करते हैं, तो प्रत्येक variant का अपना SKU होना चाहिए।

मैपिंग पैनल

ERP product mappings पर अपना सक्रिय mapping set प्रबंधित करें: SKU पंक्तियाँ जोड़ें या "sync from products"; default unit और VAT mappings जाँचें। Queue CSV download के लिए mapping snapshot आवश्यक है।

Safe write और automation

Settings में safe write mode: manual CSV only, import file only, या procedure only। Auto ERP dispatch डिफ़ॉल्ट off; ~20 सफल transfers और मजबूत mapping/customer data के बाद ही enable करें।

Logo — उपयोगकर्ता दृष्टिकोण

Convord पहले ऑर्डर outbox queue में लिखता है। सामान्य Logo मार्ग: manual CSV import या (advanced) SQL stored procedures / local agent। Logo के लिए classic "REST connection test" उपयोग नहीं; production में direct Logo REST push अक्षम।

Dashboard में

1. Accounting integrations → Logo → Start setup / Settings।
2. वैकल्पिक रूप से bridge के लिए API endpoint / API key; संचालन के लिए safe write mode सेट करें और integration Active चिह्नित करें।
3. ERP product mappings पर SKU mapping पूरी करें (provider=logo)।
4. Test order रखें → ERP order queue या order detail से CSV डाउनलोड करें।

Mikro — उपयोगकर्ता दृष्टिकोण

सामान्य पैटर्न: delimited CSV import folder में रखें। विकल्प: bridge master-data pull (customers/products/stock) और वैकल्पिक local Convord ERP Agent। Order push अभी भी outbox से होता है।

Dashboard में

1. Accounting integrations → Mikro → Settings।
2. transport चुनें: file (import path + file prefix) या bridge (URL)। Variant: Mikro Fly / Run / Jumbo, आदि।
3. File mode में writable import path दर्ज करें और Test connection; bridge mode में health check और sync बटन उपयोग करें।
4. Mapping panel (provider=mikro) + test order → queue / CSV।

Manual CSV (अनुशंसित शुरुआत)

डिफ़ॉल्ट और fallback मार्ग:

• ERP order queue से job के लिए CSV डाउनलोड करें (mapping snapshot होना चाहिए)।
• वैकल्पिक रूप से order detail से Logo / Mikro CSV डाउनलोड करें (/dashboard/orders/{id}/erp-manual-export/logo या .../mikro)।
• उत्पाद नाम कॉलम (PRODUCT_NAME / UrunAdi) Excel में verification में मदद; mapping के बिना stock column internal SKU दिखा सकता है।

Logo columns: ORDER_NO;STOCK_CODE;PRODUCT_NAME;QTY;UNIT;UNIT_PRICE
Mikro columns: BelgeNo;StokKodu;UrunAdi;Miktar;Birim
Format: UTF-8 (BOM), delimiter ;।

चेकलिस्ट (सारांश)