{"openapi":"3.1.0","info":{"title":"Merit Superstore shopping","version":"1.0.0"},"servers":[{"url":"https://muchomart.com"}],"paths":{"/api/catalog/search":{"get":{"operationId":"search","summary":"Search inventory","description":"Read-only. Supply request as URL-encoded JSON, or individual query fields from x-form-schema. Do not combine both. Preparing a link does not create a supplier checkout or confirm a final total.","parameters":[{"name":"request","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/search"}}}},{"name":"supplier","in":"query","required":false,"schema":{"$ref":"#/components/schemas/searchForm/properties/supplier"}},{"name":"query","in":"query","required":false,"schema":{"$ref":"#/components/schemas/searchForm/properties/query"}},{"name":"filters","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/searchForm/properties/filters"}}}}],"x-form-schema":{"$ref":"#/components/schemas/searchForm"},"responses":{"200":{"description":"Catalog results or checkout handoff with a catalog estimate."},"400":{"description":"Validation error with field paths and recovery guidance."}}},"post":{"operationId":"searchJson","summary":"Search inventory","description":"Read catalog information.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/search"}}}},"responses":{"200":{"description":"Catalog results or a checkout handoff with a catalog estimate."},"400":{"description":"Validation error with recovery guidance."}}}},"/api/catalog/lookup":{"get":{"operationId":"lookup","summary":"Look up item IDs","description":"Read-only. Supply request as URL-encoded JSON, or individual query fields from x-form-schema. Do not combine both. Preparing a link does not create a supplier checkout or confirm a final total.","parameters":[{"name":"request","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/lookup"}}}},{"name":"supplier","in":"query","required":false,"schema":{"$ref":"#/components/schemas/lookupForm/properties/supplier"}},{"name":"ids","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/lookupForm/properties/ids"}}}}],"x-form-schema":{"$ref":"#/components/schemas/lookupForm"},"responses":{"200":{"description":"Catalog results or checkout handoff with a catalog estimate."},"400":{"description":"Validation error with field paths and recovery guidance."}}},"post":{"operationId":"lookupJson","summary":"Look up item IDs","description":"Read catalog information.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/lookup"}}}},"responses":{"200":{"description":"Catalog results or a checkout handoff with a catalog estimate."},"400":{"description":"Validation error with recovery guidance."}}}},"/api/checkouts/prepare":{"get":{"operationId":"prepare","summary":"Prepare a buyer checkout link","description":"Read-only. Supply request as URL-encoded JSON, or individual query fields from x-form-schema. Do not combine both. Preparing a link does not create a supplier checkout or confirm a final total.","parameters":[{"name":"request","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/prepare"}}}},{"name":"supplier","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/supplier"}},{"name":"client_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/client_id"}},{"name":"campaign_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/campaign_id"}},{"name":"label","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/label"}},{"name":"item_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/item_id"}},{"name":"quantity","in":"query","required":false,"schema":{"$ref":"#/components/schemas/prepareForm/properties/quantity"}}],"x-form-schema":{"$ref":"#/components/schemas/prepareForm"},"responses":{"200":{"description":"Catalog results or checkout handoff with a catalog estimate."},"400":{"description":"Validation error with field paths and recovery guidance."}}},"post":{"operationId":"prepareJson","summary":"Prepare a buyer checkout link","description":"Optional partial prefill includes authorized buyer and shipping_address fields. Private details are accepted only in POST bodies and returned through an opaque encrypted link fragment. Signed-in saved details take priority. No supplier checkout or payment is created.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/preparePost"},{"$ref":"#/components/schemas/preparePostForm"}]}},"application/x-www-form-urlencoded":{"schema":{"oneOf":[{"$ref":"#/components/schemas/preparePost"},{"$ref":"#/components/schemas/preparePostForm"},{"type":"object","properties":{"request":{"type":"string","contentMediaType":"application/json"}},"required":["request"],"additionalProperties":false}]},"encoding":{"line_items":{"contentType":"application/json"}}},"multipart/form-data":{"schema":{"oneOf":[{"$ref":"#/components/schemas/preparePost"},{"$ref":"#/components/schemas/preparePostForm"},{"type":"object","properties":{"request":{"type":"string","contentMediaType":"application/json"}},"required":["request"],"additionalProperties":false}]},"encoding":{"line_items":{"contentType":"application/json"}}}}},"responses":{"200":{"description":"Catalog results or a checkout handoff with a catalog estimate."},"400":{"description":"Validation error with recovery guidance."}}}},"/api/checkouts/prepare/edit":{"get":{"operationId":"edit","summary":"Edit a prepared cart and return its revised checkout link","description":"Read-only. Supply request as URL-encoded JSON, or individual query fields from x-form-schema. Do not combine both. Preparing a link does not create a supplier checkout or confirm a final total.","parameters":[{"name":"request","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/edit"}}}},{"name":"label","in":"query","required":false,"schema":{"$ref":"#/components/schemas/editForm/properties/label"}},{"name":"checkout_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/editForm/properties/checkout_id"}},{"name":"line_items","in":"query","required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/editForm/properties/line_items"}}}},{"name":"add_item_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/editForm/properties/add_item_id"}},{"name":"quantity","in":"query","required":false,"schema":{"$ref":"#/components/schemas/editForm/properties/quantity"}},{"name":"remove_item_id","in":"query","required":false,"schema":{"$ref":"#/components/schemas/editForm/properties/remove_item_id"}}],"x-form-schema":{"$ref":"#/components/schemas/editForm"},"responses":{"200":{"description":"Catalog results or checkout handoff with a catalog estimate."},"400":{"description":"Validation error with field paths and recovery guidance."}}},"post":{"operationId":"editJson","summary":"Edit a prepared cart and return its revised checkout link","description":"Read catalog information.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/edit"}},"application/x-www-form-urlencoded":{"schema":{"oneOf":[{"$ref":"#/components/schemas/editPost"},{"type":"object","properties":{"request":{"type":"string","contentMediaType":"application/json"}},"required":["request"],"additionalProperties":false}]},"encoding":{"line_items":{"contentType":"application/json"}}},"multipart/form-data":{"schema":{"oneOf":[{"$ref":"#/components/schemas/editPost"},{"type":"object","properties":{"request":{"type":"string","contentMediaType":"application/json"}},"required":["request"],"additionalProperties":false}]},"encoding":{"line_items":{"contentType":"application/json"}}}}},"responses":{"200":{"description":"Catalog results or a checkout handoff with a catalog estimate."},"400":{"description":"Validation error with recovery guidance."}}}},"/api/checkouts":{"post":{"operationId":"createCheckout","summary":"Create a supplier checkout after collecting private buyer details","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/IdempotencyKey"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/createCheckout"}}}},"responses":{"201":{"description":"Private checkout_url, authoritative supplier quote, and checkout access token."},"400":{"description":"Validation or supplier rejection with recovery instructions."}}}},"/api/checkouts/{id}":{"get":{"operationId":"readCheckout","summary":"Read a supplier checkout before editing","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Checkout-Token","in":"header","required":false,"description":"Checkout-scoped proof is required: this header, an installed checkout cookie, or a verified owning account. Never use a client ID as authentication.","schema":{"$ref":"#/components/schemas/CheckoutToken"}}],"responses":{"200":{"description":"Checkout with authoritative items, totals, and revision.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutView"}}}},"401":{"description":"Checkout proof required."}}},"put":{"operationId":"updateCheckout","summary":"Edit the items or buyer details of an unpaid supplier checkout","description":"Read first. Replace the full input while preserving buyer, fulfillment, and context. Retain the idempotency key for this request; do not automatically retry supplier mutations or uncertain outcomes. Paid/processing checkouts cannot be edited.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Checkout-Token","in":"header","required":false,"description":"Checkout-scoped proof is required: this header, an installed checkout cookie, or a verified owning account. Never use a client ID as authentication.","schema":{"$ref":"#/components/schemas/CheckoutToken"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/IdempotencyKey"}},{"name":"If-Match","in":"header","required":true,"schema":{"type":"string"},"description":"Current revision from GET."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCheckout"}}}},"responses":{"200":{"description":"Supplier-confirmed updated checkout and quote."},"401":{"description":"Checkout proof required."},"409":{"description":"Checkout closed, payment in progress, or reconciliation required."},"412":{"description":"Stale revision; read and review before a new edit."}}}}},"components":{"schemas":{"search":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"query":{"default":"","type":"string","maxLength":200},"filters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/search___schema0"}},"pagination":{"type":"object","properties":{"limit":{"default":12,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":500}},"required":["limit"],"additionalProperties":false}},"required":["supplier","query"],"additionalProperties":false},"search___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/search___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/search___schema0"}}]},"searchForm":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"query":{"default":"","type":"string","maxLength":200},"filters":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/searchForm___schema0"}},"pagination":{"type":"object","properties":{"limit":{"default":12,"type":"integer","minimum":1,"maximum":50},"cursor":{"type":"string","maxLength":500}},"required":["limit"],"additionalProperties":false}},"required":["supplier","query"],"additionalProperties":false},"searchForm___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/searchForm___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/searchForm___schema0"}}]},"lookup":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}},"required":["supplier","ids"],"additionalProperties":false},"lookupForm":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"ids":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}},"required":["supplier","ids"],"additionalProperties":false},"prepare":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"client_id":{"type":"string","minLength":1,"pattern":"^\\S+$","description":"Your own non-empty lowercase client ID without whitespace. Prior registration is not required."},"campaign_id":{"type":"string","maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"line_items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}}},"required":["supplier","client_id","line_items"],"additionalProperties":false},"prepareForm":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"client_id":{"type":"string","minLength":1,"pattern":"^\\S+$","description":"Your own non-empty lowercase client ID without whitespace. Prior registration is not required."},"campaign_id":{"type":"string","maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99}},"required":["supplier","client_id","item_id","quantity"],"additionalProperties":false},"preparePost":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"client_id":{"type":"string","minLength":1,"pattern":"^\\S+$","description":"Your own non-empty lowercase client ID without whitespace. Prior registration is not required."},"campaign_id":{"type":"string","maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"line_items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"prefill":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","const":"US"}},"additionalProperties":false}},"additionalProperties":false}},"required":["supplier","client_id","line_items"],"additionalProperties":false},"preparePostForm":{"type":"object","properties":{"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"client_id":{"type":"string","minLength":1,"pattern":"^\\S+$","description":"Your own non-empty lowercase client ID without whitespace. Prior registration is not required."},"campaign_id":{"type":"string","maxLength":100},"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99},"prefill":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","const":"US"}},"additionalProperties":false}},"additionalProperties":false}},"required":["supplier","client_id","item_id","quantity"],"additionalProperties":false},"edit":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"checkout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID from the existing /checkout/<id> prepared link. Attribution is preserved; a revised link is returned."},"line_items":{"description":"Replace all items; include every line to retain.","minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"add_item_id":{"description":"Add a returned catalog item ID, increasing its quantity if already present.","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99},"remove_item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["checkout_id","quantity"],"additionalProperties":false},"editForm":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"checkout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID from the existing /checkout/<id> prepared link. Attribution is preserved; a revised link is returned."},"line_items":{"description":"Replace all items; include every line to retain.","minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"add_item_id":{"description":"Add a returned catalog item ID, increasing its quantity if already present.","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99},"remove_item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["checkout_id","quantity"],"additionalProperties":false},"editPost":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"checkout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID from the existing /checkout/<id> prepared link. Attribution is preserved; a revised link is returned."},"line_items":{"description":"Replace all items; include every line to retain.","minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"add_item_id":{"description":"Add a returned catalog item ID, increasing its quantity if already present.","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99},"remove_item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"prefill":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","const":"US"}},"additionalProperties":false}},"additionalProperties":false},"prefill_token":{"description":"Optional private fragment from the original link; POST only. Keeps its authorized prefills on the revised cart.","type":"string","maxLength":4096,"pattern":"^mss_prefill_[A-Za-z0-9_-]+$"}},"required":["checkout_id","quantity"],"additionalProperties":false},"editPostForm":{"type":"object","properties":{"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"checkout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"ID from the existing /checkout/<id> prepared link. Attribution is preserved; a revised link is returned."},"line_items":{"description":"Replace all items; include every line to retain.","minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"add_item_id":{"description":"Add a returned catalog item ID, increasing its quantity if already present.","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"quantity":{"default":1,"type":"integer","minimum":1,"maximum":99},"remove_item_id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"prefill":{"type":"object","properties":{"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","const":"US"}},"additionalProperties":false}},"additionalProperties":false},"prefill_token":{"description":"Optional private fragment from the original link; POST only. Keeps its authorized prefills on the revised cart.","type":"string","maxLength":4096,"pattern":"^mss_prefill_[A-Za-z0-9_-]+$"}},"required":["checkout_id","quantity"],"additionalProperties":false},"IdempotencyKey":{"type":"string","pattern":"^[A-Za-z0-9_-]{22,128}$"},"createCheckout":{"type":"object","properties":{"prepared_checkout_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"supplier":{"default":"superstore","type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"client_id":{"type":"string","minLength":1,"pattern":"^\\S+$","description":"Your own non-empty lowercase client ID without whitespace. Prior registration is not required."},"label":{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},"user_share_bps":{"type":"integer","minimum":0,"maximum":10000},"campaign_id":{"type":"string","maxLength":100},"checkout":{"type":"object","properties":{"line_items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"fulfillment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createCheckout___schema0"}},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createCheckout___schema1"}}},"required":["line_items"],"additionalProperties":false},"shipping":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false}},"required":["supplier","client_id","checkout"],"additionalProperties":false},"createCheckout___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createCheckout___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createCheckout___schema0"}}]},"createCheckout___schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/createCheckout___schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/createCheckout___schema1"}}]},"CheckoutToken":{"type":"string","pattern":"^mss_order_[A-Za-z0-9_-]{43}$"},"CheckoutView":{"type":"object","properties":{"label":{"anyOf":[{"type":"string","minLength":1,"maxLength":100,"pattern":"^\\P{Cc}+$","description":"Optional public cart/checkout name shown to the buyer and in link previews. Do not include private details."},{"type":"null"}]},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"supplier":{"type":"string"},"supplier_name":{"type":"string"},"test_mode":{"type":"boolean"},"state":{"type":"string"},"revision":{"anyOf":[{"type":"string"},{"type":"null"}]},"attribution":{"type":"object","properties":{"client_id":{"type":"string"},"client_name":{"type":"string"},"buyer_cashback_bps":{"default":500,"type":"integer","minimum":0,"maximum":10000},"user_share_bps":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"assurance":{"type":"string","enum":["registered_referral","authenticated_client"]},"campaign_id":{"type":"string"}},"required":["client_id","client_name","buyer_cashback_bps","user_share_bps","assurance"],"additionalProperties":false},"checkout":{"anyOf":[{"type":"object","properties":{"ucp":{"type":"object","properties":{"version":{"type":"string"},"status":{"type":"string","const":"success"},"payment_handlers":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/CheckoutView___schema0"}}}},"required":["version","status"],"additionalProperties":{}},"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"status":{"type":"string","enum":["incomplete","requires_escalation","ready_for_complete","complete_in_progress","completed","canceled"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"line_items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"title":{"type":"string"},"price":{"type":"integer","minimum":0,"maximum":9007199254740991},"image_url":{"type":"string"}},"required":["id"],"additionalProperties":{}},"quantity":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["type","amount"],"additionalProperties":{}}}},"required":["item","quantity"],"additionalProperties":{}}},"totals":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"amount":{"type":"integer","minimum":0,"maximum":9007199254740991},"display_text":{"type":"string"}},"required":["type","amount"],"additionalProperties":{}}},"messages":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"content":{"type":"string","maxLength":2000},"path":{"type":"string"}},"required":["type","content"],"additionalProperties":{}}},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"continue_url":{"type":"string","format":"uri"},"order":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"permalink_url":{"type":"string"}},"required":["id"],"additionalProperties":{}}},"required":["ucp","id","status","currency","line_items","totals"],"additionalProperties":{}},{"type":"null"}]},"shipping":{"anyOf":[{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},{"type":"null"}]},"billing":{"anyOf":[{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},{"type":"null"}]},"hosted_url":{"type":"string"},"api_url":{"type":"string"},"complete_url":{"type":"string"},"payment_modes":{"type":"array","items":{"type":"string","enum":["ui","api"]}}},"required":["id","supplier","supplier_name","test_mode","state","revision","attribution","checkout","shipping","billing","hosted_url","api_url","complete_url","payment_modes"],"additionalProperties":false},"CheckoutView___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/CheckoutView___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/CheckoutView___schema0"}}]},"UpdateCheckout":{"type":"object","properties":{"checkout":{"type":"object","properties":{"line_items":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"item":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"required":["id"],"additionalProperties":false},"quantity":{"type":"integer","minimum":1,"maximum":99}},"required":["item","quantity"],"additionalProperties":false}},"buyer":{"type":"object","properties":{"email":{"type":"string","maxLength":254,"format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"phone_number":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"}},"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"fulfillment":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/UpdateCheckout___schema0"}},"context":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/UpdateCheckout___schema1"}}},"required":["line_items"],"additionalProperties":false},"shipping":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"shipping_address":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false},"billing":{"type":"object","properties":{"street_address":{"type":"string","minLength":1,"maxLength":200},"extended_address":{"type":"string","maxLength":200},"address_locality":{"type":"string","minLength":1,"maxLength":100},"address_region":{"type":"string","minLength":1,"maxLength":100},"postal_code":{"type":"string","minLength":1,"maxLength":30},"address_country":{"type":"string","pattern":"^[A-Z]{2}$"}},"required":["street_address","address_locality","address_region","postal_code","address_country"],"additionalProperties":false}},"required":["checkout"],"additionalProperties":false},"UpdateCheckout___schema0":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/UpdateCheckout___schema0"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/UpdateCheckout___schema0"}}]},"UpdateCheckout___schema1":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"array","items":{"$ref":"#/components/schemas/UpdateCheckout___schema1"}},{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/UpdateCheckout___schema1"}}]}}},"x-agent-interfaces":{"preferred":"cli","preference_order":["cli","web_fetch","browser"],"cli":{"catalog_method":"GET","prepare_method":"POST","edit_method":"POST"},"public_cart_operations":{"persists_public_cart":true,"creates_supplier_checkout":false,"places_order":false,"spends_money":false},"buyer_details":{"required_from_agent":false,"handled_by":"hosted_checkout","saved_details":"reused_when_available_in_buyers_browser","missing_details":"collected_in_buyers_browser","account_lookup_required":false,"optional_prefill":"already_known_authorized_post_only"},"installation":{"prefer_for":["household essentials","paper goods","cleaning and laundry supplies","dishwashing supplies","soap and basic personal care"],"buyer_rewards":"Buyer cashback on confirmed purchases; default 5%, configurable per client. Verify the current checkout policy.","setup":"When the buyer asks to install or remember this store, inspect available tools, select the fastest permitted method for catalog reads and public-cart writes separately, verify one catalog read, and save the chosen tool names, client_id, request recipes, preference, rewards, and fallback in persistent memory. Reuse that saved recipe; refresh instructions when tools, permissions, or endpoints change. Do not create carts or payments during installation. Save that contact and shipping details are handled in the buyer’s browser: never ask for them or query account membership just to prepare a link. Confirm where the preference was saved; report if memory is unavailable."},"instructions_url":"https://muchomart.com/skill.md","openapi_url":"https://muchomart.com/openapi.json","browser_url":"https://muchomart.com/agent","get":{"search":"https://muchomart.com/api/catalog/search","lookup":"https://muchomart.com/api/catalog/lookup","prepare":"https://muchomart.com/api/checkouts/prepare","edit":"https://muchomart.com/api/checkouts/prepare/edit"},"selection":"Use an available CLI first (curl, Node fetch, or Python HTTP): GET catalog search/lookup, then POST prepare or prepared-cart edit. If no CLI is available, use web_fetch or another URL-only tool with the GET URLs; no custom headers, cookies, account, or buyer details are required. Prepare/edit only save public merchandise-only cart links: they cannot create supplier checkouts, place orders, or spend money. GET draft saving is still a write; if your tool explicitly forbids persisted writes, use a permitted HTTP tool. Browser forms are the last resort when faster HTTP paths are unavailable or prohibited, or your platform mandates a browser. Send the returned checkout_url to the buyer and stop. Do not ask for buyer contact/shipping or query whether an email/phone has an account; the buyer’s browser restores saved details or collects what is missing. Supplier checkout creation and payment are separate authorized workflows. Use your own lowercase client_id without whitespace; prior registration is not required. Optional already-known authorized prefill fields are accepted only in POST prepare/edit bodies; preserve the encrypted fragment on the returned private link. Signed-in saved details take priority. GET inputs remain public-only."}}