介護保険情報登録API

利用者の介護保険情報を登録するAPI

利用者の介護保険情報をCAREKARTEに登録するAPIです。
利用者IDと被保険者番号を使用して利用者を特定し、履歴情報を1件ずつ登録可能です。

API ID

I0002

Request URL

insurance/id-add
環境 URL
Staging環境 https://stage-api.link.carekarte.jp/insurance/id-add
環境 URL
本番環境 https://api.link.carekarte.jp/insurance/id-add

HTTPメソッド

POST

リクエスト

header（すべて必須）

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

Body（JSON形式）

パラメータ 型 必須 サイズ・形式 説明 仕様
userId String ○ 10桁 利用者ID  
insuredNumber String ○ 10桁 被保険者番号  
insuredClass String   1桁 被保険者区分 0：空白
1：第1号被保険者
2：第2号被保険者
9：その他
userName String     名前  
kanaName String     名前フリガナ （半角カナ）  
deliveryDate String   YYYY-MM-DD 交付年月日  
provisionalFlag String   1桁 暫定フラグ 0：チェックOFF
1：チェックON
isurerNumber String ○   保険者番号  
isurerName String ○   保険者名称  
careLevel String ○ 2桁 要介護度 00：空白
01：非該当
11：要支援 (経過的要介護)
12：要支援1
13：要支援2
21：要介護1
22：要介護2
23：要介護3
24：要介護4
25：要介護5
31：再調査
88：取消
99：なし
certificationDate String ○ YYYY-MM-DD 認定年月日  
certificationSdate String ○ YYYY-MM-DD 認定有効期間開始日  
certificationEdate String ○ YYYY-MM-DD 認定有効期間終了日  
limitCost String ○   区分支給限度基準額（1月あたり）  
limitCostSdate String ○ YYYY-MM-DD 区分支給限度基準額有効期間開始日  
limitCostEdate String ○ YYYY-MM-DD 区分支給限度基準額有効期間終了日  
limitCostOfType [array]     種類支給限度基準額  
　cost String     サービスごとの種類支給限度基準額  
benefitRestrictions [array]     給付制限  
　content String     給付制限内容  
　sdate String   YYYY-MM-DD 給付制限期間開始日  
　edate String   YYYY-MM-DD 給付制限期間終了日  
supportOfficeNumber String     居宅介護支援事業所番号  
supportOfficeName String     居宅介護支援事業所名称  
notificationDate String   YYYY-MM-DD 届出年月日  
selfCreated String   1桁 自己作成フラグ 0：チェックOFF
1：チェックON
opinion String     審査委員会意見
サービス種類指定		  
staffId String   10桁 職員ID  

サンプルデータ

{
    "userId": "0000001721",
    "insuredNumber": "1000001011",
    "insuredClass": "1",
    "userName": "被保険者名",
    "kanaName": "ﾋﾎｹﾝｼｬｶﾅ",
    "deliveryDate": "2021-06-01",
    "provisionalFlag": "1",
    "isurerNumber": "452094",
    "isurerName": "保険者名称",
    "careLevel": "22",
    "certificationDate": "2021-06-02",
    "certificationSdate": "2021-06-03",
    "certificationEdate": "2025-06-04",
    "limitCost": "1000",
    "limitCostSdate": "2025-06-05",
    "limitCostEdate": "2025-06-06",
    "limitCostOfType": [
        {
            "cost": "2000"
        },
        {
            "cost": "3000"
        }
    ],
    "benefitRestrictions": [
        {
            "content": "4000",
            "sdate": "2021-06-07",
            "edate": "2021-06-08"
        },
        {
            "content": "5000",
            "sdate": "2021-06-09",
            "edate": "2021-06-10"
        }
    ],
    "supportOfficeNumber": "0000002020",
    "supportOfficeName": "居宅介護支援事業所名称",
    "notificationDate": "2021-06-11",
    "selfCreated": "1",
    "opinion": "審査委員会意見サービス種類指定",
    "staffId": "0000000012"
}

レスポンス

Body（JSON形式）

パラメータ 型 必須 サイズ・形式 説明 仕様
userId String ○ 10桁 利用者ID  
insuredNumber String ○ 10桁 被保険者番号  

サンプルデータ

正常登録時
{
    "insuredNumber": "1000001011",
    "userId": "0000001721"
}

API個別エラー

HTTPコード message エラー説明
400 “Data is existed” 認定有効期間開始日が既存のレコードと重複しています。
400 “UserId does not exist” 利用者IDが見つかりませんでした。
400 “Data does not exist” 保険者番号が見つかりませんでした。
400 “Validation failed: {{パラメータ名}} must be longer than or equal to {{文字数}} characters” パラメータの文字数を修正してください。
400 “Validation failed: {{パラメータ名}} must be a number string” パラメータの形式を修正してください。
400 “Validation failed: {{パラメータ名}} is incorrect format YYYY-MM-DD” パラメータの形式を修正してください。 
{
    "code": 400,
    "timestamp": "10/3/2021, 4:04:40 AM",
    "path": "/insurance/id-add",
    "method": "POST",
    "message": "UserId does not exist"
}

連携イメージ(CAREKARTE)