{
  "tool": "msc-agribusiness--water.gross_margin",
  "name": "Enterprise gross margin and break-evens (CDU-AGR-AGW-900)",
  "answers": "What gross margin does this enterprise earn, and at what yield or price does it only just cover its variable costs?",
  "degree": {
    "id": "competency:msc-agribusiness--water",
    "code": "CDU-AGR-AGW-900",
    "name": "MSc Agribusiness & Water",
    "version": "1.0.0"
  },
  "reference": "Farm-management enterprise budgeting (gross margin = output value − variable costs); Kay, Edwards & Duffy, Farm Management",
  "endpoint": "/faculty/msc-agribusiness--water/gross_margin",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "yieldPerHa",
      "pricePerUnit",
      "variableCostPerHa",
      "hectares"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "yieldPerHa": {
        "type": "number",
        "description": "Yield per hectare (t or units)",
        "minimum": 0.0001
      },
      "pricePerUnit": {
        "type": "number",
        "description": "Price per unit of yield",
        "minimum": 0.0001
      },
      "variableCostPerHa": {
        "type": "number",
        "description": "Variable costs per hectare",
        "minimum": 0
      },
      "hectares": {
        "type": "number",
        "description": "Area planted",
        "minimum": 0
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "revenuePerHa",
      "grossMarginPerHa",
      "totalGrossMargin",
      "breakevenYield",
      "breakevenPrice"
    ],
    "properties": {
      "revenuePerHa": {
        "type": "number",
        "description": "Yield × price"
      },
      "grossMarginPerHa": {
        "type": "number",
        "description": "Revenue − variable costs"
      },
      "totalGrossMargin": {
        "type": "number",
        "description": "Per-ha margin × hectares"
      },
      "breakevenYield": {
        "type": "number",
        "description": "Variable costs ÷ price"
      },
      "breakevenPrice": {
        "type": "number",
        "description": "Variable costs ÷ yield"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "yieldPerHa": 6.5,
    "pricePerUnit": 4200,
    "variableCostPerHa": 19500,
    "hectares": 120
  }
}