Helpcenter +918010117117 //cdn1.storehippo.com/s/573db3149f0d58741f0cc63b/ms.settings/5256837ccc4abf1d39000001/57614ef64256dc6851749879-480x480.png" support@storehippo.com https://www.facebook.com/StoreHippohttps://twitter.com/StoreHippohttps://www.linkedin.com/company/hippoinnovations/https://plus.google.com/+Storehippo/posts
B4,309-10 Spaze iTech Park, Sector 49, Sohna Road, 122001 Gurgaon India

Introduction

Overview How to call Authentication Request Response Pagination Filtering Sorting

API Reference

Returns

(ms.returns)

Returns allow the user to return an order if the order is delivered.

Fields
EndPoints

Fields

ValueDescription
order_id   
Type: string
Required
This field stores the id of the order.
OID-123
return_type   
Type: string
Required
This field stores the type of the return. The value of this field can be Full and Partial.
full
items   
Type: array
Required
Array of objects containing the details of items at the time of return.
{ 
  "items": [
  {
 	"_id": "59d605da64abe444540ee6e0",
    "name": "mustard sweater",
 	"quantity": 1,
    "weight": 500,
  }
 ]
}
_id
Type: string
It contains the product id.
name
Type: string
It contains the name of the product.
sku
Type: string
It contains the SKU of the product.
quantity
Type: integer
Required
It contains the quantity of the product.
weight
Type: string
It contains the weight of the product.
price
Type: string
It contains the the price of the product.
total
Type: integer
item_condition   
Type: string
Required
This field stores the condition of the items. The value of item condition can be Unopened, Opened, Damaged.
unopened
return_reason   
Type: string
Required
This field stores the reason for the return.
Does not fit.
shipping_status   
Type: string
The field stores the shipping status of the order.
Delivered
tracking_number   
Type: string
tracking_company   
Type: string
user_id   
Type: string
It stores the id of the user of the order.
5b83a011cb2b6406c6273a9a
user_email   
Type: string
It stores the email id of the user of the order.
rma_number   
Type: string
It stores the RMA number for the return order.
RMA2
refunded_amount   
Type: string
status   
Type: string
It stores the status of the returned order.
user_id   
Type: string
It stores the id of the user of the order.
5b83a011cb2b6406c6273a9a
financial_status   
Type: string
customer_email   
Type: string
transaction_id   
Type: string
customer_shipping_address   
Type: object
full_name
Type: string
address
Type: string
city
Type: string
country
Type: string
state
Type: string
phone
Type: string
customer_billing_address   
Type: object
full_name
Type: string
address
Type: string
city
Type: string
country
Type: string
state
Type: string
phone
Type: string
seller_name   
Type: string
seller_email   
Type: string
seller   
Type: string
It stores the id of the seller of the product.
5a834e9606302b3934dac143

Commands (Endpoints)

POST /api/1.1/entity/ms.returns   
This command is used to add returns order.

Examples

Return type is full and item condition is unopened

Request
{
  "data": {
     "item_condition": "unopened",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 2}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "full"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}

Return type is full and item condition is opened

Request
{
  "data": {
     "item_condition": "opened",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 2}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "full"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}

Return type is full and item condition is damaged

Request
{
  "data": {
     "item_condition": "damaged",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 2}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "full"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}

Return type is partial and item condition is unopened

Request
{
  "data": {
     "item_condition": "unopened",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 1}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "partial"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}

Return type is partial and item condition is opened

Request
{
  "data": {
     "item_condition": "opened",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 1}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "partial"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}

Return type is partial and item condition is damaged

Request
{
  "data": {
     "item_condition": "damaged",
     "items": [{"_id": "5c6597b151f0fc16d9866e23", "quantity": 1}],
     "order_id": "5c6507b124f0fc15d8366e28",
     "return_reason": "Any reason",
     "return_type": "partial"
  }
}
Response
{
  data: {
    _id: '5c6507b154f0fc16d8866e23'
  }
}
GET /api/1.1/entity/ms.returns/_/authorized   
This command is used to authorized the added returns order.

Examples

authorized

Request
{
  "data": {
    "_id": "5c6506b154f0fc16d8866e28"
  }
}
Response
{
  data: 'Successfully Authorized!'
}
DEL /api/1.1/entity/ms.returns/{resource_id}   
Deletes a return
PUT /api/1.1/entity/ms.returns/{resource_id}   
Updates an existing return
GET /api/1.1/entity/ms.returns/{resource_id}   
Retrieves a single return
GET /api/1.1/entity/ms.returns   
Retrieves a list of returns
GET /api/1.1/entity/ms.returns/_/markAsReceived   
This API takes return id, used to mark as received returns order after authorized. This is the final stage of returns order.

Examples

markAsReceived

Request
{
  "data": {
    "order_delivered": "1",
    "shipping_status": "Delivered"
  }
}
Response
{
  data: 'updated successfully'
}