Modèle de posologie structurée
Introduction
La posologie structurée Posos est conforme au format FHIR R4, la ressource renvoyée par l’api est une MedicationRequest
Pour des détails sur les différents champs vous pouvez vous référer à cette documentation, ainsi qu’aux pages liés suivantes :
Dans cette API, la MedicationRequest contient quasi exclusivement un objet dosageInstruction. Les champs pouvant actuellement être renvoyés sont les suivants :
Dosage
DosageUsedFields
{
"sequence" : <integer>, // The order of the dosage instructions
"text" : "<string>", // Free text dosage instructions
"timing" : { Timing }, // When medication should be administered
"asNeededBoolean" : <boolean>, // asNeeded: Take "as needed" (for x)
"route" : { CodeableConcept }, // How drug should enter body
"doseAndRate" : [{ // Amount of medication administered
// dose[x]: Amount of medication per dose. One of these 2:
"doseRange" : { Range },
"doseQuantity" : { Quantity(SimpleQuantity) },
}],
"maxDosePerPeriod" : { Ratio }, // Upper limit on medication per unit of time
}Timing
TimingUsedFields
{
"repeat" : { // When the event is to occur
// bounds[x]: Length/Range of lengths, or (Start and/or end) limits. One of these 3:
"boundsDuration" : { Duration },
"boundsRange" : { Range },
"boundsPeriod" : { Period },
"duration" : <integer>, // How long when it happens
"durationMax" : <decimal>, // How long when it happens (Max)
"durationUnit" : "<code>", // s | min | h | d | wk | mo | a - unit of time (UCUM)
"frequency" : "<positiveInt>", // Event occurs frequency times per period
"frequencyMax" : "<positiveInt>", // Event occurs up to frequencyMax times per period
"period" : <decimal>, // Event occurs frequency times per period
"periodMax" : <decimal>, // Upper limit of period (3-4 hours)
"periodUnit" : "<code>", // s | min | h | d | wk | mo | a - unit of time (UCUM)
"dayOfWeek" : ["<code>"], // mon | tue | wed | thu | fri | sat | sun
"timeOfDay" : ["<time>"], // Time of day for action
"when" : ["<code>"] // Code for time period of occurrence
},
}Champs spécifiques
Ci-dessous les détails des terminologies utilisés pour les CodeableConcept présents dans l’objet Dosage.
Bon à savoir : Si nécessaire, nous pouvons vous fournir des mappings vers certaines autre terminologies sur demande auprès de votre contact technique.
Route
Nous utilisons la terminologie EDQM pour les voies d’administrations :
RouteExample
"route": {
"coding": [
{
"display": "Voie orale",
"system": "https://standardterms.edqm.eu",
"code": "ROA-20053000"
}
]
}Dose
Pour les unités de doses nous utilisons les terminologies Snomed et UCUM. Une liste exhaustive des unités possibles est disponible sur demande.
SnomedExample
{
"doseQuantity": {
"value": 1.0,
"unit": "comprimé(s)",
"system": "http://snomed.info/sct",
"code": "428673006"
}
}UCUMExample
"doseRange": {
"low": {
"value": 150.0,
"unit": "mg",
"system": "https://ucum.org",
"code": "mg"
},
"high": {
"value": 300.0,
"unit": "mg",
"system": "https://ucum.org",
"code": "mg"
}
}Exemples
Quelques exemples de posologies couvrant la majorité des champs disponibles dans l’API
1 cp toutes les 4 à 6 h si besoin, maximum 4 g par jour, pendant 2 à 3 mois
Example1
{
"resourceType": "MedicationRequest",
"status": "unknown",
"intent": "proposal",
"dosageInstruction": [
{
"text": "1 cp toutes les 4 à 6 h si besoin pendant 2 à 3 mois",
"timing": {
"repeat": {
"frequency": 1,
"period": 4,
"periodMax": 6,
"periodUnit": "h",
"boundsRange": {
"low": {
"unit": "month",
"value": 2,
"system": "http://hl7.org/fhir/ValueSet/duration-units",
"code": "mo"
},
"high": {
"unit": "month",
"value": 3,
"system": "http://hl7.org/fhir/ValueSet/duration-units",
"code": "mo"
}
}
}
},
"asNeededBoolean": true,
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "comprimé(s)",
"system": "http://snomed.info/sct",
"code": "428673006"
}
}
],
"maxDosePerPeriod": {
"numerator": {
"value": 4,
"unit": "g",
"system": "https://ucum.org",
"code": "g"
},
"denominator": {
"value": 1,
"unit": "day",
"system": "http://hl7.org/fhir/ValueSet/duration-units",
"code": "d"
}
}
}
],
"medicationReference": {}
}1 à 2 gélules matin midi et soir pendant 7 jours, puis 1 matin et soir pendant 1 mois
Example2
{
"resourceType": "MedicationRequest",
"status": "unknown",
"intent": "proposal",
"dosageInstruction": [
{
"sequence": 0,
"text": "1 à 2 gélules matin midi et soir pendant 7 jours",
"timing": {
"repeat": {
"frequency": 3,
"period": 1,
"periodUnit": "d",
"when": ["EVE", "MORN", "NOON"],
"boundsDuration": {
"unit": "day",
"value": 7,
"system": "http://hl7.org/fhir/ValueSet/duration-units",
"code": "d"
}
}
},
"doseAndRate": [
{
"doseRange": {
"low": {
"value": 1,
"unit": "Gélule(s)",
"system": "http://snomed.info/sct",
"code": "943299900010000008"
},
"high": {
"value": 2,
"unit": "Gélule(s)",
"system": "http://snomed.info/sct",
"code": "943299900010000008"
}
}
}
]
},
{
"sequence": 1,
"text": "1 matin et soir pendant 1 mois",
"timing": {
"repeat": {
"frequency": 2,
"period": 1,
"periodUnit": "d",
"when": ["EVE", "MORN"],
"boundsDuration": {
"unit": "month",
"value": 1,
"system": "http://hl7.org/fhir/ValueSet/duration-units",
"code": "mo"
}
}
},
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "Gélule(s)",
"system": "http://snomed.info/sct",
"code": "943299900010000008"
}
}
]
}
],
"medicationReference": {}
}1000 mg tous les lundi à 8 h, du 1/12/2024 au 31/03/25
Example3
{
"resourceType": "MedicationRequest",
"status": "unknown",
"intent": "proposal",
"dosageInstruction": [
{
"text": "1000 mg lundi à 8 h du 1/12/2024 au 31/03/25",
"timing": {
"repeat": {
"frequency": 1,
"period": 1,
"periodUnit": "wk",
"dayOfWeek": ["mon"],
"timeOfDay": ["08:00:00"],
"boundsPeriod": {
"start_date": "2024/12/01",
"end_date": "2025/03/31"
}
}
},
"doseAndRate": [
{
"doseQuantity": {
"value": 1000,
"unit": "mg",
"system": "https://ucum.org",
"code": "mg"
}
}
]
}
],
"medicationReference": {}
}1 injection 1 à 2 fois par jour sur 6 à 8 h
Example4
{
"resourceType": "MedicationRequest",
"status": "unknown",
"intent": "proposal",
"dosageInstruction": [
{
"text": "1 injection 1 à 2 fois par jour",
"timing": {
"repeat": {
"duration": 6,
"durationMax": 8,
"durationUnit": "h",
"frequency": 1,
"frequencyMax": 2,
"period": 1,
"periodUnit": "d"
}
},
"doseAndRate": [
{
"doseQuantity": {
"value": 1,
"unit": "Injection(s)",
"system": "http://snomed.info/sct",
"code": "943299900010000005"
}
}
]
}
],
"medicationReference": {}
}