post_vouchers_batches

{
  "name": "post_vouchers_batches",
  "description": "POST /api/vouchers/batches — Creates an inventory batch and mints its vouchers in a single DAL transaction. The DAL enforces the voucher-pool balance and the per-organization allocation inside that same transaction, so an unaffordable batch is refused as a 400 rather than partially created. `type` is coerced by exact match: only the literal string `PHYSICAL` selects a physical batch and every other value yields `DIGITAL`. `unitValue` is honoured only when sent as a JSON number; anything else falls back to the service's unit-value policy. PRINTING IS DECIDED HERE, ONCE: a PHYSICAL batch is sent to the office printer AFTER it is committed when, and only when, `print` is `true`, using the codes the mint just returned. The batch stays committed whatever the printer does, and the response's `print` carries the TRUE outcome — a failure is reported there, never swallowed — while every voucher the print covered is recorded SUBMITTED or PRINT_FAILED. A SUBMITTED print ISSUES the vouchers it carried in that same write (paper exists, so they are live); a failed or skipped one leaves them unissued, and is sent again with `POST /api/vouchers/batches/{id}/print`. Requires `execute:CreateVoucherBatchCommand` — MINTING, which no organization is ever entitled to; platform staff are admitted as on every gate.\n\nThis changes data. The person is asked to confirm it before it runs, and nothing happens if they decline.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "body": {
        "type": "string",
        "description": "The JSON request body: { assignToOrgId: string (Organization the batch and its vouchers are assigned to.); expiresAt: integer or string (Expiry as epoch MILLISECONDS or a Date.parse-able string.); print: boolean (Print a PHYSICAL batch on the office printer as soon as it is minted.); procedure: string; quantity*: integer (Vouchers to mint.); serviceType: string; sex: string; species: string (Procedure-catalog binding.); type: one of \"DIGITAL\" | \"PHYSICAL\" (Anything but the literal `PHYSICAL` is treated as `DIGITAL`.); unitValue: integer (Face value per voucher in CENTS.) }"
      }
    },
    "required": [
      "body"
    ]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": false
  }
}