Transfer Orders

Transfer Orders allow you transfer stock from one warehouse to another, thereby greatly reducing the hassle of manually updating the stock levels.

End Points

POST

/transferorders

GET

/transferorders

GET

/transferorders/{transfer_order_id}

DELETE

/transferorders/{transfer_order_id}

POST

/transferorders/{transfer_order_id}/markastransferred

Attribute

transfer_order_id

long

Unique ID generated by the server for the Transfer Order. This is used as identifier.

transfer_order_number

string

The Transfer Order number. This is unique for each transfer order. This node is optional if auto number generation is enabled for transfer order.

date

string

The date for the Transfer Order.

from_warehouse_id

long

Unique ID generated by the server for the Warehouse.This is used a unique identifier.This is a source warehouse.

to_warehouse_id

long

Unique ID generated by the server for the Warehouse.This is used a unique identifier.This is a destination warehouse.

line_items

array

A transfer can contain multiple line items. Each line item contains item_id,name,description,quantity_transfer,unit.

Show Sub-Attributes

item_id

long

Unique ID generated by the server for the item. This is used as an identifier.

line_item_id

long

Unique ID generated by the server for each line item. This is used as an identifier.

name

string

Name of the line item.

description

string

Description of the line item.

quantity_transfer

double

Quantity of the line item to be transferred.

unit

string

Unit of line item.

is_intransit_order

boolean

It states whether the transfer order is in transit or transferred.The default value is false.

{
    "transfer_order_id": 4815000000044895,
    "transfer_order_number": "TO-00001",
    "date": "2018-03-23",
    "from_warehouse_id": 4815000000035003,
    "to_warehouse_id": 4815000000035003,
    "line_items": [
        {
            "item_id": 4815000000044100,
            "line_item_id": 4815000000044897,
            "name": "Laptop-white/15inch/dell",
            "description": "Just a sample description.",
            "quantity_transfer": 2,
            "unit": "qty"
        }
    ],
    "is_intransit_order": false
}

Create a transfer order

Creates a new transfer order in Zoho Inventory.
oauthscope : ZohoInventory.transferorders.CREATE

Arguments

transfer_order_number

string

(Required)

The Transfer Order number. This is unique for each transfer order. This node is optional if auto number generation is enabled for transfer order.

date

string

(Required)

The date for the Transfer Order.

from_warehouse_id

long

(Required)

Unique ID generated by the server for the Warehouse.This is used a unique identifier.This is a source warehouse.

to_warehouse_id

long

(Required)

Unique ID generated by the server for the Warehouse.This is used a unique identifier.This is a destination warehouse.

line_items

array

(Required)

A transfer can contain multiple line items. Each line item contains item_id,name,description,quantity_transfer,unit.

Show Sub-Attributes

item_id

long

(Required)

Unique ID generated by the server for the item. This is used as an identifier.

name

string

(Required)

Name of the line item.

description

string

Description of the line item.

quantity_transfer

double

(Required)

Quantity of the line item to be transferred.

unit

string

Unit of line item.

is_intransit_order

boolean

It states whether the transfer order is in transit or transferred.The default value is false.

Query Parameters

ignore_auto_number_generation

When auto number generation is enabled in transfer order, this node states whether the auto generated transfer order number should be used or not. The default value is false.

parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f",
    'content-type': "application/json"
    }

conn.request("POST", "/inventory/v1/transferorders?organization_id=10234695", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/transferorders?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "transfer_order_number": "TO-00001",
    "date": "2018-03-23",
    "from_warehouse_id": 4815000000035003,
    "to_warehouse_id": 4815000000035003,
    "line_items": [
        {
            "item_id": 4815000000044100,
            "name": "Laptop-white/15inch/dell",
            "description": "Just a sample description.",
            "quantity_transfer": 2,
            "unit": "qty"
        }
    ],
    "is_intransit_order": false
}

{
    "code": 0,
    "message": "Transfer Order added successfully.",
    "transfer_order": {
        "transfer_order_id": 4815000000044895,
        "transfer_order_number": "TO-00001",
        "date": "2018-03-23",
        "from_warehouse_id": 4815000000035003,
        "to_warehouse_id": 4815000000035003,
        "line_items": [
            {
                "item_id": 4815000000044100,
                "line_item_id": 4815000000044897,
                "name": "Laptop-white/15inch/dell",
                "description": "Just a sample description.",
                "quantity_transfer": 2,
                "unit": "qty"
            }
        ],
        "is_intransit_order": false
    }
}

List all the transfer orders

Lists all the transfer orders present in Zoho Inventory.
oauthscope : ZohoInventory.transferorders.READ

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695"
type: GET
headers: headers_data
content-type: application/octet-stream
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" }

conn.request("GET", "/inventory/v1/transferorders?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/transferorders?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/inventory/v1/transferorders?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

{
    "code": 0,
    "message": "success",
    "transfer_orders": [
        {
            "transfer_order_id": 4815000000044895,
            "transfer_order_number": "TO-00001",
            "date": "2018-03-23",
            "from_warehouse_id": 4815000000035003,
            "to_warehouse_id": 4815000000035003,
            "is_intransit_order": false
        },
        {...},
        {...}
    ]
}

Retrieve a transfer order

Fetches the details for an existing transfer order.
oauthscope : ZohoInventory.transferorders.READ

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695"
type: GET
headers: headers_data
content-type: application/octet-stream
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" }

conn.request("GET", "/inventory/v1/transferorders/4815000000044895?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/transferorders/4815000000044895?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

{
    "code": 0,
    "message": "success",
    "transfer_order": {
        "transfer_order_id": 4815000000044895,
        "transfer_order_number": "TO-00001",
        "date": "2018-03-23",
        "from_warehouse_id": 4815000000035003,
        "to_warehouse_id": 4815000000035003,
        "line_items": [
            {
                "item_id": 4815000000044100,
                "line_item_id": 4815000000044897,
                "name": "Laptop-white/15inch/dell",
                "description": "Just a sample description.",
                "quantity_transfer": 2,
                "unit": "qty"
            }
        ],
        "is_intransit_order": false
    },
    "warehouses": {...}
}

Delete a transfer order

Deletes an existing transfer order from Zoho Inventory.
oauthscope : ZohoInventory.transferorders.DELETE

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695"
type: DELETE
headers: headers_data
content-type: application/octet-stream
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" }

conn.request("DELETE", "/inventory/v1/transferorders/4815000000044895?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/transferorders/4815000000044895?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request DELETE \
  --url 'https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

{
    "code": 0,
    "message": "Transfer Order(s) has been deleted."
}

Mark as Received

Changes the status of a transfer order to Transferred.
oauthscope : ZohoInventory.transferorders.CREATE

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/octet-stream
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'
  }
};

fetch('https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" }

conn.request("POST", "/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/inventory/v1/transferorders/4815000000044895/markastransferred?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

{
    "code": 0,
    "message": "The status of the Transfer Order has been updated."
}