Shopify Product Publishing & Loop Return Governance

1. Overview

This document defines the configuration controls and architectural governance governing Shopify product publishing by operational source and return application positioning within XoroERP.

It covers:

• Source-based publishing control • Multi-channel visibility management • Supported return integrations • Exchange order behavior • Structural separation between publishing configuration and return processing systems

This document does not redefine detailed RMA mechanics, refund calculations, restock workflows, handle-matching logic, or inventory valuation rules, which are covered separately.

---

2. Functional Workflow

---

2.1 Shopify Product Publishing by Operational Source

System Behavior

• Products are created and maintained inside Xoro
• Users may select one or multiple Shopify operational sources
• Supported sources may include:

  • Web Store
  • POS
  • Other Shopify sales channels
• Publishing scope determines where the product is visible
• Non-selected sources remain unaffected

Result

• Product visibility is controlled directly from Xoro
• Publishing scope must be defined before synchronization
• Publishing does not imply universal store visibility

---

2.2 Multi-Source Publishing Governance

Applicable Scenarios

• Merchants operating:

  • E-commerce channels
  • POS environments
  • B2B storefronts
  • Hybrid multi-source structures

Governance Behavior

• Source selection must align with the client’s operational structure
• Improper source assignment may result in:

  • Channel misalignment
  • Reporting inconsistencies
  • Inventory segmentation issues
• Publishing scope must reflect intended operational distribution

---

2.3 Shopify Return Integration Architecture Overview

Supported Integrations

• Loop
• ReturnLogic
• AfterShip

Architectural Positioning

• Return integrations function as decision systems
• The selected return application determines refund, store credit, or exchange outcomes
• Shopify reflects return status
• Xoro reflects operational and financial impact

Control Rule

• The return integration must be identified before configuration
• Return architecture depends on the selected integration

---

2.4 Loop Return Decision Governance

When Loop Is Used

• Return decisions originate in Loop
• Shopify reflects the processed outcome
• Xoro updates fulfillment and financial records

Architectural Clarification

• Loop operates as the return decision authority
• Shopify acts as a synchronization layer, not the decision engine

---

2.5 Exchange Order Governance Principle

• When an exchange is selected:

  • A new sales order is generated
  • The original order remains unchanged
  • The exchange is treated as a forward-flow transaction

Governance Clarification

• Exchange behavior does not modify the original sales order
• Exchange creates a new commercial transaction linked to the return

---

2.6 Publishing & Return Separation Principle

• Product publishing control and return processing operate as independent configuration layers.

Architectural Rules

• Publishing scope does not impact return eligibility
• Return configuration does not alter product visibility
• Channel governance and reverse logistics must remain structurally separated

---

3. Core Configuration Logic

• Product publishing must explicitly define Shopify sources
• Multi-source merchants require structured visibility control
• Return integration selection determines return authority
• Loop operates as decision authority when configured
• Exchange generates new sales orders
• Publishing and return layers must be configured independently

---

4. Transaction-Level Behavior

4.1 When Product Is Published

• Product appears only in selected Shopify sources
• Other sources remain unaffected

---

4.2 When Return Is Initiated via Loop

• Loop determines the outcome
• Shopify reflects return status
• Xoro reflects resulting operational and financial state

---

4.3 When Exchange Is Selected

• A new sales order is created
• The original order remains preserved

---

5. Important Rules & Constraints

• Publishing scope must be defined before synchronization
• Return integration must be confirmed before configuration
• Exchange does not modify original orders
• Publishing and return systems operate independently
• Shopify reflects outcomes but does not determine return decisions when Loop is active

---

6. Best Practices

• Confirm Shopify source structure before enabling publishing
• Define publishing scope intentionally for multi-source merchants
• Identify return integration before setup
• Align operational expectations regarding exchange behavior
• Maintain clear separation between publishing configuration and return processing logic

---

7. Frequently Asked Questions (FAQs)

Q1: Can products be published to multiple Shopify sources? A: Yes. One or multiple sources can be selected during publishing configuration.

Q2: Which return integrations are supported? A: Loop, ReturnLogic, and AfterShip.

Q3: Where is the return decision made when using Loop? A: In Loop. Shopify reflects the result afterward.

Q4: Does an exchange modify the original order? A: No. It creates a new sales order.

Q5: Does publishing configuration affect return behavior? A: No. Publishing and return systems operate independently.

---

8. Conclusion

Proper governance of Shopify product publishing and return application positioning ensures:

• Structured multi-source visibility control
• Predictable return decision architecture
• Clear separation between channel configuration and reverse logistics

By maintaining this separation, organizations prevent channel conflicts, operational ambiguity, and structural misalignment across Shopify and XoroERP environments.