FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagetz.nhif.zhsf.claims
Resource TypeImplementationGuide
IdImplementationGuide-tz.nhif.zhsf.claims.json
FHIR VersionR5
Sourcehttps://build.fhir.org/ig/Speedykom/tanzania-nhif-zhsf-claims-ig/index.html
URLhttps://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/ImplementationGuide/tz.nhif.zhsf.claims
Version0.1.0
Statusactive
Date2026-01-11
NameTanzaniaNHIFZHSFClaimsIG
TitleTanzania NHIF → ZHSF Claims Submission FHIR IG
DescriptionThis Implementation Guide defines the FHIR R5 facade contract for submitting health insurance claims from NHIF systems to ZHSF, including logical models, profiles, examples, and StructureMaps for transformation and validation.

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: ImplementationGuide tz.nhif.zhsf.claims

TanzaniaNHIFZHSFClaimsIG

The official URL for this implementation guide is:

https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/ImplementationGuide/tz.nhif.zhsf.claims

This Implementation Guide defines the FHIR R5 facade contract for submitting health insurance claims from NHIF systems to ZHSF, including logical models, profiles, examples, and StructureMaps for transformation and validation.


Source1

{
  "resourceType": "ImplementationGuide",
  "id": "tz.nhif.zhsf.claims",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/ImplementationGuide/tz.nhif.zhsf.claims",
  "version": "0.1.0",
  "name": "TanzaniaNHIFZHSFClaimsIG",
  "title": "Tanzania NHIF → ZHSF Claims Submission FHIR IG",
  "status": "active",
  "date": "2026-01-11",
  "publisher": "Speedykom GmbH",
  "contact": [
    {
      "name": "Speedykom GmbH",
      "telecom": [
        {
          "system": "url",
          "value": "https://www.speedykom.de"
        }
      ]
    },
    {
      "name": "Ahmed Amri",
      "telecom": [
        {
          "system": "email",
          "value": "ahmed.amri@speedykom.de",
          "use": "work"
        }
      ]
    }
  ],
  "description": "This Implementation Guide defines the FHIR R5 facade contract for submitting health insurance claims from NHIF systems to ZHSF, including logical models, profiles, examples, and StructureMaps for transformation and validation.\n",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "TZ",
          "display": "Tanzania"
        }
      ]
    }
  ],
  "packageId": "tz.nhif.zhsf.claims",
  "license": "CC-BY-4.0",
  "fhirVersion": [
    "5.0.0"
  ],
  "dependsOn": [
    {
      "id": "hl7tx",
      "extension": [
        {
          "url": "http://hl7.org/fhir/tools/StructureDefinition/implementationguide-dependency-comment",
          "valueMarkdown": "Automatically added as a dependency - all IGs depend on HL7 Terminology"
        }
      ],
      "uri": "http://terminology.hl7.org/ImplementationGuide/hl7.terminology",
      "packageId": "hl7.terminology.r5",
      "version": "7.0.1"
    },
    {
      "id": "hl7_fhir_uv_tools_r5",
      "uri": "http://hl7.org/fhir/tools",
      "packageId": "hl7.fhir.uv.tools.r5",
      "version": "0.9.0"
    },
    {
      "id": "hl7_fhir_uv_extensions_r5",
      "uri": "http://hl7.org/fhir/extensions/ImplementationGuide/hl7.fhir.uv.extensions",
      "packageId": "hl7.fhir.uv.extensions.r5",
      "version": "5.2.0"
    }
  ],
  "definition": {
    "resource": [
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "Claim"
          }
        ],
        "reference": {
          "reference": "Claim/TZClaimExample"
        },
        "name": "Example TZ Claim",
        "isExample": true,
        "profile": [
          "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/StructureDefinition/tz-claim"
        ]
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/implementationguide-resource-format",
            "valueCode": "application/fhir+json"
          },
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "Binary"
          }
        ],
        "reference": {
          "reference": "Binary/TZClaimSubmissionErrorResponseExample"
        },
        "name": "Example ZHSF Claim Submission Error Response",
        "isExample": true,
        "profile": [
          "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/StructureDefinition/tz-claim-submission-error-response"
        ]
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/implementationguide-resource-format",
            "valueCode": "application/fhir+json"
          },
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "Binary"
          }
        ],
        "reference": {
          "reference": "Binary/TZClaimSubmissionRequestExample"
        },
        "name": "Example ZHSF Claim Submission Request",
        "isExample": true,
        "profile": [
          "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/StructureDefinition/tz-claim-submission-request"
        ]
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/implementationguide-resource-format",
            "valueCode": "application/fhir+json"
          },
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "Binary"
          }
        ],
        "reference": {
          "reference": "Binary/TZClaimSubmissionSuccessResponseExample"
        },
        "name": "Example ZHSF Claim Submission Success Response",
        "isExample": true,
        "profile": [
          "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/StructureDefinition/tz-claim-submission-success-response"
        ]
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:logical"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-claim-submission-error-response"
        },
        "name": "TZ Claim Submission Error Response (ZHSF JSON)",
        "description": "Logical model representing an error response returned by ZHSF\nwhen a claim submission fails validation or processing.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:logical"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-claim-submission-request"
        },
        "name": "TZ Claim Submission Request (ZHSF JSON)",
        "description": "Logical model representing the ZHSF Claim Submission JSON request payload.\nThis model defines the facade contract and is validated before transformation\nto FHIR R5 resources.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:logical"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-claim-submission-success-response"
        },
        "name": "TZ Claim Submission Success Response (ZHSF JSON)",
        "description": "Logical model representing a successful ZHSF claim submission response.\nReturned when a claim is accepted and registered by ZHSF.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureMap"
          }
        ],
        "reference": {
          "reference": "StructureMap/TZClaimSubmissionToClaim"
        },
        "name": "TZ Claim Submission → FHIR Claim",
        "description": "Transforms the proprietary NHIF claim submission request into a FHIR R5 Claim resource for ZHSF processing.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:resource"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-encounter"
        },
        "name": "TZ Encounter",
        "description": "Encounter associated with a claim.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:resource"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-organization"
        },
        "name": "TZ Healthcare Facility",
        "description": "Organization representing an NHIF/ZHSF healthcare facility.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:resource"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-claim"
        },
        "name": "TZ NHIF → ZHSF Claim",
        "description": "FHIR Claim resource representing a claim submitted from NHIF facilities\nto ZHSF. Used as the primary target of the facade transformation.",
        "isExample": false
      },
      {
        "extension": [
          {
            "url": "http://hl7.org/fhir/tools/StructureDefinition/resource-information",
            "valueString": "StructureDefinition:resource"
          }
        ],
        "reference": {
          "reference": "StructureDefinition/tz-patient"
        },
        "name": "TZ Patient",
        "description": "Patient involved in a claim submission.",
        "isExample": false
      }
    ],
    "page": {
      "sourceUrl": "toc.html",
      "name": "toc.html",
      "title": "Table of Contents",
      "generation": "html",
      "page": [
        {
          "sourceUrl": "index.html",
          "name": "index.html",
          "title": "Home",
          "generation": "markdown"
        },
        {
          "sourceUrl": "changes.html",
          "name": "changes.html",
          "title": "Changes",
          "generation": "html"
        },
        {
          "sourceUrl": "usecase.html",
          "name": "usecase.html",
          "title": "Usecase",
          "generation": "markdown"
        }
      ]
    },
    "parameter": [
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "copyrightyear"
        },
        "value": "2026+"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "releaselabel"
        },
        "value": "ci-build"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/maps"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-pages"
        },
        "value": "input/pagecontent"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "autoload-resources"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/capabilities"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/examples"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/extensions"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/models"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/operations"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/profiles"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/resources"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/vocabulary"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/testing"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "input/history"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-resource"
        },
        "value": "fsh-generated/resources"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-pages"
        },
        "value": "template/config"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-pages"
        },
        "value": "input/images"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-liquid"
        },
        "value": "template/liquid"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-liquid"
        },
        "value": "input/liquid"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-qa"
        },
        "value": "temp/qa"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-temp"
        },
        "value": "temp/pages"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-output"
        },
        "value": "output"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/guide-parameter-code",
          "code": "path-tx-cache"
        },
        "value": "input-cache/txcache"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-suppressed-warnings"
        },
        "value": "input/ignoreWarnings.txt"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "path-history"
        },
        "value": "https://build.fhir.org/ig/speedykom/tanzania-nhif-zhsf-claims-ig/history.html"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "template-html"
        },
        "value": "template-page.html"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "template-md"
        },
        "value": "template-page-md.html"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-contact"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-context"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-copyright"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-jurisdiction"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-license"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-publisher"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-version"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "apply-wg"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "active-tables"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "fmm-definition"
        },
        "value": "http://hl7.org/fhir/versions.html#maturity"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "propagate-status"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "excludelogbinaryformat"
        },
        "value": "true"
      },
      {
        "code": {
          "system": "http://hl7.org/fhir/tools/CodeSystem/ig-parameters",
          "code": "tabbed-snapshots"
        },
        "value": "true"
      }
    ]
  }
}