HomeInterfacesRecipesChangelogFAQ
Log In
Interfaces

Open Bin

Endpoint

http://<server>:44000/api/v2/task

Request parameters

ParameterMandatory?Data typeDescription
port_idTrueInt
(1-2000)
Identifies the Port.
bin_idFalseInt
(1 and 4000000)
Explicitly selects a specific bin.
task_idFalseInt
(1 and 2147483647)
Explicitly selects a specific task.
taskgroup_idFalseInt
(1 and 2147483647)
Explicitly selects a specific task group
shipmentFalseInt
(1 and 2147483647)
Explicitly selects a specific shipment.

Request example

//Interface installation location(Ip adress)
string ip = "127.0.0.1";
//The URL to the task interface
string url = "http://" + ip + ":44000/api/v2/task";
//XML that will be POST'ed
string xmlData = string.Format(
@"<?xml version=""1.0""?>
<methodcall>
  <name>openbin</name>
  <params>
    <port_id>4</port_id>
  </params>
</methodcall>");
//POST to interface
HttpResponseMessage response = await new HttpClient().PostAsync(url, new StringContent(xmlData,
        Encoding.UTF8, "application/xml"));
string responseString = await response.Content.ReadAsStringAsync();
Console.WriteLine(responseString);
# Interface installation location (IP address)
ip = "127.0.0.1"
# The URL to the task interface
url = f"http://{ip}:44000/api/v2/task"
# XML that will be POST'ed
xmlData ="""<?xml version="1.0"?>
<methodcall>
  <name>openbin</name>
  <params>
    <port_id>4</port_id>
  </params>
</methodcall>>"""
# POST to interface
response = requests.post(url, data=xmlData.encode('utf-8'), headers={"Content-Type": "application/xml"})
print(response.text)
const ip = "127.0.0.1";
const url = `http://${ip}:44000/api/v2/task`;
const xmlData =
`<?xml version="1.0"?>
<methodcall>
  <name>openbin</name>
  <params>
    <port_id>1</port_id>
  </params>
</methodcall>`;

fetch(url, {
    method: 'POST',
    body: xmlData,
    headers: {
        'Content-Type': 'application/xml'
    }
})
    .then(response => response.text())
    .then(responseString => console.log(responseString));
<?xml version="1.0"?>
<methodcall>
  <name>openbin</name>
  <params>
    <port_id>4</port_id>
  </params>
</methodcall>

Response parameters

ParameterData typeDescription
port_idInt
(1-2000)
Identifies the Port.
bin_idInt
(1-4000000)
The Port's selected Bin.
task_idInt
(1-2147483647)
The Port's selected task.

Response example

<?xml version="1.0"?>
<response>
  <params>
    <port_id>4</port_id>
    <bin_id>14861</bin_id>
    <task_id>310022</task_id>
  </params>
</response>

OR

<?xml version="1.0"?>
<response>
  <fault>
    <code>1000</code>
  </fault>
</response>

Error Codes

Error CodeDescription
1000The specified Port is not available.
1003Mandatory parameter port_id is missing.
1004Parameter port_id is not valid (invalid format or out of range).
1009The specified Port is not open.
1010Parameter bin_id is not valid (invalid format or out of range).
1011The specified Bin does not exist
1012Parameter task_id is not valid (invalid format or out of range).
1013Parameter taskgroup_id is not valid (invalid format or out of range).
1014Parameter shipment is not valid (invalid format or out of range).
1015There are no tasks or Bins that fulfill the Port select requirements.
1016There are no Bins ready that fulfill the Port select requirements.
1017The specified task does not exist
1018The specified task group does not exist.
1019The specified task group is selected by another Port.
1020The openbin conflicts with a previous openbin call that is not yet closed.
1021The openbin conflicts with the Port's selected shipment.
1022The openbin conflicts with the Port's selected task group
1023Multiple selection parameters are not allowed
1048System is not available

Software version requirement

Software Release October 2022 and newer