{"openapi":"3.1.0","info":{"title":"ReBill merchant agents","version":"1.1.0","description":"Commercial requests require Ali approval before setup. Payment is confirmed manually. Monetary output is integer minor units with an explicit currency and precision."},"servers":[{"url":"https://rebill-pos.com/agents/api/v1"}],"paths":{"/catalog":{"get":{"operationId":"get_product_catalog","summary":"get product catalog","security":[],"parameters":[],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action."},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/capabilities":{"get":{"operationId":"get_agent_capabilities","summary":"get agent capabilities","security":[],"parameters":[],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action."},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sessions":{"post":{"operationId":"create_commercial_session","summary":"create commercial session","security":[],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentName":{"type":"string"},"transport":{"enum":["cookie","bearer"]}},"required":[],"additionalProperties":false}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action."},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/fit-assessments":{"post":{"operationId":"assess_business_fit","summary":"assess business fit","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fit"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/FitResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes":{"post":{"operationId":"create_quote","summary":"create quote","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/QuoteResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/counteroffers":{"post":{"operationId":"negotiate_quote","summary":"negotiate quote","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteroffer"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/QuoteResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}/acceptance":{"post":{"operationId":"accept_quote","summary":"accept quote","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Acceptance"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/QuoteResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-submissions":{"post":{"operationId":"accept_and_submit_setup","summary":"accept and submit setup","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CombinedSubmission"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-requests":{"get":{"operationId":"list_setup_requests","summary":"list setup requests","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action."},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-drafts":{"post":{"operationId":"create_setup_draft","summary":"create setup draft","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-drafts/{id}":{"patch":{"operationId":"update_setup_draft","summary":"update setup draft","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftUpdate"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"get_setup_draft","summary":"get setup draft","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-drafts/{id}/submission":{"post":{"operationId":"submit_setup_request","summary":"submit setup request","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Submission"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/setup-requests/{id}":{"get":{"operationId":"get_setup_request_status","summary":"get setup request status","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/RequestResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{id}":{"get":{"operationId":"get_quote","summary":"get quote","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/QuoteResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/conversations":{"post":{"operationId":"create_conversation","summary":"create conversation","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationCreate"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/ConversationResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/conversations/{id}":{"get":{"operationId":"get_commercial_conversation","summary":"get commercial conversation","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/ConversationResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"operationId":"update_commercial_conversation","summary":"update commercial conversation","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationUpdate"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"$ref":"#/components/schemas/ConversationResult"}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/conversations/current":{"get":{"operationId":"get_current_commercial_conversation","summary":"get current commercial conversation","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[],"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"anyOf":[{"$ref":"#/components/schemas/ConversationResult"},{"type":"null"}]}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/conversations/{id}/messages":{"post":{"operationId":"send_commercial_message","summary":"send commercial message","security":[{"commercialBearer":[]},{"commercialCookie":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommercialMessage"}}}},"responses":{"200":{"description":"Result envelope: success=true, result contains IDs, revisions, states and next action.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"const":true},"result":{"anyOf":[{"$ref":"#/components/schemas/TurnResult"},{"$ref":"#/components/schemas/InProgress"}]}},"required":["success","result"],"additionalProperties":false}}}},"401":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Origin or permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Validation, requester or version conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate or inference cost limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Unavailable inference or paused submission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Outlet":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"tables":{"type":"integer","minimum":0},"address":{"type":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"timezone":{"type":"string"},"tablets":{"type":"integer"},"printers":{"type":"integer"},"comparableProfile":{"enum":["micro","small","medium","large","extended"]}},"required":["id","name","tables","address","country","timezone"],"additionalProperties":false},"Profile":{"type":"object","properties":{"businessName":{"type":"string"},"businessType":{"type":"string"},"narrative":{"type":"string"},"country":{"type":"string"},"language":{"enum":["en","id","de","es","fr","it","ms","fil","pt","th","vi"]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"cadence":{"enum":["monthly","annual"]},"outlets":{"type":"array","minItems":1,"maxItems":30,"items":{"$ref":"#/components/schemas/Outlet"}},"requirements":{"type":"array","items":{"type":"string"}},"requirementsConfirmed":{"type":"boolean"}},"required":["businessName","country","currency","cadence","outlets"],"additionalProperties":false},"Contact":{"type":"object","properties":{"name":{"type":"string"},"role":{"type":"string"},"email":{"type":"string","format":"email"},"phone":{"type":"string","pattern":"^\\+[1-9]\\d{7,14}$"},"phoneChannel":{"enum":["telephone","whatsapp","both"]},"preferredMethod":{"enum":["email","telephone","whatsapp"]},"preferredLanguage":{"type":"string"}},"required":["name","role","email","phone","phoneChannel","preferredMethod"],"additionalProperties":false},"Menu":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"string"}},"products":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"category":{"type":"string"},"salesPrice":{"type":"number","exclusiveMinimum":0}},"required":["name","category","salesPrice"],"additionalProperties":true}},"ingredients":{"type":"array","items":{"type":"object"}},"reviewed":{"type":"boolean"}},"required":["categories","products"],"additionalProperties":false},"Fit":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/Profile"}},"required":["profile"],"additionalProperties":false},"Quote":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/Profile"}},"required":["profile"],"additionalProperties":false},"Budget":{"type":"object","properties":{"amount":{"type":"number","exclusiveMinimum":0},"currency":{"type":"string"},"cadence":{"enum":["monthly","annual"]}},"required":["amount","currency","cadence"],"additionalProperties":false},"Commitments":{"type":"array","items":{"enum":["annual_upfront","ready_to_accept","multiple_outlets_confirmed"]},"maxItems":3},"Counteroffer":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1},"message":{"type":"string"},"budget":{"$ref":"#/components/schemas/Budget"},"commitments":{"$ref":"#/components/schemas/Commitments"},"counteroffer":{"type":"object","properties":{"annualTotal":{"type":"number","exclusiveMinimum":0}},"required":[],"additionalProperties":false}},"required":["expectedRevision"],"additionalProperties":false},"Acceptance":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1},"authorityConfirmed":{"const":true}},"required":["expectedRevision","authorityConfirmed"],"additionalProperties":false},"Draft":{"type":"object","properties":{"quoteId":{"type":"string","format":"uuid"},"profile":{"$ref":"#/components/schemas/Profile"},"contact":{"$ref":"#/components/schemas/Contact"},"menu":{"$ref":"#/components/schemas/Menu"},"customRequirements":{"type":"string"}},"required":["quoteId","profile","contact"],"additionalProperties":false},"CombinedSubmission":{"type":"object","properties":{"quoteId":{"type":"string","format":"uuid"},"expectedQuoteRevision":{"type":"integer","minimum":1},"profile":{"$ref":"#/components/schemas/Profile"},"contact":{"$ref":"#/components/schemas/Contact"},"menu":{"$ref":"#/components/schemas/Menu"},"customRequirements":{"type":"string"},"authorityConfirmed":{"const":true},"conversationId":{"type":"string","format":"uuid"},"expectedConversationRevision":{"type":"integer","minimum":1},"requestId":{"type":"string","format":"uuid"},"expectedRequestRevision":{"type":"integer","minimum":1}},"required":["quoteId","expectedQuoteRevision","profile","contact","authorityConfirmed"],"additionalProperties":false},"DraftUpdate":{"type":"object","properties":{"quoteId":{"type":"string","format":"uuid"},"profile":{"$ref":"#/components/schemas/Profile"},"contact":{"$ref":"#/components/schemas/Contact"},"menu":{"$ref":"#/components/schemas/Menu"},"customRequirements":{"type":"string"},"expectedRevision":{"type":"integer","minimum":1}},"required":["quoteId","profile","contact","expectedRevision"],"additionalProperties":false},"Submission":{"type":"object","properties":{"expectedRevision":{"type":"integer","minimum":1},"authorityConfirmed":{"const":true}},"required":["expectedRevision","authorityConfirmed"],"additionalProperties":false},"QuoteResult":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1},"state":{"type":"string"},"currency":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":4},"cadence":{"enum":["monthly","annual"]},"annualTotalMinor":{"type":"integer","minimum":0},"monthlyTotalMinor":{"type":"integer","minimum":0},"payableMinor":{"type":"integer","minimum":0},"lines":{"type":"array","items":{"type":"object","properties":{"outletId":{"type":"string"},"name":{"type":"string"},"band":{"type":"string"},"annualMinor":{"type":"integer","minimum":0},"monthlyMinor":{"type":"integer","minimum":0},"appliedOutletDiscount":{"type":"number","minimum":0}},"required":["outletId","name","band","annualMinor","monthlyMinor","appliedOutletDiscount"],"additionalProperties":true}},"issuedAt":{"type":"string"},"expiresAt":{"type":"string"},"acceptedAt":{"type":["string","null"]},"included":{"type":"array","items":{"type":"string"}},"excluded":{"type":"array","items":{"type":"string"}},"reviewConditions":{"type":"array","items":{"type":"string"}},"invoiceTax":{"type":"object"},"turnBudget":{"$ref":"#/components/schemas/TurnBudget"}},"required":["id","revision","state","currency","decimals","cadence","annualTotalMinor","monthlyTotalMinor","payableMinor","lines","issuedAt","expiresAt","acceptedAt","included","excluded","reviewConditions","invoiceTax"],"additionalProperties":true},"FitResult":{"type":"object","properties":{"catalogVersion":{"type":"string"},"supported":{"type":"array","items":{"type":"string"}},"conditional":{"type":"array","items":{"type":"string"}},"gaps":{"type":"array","items":{"type":"string"}},"confirmedRequirements":{"type":"array","items":{"type":"string"}},"needsConfirmation":{"type":"boolean"},"questions":{"type":"array","items":{"type":"string"}},"limitations":{"type":"array","items":{"type":"string"}},"bandRationale":{"type":"array","items":{"type":"object"}}},"required":["catalogVersion","supported","conditional","gaps","confirmedRequirements","needsConfirmation","questions","limitations","bandRationale"],"additionalProperties":true},"Completeness":{"type":"object","properties":{"readyForApproval":{"type":"boolean"},"missingItems":{"type":"array","items":{"type":"string"}},"productCount":{"type":"integer"},"menuReviewed":{"type":"boolean"}},"required":["readyForApproval","missingItems","productCount","menuReviewed"],"additionalProperties":true},"SupportReview":{"type":"object","properties":{"conditions":{"type":"array","items":{"type":"string"}},"customRequirements":{"type":"string"},"requiresHumanReview":{"type":"boolean"},"invoiceTax":{"type":"object"}},"required":["conditions","customRequirements","requiresHumanReview","invoiceTax"],"additionalProperties":true},"Receipt":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/Profile"},"contact":{"$ref":"#/components/schemas/Contact"},"fitAssessment":{"$ref":"#/components/schemas/FitResult"},"completeness":{"$ref":"#/components/schemas/Completeness"},"quote":{"anyOf":[{"$ref":"#/components/schemas/QuoteResult"},{"type":"null"}]},"menu":{"type":"object"},"customRequirements":{"type":"string"},"supportReview":{"$ref":"#/components/schemas/SupportReview"}},"required":["profile","contact","fitAssessment","completeness","quote","menu","customRequirements","supportReview"],"additionalProperties":true},"RequestResult":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1},"state":{"type":"string"},"billingState":{"type":"string"},"businessName":{"type":"string"},"quoteId":{"type":"string","format":"uuid"},"receipt":{"$ref":"#/components/schemas/Receipt"},"completeness":{"$ref":"#/components/schemas/Completeness"},"nextAction":{"type":"string"},"nextActionActor":{"type":"string"},"primaryTimezone":{"type":"string"},"notificationStates":{"type":"object"}},"required":["id","revision","state","billingState","businessName","quoteId","receipt","completeness","nextAction","nextActionActor","primaryTimezone","notificationStates"],"additionalProperties":true},"ConversationCreate":{"type":"object","properties":{"profile":{"$ref":"#/components/schemas/Profile"},"quoteId":{"type":"string","format":"uuid"}},"required":["profile"],"additionalProperties":false},"ConversationUpdate":{"type":"object","properties":{"expectedConversationRevision":{"type":"integer","minimum":1},"profile":{"$ref":"#/components/schemas/Profile"},"setupDetails":{"type":"object","properties":{"contact":{"type":"object"},"menu":{"$ref":"#/components/schemas/Menu"},"customRequirements":{"type":"string"}},"additionalProperties":false},"setupRequestId":{"type":"string","format":"uuid"}},"required":["expectedConversationRevision"],"additionalProperties":false},"CommercialMessage":{"type":"object","properties":{"expectedConversationRevision":{"type":"integer","minimum":1},"quoteId":{"type":"string","format":"uuid"},"expectedQuoteRevision":{"type":"integer","minimum":1},"message":{"type":"string"},"budget":{"$ref":"#/components/schemas/Budget"},"commitments":{"$ref":"#/components/schemas/Commitments"}},"required":["expectedConversationRevision"],"additionalProperties":false},"ConversationResult":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1},"profile":{"$ref":"#/components/schemas/Profile"},"quote":{"$ref":"#/components/schemas/QuoteResult"},"fitAssessment":{"$ref":"#/components/schemas/FitResult"},"supportReview":{"$ref":"#/components/schemas/SupportReview"},"history":{"type":"array","items":{"type":"object"}},"suggestedRequirements":{"type":"array","items":{"type":"string"}},"setupDetails":{"type":["object","null"]},"pendingTurn":{"type":["object","null"]},"turnBudget":{"$ref":"#/components/schemas/TurnBudget"}},"required":["id","revision","profile","quote","fitAssessment"],"additionalProperties":true},"TurnResult":{"type":"object","properties":{"state":{"enum":["completed","conflict"]},"turnId":{"type":"string","format":"uuid"},"conversationId":{"type":"string","format":"uuid"},"conversationRevision":{"type":"integer","minimum":1},"reply":{"type":"string"},"quote":{"$ref":"#/components/schemas/QuoteResult"},"decision":{"type":"object"},"suggestedRequirements":{"type":"array","items":{"type":"string"}},"factQuestions":{"type":"array","items":{"type":"string"}},"fitAssessment":{"$ref":"#/components/schemas/FitResult"},"inferenceError":{"type":["string","null"]}},"required":["state","turnId","conversationId","conversationRevision","reply","quote","decision","suggestedRequirements","factQuestions","fitAssessment","inferenceError"],"additionalProperties":true},"TurnBudget":{"type":"object","properties":{"limit":{"type":"integer","const":20},"used":{"type":"integer","minimum":0},"remaining":{"type":"integer","minimum":0}},"required":["limit","used","remaining"],"additionalProperties":true},"InProgress":{"type":"object","properties":{"state":{"const":"in_progress"},"turnId":{"type":"string","format":"uuid"},"conversationId":{"type":"string","format":"uuid"}},"required":["state","turnId","conversationId"],"additionalProperties":true},"Error":{"type":"object","properties":{"success":{"const":false},"error":{"type":"object","properties":{"code":{"type":"string"},"details":{"type":"object"}},"required":["code"],"additionalProperties":false}},"required":["success","error"],"additionalProperties":false}},"securitySchemes":{"commercialBearer":{"type":"http","scheme":"bearer"},"commercialCookie":{"type":"apiKey","in":"cookie","name":"rebill_agent_session"}}}}