मुख्य सामग्री के लिए छोड़ें
संस्करण: 1.x

WCPOS ATUM Integration

ATUM Multi-Inventory को WCPOS Pro से integrate करता है, जिससे Point of Sale पर location-based inventory, pricing और SKUs मिलते हैं।

ATUM Multi-Inventory आपको किसी product का stock कई inventory locations, जैसे warehouses और retail stores, में बाँटने देता है। यह plugin उन ATUM locations को WCPOS Pro stores से जोड़ता है, ताकि हर POS terminal अपनी physical location के लिए सही stock levels, prices और SKUs देखे।

विशेषताएँ​

हर स्थान का स्टॉक

प्रत्येक store aggregate WooCommerce stock के बजाय अपने assigned ATUM inventory location से stock quantities लेता है।

लचीली कीमतें

WooCommerce defaults, WCPOS Pro per-store prices, या ATUM location-specific prices में से pricing चुनें।

स्थान-विशिष्ट SKU

POS में product के main SKU को optional रूप से ATUM location-specific SKU से बदलें।

ऑडिट-सुरक्षित स्टॉक मूवमेंट

Orders सही ATUM location पर stock deduct और restore करते हैं, और atum_inventory_orders में पूरा audit trail रखते हैं।

उत्पाद edits का write-back

POS से किए गए stock, price और SKU edits उस location की mapped ATUM inventory row में वापस sync होते हैं।

इंस्टॉलेशन​

1

ATUM और Multi-Inventory इंस्टॉल करें

ATUM Inventory Management और ATUM Multi-Inventory add-on install करें। ATUM में अपनी inventory locations configure करें।

2

WCPOS ATUM Integration इंस्टॉल करें

WP Admin > POS > Settings > Extensions से install करें, या GitHub releases page से latest release डाउनलोड करके Plugins > Add New > Upload Plugin से upload करें।

3

Stores को ATUM locations से map करें

POS > Stores पर जाएँ, store edit करें और ATUM Inventory sidebar section configure करें। Store को उपयोग करनी वाली inventory location चुनें, pricing source चुनें और optional रूप से SKU overrides enable करें।

Store configuration​

Plugin WCPOS Pro store editor sidebar में ATUM Inventory section जोड़ता है, जिसमें हर store के लिए तीन settings होती हैं:

  • Inventory Location — यह store किस ATUM location से stock लेता है।
  • Pricing Source — product prices कहाँ से आते हैं:
    • Default — standard WooCommerce prices
    • WCPOS Pro — WCPOS Pro में set per-store pricing
    • ATUM — ATUM inventory से location-specific prices
  • SKU Override — optional रूप से product के main SKU के बजाय ATUM location-specific SKUs उपयोग करें।

POS व्यवहार​

जब किसी store को ATUM location assigned होता है, POS को served product data अपने आप adjust होता है:

  • Stock quantities specific location की inventory दिखाती हैं, aggregate WooCommerce stock नहीं।
  • Stock status location की quantity के आधार पर फिर से calculate होता है।
  • Prices configured pricing source से आते हैं।
  • SKUs override enabled होने पर ATUM location SKU से बदल जाते हैं।

सभी adjustments WCPOS REST API के through transparent तरीके से होते हैं। POS app side पर कोई change आवश्यक नहीं है। POS से किए गए product edits भी mapped ATUM inventory row में वापस लिखे जाते हैं; नीचे product edits के write-back देखें।

Stock management​

Mapped ATUM location वाले stores में रखे गए POS orders के लिए plugin ATUM के native stock deduction flow को write संभालने देता है, लेकिन उसे सही location की ओर steer करता है:

  1. REST payload injection. जब POS order create या update करता है, plugin हर line item पर mi_inventories entry inject करता है ताकि ATUM जान सके कि किस location से stock लेना है। इसके बिना ATUM main inventory पर fallback करता।
  2. Location-scoped inventory filter. Plugin ATUM की candidate inventory list को केवल उन entries तक filter करता है जो store के mapped location term से linked हैं, ताकि reduction और restoration दोनों में सही one चुना जाए।

ATUM खुद order और refund पर actual stock change करता है और real order_id के साथ atum_inventory_orders में rows लिखता है, जिससे ATUM का audit trail सुरक्षित रहता है।

Product edits का write-back​

जब cashier या manager POS से product या variation edit करता है, changes उस store की location से mapped ATUM inventory row में वापस sync होते हैं, केवल main WooCommerce product में नहीं। इससे हर location का stock, price और SKU WP Admin में manual updates के बिना ATUM के साथ sync रहता है।

Write-back WCPOS product और variation REST updates (POST, PUT, PATCH to /wcpos/v1/products/...) पर trigger होता है जिनमें store_id शामिल है। Plugin store की mapped ATUM location lookup करता है और केवल उस location की inventory row update करता है। बाकी locations untouched रहती हैं।

क्या sync होता है​

Write-back हर store की configuration का सम्मान करता है, ताकि ATUM data तभी बदले जब store वास्तव में उस data का owner हो:

फ़ील्डकब sync होता है
Stock quantityहमेशा — mapped ATUM location वाला हर store अपनी location row को sync में रखता है।
Regular price / Sale price / Priceकेवल जब store का Pricing Source ATUM पर set हो।
SKUकेवल जब store के लिए SKU Override enabled हो।

अगर store Default या WCPOS Pro pricing उपयोग करता है, ATUM price fields untouched रहते हैं ताकि ATUM source of truth के बजाय reference price बना रहे। Override बंद होने पर SKUs पर भी यही लागू होता है।

क्या write-back trigger नहीं करता​

  • Product creation; केवल updates write back करते हैं। नए products WooCommerce के normal save path से गुजरते हैं।
  • store_id के बिना requests; POS को plugin को बताना होगा कि किस location में write करना है।
  • Mapped ATUM location के बिना stores।
  • Store की location के लिए existing ATUM inventory row के बिना products। Plugin नई inventory rows नहीं बनाता, केवल existing rows update करता है।

आवश्यकताएँ​

WordPress: WordPress 5.9+ with PHP 7.4+
WooCommerce: WooCommerce इंस्टॉल और सक्रिय है
ATUM: ATUM Inventory Management और ATUM Multi-Inventory add-on
WCPOS: WCPOS Pro — multi-store एक Pro feature है