Docs & Guides
Item and Box Limits
5 min
learn how to add specific boundaries when making box selections via the paccurate api while the paccurate api will cartonize requests based on provided boxes, items, and item rules, there are often additional packing operations that need to be considered when making a cartonization decision for example, you may want to limit the number of boxes used to fulfill an order, or only allow a certain number of items in a box there are several settings in the paccurate api that allow these request level controls boxesmax boxesperitemsetmax boxespersequencemax itemsperboxmax itemsetsperboxmax itemsinlinemax let's explore what each of these options mean when making a pack request 📘 note many of these controls can result in leftover items or additional packed boxes if not used carefully additionally, half of these options can be overridden on a per boxtype basis boxes max the boxesmax parameter sets a limit on how many boxes can be used to cartonize an order it is an integer, and if not specified, uses as many boxes as required based on any boxes , boxtypes or boxtypegenerators provided in the request if boxesmax is provided and the items being cartonized exceed the volume of the max number times the largest available box, the pack response will return leftovers the pack response will always return, at most, the number of boxes as set by this value (as well as subspaces created by items that may have them) in this example https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqmgaz6ay1eabuvjqgaxgwsglzkce0bdegajuskafquabygudfamvg5qgxw0k0zmdggawqmzvaolnmedawcaircaalkplgtashbefiercrjpouvuni1uljjnf3owqws7puioogssmajknfwdoyqoijdonlyaznospttotewqusisaxnxzxysut0igfoig2saaybwabgcigs2jiqcs7ggiaconozgsxbjukaijefkhgxoikivkgpecagjvdfyujshbinj2yioetaqrgjbzq4mcj2mbqjzmiz+traa== , we set boxesmax to 3 but pass a quantity of 20 each box can hold 4 items, so we have 8 leftover undefined https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqmgaz6ay1eabuvjqgaxgwsglzkce0bdegajuskafquabygudfamvg5qgxw0k0zmdggawqmzvaolnmedawcaircaalkplgtashbefiercrjpouvuni1uljjnf3owqws7puioogssmajknfwdoyqoijdonlyaznospttotewqusisaxnxzxysut0igfoig2saaybwabgcigs2jiqcs7ggiaconozgsxbjukaijefkhgxoikivkgpecagjvdfyujshbinj2yioetaqrgjbzq4mcj2mbqjzmiz+traa==\&embed=true box per item set max when trying to maximize volume utilization, paccurate will place items in any available space across cartons that have been opened for example, if an order with several large items requires 3 boxes to opened, when paccurate has to place additional items of smaller dimensions or weights, the same smaller sku may wind up being placed in various quantities across all 3 of those boxes before paccurate opens another box the boxesperitemsetmax parameter restricts the number of boxes a given itemset can be packed in the green items in this example https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqmgaz6ay1eabuvjqgaxgwsglzkcg3y8rksuvcs6hsamags8/eii4iio0ioadkogznqggqjk2ozm7jyoxcrp9iigas4agkxiogiababioehstxcibgaoidb2js4uamwgxbtwo760/gteqoquaoxwippgjhbmxfqxasjiekkgmuakcupy+uyshnwvvt6oihawbnz2tqdc4ty4ac/nhgawaayeaxatgctleliguc4kwmjf8af16aajursaaqcl6uesmak9wgeimodq6zurqasgzzhqlotktvxgahxfnlhkkrccwcshqviheinzjls4ldy5qwatsy8ccax2psekbwafgxrinc4t5ikdy3hegakucw+gg8eqjpoze0qa== cannot all be packed, since the boxesperitemsetmax is set to 2 undefined https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqmgaz6ay1eabuvjqgaxgwsglzkcg3y8rksuvcs6hsamags8/eii4iio0ioadkogznqggqjk2ozm7jyoxcrp9iigas4agkxiogiababioehstxcibgaoidb2js4uamwgxbtwo760/gteqoquaoxwippgjhbmxfqxasjiekkgmuakcupy+uyshnwvvt6oihawbnz2tqdc4ty4ac/nhgawaayeaxatgctleliguc4kwmjf8af16aajursaaqcl6uesmak9wgeimodq6zurqasgzzhqlotktvxgahxfnlhkkrccwcshqviheinzjls4ldy5qwatsy8ccax2psekbwafgxrinc4t5ikdy3hegakucw+gg8eqjpoze0qa==\&embed=true boxes per sequence max the boxespersequencemax setting works the same way as boxesperitemsetmax but uses an item's sequence property to enforce the limit this sequence can apply to any number of itemsets a possible use case would be making sure an item category cannot be spread across too many boxes items per box max as the name implies, the itemsperboxmax setting is a number that limits the quantity of items that can be packed in a given carton at the request level, this applies to all boxtypes that are a part of the request body, however any boxtype specific setting of itemsperboxmax can override the global setting if a box's item maximum is reached, paccurate will add new boxes to pack the remaining items (provided there is not a boxesmax setting that would limit the addition of another box) here is an example https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqoiadgogdaisaeagiylgwayyuenux4ipjrujlqgxqzoaoy8/eii4iio0ioadkogzhyaqmrajmzsnkhcjgn0ggycjgccteiiagaeagi4sgynckigaa4g9nz2dqjoamwgxbswoz60fgteqoquke6hriyqzlxrihwcwmisssayqgskcupyeuyshnzlld4jcdagnjanamliljjqh5smcwadwqn6vls9kctiguc4kqmjb8af16aajursaaqch6uesmhy9wgoimodquzuhqasgyzhr3lsklurgahbgnlhkkq7plksh7ojhrljjaxyq7bi7tsadhgqswgx6qhqod/ma9zboxafjbqeiqwbiaakucwnkk9lousaa= of a request with itemsperboxmax set to 5; you can see it packs 25 items in 5 boxes of 5 items undefined https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqoiadgogdaisaeagiylgwayyuenux4ipjrujlqgxqzoaoy8/eii4iio0ioadkogzhyaqmrajmzsnkhcjgn0ggycjgccteiiagaeagi4sgynckigaa4g9nz2dqjoamwgxbswoz60fgteqoquke6hriyqzlxrihwcwmisssayqgskcupyeuyshnzlld4jcdagnjanamliljjqh5smcwadwqn6vls9kctiguc4kqmjb8af16aajursaaqch6uesmhy9wgoimodquzuhqasgyzhr3lsklurgahbgnlhkkq7plksh7ojhrljjaxyq7bi7tsadhgqswgx6qhqod/ma9zboxafjbqeiqwbiaakucwnkk9lousaa=\&embed=true item sets per box max while itemsperboxmax limits the total quantity of items in a packed box, itemsetsperboxmax controls how many types of items can go into a box for example, setting "itemsetsperboxmax" 1 would mean each type of item would have to go into its own box, and you would prevent paccurate from mixing skus setting the value to 3 would mean there would be at most 3 different itemsets (items with unique refids) packed together much like itemsperboxmax , itemsetsperboxmax can be overridden on a per box basis in this example, we have set "itemsetsperboxmax" 3 on the request there are 6 types of items in the request, but only 3 at most in the response undefined https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0boajga4a2cgghahcowbzacwjqez7cwyoaoyrga9slsgahmgas9aj5oarpqbekgl70ajgfcahoiiqlqoiadgogdaisaeagiylgwayyuenux4ipjrujlqgxqzoaoy8/eii4iio0ioadkogzhyaqmrajmzsnkhcjgn0ggycjgccteiiagaeagi4sgynckigaa4g9nz2dqjoamwgxbswoz60fgteqoquke6hriyqzlxrihwcwmisssayqgskcupyeuyshnzlld4jcdagnjanamliljjqh5smcwadwqn6vls9kctiguc4kqmjfm8wcs0okr4ih0gwiqfgmqo8woyxmzqy3fgfoyxgpuxod0k3fkkui6qqvvennhoj+oggehejqaknokpdbjcrk5ziqqfxzn5fcacataisljiwpttks4kdemsumo2ekzfrrsuqlccg9ik8usb8ij/la+aajhmdabql7nmdtsxq4bosikuaelggvgq/ylzarqnavfbndj/yghksu7cs2u4ru9lwnzpw33ipclhmx0vec1kd1joacswrkgue6hwmxagidhzhcowosgopgauvqpaipckfd1g2hmpkkykddg0lsmrwaligm4udy7tl1gay65ynyaqjpizndtmtmdb5dzrtsopnjpj+bxty9iqubwp8ya9mgac4b8sbqpqhbwigsaaapqfgn5shuzyjjoqa==\&embed=true items inline max unlike the other box and item limits discussed here, itemsinlinemax is an array of 3 values each value corresponds to the maximum number of items that can be placed along the x, y, and z axes for example, "itemsinlinemax" \[2, 3, 5] would mean that boxes can only be packed 2 items tall, 3 items wide, and 5 items deep setting this value at a pack request level applies the limits to all boxtypes in the order, and it can be overridden by adding the setting to a specific boxtype an order of 24 items, with itemsinlinemax set to \[2,3,5] will pack like this https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0agaghahcowbzacwjqeylcwyoa7jmaex5pqadzqamcge9xfaf7iavhqcoavwcgxcjgmoxafgobjpgbs+wncadeyo+pjioibqf0kaiz7cakpiaoucgyonr0jd7qokquyqwqallqoqgahctkifzqnfyamlg0uaaeaeleigwc3lwcwsjoaoxsaaccciz6cm4uyfxgpqqeuhbgwgd+ygi46qziul3qmej4xkz9uekp6biazgqark4kqa=== undefined https //inspector manage paccurate io/config editor?config=n4iglglgpgtgylcbneaua2qatlazgsqbm0agaghahcowbzacwjqeylcwyoa7jmaex5pqadzqamcge9xfaf7iavhqcoavwcgxcjgmoxafgobjpgbs+wncadeyo+pjioibqf0kaiz7cakpiaoucgyonr0jd7qokquyqwqallqoqgahctkifzqnfyamlg0uaaeaeleigwc3lwcwsjoaoxsaaccciz6cm4uyfxgpqqeuhbgwgd+ygi46qziul3qmej4xkz9uekp6biazgqark4kqa===\&embed=true