bahi.naklitechie.com

{
  "type": "object",
  "properties": {
    "vendorId": {
      "type": "integer",
      "minimum": 1,
      "description": "Vendor id from list_vendors."
    },
    "billNumber": {
      "type": "string",
      "maxLength": 60,
      "description": "The vendor's own document number."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "maxItems": 500,
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "quantity": {
            "type": "number",
            "exclusiveMinimum": 0,
            "description": "A number of units, not paise."
          },
          "rate": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Price per unit in integer paise (₹150.00 = 15000)."
          },
          "taxRate": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "GST rate as a decimal fraction: 0.18 for 18%. Passing 18 is refused."
          },
          "hsnSac": {
            "type": [
              "string",
              "null"
            ]
          },
          "itemId": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "Item id from list_items. Links the line to the item master and its stock."
          },
          "cess": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Cess in integer paise. null derives it from the HSN table."
          }
        },
        "required": [
          "description",
          "quantity",
          "rate"
        ]
      }
    },
    "billDate": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Defaults to today."
    },
    "internalRef": {
      "type": "string",
      "maxLength": 60,
      "description": "Generated when omitted."
    },
    "placeOfSupply": {
      "type": "string",
      "maxLength": 8,
      "pattern": "^[A-Z]{2}$"
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "reverseCharge": {
      "type": "boolean",
      "default": false
    },
    "itcEligible": {
      "type": "boolean",
      "default": true
    },
    "aiAssisted": {
      "type": "boolean",
      "default": false,
      "description": "Set by the person's own Smart Capture when it drafted this purchase."
    },
    "agentName": {
      "type": "string",
      "maxLength": 60,
      "pattern": "^[A-Za-z0-9._-]{1,60}$",
      "description": "Your name for the audit log: the actor becomes agent:<agentName>. Letters, digits, dot, dash and underscore only."
    }
  },
  "required": [
    "vendorId",
    "billNumber",
    "lines"
  ],
  "additionalProperties": false
}