Using the API for a POS/ERP
When you integrate your system as POS/ERP, you establish a direct connection with the Neomode platform to:
Below, we explain step-by-step how each integration stage works.
- Publish and keep the product catalog updated (categories, products, and SKUs).
- Send price and stock updates asynchronously.
- Manage orders received from connected channels — from retrieval to invoicing and tracking.
📦Catalog Integration Flow
Catalog updates must be submitted in batches and will be processed asynchronously.
1. Register the category tree
The category structure is hierarchical and should be created level by level.
- With a valid token – Authenticate
- Send the first level of the category tree asynchronously – PUT Upsert Batch Categories
- Retrieve the ID of the created category searching by your
code
– GET Category - Send the second level, using the
parentId
of the upper-level category asynchronously – PUT Upsert Batch Categories
Send Top-Level Categories

Send Other Level Categories

🔗 More details about category hierarchy
2. Send Products and SKUs
The submission should be done in batch with the complete set (product and SKUs).
- Whit a valid token – Authenticate
- Send products and SKUs asynchronously – PUT Upsert Batch Products

🔗 More details about Product and SKU Catalog
3. Send Price Updates
Price updates must be sent in batches and are processed asynchronously.
- Whit a valid token – Authenticate
- Send prices asynchronously – PUT Upsert Batch Prices
It is important to set the Match Codes via query parameters for data persistence to occur successfully.
Stocks Batch query parameter options:
- ProcuctMatchCode:
code
,auxCode
,referenceCode
,id
- SellerMatchCode:
cnpj
,pointsaleid
,id

4. Send Stock Updates
Stock updates must be sent in batches and are processed asynchronously.
- Whit a valid token – Authenticate
- Send stocks asynchronously – PUT Upsert Batch Stocks
It is important to set the Match Codes via query parameters for data persistence to occur successfully.
Stocks Batch query parameter options:
- SkuMatchCode:
code
,auxCode
,barcode
- SellerMatchCode:
cnpj
,pointsaleid
,id

🏪Order Integration Flow
1. Search for New Orders
Fetch orders placed on connected channels, including customer, product, payment, and delivery information. Notify the channel that the order has been received and is being processed.
- Whit a valid token – Authenticate
- Fetch orders with status
2
(PendingCreate) by store and date range – GET Orders By Seller
The ERP must query orders by store (defined in the path parameter) at intervals defined by query parameters.
Paid vs. Unpaid Orders:
By default, status
2
(PendingCreate) represents paid orders.You can configure the system to display newly created unpaid orders. Contact our team.
2. Confirm Order Picking
- Whit a valid token – Authenticate
- Insert the ERP order identifier as
sellerOrderId
– PUT SellerOrderId - Send status
4
(ApprovedExternal) – PUT Status by SellerOrderId

3. Insert Invoice Data
Submit electronic invoice (NF-e) details.
- Whit a valid token – Authenticate
- Submit invoice data using
order.id
– [PUT Order Invoice by Guid Id](put-order-invoice-by-guidid os dados da nota fiscal através do Código UUID do pedido:)
You can either send the hosted document URL or the full document encoded in Base64.
4. Insert Delivery Information
Update the delivery status and send the tracking code and carrier information.
- Whit a valid token – Authenticate
- Submit delivery data using
order.id
– PUT Tracking By Id
5. Finalize Order
- Whit a valid token – Authenticate
- Send status
9
(Finalized) – PUT Status by SellerOrderId