{
 "openapi": "3.1.0",
 "info": {
  "title": "ZATCA Archive (Accounting)",
  "version": "20261030b",
  "description": "Every stamped document as issued, every document ZATCA cleared, and every answer ZATCA gave, with the SHA-256 of what was kept. Append-only: the database refuses any change or removal, except the retention purge of records older than the company’s retention (at least six years, the KSA VAT record-keeping period)."
 },
 "servers": [
  {
   "url": "https://{tenant}.tranxact.ai",
   "variables": {
    "tenant": {
     "default": "demo"
    }
   }
  }
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {
   "zatca-archive": {
    "type": "object",
    "required": [],
    "properties": {
     "id": {
      "type": "string",
      "format": "uuid",
      "description": "Id",
      "readOnly": true
     },
     "org_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org id",
      "readOnly": true
     },
     "org_unit_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org unit id",
      "readOnly": true
     },
     "invoice_id": {
      "type": "string",
      "format": "uuid",
      "description": "Invoice id",
      "readOnly": true
     },
     "invoice_no": {
      "type": "string",
      "description": "Invoice no",
      "readOnly": true
     },
     "kind": {
      "type": "string",
      "description": "Kind",
      "readOnly": true
     },
     "zatca_uuid": {
      "type": "string",
      "format": "uuid",
      "description": "Zatca uuid",
      "readOnly": true
     },
     "icv": {
      "type": "string",
      "format": "decimal",
      "description": "Icv",
      "readOnly": true
     },
     "invoice_hash": {
      "type": "string",
      "description": "Invoice hash",
      "readOnly": true
     },
     "previous_invoice_hash": {
      "type": "string",
      "description": "Previous invoice hash",
      "readOnly": true
     },
     "zatca_status": {
      "type": "string",
      "description": "Zatca status",
      "readOnly": true
     },
     "egs_unit_id": {
      "type": "string",
      "format": "uuid",
      "description": "Egs unit id",
      "readOnly": true
     },
     "issued_at": {
      "type": "string",
      "format": "date-time",
      "description": "Issued at",
      "readOnly": true
     },
     "content": {
      "type": "string",
      "description": "Content",
      "readOnly": true
     },
     "content_sha256": {
      "type": "string",
      "description": "Content sha256",
      "readOnly": true
     },
     "archived_at": {
      "type": "string",
      "format": "date-time",
      "description": "Archived at",
      "readOnly": true
     },
     "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/accounting/zatca-archive": {
   "get": {
    "summary": "list zatca-archive",
    "operationId": "list_zatca_archive_0_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Post zatca archive",
    "operationId": "action_zatca_archive_1_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/accounting/zatca-archive/{id}": {
   "get": {
    "summary": "get zatca-archive",
    "operationId": "get_zatca_archive_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "put": {
    "summary": "Put zatca archive",
    "operationId": "action_zatca_archive_1_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "Delete zatca archive",
    "operationId": "action_zatca_archive_2_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/accounting/zatca-archive/{id}/download": {
   "get": {
    "summary": "Download",
    "operationId": "action_zatca_archive_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/accounting/zatca-archive/{id}/copy": {
   "post": {
    "summary": "Copy",
    "operationId": "action_zatca_archive_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"
     }
    }
   }
  }
 }
}