{
  "description": "臺灣健保署基礎實作指引(TWNHIBASE IG)伺服端(Server)之能力聲明",
  "_filename": "CapabilityStatement-CapabilityStatementTWNHIBASEServer.json",
  "package_name": "tw.gov.mohw.nhi.base",
  "format": [ "application/fhir+json", "application/fhir+xml" ],
  "date": "2025-11-07",
  "publisher": "衛生福利部中央健康保險署",
  "patchFormat": [ "application/json-patch+json" ],
  "fhirVersion": "4.0.1",
  "name": "CapabilityStatementTWNHIBASEServer",
  "type": null,
  "experimental": "false",
  "resourceType": "CapabilityStatement",
  "title": "臺灣健保署基礎-伺服端(TWNHIBASE Server)",
  "package_version": "1.0.0",
  "status": "active",
  "id": "3d231f39-ecbc-4a59-b1b6-d677fcca301c",
  "kind": "requirements",
  "implementationGuide": [ "https://nhicore.nhi.gov.tw/base/ImplementationGuide/tw.gov.mohw.nhi.base" ],
  "url": "https://nhicore.nhi.gov.tw/base/CapabilityStatement/CapabilityStatementTWNHIBASEServer",
  "version": "1.0.0",
  "contact": [ {
    "name": "衛生福利部中央健康保險署",
    "telecom": [ {
      "value": "https://www.nhi.gov.tw",
      "system": "url"
    } ]
  } ],
  "rest": [ {
    "mode": "server",
    "resource": [ {
      "type": "Claim",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Claim-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "searchParam": [ {
        "name": "patient",
        "type": "reference",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ],
        "definition": "https://nhicore.nhi.gov.tw/base/SearchParameter/Claim-patient"
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "Organization",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "referencePolicy": [ "resolves" ],
      "supportedProfile": [ "https://nhicore.nhi.gov.tw/base/StructureDefinition/Organization-twnhibase", "https://nhicore.nhi.gov.tw/base/StructureDefinition/Organization-gene-twnhibase", "https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Organization-govt-twcore" ]
    }, {
      "type": "Patient",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Patient-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "searchParam": [ {
        "name": "name",
        "type": "string",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ],
        "definition": "https://nhicore.nhi.gov.tw/base/SearchParameter/Patient-name"
      }, {
        "name": "identifier",
        "type": "token",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ],
        "definition": "https://nhicore.nhi.gov.tw/base/SearchParameter/Patient-identifier"
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "Practitioner",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Practitioner-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHALL"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHALL"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHALL"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHALL"
        } ]
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "Observation",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Observation-diagnostic-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "Specimen",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Specimen-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "DocumentReference",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/DocumentReference-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "referencePolicy": [ "resolves" ]
    }, {
      "type": "Coverage",
      "profile": "https://nhicore.nhi.gov.tw/base/StructureDefinition/Coverage-twnhibase",
      "interaction": [ {
        "code": "create",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "read",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "vread",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      }, {
        "code": "update",
        "extension": [ {
          "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
          "valueCode": "SHOULD"
        } ]
      } ],
      "referencePolicy": [ "resolves" ]
    } ],
    "security": {
      "service": [ {
        "coding": [ {
          "code": "SMART-on-FHIR",
          "system": "http://terminology.hl7.org/CodeSystem/restful-security-service"
        } ]
      } ],
      "description": "Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求。"
    },
    "interaction": [ {
      "code": "transaction",
      "extension": [ {
        "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
        "valueCode": "SHOULD"
      } ]
    }, {
      "code": "batch",
      "extension": [ {
        "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
        "valueCode": "SHOULD"
      } ]
    } ],
    "documentation": "臺灣健保署基礎-伺服端(TWNHIBASE Server)必須(SHALL)：(1)支援本實作指引中所有profiles (2)根據FHIR規範實作RESTful (3)回傳狀態碼-①(Status 400)：無效參數(invalid parameter)、②(Status 401/4xx)：未經授權的請求(unauthorized request)、③(Status 403)：未充分授權的資料存取範圍(insufficient premission scope)、④(Status 404)：未知的resource(unknown resource) (4)支援JSON格式 (5)可識別每個新增到Server的實例(instance)之meta.profile是否為臺灣健保署基礎Profiles Defining URL，並確認實例是否依循Profile製作。臺灣健保署基礎-伺服端建議應該(SHOULD)：(1)支援XML格式。"
  } ]
}