負担割合情報取得API

利用者の負担割合情報を取得するAPI

指定した月時点で有効な負担割合情報を取得するAPIです。
指定値がない場合はリクエスト時の当月で検索し、有効な負担割合情報を取得します。

API ID

I0005

Request URL

co-pay/select
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/co-pay/select
環境 URL
本番環境 https://api.link.carekarte.jp/co-pay/select

HTTPメソッド

POST

リクエスト

ヘッダー

名前 必須
Content-Type application/json
authorization tokenサービスで取得した値を設定

ボディ

パラメータ名 物理パラメータ 必須 文字桁数 文字種/形式 仕様
対象利用者ID userId String 10    
月指定 selectMonth String     YYYY-MM 指定した月時点で有効な負担割合情報を取得します。
値がない場合はリクエストした月で有効な負担割合情報を取得します。

サンプルデータ

{ 
    "userId": "0000000004",
    "selectMonth": "2022-08"
}

レスポンス

ボディ

パラメータ名 物理パラメータ 配列内パラメータ 必須 文字桁数 文字種/形式 仕様
利用者ID userId   String 10    
名前 userName   String      
名前フリガナ (半角カナ) kanaName   String      
対象月 selectMonth   String   YYYY-MM  
負担割合情報 co-payData   [array]       リクエスト月に有効な負担割合情報が存在しない場合は省略されます
負担割合交付日   issueDate String     YYYY-MM-DD  
被保険者番号   insuredNumber String   10    
保険者番号   isurerNumber String   6    
保険者名称   isurerName String        
負担割合期間開始日   sdate String     YYYY-MM-DD  
負担割合期間終了日   edate String     YYYY-MM-DD  
負担割合   rate String       文字列「1割負担」「2割負担」「3割負担」いずれかで返却されます

有効な負担割合証の取得に成功した際のサンプルデータ

{
    "userId": "0000000004",
    "userName": "利用者4",
    "kanaName": "リヨウシャアアエ",
    "selectMonth": "2022-08",
    "co-payData": [
        {
            "issueDate": "2020-01-01",
            "insuredNumber": "1111111114",
            "isurerNumber": "221028",
            "isurerName": "静岡市駿河区",
            "sdate": "2022-07-01",
            "edate": "2022-08-15",
            "rate": "2割負担"
        },
        {
            "issueDate": "2020-01-01",
            "insuredNumber": "1111111114",
            "isurerNumber": "221028",
            "isurerName": "静岡市駿河区",
            "sdate": "2022-08-16",
            "edate": "2022-09-30",
            "rate": "1割負担"
        }
    ]
}

エラーレスポンス

エラーレスポンスを参照してください。

連携イメージ(CAREKARTE)

イメージ画像はCAREKARTEでの負担割合証を確認できる画面です。
サンプルリクエストの通り、有効月内で負担割合証履歴をまたぐ場合は有効月の情報として複数取得します。