Content Comparison

What is a partner and partner location code for Assure?

Partners can either be of the type Supplier or of the type Customer.. Assure support multiple locations of suppliers and customers, hence all partners have at least one Partner Location.

Why is partner / partner location code required for Assure?What is the significance of Partners and Partner Locations in Assure

Partners and their locations are used to identify the sources and destination of inward as well as outward orders. 

Partner and Partner Location information is also used within generated internal invoices. 

What happens on duplicate create requests for Customers and Vendors (Partners)?

Duplicate calls to create Customers and Vendors (Partners) are idempotent. No changes will be made to the existing Customers or Vendors and a 200-OK response will be sent by the API 

Is Partner Location creation mandatory and what to do if we don't have partner location code?

If you don't have PartnerLocation codes at your end then two approaches can be followed:

1. Use a single, constant Location Code for all the Vendors

2. Set the Location Code same as the Vendor code

What are the meanings of address(partner), billing(partnerLocation) and shipping address(partnerLocation) of partner and partner locations?

The Partner’s Address represents the geographic location of a Partner’s headquarters

The Partner’s Location has two aspects - the billing address and the shipping address. The address that the Partner desires to use for billing and shipping purposes must be specified in the Partner’s billing and shipping address data. These three addresses might or might not be the same

What are the unique fields (primary key) in partner and partner location creation?

For Partner, the name and partnerType values must be unique across all partners. For Partner Location, no unique constraints exist.

What if GSTIN is not available for partner location creation?

The GSTIN field is a mandatory field. A value must be provided for this field

What happens on duplicate Create requests with the same master data and sku attribute? (Applicable to all type of masters, SKU Attributes)

The calls made for creation of product masters are idempotent meaning that if duplicate requests are sent, no change will be made. Therefore, if the product master data was successfully saved after the first call, subsequent duplicate calls will have no impact on the data. Each duplicate call will result in a 200-OK response. 

What happens on duplicate Requests with the same master data and different sku attribute? (Applicable to all type of masters,SKU Attributes)

If different attribute data is passed for a specific product master using the create-article-master API endpoint, the SKU attributes will not be updated to the latest passed value. 

However, when using the add-or-update-SKU-attributes API endpoint, the SKU Attribute Data from the latest successful call will be saved for the specified product master, i.e. the SKU attributes will be updated. 

What if ERP is not able to send Tax code?

Assure is a WMS module, hence Clients should never rely on Assure to compute accurate taxation. This is ERP’s responsibility. So in case ERP is not able to send correct tax code for each sku, it can use a default value GIVEN that in such case Assure tax computation will never be used.  

What if ERP is capable of sending the tax breakup ? 

During packing, the Assure system can fetch the tax breakup from Order Source.

What if ERP is not able to send the Image URL?

• The image URL is not a mandatory field and it may be left blank. 

• If the image URL is absent or incorrect, the image of the product won’t be displayed on WMS screens. This will affect picking, packing and all QC related operations.

• Image URLS can also be updated using the product data updation API or from Assure UI.

Note: The image URL must be a string under 255 characters

How to update an existing SKU master?

The SKU Masters can be updated using the updateArticleMaster endpoint (assuming that the listing for that product is present). OR Product master can also be updated from Assure OMS UI. 

Can ERP create marketplace listing/mapping using AssureMagic2?

No, this feature is not available at the moment.

Create Outward Order

What is the difference between Order with and without Partner Codes?

All B2B orders along with vendor/customer codes are placed through Order with Partner Code API, whereas all the B2C orders are placed through Order without Partner Codes API. 

What are the unique fields(Primary Keys) for order creation?Check OMS, CIMS

Location code and same channel order Id are unique for one set of external credentials ( indicating the Marketplace / ERP). 

What is the difference between OrderItem Code and ChannelSKU Code?

Channel SKU Code is the unique identifier for an SKU the Marketplace / ERP whereas, OrderItem Code is the unique identifier for an order line item.

Note: Two order line items can have the same ChannelSKU Code, but no two line items can have the same Order Item Code.

Can we pass EAN in the channelSkuCode/orderItemCode field when creating order?

EAN can be passed in the ChannelSKU code field during order creation if and only if both are the same, and were mapped as the same during the Article Master Creation process in Assure.

EAN can be passed  as the Order Item Code during order creation if and only if there is only one order line item (with ‘n’ quantity)  of the same EAN in the order. This will ensure no two order line items have the same Order Item Code.

What are the fields we can update for existing orders?

Channel Order Status, Required By Time, Start Processing Time and On Hold(updating to false only) property of an existing outward order can be updated.

Can we cancel/update an existing Inward order?

Cancellation / Updation of an Inward order once placed is not allowed.

What if the same call for order cancellation / creation / update order properties is made twice to AssureMagic2?

Success will be returned with no action performed in ASSURE.

What if a different request with duplicate channelOrderIds is made?

Success will be returned as Order with the same channel Order Id would have been already existing in ASSURE and duplicate order will not be created in ASSURE.

Can line Items be appended once the order is created in the system?

No.

What is the purpose of on-hold and Start Processing Time fields of an order in ASSURE?

An order with on hold value as true will be created in ASSURE but will not be moved to ASSURE WMS for processing. 

An order will be moved to ASSURE WMS for processing once the real time exceeds or equals the Start Processing Time of the order and order is not on hold.

Can we set the value of on-hold as TRUE after the order is placed?

 No.

What does Order with QC status : Fail mean?

Order with QC status Fail indicates that only the inventory marked as QC Fail in ASSURE will be allocated to the order. Generally QC fail orders are used for liquidation of QC fail inventory from the warehouse. All marketplace outward orders are QC pass only.

What if Marketplace doesn't support Seller Cancellation?

Upon doing seller cancellations from OMS UI, an error will be thrown indicating the channel does not support seller cancellation. 

What enums are applicable for inward / outward orders during order creation ? 

How B2B return, RTV , STO is created and which APIs and Enums to use?

Refer to the above table.

Why is the order Ack call not instantaneous?

While sending an order, a 200 OK response means that we have received the order. So it is already instantaneous in that sense.

An ACK call back to you means we can process it. For this our system has to allocate inventory. Since we are designed for multi-channel order processing, we have to put orders in a queue and allocate inventory to them in FIFO order. This would obviously mean that it cannot be instantaneous"

Push Customer Cancellation

What fields Assure considers for partial customer cancellation?

Assure cancels the order line Item based on the Order Item Code. The cancelled quantity is  passed in the order cancellation request to ASSURE against the Order Item Code. 

ASSURE cancels the entire order if the cancelled quantity for all line items equal the ordered quantity.

Order Posting from Assure 

What are the meanings of address(partner), billing(partnerLocation) and shipping address(partnerLocation) of partner and partner locations in B2B2C channels (Ajio/CT/Firstcry) in order posting from Assure?

?

What are the triggers for order posting from Assure?

Order posting is triggered on the following events:

• Order completion(When order is marked as handover) 

• Cancellation of order.

• Creation of order(This will have both fulfillable and unfulfillable orders)