vyaparapp.in

{
  "name": "get_partner_form_state",
  "kind": "answer",
  "impl": "imperative",
  "description": "Reports the current position of the \"Become a Partner\" form: which of the 3 steps is on screen, what is already typed in, and the exact business types and business categories the dropdowns accept. Read-only — changes nothing. Call this before filling anything, and to check what happened after a step.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/distributor/create"
}

{
  "name": "fill_partner_contact",
  "kind": "act",
  "impl": "imperative",
  "description": "Types a name and phone number into step 1 of the partner form and stops there. Nothing is submitted, no OTP is sent, no lead is created — the person still has to press \"Register Now\" themselves. Use this when someone wants the form prepared for them to review.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "phone": {
        "type": "string",
        "description": "Mobile number. National form (\"9491065427\") or international (\"+919491065427\") both work."
      },
      "name": {
        "type": "string",
        "description": "Full name of the person applying. Optional — the form falls back to \"Unknown\"."
      },
      "country_code": {
        "type": "string",
        "description": "International dial code without +, e.g. 91, 971, 44 or 1. Any country offered by the page phone selector is allowed."
      },
      "country_iso": {
        "type": "string",
        "description": "Optional two-letter country code, e.g. in, ae, gb or us. Recommended when several countries share one dial code."
      }
    },
    "required": [
      "phone"
    ],
    "additionalProperties": false
  },
  "page": "/distributor/create"
}

{
  "name": "send_partner_otp",
  "kind": "transact",
  "impl": "imperative",
  "description": "Submits step 1 of the partner form. This SENDS A REAL OTP SMS to the number given and creates a real partner lead record at Vyapar — a salesperson may follow up. Only use it when the person has clearly asked to register as a Vyapar partner/distributor and has given their own number. On success the form moves to the OTP screen.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "phone": {
        "type": "string",
        "description": "Mobile number that will receive the OTP."
      },
      "name": {
        "type": "string",
        "description": "Full name of the person applying."
      },
      "country_code": {
        "type": "string",
        "description": "International dial code without +, e.g. 91, 971, 44 or 1. Any country offered by the page phone selector is allowed."
      },
      "country_iso": {
        "type": "string",
        "description": "Optional two-letter country code, e.g. in, ae, gb or us. Recommended when several countries share one dial code."
      },
      "restart": {
        "type": "boolean",
        "description": "Set true only if the form is already on the OTP screen and the number needs correcting — it goes back to step 1 first and requests a fresh OTP."
      }
    },
    "required": [
      "phone"
    ],
    "additionalProperties": false
  },
  "page": "/distributor/create"
}

{
  "name": "verify_partner_otp",
  "kind": "act",
  "impl": "imperative",
  "description": "Types the OTP the person received into step 2 of the partner form and submits it. Only call this with a code the person has actually read out — never a guess. On success the form moves to the business-details screen.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "otp": {
        "type": "string",
        "description": "The numeric code from the SMS, e.g. \"4821\"."
      }
    },
    "required": [
      "otp"
    ],
    "additionalProperties": false
  },
  "page": "/distributor/create"
}

{
  "name": "submit_partner_details",
  "kind": "transact",
  "impl": "imperative",
  "description": "Fills and submits step 3 — the final step — of the partner form: location pincode, business type and business category. This COMPLETES the partner application; the lead is finalised and the page may sign the person in and move them to the partner dashboard. Use the exact option strings reported by get_partner_form_state.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "pincode": {
        "type": "string",
        "description": "Area PIN code. Required for India; ignored for other countries."
      },
      "business_type": {
        "type": "string",
        "description": "One of the business_types from get_partner_form_state, e.g. \"Retail\", \"Distributor\"."
      },
      "business_category": {
        "type": "string",
        "description": "One of the business_categories from get_partner_form_state, e.g. \"Kirana/ General Merchant\"."
      },
      "preferred_language": {
        "type": "string",
        "description": "Only asked for outside India, e.g. \"English\", \"Arabic\"."
      },
      "emirate": {
        "type": "string",
        "description": "Required for UAE numbers only, e.g. \"Dubai\"."
      }
    },
    "additionalProperties": false
  },
  "page": "/distributor/create"
}