omakei/laravel-nhif

一个用于将坦桑尼亚国家卫生保险基金（NHIF）与医院管理系统集成的Laravel包。

维护者

详细信息

github.com/omakei/laravel-nhif

主页

源代码

问题

安装: 10

依赖项: 0

建议者: 0

安全性: 0

星星: 8

关注者: 2

分支: 4

开放性问题: 2

2.0.0 2023-03-21 12:13 UTC

Requires

Requires (Dev)

MIT a5db86ea94fe6cde4a996daf59bf27faa2c49b8b

  • omakei <omakei96.woop@gmail.com>

laravelOmakeilaravel-nhif

This package is auto-updated.

Last update: 2024-09-24 04:09:59 UTC

README

NextSMS Logo

Laravel NHIF

一个用于将坦桑尼亚国家卫生保险基金（NHIF）与医院管理系统集成的Laravel包。

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

安装

您可以通过composer安装此包

composer require omakei/laravel-nhif

您可以使用以下命令发布配置文件

php artisan vendor:publish --tag="laravel-nhif-config"

以下密钥必须在您的.env文件中可用

NHIF_USERNAME=
NHIF_PASSWORD=

这是已发布的配置文件内容

return [

    'credentials' => [
        'username' => env('NHIF_USERNAME', ''),
        'password' => env('NHIF_PASSWORD', ''),
    ],
    'mode' => 'test', //it maybe test or production
    'url' => [
        'test' => 'http://196.13.105.15/nhifservice/breeze/',
        'production' => 'https://verification.nhif.or.tz/nhifservice/breeze/',
        'token' => 'https://verification.nhif.or.tz/nhifservice/Token/',
        'tariffs' => 'https://verification.nhif.or.tz/claimsserver/api/v1/Packages/',
        'claim' => 'https://verification.nhif.or.tz/claimsserver/api/v1/claims/SubmitFolios',
        'claim_submitted' => 'https://verification.nhif.or.tz/claimsServer/api/v1/claims/getSubmittedClaims',
        'referral' => 'https://verification.nhif.or.tz/nhifservice/breeze/verification/AddReferral',
        'pre_approved' => 'https://verification.nhif.or.tz/nhifservice/breeze/verification/GetReferenceNoStatus',
    ],
];

用法

验证成员与NHIF的关系

$response = LaravelNHIF::verifyMember(card_number:'12344554', visit_type_id:1, referral_number:'', remarks:'verification');
// response payload structure
{
    "CardNo": "01-nhif241",
    "CardStatus": "Active",
    "FirstName": "Amour",
    "MiddleName": "R",
    "LastName": "Hamad",
    "FullName": "Amour R Hamad",
    "Gender": "Male",
    "DateOfBirth": "1974- 03 - 18",
    "ExpiryDate": "",
    "AuthorizationStatus": "ACCEPTED",
    "AuthorizationNo": "720002",
    "EmployerNo": "7000885",
    "SchemeID": " 1001 ",
    "ProductCode": "NH001",
    "Remarks": "Verified OK"
}

获取卡片详情

$response = LaravelNHIF::getCardDetails(card_number:'12344554');
// response payload structure
{
    "CardNo": "01-nhif241",
    "CardStatus": "Active",
    "FirstName": "Amour",
    "MiddleName": "R",
    "LastName": "Hamad",
    "FullName": "Amour R Hamad",
    "Gender": "Male",
    "DateOfBirth": "1974- 03 - 18",
    "ExpiryDate": "",
    "AuthorizationStatus": "ACCEPTED",
    "AuthorizationNo": "720002",
    "EmployerNo": "7000885",
    "SchemeID": " 1001 ",
    "ProductCode": "NH001",
    "Remarks": "Verified OK"
}

下载不含排除服务的费率

$response = LaravelNHIF::downloadTariffsWithoutExcludedService(facility_code:'12344554');
// response payload structure
{
    "FacilityCode": " 01099 ",
    "PricePackage": [
        {
            "ItemCode": "10001",
            "ItemName": "General Practitioner Consultation",
            "PackageID": 102,
            "SchemeID": 1001,
            "UnitPrice": 10000.0,
            "IsRestricted": false
        },
        {
            "ItemCode": "10001",
            "ItemName": "General Practitioner Consultation",
            " PackageID": 201,
            "SchemeID": 1002,
            "UnitPrice": 25000.0,
            "IsRestricted": false
        }
    ],
    "ExcludedServices": [
        {
            "ItemCode": "10001",
            "SchemeID": 1001,
            "ExcludedForProducts": "NH003,NH004"
        },
        {
            "ItemCode": "10002",
            "SchemeID": 1003,
            "ExcludedForProducts": "NH001,NH002"
        }
    ]
}

下载含排除服务的费率

$response = LaravelNHIF::downloadTariffsWithExcludedService(facility_code:'12344554');
// response payload structure

{
    [
        {
            "ItemCode": "10001",
            "ItemName": "General Practitioner Consultation",
            "PackageID": 102,
            "UnitPrice": 10000.0,
            "IsRestricted": false
        },
        {
            "ItemCode": "10001",
            "ItemName": "General Practitioner Consultation",
            "PackageID": 201,
            "UnitPrice": 25000.0,
            "IsRestricted": false
        }
    ]
}

向NHIF提交索赔

$data = {
    "entities": [
        {
            "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
            "ClaimYear": 2016,
            "ClaimMonth": 7,
            "FolioNo": 1,
            "SerialNo": "SN00 099",
            "CardNo": "308900035308",
            "FirstName": "Flora",
            "LastName": "Mataba",
            "Gender": "Female",
            "DateOfBirth": "1974- 01 -23T16:56:20.287",
            "Age": 30.0,
            "TelephoneNo": "0686155255",
            "PatientFileNo": null,
            "PatientFile": "GQ8XQAYFAiEMfN0qD0COTgMX......",
            "AuthorizationNo": null,
            "AttendanceDate": "2014- 09 -01T00:00:00",
            "PatientTypeCode": "OUT",
            "DateAdmitted": null,
            "DateDischarged": null,
            "PractitionerNo": "12345",
            "CreatedBy": "Administrator",
            "DateCreated": "2015- 01 -23T16:56:20.223",
            "LastModifiedBy": "Administrator",
            "LastModified": "2015-01 - 2 6T12:31:25.097",
            "FolioDiseases": [
                {
                    "FolioDiseaseID": "e9429e1c-f892-40ae-8c0a-a3bc0095681f",
                    "DiseaseCode": "084",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "Remarks": null,
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015 - 01 -23T16:56:20.287",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.287"
                }
            ],
            "FolioItems": [
                {
                    "FolioItemID": "e0d30408- 1863 - 4eb4-8cce-a3bc00957501",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "ItemCode": "11",
                    "OtherDetails": null,
                    "ItemQuantity": 1,
                    "UnitPrice": 2000.0,
                    "AmountClaimed": 2000.0,
                    "ApprovalRefNo": "NHIF/REF/201000024",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.35",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.35"
                },
                {
                    "FolioItemID": "84ae41a0-514c-489d-8e6f-a3bc00958289",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "ItemCode": "11533",
                    "OtherDetails": null,
                    "ItemQuantity": 1,
                    "UnitPrice": 1950.0,
                    "AmountClaimed": 1950.0,
                    "ApprovalRefNo": "null",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.37",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.37"
                },
                {
                    "FolioItemID": "3c5b814c-7fbf-454b-9c9e-a3bc00985ba5",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "ItemCode": "11004",
                    "OtherDetails": null,
                    "ItemQuantity": 3,
                    "UnitPrice": 100.0,
                    "AmountClaimed": 300.0,
                    "ApprovalRefNo": "null",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.39",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.39"
                },
                {
                    "FolioItemID": "338ce17c- 1655 - 417f-80e3-a3ca01019326",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "ItemCode": "5039",
                    "OtherDetails": null,
                    "ItemQuantity": 2,
                    "UnitPrice": 3000.0,
                    "AmountClaimed": 6000.0,
                    "ApprovalRefNo": "null",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.41",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2 015 -01 - 23T16:56:20.41"
                },
                {
                    "FolioItemID": "ae3e912a-137b-48e7- 9853 -a3ca01058118",
                    "FolioID": "817d6e75-3bef-4d25-a2e1-a3bc009530ab",
                    "ItemCode": "7402",
                    "OtherDetails": null,
                    "ItemQuantity": 1,
                    "UnitPrice": 20000.0,
                    "AmountClaimed": 20000.0,
                    "ApprovalRefNo": "null",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.47",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.47"
                }
            ]
        },
        {
            "FolioID": "d3d7656b-7c3b- 4392 - b75f-a3ca01048e2b",
            "ClaimYear": 2016,
            "ClaimMonth": 7,
            "FolioNo": 2,
            "SerialNo": "13/109998777",
            "CardNo": "109900035308",
            "FirstName": "Amour",
            "LastName": "Rashid",
            "Gender": "Male",
            "DateOfBirth": "1974- 01 -23T16:56:20.287",
            "Age": 40.0,
            "TelephoneNo": "0686155255",
            "PatientFileNo": null,
            "AuthorizationNo": null,
            "AttendanceDate": "2014- 09 -01T00:00:00",
            "PatientTypeCode": "OUT",
            "DateAdmitted": null,
            "DateDischarged": null,
            "PractitionerNo": null,
            "CreatedBy": "Administrator",
            "DateCreated": "2015- 01 -23T16:56:20.247",
            "LastModifiedBy": "Administrator",
            "LastModified": "2015-01 - 28T13:31:09.297",
            "FolioDiseases": [
                {
                    "FolioDiseaseID": "c4f56a4c- 6217 - 475d-b3de-a3ca0104c9dc",
                    "DiseaseCode": "084",
                    "FolioID": "d3d7656b-7c3b- 4392 - b75f-a3ca01048e2b",
                    "Remarks": null,
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015 - 01 -23T16:56:20.307",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.307"
                }
            ],
            "FolioItems": [
                {
                    "FolioItemID": "248fa65b-dab8-4ca2- 9905 -a3ca0104cfc7",
                    "FolioID": "d3d7656b-7c3b- 4392 - b75f-a3ca01048e2b",
                    "ItemCode": "5036",
                    "OtherDetails": null,
                    "ItemQuantity": 1,
                    "UnitPrice": 3200.0,
                    "AmountClaimed": 3200.0,
                    "ApprovalRefNo": "null",
                    "CreatedBy": "Administrator",
                    "DateCreated": "2015- 01 -23T16:56:20.43",
                    "LastModifiedBy": "Administrator",
                    "LastModified": "2015-01 - 23T16:56:20.43"
                }
            ]
        }
    ]
}

$response = LaravelNHIF::submitClaimToNHIF(claim_data:$data);
// response payload structure

获取提交的索赔

$response = LaravelNHIF::getSubmittedClaims(facility_code:'1232',claim_year: 2017,claim_month: 9);
// response payload structure

提交转诊

$data = {
    "CardNo": "01-NHIF45",
    "AuthorizationNo": "623456789",
    "PatientFullName": "Said Juma",
    "PhysicianMobileNo": "0655232365",
    "Gender": "Male",
    "PhysicianName": "Amour Rashid",
    "PhysicianQualificationID": 2,
    "ServiceIssuingFacilityCode": "01099",
    "ReferringDiagnosis": "084,085",
    "ReasonsForReferral": "Fractured hand needs attention from Orthopaedician at MOI"
}

$response = LaravelNHIF::submitReferralToNHIF(referral_data:$data);
// response payload structure

{
    "$id": "1",
    "$type": "NHIFService.Models.PatientReferral, NHIFService",
    "ReferralID": "838ba4f0-8a80- 4658 - bba5-e61ff602ca1d",
    "CardNo": "01-NHIF45",
    "AuthorizationNo": "623456789",
    "PatientFullName": "Said Juma",
    "Gender": "Male",
    "ReferringDate": "2018- 01 - 29T10:27:31.637",
    "PhysicianName": "Amour Rashid",
    "PhysicianMobileNo": null,
    "ReferralNo": "21081000019",
    "ServiceIssuingFacilityCode": "01099",
    "SourceFacilityCode": "06697",
    "PhysicianQualificationID": 2,
    "ReferringDiagnosis": "084,085",
    "ReasonsForReferral": "Fractured hand needs attention from Orthopaedician at MOI",
    "CreatedBy": "arashid",
    "DateCreated": "2018- 01 - 29T10:27:31.637",
    "LastModifiedBy": "arashid",
    "LastModified": "2018- 01 - 29T10:27:31.637"
}

验证预批准的服务

$response = LaravelNHIF::verifyPreApprovedService(card_number:'12344', reference_number:'12342', item_code:'5625426');
// response payload structure

VALID or INVALID

测试

composer test

变更日志

请参阅变更日志了解最近更改的更多信息。

贡献

请参阅贡献指南获取详细信息。

安全漏洞

请查看我们的安全策略了解如何报告安全漏洞。

鸣谢

许可

MIT许可（MIT）。请参阅许可文件获取更多信息。