お薬手帳情報登録API

お薬手帳情報を登録するAPI

JAHIS電子版お薬手帳フォーマット(ver.2.0)に準拠した値を、CAREKARTEの服薬情報画面で管理可能なデータとして登録します。

API ID

PRE0001

Request URL

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

HTTPメソッド

POST

リクエスト

header（すべて必須）

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

Body（JSON形式）

パラメータ名 物理パラメータ名 配列内パラメータ名1 配列内パラメータ名2 必須 型 文字桁数 JAHIS電子版お薬手帳仕様CSV
でのデータ位置		 仕様
利用者ID userId 　 　 ○ String 10 ー CAREKARTEの利用者番号
処方年月日 rpDate 　 　 　 String 10 ー YYYY-MM-DD形式
調剤等年月日 dispenseDate 　 　 　 String 10 レコードNo.5,フィールド2 YYYY-MM-DD形式
医療機関名称（調剤） dispenseInstitution 　 　 　 String 120 レコードNo.11,フィールド2 　
医療機関名称（処方） prescriptionHospital 　 　 　 String 120 レコードNo.51,フィールド2 　
職員ID staffId 　 　 ○ String 10 ー CAREKARTEの職員番号

存在しない職員IDが入力された場合はエラー返却される
調剤情報配列 recipes 　 　 　 [Array] ー ー 　
調剤情報(用法)RP番号 　 recipeNo 　 　 String 3 レコードNo.301,フィールド2 　
調剤情報(用法)用法名称 　 recipeNm 　 　 String 100 レコードNo.301,フィールド3 　
調剤情報(用法)調剤数量 　 recipeAm 　 　 Number 3 レコードNo.301,フィールド4 　
調剤情報(用法)調剤単位 　 recipeAmUni 　 　 String 100 レコードNo.301,フィールド5 　
調剤情報(用法)剤型コード 　 recipeDosage 　 　 String 2 レコードNo.301,フィールド6 　
調剤情報(用法)用法コード種別 　 recipeCdType 　 　 Number 1 レコードNo.301,フィールド7 　
調剤情報(用法)用法コード 　 recipeCd 　 　 String 16 レコードNo.301,フィールド8 　
調剤情報(薬品)配列 　 drugData 　 　 [Array] ー ー 　
調剤情報(薬品)薬品名称 　 　 drugNm ○ String 120 レコードNo.201,フィールド2 　
調剤情報(薬品)用量 　 　 drugUni 　 String 12 レコードNo.201,フィールド3 　
調剤情報(薬品)単位名 　 　 drugUniNm 　 String 12 レコードNo.201,フィールド4 　
調剤情報(薬品)薬品コード種別 　 　 drugCdType ○ Number 1 レコードNo.201,フィールド5 　
調剤情報(薬品) 　 　 drugCd ○ String 13 レコードNo.201,フィールド6 　
備考 　 　 drugNote 　 String 1000 ー CAREKARTEの「備考」に入力可能
持参薬フラグ 　 　 isJisanFlg 　 Boolean ー 　 　
処方種別 　 　 rpType 　 Number 1 　

指定されたパラメータ値に応じたシステムの表示

　0を指定した場合：(空欄)

　1を指定した場合：定期薬

　2を設定した場合：臨時薬
服用開始日 　 　 takeDrugSdate △ String 10 　 YYYY-MM-DD形式

takeDrugEdateを宣言する場合は、必須
服用終了日 　 　 takeDrugEdate 　 String 10 　 YYYY-MM-DD形式

サンプルデータ

{
"userId":"0000001003",
"rpDate":"2022-11-14",
"dispenseDate":"2022-11-14",
"dispenseInstitution":"テスト富士山薬局",
"prescriptionHospital":"テストFUJIクリニックセンター",
"staffId":"0000000001",
"recipes":[
    {
        "recipeNo":"1",
        "recipeNm":"１日３回　毎食後服用",
        "recipeAm":5,
        "recipeAmUni":"日分",
        "recipeDosage":"1",
        "recipeCdType":2,
        "recipeCd":"1234",
        "drugData":[
            {
                "drugNm":"アスベリン錠２０　２０ｍｇ",
                "drugUni":"3",
                "drugUniNm":"錠",
                "drugCdType":4,
                "drugCd":"2249003F2027",
                "drugNote":"いつも飲みづらそうなのでゼリーに包んで提供し、見守ること",
        "isJisanFlg":false,
        "rpType":1,
        "takeDrugSdate":"2022-11-14",
        "takeDrugEdate":"2022-11-21"
            },
            {
                "drugNm":"トラネキサム酸錠２５０ｍｇ「ＹＤ」",
                "drugUni":"3",
                "drugUniNm":"錠",
                "drugCdType":4,
                "drugCd":"327002F1169",
        "isJisanFlg":true,
        "rpType":2,
        "takeDrugSdate":"2022-11-14",
        "takeDrugEdate":"2022-11-21"
            }
        ]
    },
    {
        "recipeNo":"2",
        "recipeNm":"発熱時",
        "recipeAm":3,
        "recipeAmUni":"回分",
        "recipeDosage":"3",
        "recipeCdType":1,
        "recipeCd":"",
        "drugData":[
            {
                "drugNm":"カロナール錠３００　３００ｍｇ",
                "drugUni":"1",
                "drugUniNm":"錠",
                "drugCdType":4,
                "drugCd":"1141007F2027",
                "takeDrugSdate":"2022-11-14"
            }
        ]
    }
]
}

レスポンス

Body（JSON形式）

パラメータ名 物理パラメータ 型 文字桁数 文字種/形式 仕様
利用者ID userId String 10 　 リクエストのuserIdと同じ
服薬記録No drgRecordId Number[array] 　 　 作成した服薬記録の記録連番を返却する

サンプルデータ

記録の登録完了
{
    "userId": "0000001003",
    "drgRecordId": [
        1,
        2,
        3
    ]
}

API個別エラー

メニューのエラーレスポンスを参照してください

 

連携イメージ(CAREKARTE)

CAREKARTE 服薬情報一覧画面

CAREKARTE 服薬情報編集画面

JAHIS電子版お薬手帳フォーマット サンプルCSV

JAHISTC03,1
1,利用者　88,2,19500825,,,,,,,リヨウシャ　アイロ
2,1,えび,2
2,1,ハウスダスト,2
2,3,気管支喘息,2
2,3,腰痛,2
3,パトマロンひびあかぎれクリームプラス　２４ｇ,20210319,20210319,2
5,20221114,2
11,テスト薬局,13,4,,,,9900100003,1
51,テスト内科クリニック,13,1,,1
201,1,アスベリン錠２０　２０ｍｇ,3,錠,4,2249003F2027,1
201,1,トラネキサム酸錠２５０ｍｇ「ＹＤ」,3,錠,4,3327002F1169,1
301,1,１日３回　毎食後服用,5,日分,1,1,,1
201,2,カロナール錠３００　３００ｍｇ,1,錠,4,1141007F2027,1
301,2,発熱時,3,回分,3,1,,1
601,副作用の症状あり【歯茎の痛み・出血】,20140919