bahi.naklitechie.com

{
  "type": "object",
  "properties": {
    "customerId": {
      "type": "integer",
      "minimum": 1,
      "description": "Customer id from list_customers."
    },
    "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."
          },
          "discount": {
            "type": "integer",
            "minimum": 0,
            "maximum": 2147483647,
            "description": "Line discount in integer paise."
          }
        },
        "required": [
          "description",
          "quantity",
          "rate"
        ]
      }
    },
    "invoiceDate": {
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Defaults to today."
    },
    "invoiceNumber": {
      "type": "string",
      "maxLength": 60,
      "description": "Generated from the series when omitted."
    },
    "series": {
      "type": "string",
      "maxLength": 60,
      "description": "Invoice series; defaults to Domestic."
    },
    "placeOfSupply": {
      "type": "string",
      "maxLength": 8,
      "pattern": "^[A-Z]{2}$",
      "description": "Two-letter state code; defaults to the customer's state."
    },
    "notes": {
      "type": "string",
      "maxLength": 2000
    },
    "isComposition": {
      "type": "boolean",
      "default": false
    },
    "advanceAllocations": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object",
        "properties": {
          "advanceId": {
            "type": "integer",
            "minimum": 1
          },
          "amount": {
            "type": "integer",
            "minimum": 1,
            "description": "Integer paise of the advance to adjust against this invoice."
          }
        },
        "required": [
          "advanceId",
          "amount"
        ]
      },
      "description": "Open advances of this customer to adjust against the invoice; see list_advances."
    },
    "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": [
    "customerId",
    "lines"
  ],
  "additionalProperties": false
}