1. Overview
Omisell Developer Portal | API Documentation & Integration Guides
  • Authentication
  • Common Errors
  • Overview
    • Introduction
    • Push Mechanism
    • Status overview
    • Accounting - API Call Flow
    • ERP Integration Flow
    • API Rate Limits
    • Guide: Direct Integration
    • MCP Server
    • Pagination
  • Changelog
    • 🔐 API Security Upgrade
    • Orders
    • Returns Order
    • Products
    • Shipments
    • Push mechanism
  • API Refference
    • Location
      • Get Country List
      • Get Province List By Country
      • Get District List By Province
      • Get SubDistrict List By District
    • Product
      • Get Product Category
      • Get Product List
      • Add Product
      • Get Product Detail
      • Update Product Detail
      • Get Product Detail by SKU
      • Update Product Detail by SKU
    • Inventory
      • Adjust Stock
      • Delisted Stock
      • Adjust Stock(Old)
    • Serial Number
      • Adjust Serial Number
    • Catalogue
      • Get Catalogue List
      • Get Catalogue Detail
    • Orders
      • Get Order List
      • Add Order
      • Update Document Order
      • Get Order Detail
      • Update Order
      • Cancel Order
      • Get Order Finance
      • Get Returns Receiving Note
      • Get Goods Receipts
    • Returns Order
      • Get Returns Order List
      • Add Order Return
      • Get Return Order Detail
    • Shipments
      • Get Shipment List
      • Add Shipment
      • Update Document Shipment
      • Update Shipment Status
      • Get Shipment Detail
    • Order Dropship
    • Pickup Address
      • Get Pickup List
      • Get WMS Pickup Map
    • Shop
      • Get Shop List
    • Finance
      • Get Order Revenue
      • Get Order Return Revenue
    • Customer
      • Get Customer Review List
    • Public
      • Get Seller by Partner
  • Webhooks
    • Order Status Push
    • Return Order Status Push
    • Shipment Status Push
    • Sale Invoice Request
  • eCommerce Platform
    • PrestaShop
    • Magento
    • Shopify
    • Woocommerce
    • Zalora
  1. Overview

ERP Integration Flow

image.png

Order – ERP Integration Flow (Process Description)#

1. New Order → Order Approved (paid)#

When there is a New Order, the Omisell system will verify it and change the status to Order Approved, which means the order has been confirmed for processing — ⚠️ NOT that it has been paid. approve_order only requires the order to HAVE a payment record; it does not require the money to have been collected: a COD order with payment_status = 100 Unpaid can still be approved. Do not raise a "paid" Sales Order off this milestone.
ERP: Generate a Sales Order (SO).

2. Shipment Creation (Delivery Order)#

After the order is approved, Omisell will move the order status to Created Shipment.
ERP: Generate a Delivery Order (DO).

3. Cancellation Flow#

If the order is cancelled:
Omisell: order status changes to Order Cancelled.
ERP: execute Cancel SO.

4. Shipping & Invoicing#

When the order is shipped:
Omisell: status changes to Order Shipped.
ERP: perform Invoice Confirmation and generate an Invoice (IV).

5. Return Flow#

If the delivery fails → status changes to Order Returned (Fail Delivery).
If the customer returns the product → status changes to Order Returned (RMA).
In both cases:
ERP: generate a Return Order.

Conclusion:#

Implementing all of the above steps helps reduce inventory discrepancies between the ERP and WMS at any given time. However, certain discrepancies may still occur at specific points due to data synchronization issues between the two systems or exceptional cases such as damaged or lost goods.
We provide a Webhook system that allows you to receive order information or status changes in real time. For more details, please refer to Webhook.
Modified at 2026-11-03 04:22:18
Previous
Accounting - API Call Flow
Next
API Rate Limits
Built with