[{"data":1,"prerenderedAt":625},["ShallowReactive",2],{"navigation_docs":3,"-api-dynamic-template-attributes":88,"-api-dynamic-template-attributes-surround":620},[4,30,71],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17,21,25],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F2.authentication",{"title":18,"path":19,"stem":20},"Concepts","\u002Fgetting-started\u002Fconcepts","1.getting-started\u002F3.concepts",{"title":22,"path":23,"stem":24},"Order keys","\u002Fgetting-started\u002Forder-keys","1.getting-started\u002F4.order-keys",{"title":26,"path":27,"stem":28},"Errors and retries","\u002Fgetting-started\u002Ferrors-and-retries","1.getting-started\u002F5.errors-and-retries",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"API","\u002Fapi","2.api",[35,39,43,47,51,55,59,63,67],{"title":36,"path":37,"stem":38},"Create order","\u002Fapi\u002Fcreate-order","2.api\u002F1.create-order",{"title":40,"path":41,"stem":42},"Fetch order","\u002Fapi\u002Ffetch-order","2.api\u002F2.fetch-order",{"title":44,"path":45,"stem":46},"Fetch order status","\u002Fapi\u002Ffetch-order-status","2.api\u002F3.fetch-order-status",{"title":48,"path":49,"stem":50},"Fetch printers","\u002Fapi\u002Ffetch-printers","2.api\u002F4.fetch-printers",{"title":52,"path":53,"stem":54},"Print orders","\u002Fapi\u002Fprint-orders","2.api\u002F5.print-orders",{"title":56,"path":57,"stem":58},"Fetch order PDF","\u002Fapi\u002Ffetch-order-pdf","2.api\u002F6.fetch-order-pdf",{"title":60,"path":61,"stem":62},"Links","\u002Fapi\u002Flinks","2.api\u002F7.links",{"title":64,"path":65,"stem":66},"Validate source app credentials","\u002Fapi\u002Fvalidate-source-app-credentials","2.api\u002F8.validate-source-app-credentials",{"title":68,"path":69,"stem":70},"Dynamic template attributes","\u002Fapi\u002Fdynamic-template-attributes","2.api\u002F9.dynamic-template-attributes",{"title":72,"path":73,"stem":74,"children":75,"page":29},"3PL teams","\u002F3pl-teams","3.3pl-teams",[76,80,84],{"title":77,"path":78,"stem":79},"Overview","\u002F3pl-teams\u002Foverview","3.3pl-teams\u002F1.overview",{"title":81,"path":82,"stem":83},"Manage merchant teams","\u002F3pl-teams\u002Fmanage-merchants","3.3pl-teams\u002F2.manage-merchants",{"title":85,"path":86,"stem":87},"Send orders to merchants","\u002F3pl-teams\u002Fsend-orders","3.3pl-teams\u002F3.send-orders",{"id":89,"title":68,"body":90,"description":613,"extension":614,"links":615,"meta":616,"navigation":617,"path":69,"seo":618,"stem":70,"__hash__":619},"docs\u002F2.api\u002F9.dynamic-template-attributes.md",{"type":91,"value":92,"toc":607},"minimark",[93,97,102,212,223,227,239,482,485,489,546,581,587,591,594,603],[94,95,96],"p",{},"Bind a block's font and colour to variables so its appearance can change with each order. For example, clients can choose different handwriting styles while using the same template.",[98,99,101],"h2",{"id":100},"bind-attributes-to-variables","Bind attributes to variables",[103,104,105,160,191,209],"ol",{},[106,107,108,109,113,114,117,118],"li",{},"In ",[110,111,112],"strong",{},"Variables",", create an order-scoped text variable called ",[110,115,116],{},"Note font"," with this mapper:",[119,120,125],"pre",{"className":121,"code":122,"language":123,"meta":124,"style":124},"language-js shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","return order.variables?.note_font ?? null\n","js","",[126,127,128],"code",{"__ignoreMap":124},[129,130,133,137,141,145,148,151,154,157],"span",{"class":131,"line":132},"line",1,[129,134,136],{"class":135},"s7zQu","return",[129,138,140],{"class":139},"sTEyZ"," order",[129,142,144],{"class":143},"sMK4o",".",[129,146,147],{"class":139},"variables",[129,149,150],{"class":143},"?.",[129,152,153],{"class":139},"note_font ",[129,155,156],{"class":143},"??",[129,158,159],{"class":143}," null\n",[106,161,162,163,166,167],{},"Create another order-scoped text variable called ",[110,164,165],{},"Note colour",":",[119,168,170],{"className":121,"code":169,"language":123,"meta":124,"style":124},"return order.variables?.note_colour ?? null\n",[126,171,172],{"__ignoreMap":124},[129,173,174,176,178,180,182,184,187,189],{"class":131,"line":132},[129,175,136],{"class":135},[129,177,140],{"class":139},[129,179,144],{"class":143},[129,181,147],{"class":139},[129,183,150],{"class":143},[129,185,186],{"class":139},"note_colour ",[129,188,156],{"class":143},[129,190,159],{"class":143},[106,192,193,194,196,197,200,201,204,205,208],{},"Open your template and select the note block. For a handwriting block, use the ",[110,195],{"x":124}," control beside ",[110,198,199],{},"Font"," and ",[110,202,203],{},"Color"," to select the corresponding variables. For a normal text block, select ",[110,206,207],{},"Use a variable"," in the font dropdown and colour picker.",[106,210,211],{},"Set the block's fallback font and colour, then publish the template.",[94,213,214,215,218,219,222],{},"The variable names and payload keys above are examples. Use matching keys in your mappers and requests. If you send the note through ",[126,216,217],{},"order.note",", bind the block's content to the built-in ",[110,220,221],{},"Note"," variable.",[98,224,226],{"id":225},"send-attribute-values","Send attribute values",[94,228,229,230,233,234,238],{},"Include the values in ",[126,231,232],{},"order.variables"," when you ",[235,236,237],"a",{"href":37},"create or update an order",". This example selects Nightingale handwriting and dark blue ink in a template whose handwriting block uses the bindings above:",[119,240,244],{"className":241,"code":242,"language":243,"meta":124,"style":124},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"source\": \"warehouse-east\",\n  \"sourceId\": \"WE-1001\",\n  \"order\": {\n    \"orderNumber\": \"#1001\",\n    \"note\": \"Hi Sam,\\n\\nThank you for your order!\\n\\nThe team\",\n    \"overrides\": {\n      \"template\": \"YOUR_TEMPLATE_ID\"\n    },\n    \"variables\": {\n      \"note_font\": \"Nightingale\",\n      \"note_colour\": \"darkBlue\"\n    }\n  }\n}\n","json",[126,245,246,251,278,299,314,337,369,383,405,411,424,445,464,470,476],{"__ignoreMap":124},[129,247,248],{"class":131,"line":132},[129,249,250],{"class":143},"{\n",[129,252,254,257,261,264,266,269,273,275],{"class":131,"line":253},2,[129,255,256],{"class":143},"  \"",[129,258,260],{"class":259},"spNyl","source",[129,262,263],{"class":143},"\"",[129,265,166],{"class":143},[129,267,268],{"class":143}," \"",[129,270,272],{"class":271},"sfazB","warehouse-east",[129,274,263],{"class":143},[129,276,277],{"class":143},",\n",[129,279,281,283,286,288,290,292,295,297],{"class":131,"line":280},3,[129,282,256],{"class":143},[129,284,285],{"class":259},"sourceId",[129,287,263],{"class":143},[129,289,166],{"class":143},[129,291,268],{"class":143},[129,293,294],{"class":271},"WE-1001",[129,296,263],{"class":143},[129,298,277],{"class":143},[129,300,302,304,307,309,311],{"class":131,"line":301},4,[129,303,256],{"class":143},[129,305,306],{"class":259},"order",[129,308,263],{"class":143},[129,310,166],{"class":143},[129,312,313],{"class":143}," {\n",[129,315,317,320,324,326,328,330,333,335],{"class":131,"line":316},5,[129,318,319],{"class":143},"    \"",[129,321,323],{"class":322},"sBMFI","orderNumber",[129,325,263],{"class":143},[129,327,166],{"class":143},[129,329,268],{"class":143},[129,331,332],{"class":271},"#1001",[129,334,263],{"class":143},[129,336,277],{"class":143},[129,338,340,342,345,347,349,351,354,357,360,362,365,367],{"class":131,"line":339},6,[129,341,319],{"class":143},[129,343,344],{"class":322},"note",[129,346,263],{"class":143},[129,348,166],{"class":143},[129,350,268],{"class":143},[129,352,353],{"class":271},"Hi Sam,",[129,355,356],{"class":139},"\\n\\n",[129,358,359],{"class":271},"Thank you for your order!",[129,361,356],{"class":139},[129,363,364],{"class":271},"The team",[129,366,263],{"class":143},[129,368,277],{"class":143},[129,370,372,374,377,379,381],{"class":131,"line":371},7,[129,373,319],{"class":143},[129,375,376],{"class":322},"overrides",[129,378,263],{"class":143},[129,380,166],{"class":143},[129,382,313],{"class":143},[129,384,386,389,393,395,397,399,402],{"class":131,"line":385},8,[129,387,388],{"class":143},"      \"",[129,390,392],{"class":391},"sbssI","template",[129,394,263],{"class":143},[129,396,166],{"class":143},[129,398,268],{"class":143},[129,400,401],{"class":271},"YOUR_TEMPLATE_ID",[129,403,404],{"class":143},"\"\n",[129,406,408],{"class":131,"line":407},9,[129,409,410],{"class":143},"    },\n",[129,412,414,416,418,420,422],{"class":131,"line":413},10,[129,415,319],{"class":143},[129,417,147],{"class":322},[129,419,263],{"class":143},[129,421,166],{"class":143},[129,423,313],{"class":143},[129,425,427,429,432,434,436,438,441,443],{"class":131,"line":426},11,[129,428,388],{"class":143},[129,430,431],{"class":391},"note_font",[129,433,263],{"class":143},[129,435,166],{"class":143},[129,437,268],{"class":143},[129,439,440],{"class":271},"Nightingale",[129,442,263],{"class":143},[129,444,277],{"class":143},[129,446,448,450,453,455,457,459,462],{"class":131,"line":447},12,[129,449,388],{"class":143},[129,451,452],{"class":391},"note_colour",[129,454,263],{"class":143},[129,456,166],{"class":143},[129,458,268],{"class":143},[129,460,461],{"class":271},"darkBlue",[129,463,404],{"class":143},[129,465,467],{"class":131,"line":466},13,[129,468,469],{"class":143},"    }\n",[129,471,473],{"class":131,"line":472},14,[129,474,475],{"class":143},"  }\n",[129,477,479],{"class":131,"line":478},15,[129,480,481],{"class":143},"}\n",[94,483,484],{},"Sending values changes only attributes bound to the corresponding variables. No block IDs or additional handwriting flag are required.",[98,486,488],{"id":487},"supported-values","Supported values",[490,491,492,507],"table",{},[493,494,495],"thead",{},[496,497,498,502,504],"tr",{},[499,500,501],"th",{},"Block type",[499,503,199],{},[499,505,506],{},"Colour",[508,509,510,528],"tbody",{},[496,511,512,516,519],{},[513,514,515],"td",{},"Handwriting",[513,517,518],{},"A handwriting style available in Yuzu.",[513,520,521,522,525,526,144],{},"A named ink colour from the editor, such as ",[126,523,524],{},"black"," or ",[126,527,461],{},[496,529,530,533,540],{},[513,531,532],{},"Normal text",[513,534,535,536,539],{},"A Yuzu font or a font already uploaded to your team. Use its font family name, such as ",[126,537,538],{},"EB Garamond",", rather than a file URL or asset ID.",[513,541,542,543,144],{},"A valid CSS colour, such as ",[126,544,545],{},"#373DCF",[94,547,548,549,552,553,552,556,552,559,552,562,552,565,552,568,552,570,552,573,576,577,580],{},"Handwriting styles are ",[126,550,551],{},"Arthur",", ",[126,554,555],{},"Carpenter",[126,557,558],{},"Foster",[126,560,561],{},"George",[126,563,564],{},"Grogan",[126,566,567],{},"Knowles",[126,569,440],{},[126,571,572],{},"Robinson",[126,574,575],{},"Singh",", and ",[126,578,579],{},"Stafford",". CSS colour values do not select handwriting ink colours.",[94,582,583,584,144],{},"The block type determines whether the text renders as handwriting or normal text. A font variable does not change that type. If your integration offers both, use a template for each block type and select it with ",[126,585,586],{},"order.overrides.template",[98,588,590],{"id":589},"fallbacks-and-preview","Fallbacks and preview",[94,592,593],{},"Missing, empty, or unsupported font or colour values use the block's configured fallback. Font and colour resolve independently.",[94,595,596,597,599,600,602],{},"Preview representative orders before using the template in production. Use ",[235,598,40],{"href":41}," to check the saved variables and ",[235,601,56],{"href":57}," to inspect the rendered result.",[604,605,606],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":124,"searchDepth":253,"depth":253,"links":608},[609,610,611,612],{"id":100,"depth":253,"text":101},{"id":225,"depth":253,"text":226},{"id":487,"depth":253,"text":488},{"id":589,"depth":253,"text":590},"Bind template fonts and colours to values in your order data.","md",null,{},true,{"title":68,"description":613},"JCErhAKh0Yjitned11_ep9T0i1EEOqzYNN9a-UKJvMw",[621,623],{"title":64,"path":65,"stem":66,"description":622,"children":-1},"Confirm that an API key can access a source App ID without creating or printing an order.",{"title":77,"path":78,"stem":79,"description":624,"children":-1},"Manage merchant teams and their orders with one 3PL API key.",1791822942765]