Quarantine Stock Increment/Decrement

This endpoint used for quarantine your product stock by increment or decrement.

Path

post

/fulfillment/partner/fs/:fs_id/quarantinestock/incrementdecrement

Request Parameters

Parameter	Type	Required	Location	Description
fs_id	Integer	Required	path	Fulfillment service id
shop_id	Integer	Required	query	Shop ID, owner of the product
warehouse_id	Integer	Required	query	Warehouse ID, where the increment decrement address to
request_id	string	Required	query	Request ID, unique ID generated by WMS for preventing duplicated request to the API
product_id	Integer	Required	body	Product ID (maximum 20 product_id per request)
stock_change	Integer	Required	body	Numbers of increment/decrement
use_case	Integer	Required	body	Type of use_case this changes applies to
reason	string	Optional	body	Quarantine reason
ref_num	string	Required	body	Ref_num for the event in WMS (for_ex: ASN code generated by WMS system). Purpose: during the reconciliation process, this ref_num is vital for identifying if there is not recorded transaction in tokopedia’s increment/decrement process
changes_timestamp	timestamp string	Required	body	Timestamp when the changes takes place Purpose: If partner’s retry mechanism takes place, tokopedia should be able to define if the changes should be applied or not (if tokopedia already has the auto adjust mechanism when discrepancy occurs)
wsn_id	Integer	Optional	body	WSN ID for decrement action
asn_id	Integer	Optional	body	ASN ID, for increment only

Example Request

curl -X POST \
  'https://fs.tokopedia.net/fulfillment/partner/fs/:fs_id/quarantinestock/incrementdecrement?
  shop_id=:shop_id&warehouse_id=1&request_id=12345-6789-123' \
   -H 'Authorization: Bearer C-UMqWWXRqaJugr7w5U0zQ' \
   -H 'Content-Type: application/json' \
   -d '[
          {
            "product_id": 446082276,
            "stock_change": 10,
            "use_case": 200,
            "ref_num": "ASNBBW/20200615/JAKARTA/12345678"
            "reason": "Product damaged"
          }
    ]'

Response Parameters

Success Response Examples

{
    "header": {
        "process_time": 1950.2109079999998,
        "messages": "Your request has been processed successfully"
    },
    "data": {
        "failed_rows": 1,
        "failed_rows_data": [{
            "product_id": 446082276,
            "warehouse_id": 1,
            "use_case": 200,
            "ref_num": "ASNBBW/20200615/JAKARTA/12345678",
            "reason": "SYSTEM_ERROR"
        }],
        "succeed_rows": 0
    }
}

Error Response Examples

{
    "header": {
        "process_time": 102.105345,
        "messages": "We had a problem with our server. Try again later.",
        "reason": "",
        "error_code": 0
    },
    "data": null
}

Error Codes

Notes

Maximum JSON body length is 20

Action

Action Name	Code
Increment	1
Decrement	2

Use Case

Use Case Name	Code
Inbound	200
Re-Inbound	210
Inbound Without Activating Product	215
Increment Bundling Adjustment	225
Other Inbound	230
Withdrawal	300
Damaged	310
Inventory Loss	320
After sales	330
Other Outbound	340
Order Bundling	350
Decrement Bundling Adjustment	355
Expired Product	360