[{"data":1,"prerenderedAt":225},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-order-keys":55,"-getting-started-order-keys-surround":220},[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":22,"body":57,"description":213,"extension":214,"links":215,"meta":216,"navigation":217,"path":23,"seo":218,"stem":24,"__hash__":219},"docs\u002F1.getting-started\u002F4.order-keys.md",{"type":58,"value":59,"toc":207},"minimark",[60,64,73,76,86,93,98,117,123,141,144,150,154,157,163,170,175,183,186,190,193],[61,62,22],"h1",{"id":63},"order-keys",[65,66,67,68,72],"p",{},"Every order has a Yuzu order ID and one or more order keys. The Yuzu order ID is the UUID returned as ",[69,70,71],"code",{},"id",". An order key is a stable compound identifier that links an external source to that order.",[65,74,75],{},"Order keys are built from a source and a source ID.",[77,78,84],"pre",{"className":79,"code":81,"language":82,"meta":83},[80],"language-text","{source}-{sourceId}\n","text","",[69,85,81],{"__ignoreMap":83},[65,87,88,89,92],{},"Use a ",[69,90,91],{},"sourceId"," that is stable and unique inside the source you are using. If you retry or resync with the same source and source ID, Yuzu updates the same order instead of creating a duplicate.",[94,95,97],"h2",{"id":96},"team-api-keys","Team API keys",[65,99,100,101,104,105,108,109,112,113,116],{},"For orders created with a team API key, Yuzu scopes the submitted ",[69,102,103],{},"source"," to your organization. If your organization ID is ",[69,106,107],{},"org_exampleTeam123456789",", you create an order with ",[69,110,111],{},"source: \"warehouse-east\"",", and the external order ID is ",[69,114,115],{},"WE-1001",", the returned order key is:",[77,118,121],{"className":119,"code":120,"language":82,"meta":83},[80],"org_exampleTeam123456789\u002Fwarehouse-east-WE-1001\n",[69,122,120],{"__ignoreMap":83},[65,124,125,126,129,130,129,133,136,137,140],{},"For API-key orders, choose source IDs that are unique within your team and source namespace, such as ",[69,127,128],{},"api",", ",[69,131,132],{},"shopify",[69,134,135],{},"wms",", or ",[69,138,139],{},"warehouse-east",".",[65,142,143],{},"Orders created manually in Yuzu or through web workflows can also use team-scoped sources. For example, an order created from a web workflow may have a key shaped like:",[77,145,148],{"className":146,"code":147,"language":82,"meta":83},[80],"org_exampleTeam123456789\u002Fweb-12345\n",[69,149,147],{"__ignoreMap":83},[94,151,153],{"id":152},"app-integrations","App integrations",[65,155,156],{},"For app-authenticated integrations, the source is the installed app ID. That means the same external source ID can exist in two different connected apps without colliding:",[77,158,161],{"className":159,"code":160,"language":82,"meta":83},[80],"a2cb2c3d-4e5f-6g7h-8i9j-0k1l2m3n4o5p-1234567890\n",[69,162,160],{"__ignoreMap":83},[65,164,165,166,169],{},"For example, a Shopify order key is not ",[69,167,168],{},"shopify-10000000000001",". It uses the installed Shopify app ID:",[77,171,173],{"className":172,"code":160,"language":82,"meta":83},[80],[69,174,160],{"__ignoreMap":83},[65,176,177,178,182],{},"Find an installed app ID in Yuzu by opening ",[179,180,181],"strong",{},"Apps",", selecting the app, and copying the ID from the right-hand slideover.",[65,184,185],{},"For app-authenticated orders, the source ID only needs to be unique within that connected app.",[94,187,189],{"id":188},"multiple-keys","Multiple keys",[65,191,192],{},"An order can have multiple order keys if it has been enriched or linked by multiple apps or systems. For example, the same order may have one key from a Shopify app and another from an API import.",[65,194,195,196,199,200,129,203,206],{},"Print requests and PDF fetch requests accept order UUIDs and order keys. When you send an order key in a JSON body, such as ",[69,197,198],{},"orderIds",", send it exactly as returned by Yuzu. If you use an order key in a URL path, URL-encode it because keys can contain ",[69,201,202],{},"\u002F",[69,204,205],{},":",", and other path-sensitive characters.",{"title":83,"searchDepth":208,"depth":208,"links":209},2,[210,211,212],{"id":96,"depth":208,"text":97},{"id":152,"depth":208,"text":153},{"id":188,"depth":208,"text":189},"Understand source IDs and stable order identifiers.","md",null,{},true,{"title":22,"description":213},"4DpmIgTt2hD4ZUIxK7yVgTqreXF4FCAmqekWe7GkXqs",[221,223],{"title":18,"path":19,"stem":20,"description":222,"children":-1},"Core resources used by the Yuzu API.",{"title":26,"path":27,"stem":28,"description":224,"children":-1},"Handle Yuzu API failures safely.",1780070562371]