{
 "openapi": "3.1.0",
 "info": {
  "title": "Purchase Order Types (Supply Chain)",
  "version": "20261030b",
  "description": "What each kind of purchase order does: its own numbers, the warehouse and payment terms it starts with, whether it needs approval, whether it is received, and the invoice matching it needs. Orders of no type behave as they always have."
 },
 "servers": [
  {
   "url": "https://{tenant}.tranxact.ai",
   "variables": {
    "tenant": {
     "default": "demo"
    }
   }
  }
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {
   "po-types": {
    "type": "object",
    "required": [
     "code",
     "name"
    ],
    "properties": {
     "id": {
      "type": "string",
      "format": "uuid",
      "description": "Id",
      "readOnly": true
     },
     "org_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org id",
      "readOnly": true
     },
     "code": {
      "type": "string",
      "description": "Code"
     },
     "name": {
      "type": "string",
      "description": "Name"
     },
     "kind": {
      "type": "string",
      "description": "Kind",
      "enum": [
       "standard",
       "blanket",
       "release",
       "subcontract",
       "return",
       "service",
       "consignment"
      ]
     },
     "number_prefix": {
      "type": "string",
      "description": "Number prefix"
     },
     "number_digits": {
      "type": "integer",
      "description": "Digits in the number"
     },
     "next_number": {
      "type": "string",
      "format": "decimal",
      "description": "Next number"
     },
     "default_warehouse_id": {
      "type": "string",
      "format": "uuid",
      "description": "Default warehouse"
     },
     "default_payment_terms_id": {
      "type": "string",
      "format": "uuid",
      "description": "Default payment terms"
     },
     "approval_mode": {
      "type": "string",
      "description": "Approval",
      "enum": [
       "By the company’s approval rules",
       "No approval needed"
      ]
     },
     "receipt_mode": {
      "type": "string",
      "description": "Goods receipt",
      "enum": [
       "Received as goods",
       "Not received (a service, invoiced to the order)"
      ]
     },
     "invoice_matching": {
      "type": "string",
      "description": "Invoice matching",
      "enum": [
       "As the item, supplier or company says",
       "Two-way (order and invoice)",
       "Three-way (order, receipt and invoice)",
       "No matching"
      ]
     },
     "is_default": {
      "type": "boolean",
      "description": "Default type for new orders"
     },
     "is_active": {
      "type": "boolean",
      "description": "Active"
     },
     "description": {
      "type": "string",
      "description": "Description"
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Created at",
      "readOnly": true
     },
     "created_by": {
      "type": "string",
      "format": "uuid",
      "description": "Created by",
      "readOnly": true
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Updated at",
      "readOnly": true
     },
     "updated_by": {
      "type": "string",
      "format": "uuid",
      "description": "Updated by",
      "readOnly": true
     },
     "xf_text_1": {
      "type": "string",
      "description": "Xf text 1",
      "readOnly": true
     },
     "xf_text_2": {
      "type": "string",
      "description": "Xf text 2",
      "readOnly": true
     },
     "xf_text_3": {
      "type": "string",
      "description": "Xf text 3",
      "readOnly": true
     },
     "xf_text_4": {
      "type": "string",
      "description": "Xf text 4",
      "readOnly": true
     },
     "xf_text_5": {
      "type": "string",
      "description": "Xf text 5",
      "readOnly": true
     },
     "xf_num_1": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 1",
      "readOnly": true
     },
     "xf_num_2": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 2",
      "readOnly": true
     },
     "xf_num_3": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 3",
      "readOnly": true
     },
     "xf_date_1": {
      "type": "string",
      "format": "date",
      "description": "Xf date 1",
      "readOnly": true
     },
     "xf_date_2": {
      "type": "string",
      "format": "date",
      "description": "Xf date 2",
      "readOnly": true
     }
    }
   }
  }
 },
 "security": [
  {
   "bearer": []
  }
 ],
 "paths": {
  "/api/scm/po-types": {
   "get": {
    "summary": "list po-types",
    "operationId": "list_po_types_0_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "create po-types",
    "operationId": "create_po_types_1_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/scm/po-types/{id}": {
   "get": {
    "summary": "get po-types",
    "operationId": "get_po_types_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "put": {
    "summary": "change po-types",
    "operationId": "change_po_types_1_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "delete po-types",
    "operationId": "delete_po_types_2_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/scm/po-types/{id}/copy": {
   "post": {
    "summary": "Copy",
    "operationId": "action_po_types_0_6",
    "description": "Body keys: overrides, preview, withLines",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  }
 }
}