Przejdź do treści

ProductDefinition — medication (produkt leczniczy)

Konwencja atrybutów klasy medication zasobu ProductDefinition. Obejmuje leki gotowe, galenowe, recepturowe, homeopatyczne, szczepionki i produkty immunologiczne. Wariant przygotowania i kategorie regulacyjne są cechami (preparation-type, pharmaceutical-category), nie osobnymi klasami.

type = product-class / medication (źródło detaliczne) albo warehouse/product-definition-type / medicine (źródło magazynowe). Klasa nie ma osobnego schematu ani wymuszanych pól; poniższa tabela opisuje, jakie kody atrybutów niosą leki.

1. Konwencja atrybutów

Poza cechami wspólnymi (unit-of-measure, vat-rate, producer, product-group) i identyfikatorami katalogowymi (identifier[]: EAN, ProductDefinition.Id, ProductDefinition.Number) lek niesie w attribute[] (system product-definition-attribute-type):

attribute.code Wariant value Słownik wartości
atc valueCodeableConcept klasyfikacja ATC (https://www.whocc.no/atc)
pharmaceutical-form (postać) valueCodeableConcept kody nadaje wdrożenie
strength (dawka) valueString —
availability-category (kategoria dostępności) valueCodeableConcept product-availability-category (Rp, Rpw, Rpz, OTC, Lz)
marketing-authorization (pozwolenie) valueString —
preparation-type (sposób przygotowania) valueCodeableConcept kody nadaje wdrożenie
pharmaceutical-category (kategoria regulacyjna) valueCodeableConcept kody nadaje wdrożenie
storage-condition (warunek przechowywania) valueCodeableConcept kody nadaje wdrożenie
intended-use (przeznaczenie) valueCodeableConcept kody nadaje wdrożenie

Źródło detaliczne wypełnia dziś atc, pharmaceutical-form, strength, availability-category. Źródło magazynowe używa własnego słownika warehouse/product-definition-attribute-type i wypełnia odpowiedniki: form (postać), dose (dawka), package, producer, country, international-name, trade-name oraz jednostki miary (unit-name-*, unit-factor-*, unit-id-*) — wszystkie jako valueString.

2. Przykład (źródło detaliczne)

{
  "resourceType": "ProductDefinition",
  "type": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-class", "code": "medication", "display": "Produkt leczniczy" }] },
  "name": "Paracetamol 500 mg tabletki",
  "identifier": [
    { "system": "https://gov.pl/ean", "value": "05909991234567" }
  ],
  "attribute": [
    { "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-definition-attribute-type", "code": "atc" }] },
      "value": { "valueCodeableConcept": { "coding": [{ "system": "https://www.whocc.no/atc", "code": "N02BE01" }] } } },
    { "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-definition-attribute-type", "code": "pharmaceutical-form" }] },
      "value": { "valueCodeableConcept": { "coding": [{ "code": "tabl.", "display": "tabl." }] } } },
    { "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-definition-attribute-type", "code": "strength" }] },
      "value": { "valueString": "500 mg" } },
    { "code": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-definition-attribute-type", "code": "availability-category" }] },
      "value": { "valueCodeableConcept": { "coding": [{ "system": "https://api-erp.kamsoft.pl/vs/product-availability-category", "code": "OTC" }] } } }
  ]
}

Ten sam lek ze źródła magazynowego niesie type = medicine (system …/vs/warehouse/product-definition-type) oraz atrybuty form = tabl. i dose = 500 mg (system …/vs/warehouse/product-definition-attribute-type).

3. Odniesienia