Overview

This method allows you to change the box codes of an existing set of boxes in Komet Sales. 

Request

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 that will be updated.
    • currentBoxCode (required)(string:20): current box code that you want to change.
    • newBoxCode (required)(string:20): new box code.

Sample
{
  "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. 1 for success or 0 for failure.
  • message (string:500): description of the status of the transaction.
  • boxes (array): array of boxes with their corresponding transaction results.
    • newBoxCode (string:20): box code given in the input parameters.
    • status (integer:1): transaction status. 1 for success or 0 for failure.
    • message (string:500): description of the status of the transaction.

Sample
{
  "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"
       }  
      ]
 }
Related Articles

Information

This method acan be executed with tokens type company and vendor. In case you use a token type vendor, the boxes to change must be associated to the vendor.