Skip to end of banner
Go to start of banner

warehouse_transactions

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 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)

StringA reference number which is entered to keep track of the warehouse transaction source

supplier_identifier

(optional)

Contact information identifierThe 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

Available from CRM.COM R14.0.0

description

(optional)

StringA 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_setA set of stock in items objectsThe items that should be added in the warehouse through this stock in transaction.

Referred Parameter Objects

 stock_in_item parameter object data

Name

Type

Description

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)

 

 

NumberThe 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_costNumberThe unit cost of the item to be added

installed_item

(semi-optional)

Installed item objectA 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)

StringThe alternative code of the installed item to be created

product_identifier

(mandatory)

Products identifierThe 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 identifierThe installed item category that will be related with the installed item. The allowed installed item category identifier fields are the following:

Deprecated from R18.0.0

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)

StringThe state of the installed item to be created, which can be EFFECTIVE or NOT_EFFECTIVE

notes

(optional)

StringNotes 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)

StringThe alternative code of the installed item to be created

product_identifier

(mandatory)

Products identifierThe 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 identifierThe installed item category that will be related with the installed item. The allowed installed item category identifier fields are the following:

Deprecated from R18.0.0

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)

StringThe state of the installed item to be created, which can be EFFECTIVE or NOT_EFFECTIVE

notes

(optional)

StringNotes 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

idString

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

StringThe 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
        },
        {
            "installed_item":
                {
                    "serial_number":"MODEM0019",
                    "product_identifier":{"code":"Modem"},
            "alternative_code":"MODEM0019"
                },
            "unit_cost":50
        },
        {
            "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)

StringA reference number which is entered to keep track of the warehouse transaction source

description

(optional)

StringA 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_setA set of stock out items objectsThe items that should be removed from the warehouse through this stock out transaction.

Referred Parameter Objects

 stock_out_item parameter object data

Name

Type

Description

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).

Available from R14.2.0

quantity

(mandatory on conditions)

 

 

NumberThe 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

idString

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

StringThe 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":"POSTED",
    "batch_number":"BN89102911",
    "items_set":
    [
         {
            "installed_item_identifier": { "serial_number":"MOD0091" }
        },{
            "product_identifier":{"code":"Universal Remote Controls"},
            "quantity":57
        }
    ]   
}


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)

StringA reference number which is entered to keep track of the warehouse transaction source

description

(optional)

StringA 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_setA set of stock movement items objectsThe items that should be moved from one warehouse to another through this stock movement transaction.

Referred Parameter Objects

 stock_movement_item parameter object data

Name

Type

Description

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).

Available from R14.2.0

quantity

(mandatory on conditions)

 

 

NumberThe 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

idString

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

StringThe 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":"6FC91FE36F81476D70D0A335094DCFBF",
    "from_warehouse_identifier":{"name":"Central Warehouse"},
    "to_warehouse_identifier":{"name":"Main Warehouse"},
    "life_cycle_state":"POSTED",
    "batch_number":"BNSTOCKOUT009",
    "items_set":
    [
         {
            "installed_item_identifier": { "serial_number":"SMC001-EN" }
        },{
            "product_identifier":{"code":"Universal Remote Controls"},
            "quantity":5
        }
    ]   
}


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_identifierWarehouse 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

idString

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

StringThe 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"
    }
}
  • No labels