You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 20
Next »
POST warehouse_transactions/stock_in
This method is creating a new stock in warehouse transaction
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
warehouse_identifier (mandatory) | Warehouse identifier | The warehouse in which the items will be added into. The allowed warehouse identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the warehouse | name (semi-optional) | String | The name of the warehouse | alternative_code (semi-optional) | String | The alternative code of the warehouse |
|
life_cycle_state (mandatory) | String | The stated of the transaction which can be DRAFT or POSTED |
batch_number (optional) | String | A reference number which is entered to keep track of the warehouse transaction source |
supplier_identifier (optional) | Contact information identifier | The supplier of the items to be added. Suppliers refer to contact information. The allowed contact information identifier fields are the following:Name | Type | Description |
---|
id (semi-optional) | String | The ID of the contact information | id_number (semi-optional) | String | The ID number of the contact information Applicable only for contact information that represent PERSON | passport_number (semi-optional) | String | The passport number of the contact information Applicable only for contact information that represent PERSON | social_security_number (semi-optional) | String | The social security number of the contact information Applicable only for contact information that represent PERSON | vat_registration_number (semi-optional) | String | The VAT registration number of the contact information Applicable only for contact information that represent COMPANY | registration_number (semi-optional) | String | The registration number of the contact information Applicable only for contact information that represent COMPANY |
|
description (optional) | String | A description for the warehouse transaction to be created |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_float_5 (optional) | Float | User Defined Field of type Float |
udf_float_6 (optional) | Float | User Defined Field of type Float |
udf_float_7 (optional) | Float | User Defined Field of type Float |
udf_float_8 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
items_set | A set of stock in items objects | The items that should be added in the warehouse through this stock in transaction. |
Referred Parameter Objects
stock_in_item parameter object data
| | |
---|
installed_item_identifier
(semi-optional) | String | An existing installed item that should be added in the warehouse. The allowed installed item identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the installed item | serial_number (semi-optional) | String | The serial number of the installed item | alternative_code (semi-optional) | String | The alternative code of a installed item |
|
product_identifier
(semi-optional) | String | A non traceable physical good that should be added in the warehouse. The allowed physical good product identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the product | code (semi-optional) | String | The code of the product | alternative_code (semi-optional) | String | The alternative code of the product |
|
quantity
(mandatory on conditions) | Number | The quantity of the non traceable physical goods that should be added in the warehouse.. This is available and mandatory only if a non traceable physical good is specified in the product_identifier parameter
|
unit_cost | Number | The unit cost of the item to be added |
installed_item (semi-optional) | Installed item object | A new installed item that should be created and added in the warehouse. |
Referred Parameter Objects
installed_item parameter object data
Name | Type | Description |
serial_number (mandatory) | String | The serial number of the installed item to be created |
alternative_code (mandatory) | String | The alternative code of the installed item to be created |
product_identifier (mandatory) | Products identifier | The product that will be related with the installed item. The allowed product identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the product | code (semi-optional) | String | The code of the product | alternative_code (semi-optional) | String | The alternative code of the product |
|
category_identifier (optional) | Installed item category identifier | The installed item category that will be related with the installed item. The allowed installed item category identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the installed item category | name (semi-optional) | String | The name of the installed item category | code (semi-optional) | String | The code of the installed item category |
|
state (mandatory) | String | The state of the installed item to be created, which can be EFFECTIVE or NOT_EFFECTIVE |
notes (optional) | String | Notes for the installed item to be created |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
components_set (mandatory and applicable on conditions) | Set of Installed Item Components | The components that should be added on the installed item that will be created. This information is applicable and mandatory if the installed item that will be created has a product type classified as fixed product bundle |
Referred Parameter Objects
installed_item_component parameter object data
Name | Type | Description |
serial_number (mandatory) | String | The serial number of the installed item to be created |
alternative_code (mandatory) | String | The alternative code of the installed item to be created |
product_identifier (mandatory) | Products identifier | The product that will be related with the installed item. The allowed product identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the product | code (semi-optional) | String | The code of the product | alternative_code (semi-optional) | String | The alternative code of the product |
|
category_identifier (optional) | Installed item category identifier | The installed item category that will be related with the installed item. The allowed installed item category identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the installed item category | name (semi-optional) | String | The name of the installed item category | code (semi-optional) | String | The code of the installed item category |
|
state (mandatory) | String | The state of the installed item to be created, which can be EFFECTIVE or NOT_EFFECTIVE |
notes (optional) | String | Notes for the installed item to be created |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
id | String | The ID of the stock in warehouse transaction that was created |
number | String | The number of the stock in warehouse transaction that was created |
batch_number | String | The batch_number of the stock in warehouse transaction that was created |
life_cycle_state | String | The stated of the transaction which can be DRAFT or POSTED |
Examples
Example 1
HTTP Method: POST
Request:
Body:
{
"token":"47995B93A94E35C992956091325A3D92",
"warehouse_identifier":{"name":"Central Warehouse"},
"life_cycle_state":"DRAFT",
"supplier_identifier":{"id_number":"984783"},
"description":"Stock in transaction of a broken TV to the Central Warehouse",
"items_set":
[
{
"installed_item_identifier":{"serial_number":"T1M001000000001"},
"alternative_code":"T1M001000000001",
"unit_cost":80
},
{
"product_identifier":{"code":"Universal Remote Controls"},
"quantity":50
}
]
}
Response:
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"life_cycle_state": "DRAFT",
"number": "336",
"id": "C8D9AECE85C160AEB18B6FE0148A12FF",
"batch_number": null
}
}
POST warehouse_transactions/stock_out
This method is creating a new stock out warehouse transaction
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
warehouse_identifier (mandatory) | Warehouse identifier | The warehouse from which the items will be removed from. The allowed warehouse identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the warehouse | name (semi-optional) | String | The name of the warehouse | alternative_code (semi-optional) | String | The alternative code of the warehouse |
|
life_cycle_state (mandatory) | String | The stated of the transaction which can be DRAFT or POSTED |
batch_number (optional) | String | A reference number which is entered to keep track of the warehouse transaction source |
description (optional) | String | A description for the warehouse transaction to be created |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_float_5 (optional) | Float | User Defined Field of type Float |
udf_float_6 (optional) | Float | User Defined Field of type Float |
udf_float_7 (optional) | Float | User Defined Field of type Float |
udf_float_8 (optional) | Float | User Defined Field of type Float |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
items_set | A set of stock out items objects | The items that should be removed from the warehouse through this stock out transaction. |
Referred Parameter Objects
stock_out_item parameter object data
| | |
---|
installed_item_identifier
(semi-optional) | String | An existing installed item that should be moved from the warehouse.The allowed installed item identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the installed item | serial_number (semi-optional) | String | The serial number of the installed item | alternative_code (semi-optional) | String | The alternative code of a installed item |
|
product_identifier
(semi-optional) | String | A non traceable physical good that should be moved from the warehouse. The allowed physical good product identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the product | code (semi-optional) | String | The code of the product | alternative_code (semi-optional) | String | The alternative code of the product |
|
warehouse_transaction_batch_number (semi-optional) | String | The batch number related to one or more warehouse transactions. All of the transactions' physical goods (traceable or non-traceable) they will be retrieved and included in the stock out transaction, if they still exist in the from warehouse (for traceable physical goods) or enough quantity exists (for non traceable physical goods). |
quantity
(mandatory on conditions) | Number | The quantity of the non traceable physical goods that should be moved from the warehouse. This is available and mandatory only if a non traceable physical good is specified in the product_identifier parameter
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
id | String | The ID of the stock out warehouse transaction that was created |
number | String | The number of the stock out warehouse transaction that was created |
batch_number | String | The batch_number of the stock out warehouse transaction that was created |
life_cycle_state | String | The stated of the transaction which can be DRAFT or POSTED |
Examples
Example 1
HTTP Method: POST
Request:
Body:
{
"token":"9A30B8EAB0A28E012329162912CC0736",
"warehouse_identifier":{"name":"Central Warehouse"},
"life_cycle_state":"DRAFT",
"supplier_identifier":{"id_number":"984783"},
"description":"Stock out transaction of a broken TV from Central Warehouse",
"items_set":
[
{
"installed_item_identifier":{"serial_number":"T1M001000000001"},
"alternative_code":"T1M001000000001",
"unit_cost":80
},
{
"product_identifier":{"code":"Universal Remote Controls"},
"quantity":50
}
]
}
Response:
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"life_cycle_state": "POSTED",
"number": "291",
"id": "BDDB284AD8E12E9753D838C126F33D70",
"batch_number": "bn00090221"
}
}
POST warehouse_transactions/stock_movement
This method is creating a new stock movement warehouse transaction
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
from_warehouse_identifier (mandatory) | Warehouse identifier | The warehouse from which the items will be removed from. The allowed warehouse identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the warehouse | name (semi-optional) | String | The name of the warehouse | alternative_code (semi-optional) | String | The alternative code of the warehouse |
|
to_warehouse_identifier (mandatory) | Warehouse identifier | The warehouse in which the items will be added into. The allowed warehouse identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the warehouse | name (semi-optional) | String | The name of the warehouse | alternative_code (semi-optional) | String | The alternative code of the warehouse |
|
life_cycle_state (mandatory) | String | The stated of the transaction which can be DRAFT or POSTED |
batch_number (optional) | String | A reference number which is entered to keep track of the warehouse transaction source |
description (optional) | String | A description for the warehouse transaction to be created |
udf_string_1 (optional) | String | User Defined Field of type String |
udf_string_2 (optional) | String | User Defined Field of type String |
udf_string_3 (optional) | String | User Defined Field of type String |
udf_string_4 (optional) | String | User Defined Field of type String |
udf_float_5 (optional) | Float | User Defined Field of type Float |
udf_float_6 (optional) | Float | User Defined Field of type Float |
udf_float_7 (optional) | Float | User Defined Field of type Float |
udf_float_8 (optional) | Float | User Defined Field of type Float |
udf_float_1 (optional) | Float | User Defined Field of type Float |
udf_float_2 (optional) | Float | User Defined Field of type Float |
udf_float_3 (optional) | Float | User Defined Field of type Float |
udf_float_4 (optional) | Float | User Defined Field of type Float |
udf_date_1 (optional) | Date | User Defined Field of type Date |
udf_date_2 (optional) | Date | User Defined Field of type Date |
udf_date_3 (optional) | Date | User Defined Field of type Date |
udf_date_4 (optional) | Date | User Defined Field of type Date |
items_set | A set of stock movement items objects | The items that should be moved from one warehouse to another through this stock movement transaction. |
Referred Parameter Objects
stock_movement_item parameter object data
| | |
---|
installed_item_identifier
(mandatory) | String | An existing installed item that should be moved from one warehouse to the other. The allowed installed item identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the installed item | serial_number (semi-optional) | String | The serial number of the installed item | alternative_code (semi-optional) | String | The alternative code of a installed item |
|
product_identifier
(semi-optional) | String | A non traceable physical good that should be moved from one warehouse to the other. The allowed physical good product identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the product | code (semi-optional) | String | The code of the product | alternative_code (semi-optional) | String | The alternative code of the product |
|
warehouse_transaction_batch_number (semi-optional) | String | The batch number related to one or more warehouse transactions. All of the transactions' physical goods (traceable or non-traceable) they will be retrieved and included in the stock movement transaction, if they still exist in the from warehouse (for traceable physical goods) or enough quantity exists (for non traceable physical goods). |
quantity
(mandatory on conditions) | Number | The quantity of the non traceable physical goods that should be moved from one warehouse to the other. This is available and mandatory only if a non traceable physical good is specified in the product_identifier parameter
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
id | String | The ID of the stock movement warehouse transaction that was created |
number | String | The number of the stock movement warehouse transaction that was created |
batch_number | String | The batch_number of the stock movement warehouse transaction that was created |
life_cycle_state | String | The stated of the transaction which can be DRAFT or POSTED |
Examples
Example 1
HTTP Method: POST
Request:
Body:
{
"token":"17C740BDB131F9709BD8BD605DCC0373",
"from_warehouse_identifier":{"name":"Installation Group-WHS New Items"},
"to_warehouse_identifier":{"name":"Sales Branch 1 - WHS New Items"},
"life_cycle_state":"POSTED",
"items_set":
[
{
"installed_item_identifier": { "serial_number":"cv2000000001" }
}
]
}
Response:
{
"status": {
"message": null,
"description": null,
"code": "OK"
},
"data": {
"life_cycle_state": "POSTED",
"number": "341",
"id": "0315BF181670C8A00E014058D12FC0C0",
"batch_number": "BNSTOCKOUT009"
}
}
POST warehouse_transactions/post
This method is posting a warehouse transaction which is in a draft state
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
warehouse_transaction_identifier | Warehouse transaction identifier | The warehouse transaction that should be posted. Only warehouse transactions is draft state can be specified. The allowed warehouse transaction identifier fields are the following: Name | Type | Description |
---|
id (semi-optional) | String | The ID of the warehouse transaction | number (semi-optional) | String | The number of the warehouse transaction |
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
id | String | The ID of the stock movement warehouse transaction that was created |
number | String | The number of the stock movement warehouse transaction that was created |
batch_number | String | The batch_number of the stock movement warehouse transaction that was created |
life_cycle_state | String | The stated of the transaction which can be DRAFT or POSTED |
Examples
Example 1
HTTP Method: POST
Request:
Body:
{
"token":"363D92A1BAA5BF4EABECD87CDB691EA0",
"warehouse_transaction_identifier":{"batch_number":"bn010009090"}
}
Response:
{
"status":
{
"message": null,
"description": null,
"code": "OK"
},
"data":
{
"life_cycle_state": "POSTED",
"number": "290",
"id": "F8A4A7B509DCFBE4AE969EF23C91602C",
"batch_number": "bn010009090"
}
}