[{"data":1,"prerenderedAt":271},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-concepts":55,"-getting-started-concepts-surround":266},[4,30],{"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],{"title":36,"path":37,"stem":38},"Create order","\u002Fapi\u002Fcreate-order","2.api\u002F1.create-order",{"title":40,"path":41,"stem":42},"Fetch printers","\u002Fapi\u002Ffetch-printers","2.api\u002F2.fetch-printers",{"title":44,"path":45,"stem":46},"Print orders","\u002Fapi\u002Fprint-orders","2.api\u002F3.print-orders",{"title":48,"path":49,"stem":50},"Fetch order PDF","\u002Fapi\u002Ffetch-order-pdf","2.api\u002F4.fetch-order-pdf",{"title":52,"path":53,"stem":54},"Links","\u002Fapi\u002Flinks","2.api\u002F5.links",{"id":56,"title":18,"body":57,"description":259,"extension":260,"links":261,"meta":262,"navigation":263,"path":19,"seo":264,"stem":20,"__hash__":265},"docs\u002F1.getting-started\u002F3.concepts.md",{"type":58,"value":59,"toc":248},"minimark",[60,64,68,73,76,79,83,86,89,92,108,112,115,118,121,198,205,208,214,218,221,224,228,234,237,241],[61,62,18],"h1",{"id":63},"concepts",[65,66,67],"p",{},"Before sending production traffic, make sure these Yuzu resources exist in the team you authenticate against.",[69,70,72],"h2",{"id":71},"templates","Templates",[65,74,75],{},"Templates define the printable document layout. Orders usually use the template selected by your Yuzu flow, but you can override the template when creating an order or printing a document.",[65,77,78],{},"Use template IDs when you need deterministic routing from your integration.",[69,80,82],{"id":81},"flows","Flows",[65,84,85],{},"Flows run when an order is created or updated. They can choose templates, apply tags, enrich order data, and run automation.",[65,87,88],{},"Your API payload should send stable order data; the flow should handle Yuzu-specific decisions when possible.",[69,90,22],{"id":91},"order-keys",[65,93,94,95,98,99,103,104,107],{},"Order keys are stable identifiers that connect an external system's order ID to a Yuzu order. Read ",[96,97,22],"a",{"href":23}," before relying on ",[100,101,102],"code",{},"source",", ",[100,105,106],{},"sourceId",", links, or print-by-key workflows.",[69,109,111],{"id":110},"links-and-merging","Links and merging",[65,113,114],{},"Links let Yuzu match the same order across multiple sources before it creates or updates the order. This is useful when, for example, a Shopify order and a warehouse order use different IDs but should become one Yuzu order.",[65,116,117],{},"During order ingest, Yuzu starts with the incoming source map, evaluates any matching links for that team, and merges the resolved source IDs into the source map before looking for existing orders. If any generated order key already exists, Yuzu updates and merges into that order rather than creating a duplicate.",[65,119,120],{},"A link has:",[122,123,124,137],"table",{},[125,126,127],"thead",{},[128,129,130,134],"tr",{},[131,132,133],"th",{},"Field",[131,135,136],{},"Description",[138,139,140,161,174,184],"tbody",{},[128,141,142,147],{},[143,144,145],"td",{},[100,146,102],{},[143,148,149,150,103,153,156,157,160],{},"The source that triggers the link. This can be an app UUID, a manual source (",[100,151,152],{},"api",[100,154,155],{},"web",", or ",[100,158,159],{},"csv","), or a custom source key.",[128,162,163,168],{},[143,164,165],{},[100,166,167],{},"target",[143,169,170,171,173],{},"The source to match against. It uses the same app, manual, or custom shapes as ",[100,172,102],{},".",[128,175,176,181],{},[143,177,178],{},[100,179,180],{},"resolver",[143,182,183],{},"A JavaScript expression that returns the target source ID from the incoming payload.",[128,185,186,191],{},[143,187,188],{},[100,189,190],{},"condition",[143,192,193,194,197],{},"Optional JavaScript expression that must return ",[100,195,196],{},"true"," before the resolver runs.",[65,199,200,201,204],{},"For API-key order creation, custom sources are stored as ",[100,202,203],{},"orgId\u002Fsource",". For app-authenticated creation, the source is the app UUID. The link API accepts the unscoped source values and Yuzu applies the team scope internally.",[65,206,207],{},"Example: if an API-created warehouse order includes a Shopify order ID in its payload, a link can resolve that Shopify ID so the warehouse source key and Shopify source key are attached to the same Yuzu order.",[65,209,210,211,213],{},"Use links carefully. A broad resolver can merge unrelated orders if two systems reuse the same identifier. Prefer stable, system-specific IDs and add a ",[100,212,190],{}," when a link should only apply to some orders.",[69,215,217],{"id":216},"printers","Printers",[65,219,220],{},"Printers are managed in Yuzu and connected through the Yuzu Print Client. Print requests only succeed for documents that resolve to a printer, template, paper size, and print config.",[65,222,223],{},"You can set printer defaults in Yuzu or pass print-time overrides.",[69,225,227],{"id":226},"variables","Variables",[65,229,230,231,173],{},"Variables are custom values available to templates and flows. Send per-order values in ",[100,232,233],{},"order.variables",[65,235,236],{},"Use variables for data such as gift messages, delivery instructions, campaign names, or warehouse metadata.",[69,238,240],{"id":239},"tags","Tags",[65,242,243,244,247],{},"Tags classify orders for flows, filtering, reporting, and print routing. Create-order requests can pass tags on ",[100,245,246],{},"order.tags","; print requests can filter or override by tag.",{"title":249,"searchDepth":250,"depth":250,"links":251},"",2,[252,253,254,255,256,257,258],{"id":71,"depth":250,"text":72},{"id":81,"depth":250,"text":82},{"id":91,"depth":250,"text":22},{"id":110,"depth":250,"text":111},{"id":216,"depth":250,"text":217},{"id":226,"depth":250,"text":227},{"id":239,"depth":250,"text":240},"Core resources used by the Yuzu API.","md",null,{},true,{"title":18,"description":259},"kia4ONIVG9NVfI39ax_xWLrsX50ME330YPkEVoL0PC8",[267,269],{"title":14,"path":15,"stem":16,"description":268,"children":-1},"Authenticate Yuzu API requests with X-API-Key.",{"title":22,"path":23,"stem":24,"description":270,"children":-1},"Understand source IDs and stable order identifiers.",1780070562371]