Getting Started with Paccurate: Anatomy of a Pack Request

welcome to paccurate, the smartest cartonization solution in order to cartonize your items into boxes (or any type of container), you will be making requests to our rest api a request to the paccurate api requires two core pieces items and boxes with dimensional and weight data items are the units that will be cartonized into the provided boxes to be packed properly, they must have data for length, width, and height weight is utilized and strongly recommended whenever available boxes are the cartons that the units could be placed in in parcel shipments, they are most often corrugated, envelopes, or mailers for freight/ltl shipments the boxes can refer to pallets, trailers, or containers boxes require length, width, and height dimensions as well as a maximum weight 💡 it is important to note that the item and box data must be sent as part of every paccurate request this information is usually sourced from your wms or erp of choice determining where these pieces of data become available is up to you or your technology resources what follows is an overview of what your systems need in order to make a successful cartonization request to paccurate items sending items to the api requires each type of item to be represented with a quantity (sent as an integer) and dimensions (an object with the attributes of x, y, and z, all of which are numbers) these items are wrapped in an array called itemsets to be passed as part of the request an example of a set of items looks like this { "itemsets" \[ { "refid" 0, "color" "green", "name" "dispenser", "weight" 4, "dimensions" { "x" 9 5, "y" 3 25, "z" 4 5 }, "quantity" 1 }, { "refid" 1, "color" "blue", "name" "tape", "weight" 0 3, "dimensions" { "x" 4 75, "y" 4 75, "z" 1 }, "quantity" 20 }, { "refid" 2, "color" "red", "name" "stand", "weight" 17, "dimensions" { "x" 28, "y" 4 38, "z" 23 38 }, "quantity" 3, } 	] } additional attributes on each item are name , refid , and sequence — these 3 values can be used by paccurate to target the item in rules users can also assign a color attribute to an item, which is used in the output images to identify each instance of the item in its assigned box boxes now that we have some items that need packing, it’s time to put them into some boxes a typical request to paccurate includes an array called boxtypes , which follows a similar pattern to itemsets — a list of boxes (or any type of container) along with their corresponding dimensions and a weightmax an example set of boxes looks like this { 	"boxtypes" \[ { "weightmax" 65, "name" "small", "dimensions" { "x" 12, "y" 6, "z" 6 75 } }, { "weightmax" 80, "name" "medium", "dimensions" { "x" 14 5, "y" 6 75, "z" 12 75 } }, { "weightmax" 70, "name" "wide low", "dimensions" { "x" 12, "y" 12, "z" 4 25 } } ] } boxes also support refid and name which can be used to for targeting in rules some commonly used additional attributes are price is an integer that represents the cost of the box if provided, it is used alongside volume utilization to determine which boxes to select for packing weighttare is a number that represents the actual weight of the box — if provided, this will be included into the total weight of the packed box itemsperboxmax is an integer that represents maximum quantity of items that can be contained in one instance of the box reservedspace is a number that represents the amount of space that needs to be kept available (most often for packing material) for example, adding "reservedspace" 2 to a box means it can only be packed to 80% of its volume — we are reserving 2 (or 20%) of the space there are a handful of more advanced options over in the schema https //api paccurate io/docs/#/model boxtype that provide more granular control of the boxes combining the two and sending the request now that we’ve covered what required of boxes and items, let’s construct the api request using the data above, the request body should look like this { "itemsets" \[ { "refid" 0, "color" "green", "name" "dispenser", "weight" 4, "dimensions" { "x" 9 5, "y" 3 25, "z" 4 5 }, "quantity" 1 }, { "refid" 1, "color" "blue", "name" "tape", "weight" 0 3, "dimensions" { "x" 4 75, "y" 4 75, "z" 1 }, "quantity" 20 }, { "refid" 2, "color" "red", "name" "stand", "weight" 17, "dimensions" { "x" 28, "y" 4 38, "z" 23 38 }, "quantity" 3 } ], "boxtypes" \[ { "weightmax" 65, "name" "small", "dimensions" { "x" 12, "y" 6, "z" 6 75 } }, { "weightmax" 80, "name" "medium", "dimensions" { "x" 14 5, "y" 6 75, "z" 12 75 } }, { "weightmax" 70, "name" "wide low", "dimensions" { "x" 12, "y" 12, "z" 4 25 } } ] } paccurate is a restful api https //www redhat com/en/topics/api/what is a rest api and can be accessed using any http client that can make a post request with a json body — whether that’s a curl via cli, the postman https //www postman com gui, or the fetch api https //developer mozilla org/en us/docs/web/api/fetch api from a web client the url to post to is https //api paccurate io https //api paccurate io if you have an api key, be sure to set it in the headers as demonstrated below authorization apikey xyz 123 generated key as a curl request, it will look like curl h "authorization apikey xyz 123 generated key" https //api paccurate io/ d '{ "itemsets" \[ { "refid" 0, "color" "green", "name" "dispenser", "weight" 4, "dimensions" { "x" 9 5, "y" 3 25, "z" 4 5 }, "quantity" 1 }, { "refid" 1, "color" "blue", "name" "tape", "weight" 0 3, "dimensions" { "x" 4 75, "y" 4 75, "z" 1 }, "quantity" 20 }, { "refid" 2, "color" "red", "name" "stand", "weight" 17, "dimensions" { "x" 28, "y" 4 38, "z" 23 38 }, "quantity" 3 } ], "boxtypes" \[ { "weightmax" 65, "name" "small", "dimensions" { "x" 12, "y" 6, "z" 6 75 } }, { "weightmax" 80, "name" "medium", "dimensions" { "x" 14 5, "y" 6 75, "z" 12 75 } }, { "weightmax" 70, "name" "wide low", "dimensions" { "x" 12, "y" 12, "z" 4 25 } } ] }' to see this example request in action, click here https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0agaghagmb7ag2qzrahmcoa7ec9gqxiiyarmegaohjfeyua7lddmafhdqawcotd92smnr1pqadzqboahqbwcge80aznmamayabeaqwf8karwcupowqkhaoaiw+2hheaoeunpsmqcaarrt+atx8aikakjzixcbycsqk5vyawhj6bqjgngdsrmgq5i0uhhe+iafbirbhtirridgexkhocxqmtdje2fxmcbbbsyxysiortdxauvoodsam0wactp72v+5oto63vf3boq5ealouqdrgetzxcdmfsyhaali8c4anlcvbwktgmb4tfoxu0hzqj0aermidc0k6aghhusxjgpr2kpof3iihhura4kgmn8mhrnr0wmmzzi7vaxnjrnxppjzfalou1lqttpdkyahuwiqoaacaay1bkhmxxx553celchuf7rc5m+xiaa=== you can see the details of the raw request, and also make modifications to the configuration in the ‘configure’ tab that will update the request itself and allow you to re run it wrapping up while items and boxes are required for paccurate to pack, the api’s power lies in rules and options rules allow users to apply business logic (lock orientation, pack as is, exclude) to items and cartons options offer additional configurability such as box lookahead, placement axis order, and packing goals such as most items or lowest cost more on rules and options in another post! thanks for reading!