CAREKARTEから提供明細のCSVを取得するAPI
リクエストで指定した月に請求処理をされたデータをCSV形式で取得可能です。
APIから返却されたデータはCSV形式への変換に以下の作業が必要です。
・Bodyのcalcresultとivの値をBase64デコードする
・APIキーをMD5ハッシュ化し、128bitのAES復号化キーを生成する
・Base64デコードしたcalcresultの値はAES暗号化されている為、AES復号化キーとivを使用し、AES復号化する
・AES復号化した値は圧縮データとなっている為、gzip解凍する
なお、文字コードはUTF-8となっているため、
CSVファイルとして保存する場合は文字コードをShift-JISへ変換をお願いします。
API ID
KH0001
Request URL
recekh/recelist/select
| 環境 | URL |
|---|---|
| Staging環境 | https://stage-api.link.carekarte.jp/recekh/recelist/select |
| 環境 | URL |
|---|---|
| 本番環境 | https://api.link.carekarte.jp/recekh/recelist/select |
HTTPメソッド
POST
リクエスト
ヘッダー
| 名前 | 必須 | 値 |
| Content-Type | ○ | application/json |
| Authorization | ○ | tokenサービスで取得した値を設定 |
ボディ
| パラメータ名 | 物理パラメータ名 | 必須 | 型 | 文字種/形式 | 備考 |
| 取得したい請求月 | claimedMonth | ◯ | String | YYYY-MM-DD | 月初日をセットする |
提供明細CSVを取得するサンプルリクエストデータ (実際にリクエストしても使用できません)
//コード1 recekh/recelistをリクエスト
URL:recekh/recelist/select
HTTPメソッド:POST
header:
Authorization:Bearer eyJhbGc…
Content-Type:application/json
body:
{
"claimedMonth":"2023-07-01",
}
レスポンス
ボディ
| パラメータ | 型 | 必須:○ | サイズ・形式 | 説明 |
| calcresult | String | ○ | – | AES暗号化後、Base64エンコードされたgzip圧縮ファイルデータの文字列 (以下の作業がクライアント側で必要) 1.Base64文字列のデコード 2.AES復号化 (Key:APIキーをMD5ハッシュ化した128bitの文字列。初期ベクトルはパラメータ「iv」のbase64デコードした値) 3.復号化したgzip圧縮データを解凍し、CSVファイルを取得する 4.文字コードはUTF-8になっている為、ファイルとして保存する場合はShift-JISに変換する |
| iv | String | ○ | – | AES暗号化の初期ベクトル IVはbyte型のためBase64エンコードされた値(以下の作業がクライアント側で必要) 1.Base64文字列のデコード |
{
"calcresult": "zMnlMTXW7J8HZ9……",
"iv": "AcOK5tp2sR6zroxDl6YgyA=="
}
エラーレスポンス
エラーレスポンスを参照してください。
連携イメージ(CAREKARTE)
提供明細CSVの内容について

■CSVファイルの注意点 請求金額の確認は「行区分」が「明細行」以外の行をご参照ください。 介護保険の計算方法として、月のすべての単位数に地域単価等を適用し端数が切り捨てられる等の処理が行われています。 そのため明細行に表示されている金額は、その結果を単価や回数に応じて分配して便宜上表示しているものとなるため、合計に対して数円単位の誤差が発生する可能性がございます。 「行区分」について 利用者合計行・・・1ヶ月に1行表示されます。最終的な金額についてはこちらを参照ください。 保険者合計行・・・その月に利用のあったサービスの保険者数分表示されます。保険者ごとの最終的な金額はこちらを参照ください。 事業所合計行・・・その月に利用のあったサービス種別分が保険者ごとに表示されます。サービスごとの最終的な金額はこちらを参照ください。 請求行・・・通常は保険者、事業所別に国保請求、個人請求に分かれて表示されます。また、公費や減免などの状況により行数が変化します。該当する明細行の総金額はこちらを参照ください。 ■その他のヘッダについては以下を参照ください。 ※制度改正などの影響で項目数は今後増減する可能性があります。 そのため、データ取得の際は列数ではなく区分名にて参照するようお願いいたします。
| 大項目 | 区分名(日本語) | 区分名(英語) | 備考1 |
| キー | 行区分 | rowtype | 計画単位数行、限度外単位行、限度対象単位行、支給限度超え単位行、事業所合計行、請求行、保険者合計行、明細行、利用者合計行が表示。そのうち正確な単位・金額を表示している行は「請求行」となります。その他の行は合計から割返した値を便宜上表示しており、正確なものではない場合があります。 |
| キー | 対象者コード | daicd | CAREKARTE上の個人番号 |
| キー | 対象者カナ | kananame | |
| キー | 対象者名称 | name | |
| キー | 被保険者番号 | hhcd | |
| キー | 保険者番号 | hocd | |
| キー | 保険者名 | honm | |
| キー | 介護度 | gklv | |
| キー | 性別 | gender | |
| キー | サービス提供月 | srvsdate | 請求対象となるサービスを提供した月 |
| キー | 国保請求月 | recedatekokuho | 国保請求処理を行った月(通常サービス提供月の翌月に処理を行うことが多いですが、返礼などの場合は翌月以降となる場合があります。また、個人請求に影響しない加算の漏れ等が発生した場合は、国保請求処理月のみ翌月以降となる場合があります。) |
| キー | 個人請求月 | recedatekojin | 個人請求処理を行った月(通常サービス提供月の翌月に処理を行うことが多いですが、返礼などの場合は翌月以降となる場合があります。また、実費の入れ忘れなどで個人請求のみが翌月以降の処理月となる場合がございます。) |
| キー | 種別 | jsrvkbncd | 介護保険におけるサービス種類コード |
| キー | 事業所コード | jigcd | 事業所番号 |
| キー | 指定 | shitei | サテライト事業所など、事業所番号、サービス種別が同じ場合にCAREKARTE上で事業所を区別するために発行している番号 |
| キー | 事業所名 | jignm | |
| キー | 日付 | sdate | |
| キー | 開始 | stime | |
| キー | 終了 | etime | |
| キー | サービス種別 | kindnm | 明細行は「介護福祉施設」といった介護保険上のサービス名、「生活保護」などの公費名、「日常生活費」などの種別、「請求行」や「事業所合計行」などには「保険対象外実日数」「事業所合計」など |
| キー | コード | srvcd | 介護保険上のサービスコードが表示されます |
| キー | サービス内容 | srvnm | 基本サービスや加算名、実費名など |
| キー | 科目コード | kmkcd | 実費それぞれに設定された科目コード |
| キー | 科目名 | kmknm | 実費それぞれに設定された科目名 |
| キー | 商品コード | productid | 福祉用具関連項目 |
| キー | JAN/TAISコード | taiscd | 福祉用具関連項目 |
| キー | 商品名 | productnm | 福祉用具関連項目 |
| キー | 単位数識別記号 | type | 福祉用具関連項目 |
| キー | 合成単位 | taniSrc | 事業所割引適用前の単位数 |
| キー | 割引率% | discount | 事業所体制における割引率 |
| 金額 | 基準額(円) | basePay | 食費居住費の基準額 |
| 金額 | 実際の費用 | hosokSumPrice | 施設が提供する食費居住費の費用 |
| 金額 | 負担限度(円) | limitPay | 負担限度額認定証で定められた負担限度額 |
| 金額 | 単位 | taniDst | ※参考値 |
| 金額 | 回数 | countSum | |
| 金額 | 合計単位 | taniSum | ※参考値 |
| 金額 | 請求方法 | paykbn | 国保請求「国」 公費請求「公」 |
| 金額 | 給付率 | insura | |
| 金額 | 第1公費 | kouhi1 | 公費負担割合 |
| 金額 | 第2公費 | kouhi2 | 公費負担割合 |
| 金額 | 第3公費 | kouhi3 | 公費負担割合 |
| 金額 | 地域単価 | areacost | |
| 金額 | 保険+公費負担額 | insurSum | ※明細行は参考値 |
| 金額 | 保険分自己負担額 | insuraOwn | ※明細行は参考値 |
| 金額 | 全額自己負担金額 | insoutOwn | ※明細行は参考値 |
| 金額 | 社福軽減額 | ___sfk | ※明細行は参考値 |
| 金額 | 自治体独自助成等 | ___jsi | ※明細行は参考値 |
| 金額 | 高額介護サ費 | ___kougk | ※明細行は参考値 |
| 金額 | 医療費控除対象額 | medTarget | |
| 金額 | 利用者請求額 | ___riyouPay | ※明細行は参考値 |
| 金額 | サービス費用総額 | sumPrice | ※明細行は参考値 |
| 金額 | 消費税 | ___zei | ※明細行は参考値 |
| 金額 | 消費税内訳(8%) | zei8 | ※明細行は参考値 |
| 金額 | 消費税内訳(10%) | zei10 | ※明細行は参考値 |
| 金額 | 補足給付(円) | hosokPay | ※明細行は参考値 |
| 金額 | 生保支払(円) | seihoPay | ※明細行は参考値 |
| 金額 | 福祉事務所(円) | fukusPay | ※明細行は参考値 |
| 金額 | 自己負担(円) | hoskOwn | ※明細行は参考値 |
| 金額 | 調整額(円) | adjustPay | ※明細行は参考値 |
| 日別利用回数 | 1 | DAY1 | |
| 日別利用回数 | 2 | DAY2 | |
| 日別利用回数 | 3 | DAY3 | |
| 日別利用回数 | 4 | DAY4 | |
| 日別利用回数 | 5 | DAY5 | |
| 日別利用回数 | 6 | DAY6 | |
| 日別利用回数 | 7 | DAY7 | |
| 日別利用回数 | 8 | DAY8 | |
| 日別利用回数 | 9 | DAY9 | |
| 日別利用回数 | 10 | DAY10 | |
| 日別利用回数 | 11 | DAY11 | |
| 日別利用回数 | 12 | DAY12 | |
| 日別利用回数 | 13 | DAY13 | |
| 日別利用回数 | 14 | DAY14 | |
| 日別利用回数 | 15 | DAY15 | |
| 日別利用回数 | 16 | DAY16 | |
| 日別利用回数 | 17 | DAY17 | |
| 日別利用回数 | 18 | DAY18 | |
| 日別利用回数 | 19 | DAY19 | |
| 日別利用回数 | 20 | DAY20 | |
| 日別利用回数 | 21 | DAY21 | |
| 日別利用回数 | 22 | DAY22 | |
| 日別利用回数 | 23 | DAY23 | |
| 日別利用回数 | 24 | DAY24 | |
| 日別利用回数 | 25 | DAY25 | |
| 日別利用回数 | 26 | DAY26 | |
| 日別利用回数 | 27 | DAY27 | |
| 日別利用回数 | 28 | DAY28 | |
| 日別利用回数 | 29 | DAY29 | |
| 日別利用回数 | 30 | DAY30 | |
| 日別利用回数 | 31 | DAY31 |