Overview
This page consists of all the details required to migrate from v0 OMS APIs to v1 OMS APIs which external systems can use to interact with Increff OMS system
API Endpoint Details
Below mentioned is the mapping of v0 Increff OMS APIs and v1 Increff OMS APIs. Please make note of these endpoints and the updated API details which needs to be changed in External systems to interact with Increff OMS system.
To check the new API details , please route through the hyperlinks in API Name header.
API Name | Old API endpoint (v0) | New API Endpoint (v1) |
|---|---|---|
POST /push/skuListing | POST | /usp/listing/create | |
PUT |/sellfast/inventories/absolute-update PUT | /inventories/incremental-update | PUT | /usp/inventories/absolute | |
NA | POST | {Client’s URL} | |
Seller Cancellation from External Fulfillment System (EFS) API | PUT /sellfast/order/cancel-line-items | PUT | /usp/order/cancel |
POST /sellfast/picklist/release | POST | /usp/picklist/create | |
POST /sellfast/picklist/add-orders/id | POST | /usp/picklist/add-order | |
POST /sellfast/pack/combined/{orderId} | POST | /usp/order/pack | |
NA | POST | /usp/ manifest | |
POST /sellfast/handover | POST | /usp/ handover | |
NA | POST | {Client’s URL} | |
NA | POST | /usp/return |
Steps of Migration
Updation of Endpoints & BaseUrl
External system should update the API endpoints in their system which are mentioned above.
BaseUrl of Increff OMS system will be shared by Increff Customer success team during the onboarding process to new Increff OMS APIs.
Updation of Authentication Credentials
External system should update the API authentication credentials which are used to communicate with Increff OMS system.
Credentials should be sent in headers while making the API request as stated in the example below.
authUsername:Increff.user authPassword:Increff@user1
The credentials of the production environment will be shared by Increff Customer success team during the onboarding process to new Increff OMS APIs.
Creation of Listings for new Channel
New channels in Increff system (CIMS module) will be created
EFS needs to create the listings for all the channels
Resyncing of Inventory
Since the new API endpoints and channels are now configured, EFS system needs to send the inventory updates again to Increff system so that resyncing of Inventory can happen without any inventory discrepancies between all systems (EFS, Increff , Marketplaces).
Note: Only Absolute inventory updates are accepted by Increff system
Handling of Open Orders before migration
All the open orders which are pending to be processed by EFS should be marked as
CompletedorCancelledin Increff OMS.All the orders with open Picklists should be processed or picklists should be cancelled from Increff USP user interface.
Once all open orders are closed, the EFS system can create picklists for new orders which will be created against new channels in Increff OMS.
Note: The return orders which will be created for the Forward orders processed against old channels will not flow to EFS
Configuring Order Posting Notifications
Below order notifications will be enabled with help of Increff Customer Success team once the Forward and Return orders will be started getting created against new channels from Marketplaces in Increff OMS.
Outward Order Creation Events to EFS
Push Return Order Expectations to EFS
API callback URLs of EFS will be required to be configured in Increff system to push the above-mentioned notifications
Testing Process
Post the configuration of above-mentioned steps in the External system, testing can be done using Increff Simulator environment (ASIM) by configuring the necessary details.
Old API endpoints are backward compatible untill the testing and onboarding to new OMS APIs will not be completed