Use this method to change the Box Codes of an existing set of boxes in Komet Sales. 

Valid Tokens: Company and Vendor.

Vendor Tokens: If you are using a Vendor token, the boxes to change must be associated with the Vendor of the token.


Request


URL: https://api.kometsales.com/api/box.code.change

Method: POST

Content-Type: application/JSON


Input Parameters

authenticationToken (required)(string:50)

Komet Sales security token.


boxes (required)(array)

Array of items to update.


currentBoxCode (required)(string:20)

The current Box Code.


newBoxCode (required)(string:20)

The new Box Code.


{
  "authenticationToken": "token_info_goes_here",
  "boxes": [
    {
      "currentBoxCode": "KS001001",
      "newBoxCode": "PT991001"
    },
    {
      "currentBoxCode": "KS001002",
      "newBoxCode": "PT991002"
    },
    {
      "currentBoxCode": "KS001003",
      "newBoxCode": "PT991003"
    }
  ]
}


Response


Output

status (integer:1)

Transaction status.

Valid values: 1 = Success | 0 = Failure.


message (string:500)

Transaction status description.


boxes (array)

The Box array with corresponding transaction results.


newBoxCode (string:20)

The new Box code given in the input parameters.


status (integer:1)

Transaction status.

Valid values: 1 = Success | 0 = Failure


message (string:500)

Transaction status description.


{
  "status": "1",
  "message": "2 boxes were successfully updated. 1 boxes could not be updated",
  "boxes": [
    {
      "newBoxCode": "PT991001",
      "status": "1",
      "message": "success"
    },
    {
      "newBoxCode": "PT991002",
      "status": "1",
      "message": "success"
    },
    {
      "newBoxCode": "PT991003",
      "status": "0",
      "message": "Box code does not exist"
    }
  ]
}


defaultcom.atlassian.ecosystemfc909b09-b512-4c31-a844-dd855b0e6aae/db1c8759-c7e5-4e80-9022-d19e47b0e2b0/static/macroPeacockf6148cdf-6283-4197-9a75-9cbd6faadee7ari:cloud:ecosystem::extension/fc909b09-b512-4c31-a844-dd855b0e6aae/db1c8759-c7e5-4e80-9022-d19e47b0e2b0/static/macroPeacockf2a3f88a-843d-4aa1-b77b-f9d98e658cb8defaultcom.atlassian.ecosystemfc909b09-b512-4c31-a844-dd855b0e6aae/db1c8759-c7e5-4e80-9022-d19e47b0e2b0/static/macroPeacockf6148cdf-6283-4197-9a75-9cbd6faadee7ari:cloud:ecosystem::extension/fc909b09-b512-4c31-a844-dd855b0e6aae/db1c8759-c7e5-4e80-9022-d19e47b0e2b0/static/macroPeacockf2a3f88a-843d-4aa1-b77b-f9d98e658cb8