Automatisk format- och författningskontroll - HUMAN
1 Inledning
1.1 Syfte
Syftet med automatisk format- och författningskontroll är att säkerställa receptens kvalitet innan de sparas i Nationella läkemedelslistan.
1.2 Målgrupp
Denna handbok riktar sig till apoteks- och vårdaktörer med IT-system som nyttjar E-hälsomyndighetens tjänster samt systemleverantör som utvecklar eller förvaltar dessa IT-system.
1.3 Informationsnivå
Allmän information
1.4 Kort beskrivning
Automatisk format- och författningskontroll (AFF) består av ett antal kontrollpunkter som var och en utför en specifik kontroll av ett recepts innehåll. Varje enskild kontrollpunkt resulterar i antingen en acceptans, en acceptans med varning eller en avvisning.
Brister i ett recept som bedöms som ringa och som kan rättas manuellt av farmaceut klassificeras som accepterad med varning, medan övriga brister klassificeras som avvisningar.
Recept som blivit accepterade eller accepterade med varning kategoriseras som expedierbara. Avvisade recept kategoriseras som ej expedierbara.
För recept till människa finns det vid förskrivning med NEF-formatet två kontrollsamlingar:
AFF-NEF: Kontrollen genomförs på e-recept som inkommer till Nationella läkemedelslistan via ett vårdinformationssystem.
AFF-MAK: Kontrollen genomförs på en makuleringsbegäran som inkommer till Nationella läkemedelslistan via ett vårdinformationssystem.
1.5 Definitioner och förkortningar
Se Begreppskatalogen för ytterligare beskrivning.
2 Beskrivning av kontrollsamling
2.1 AFF-NEF
Vid inkommande e-recept från vårdinformationssystemen kontrolleras receptsamlingen enligt AFF-NEF. Kontrollen kan resultera i accepterat, accepterat med varning eller avvisning.
Receptsamling som accepteras eller accepteras med varning sparas i NLL och kategoriseras som expedierbar. Motiveringen till att varningar accepteras är att bristerna inte anses utgöra absolut expeditionshinder. Dessutom kan det vara en patientsäkerhetsfråga om lång tid förflyter från förskrivning till dess att kund får tillgång till receptet.
Recept innehållande brister som utgör absolut expeditionshinder och som inte kan bli expedierbara genom korrigering av farmaceut, avvisas till vårdaktör för rättning. Recepten sparas inte i NLL.
2.2 AFF-MAK
Vid makulering av ett e-recept i Nationella läkemedelslistan via ett vårdinformationssystem kontrolleras makuleringen enligt AFF-MAK. En makuleringsbegäran kan antingen bli accepterad eller avvisad.
Resultatet av en accepterad eller avvisad makulering returneras i en makuleringskvittens.
Då makuleringsmeddelandet innehåller grava fel är det ej möjligt att spara makuleringen i Nationella läkemedelslistan, detta kommer då att avvisas och receptet som makuleringsbegäran avsåg får status Parkerad.
3 Kontrolluppbyggnad
3.1 Kontrollstruktur
AFF-strukturen är uppbyggd så att den består av ett antal separata kontroller som var och en utför en bestämd kontroll. Tillsammans bildar dessa kontroller en AFF-samling.
Vissa kontroller utförs endast under förutsättning att en annan kontroll har gått bra. Till exempel kan det vara så att en kontroll säkerställer att en receptterm har ett innehåll (det vill säga att termen inte är tom). Finns ett innehåll utförs en annan kontroll som verifierar att termens innehåll är korrekt.
Alla ingående kontroller i en AFF-samling, som inte är beroende av annan kontroll, ska alltid utföras. Kontrollen avbryts alltså inte då ett fel påträffas. De fel som hittas samlas i en AFF-fellista som sparas med receptet och returneras till anropande system.
Hittas avvisningar eller varningar sätts AFF-status, kommentarer och rekommenderade åtgärder för det kontrollerade receptet.
Se Appendix A för mer information.
AFF:s struktur. Kontroll 3 och 4 utförs endast om kontroll 2 utförts utan fel.
4 Definitioner
4.1 Läkemedel, hjälpmedel och livsmedel
Som läkemedel räknas alla artiklar där LAKEMEDEL = "Y" enligt VARA.
Som hjälpmedel räknas alla artiklar där Produkttyp = "FOR" eller "TJA" enligt VARA.
Som livsmedel räknas alla artiklar där Produkttyp = PLI enligt VARA.
Som teknisk sprit räknas gruppvarunummer 640000 och alla artiklar där Produkttyp = ALK enligt VARA.
4.2 Särskilt läkemedel
Som särskilt läkemedel räknas artiklar som är markerade i VARA med Särskilt läkemedel =Y.
4.3 Giltigt textvärde
Giltigt textvärde avser att textens längd > 0 efter trunkering av inledande och avslutande blanktecken.
4.4 Tillåtna tecken i förskrivarens namn
Med giltiga tecken i förskrivarens namn (AFF 02036) avses att fältet endast innehåller bokstäver och skiljetecken enligt UTF8. Tillåtna tecken specificeras på handbokssidan Tillåtna tecken i element och attributdata.
4.5 Kontroll om förskrivarkoden är korrekt
Följande syntaktiska kontroller görs av förskrivarkoden:
koden måste vara exakt sju (7) siffror lång
koden får inte enbart bestå av nollor eller innehålla några blanktecken
sista siffran är en kontrollsiffra som måste stämma enligt modulus10 nedan.
Kontrollsiffran beräknas enligt följande (modulus10):
Talet utan kontrollsiffra multipliceras omväxlande med 2 och 1 räknat från höger och adderas sedan ihop. Blir något tal större än 9 adderas tiotalsiffrorna och entalssiffrorna separat. Entalssiffran i resultatet dras sedan från 10 och resultatet är kontrollsiffran.
Exempel:
1 2 3 4 5 7
1 2 1 2 1 2
----------------------
1+4+3+8+5+1+4 = 26
10 - 6 = 4 --->Kontrollsiffra = 4
Specialfall: om entalssiffran är 0 så blir även kontrollsiffran 0.
Kontrollerna kan utföras även om tillgång till Legitimationsregistret saknas.
5 Regelverk
Samtliga kontroller i regelverket nedan ska genomföras och det allvarligaste upptäckta felet ska rapporteras till anropande system.
Kan kontroll för AFF-NEF eller AFF-MAK inte genomföras i sin helhet (till exempel om ett nödvändigt stödregister inte är tillgängligt) ska det hanteras olika beroende på om kontrollen är avvisande eller varnande:
- Misslyckas kontakt med underliggande system för avvisande AFF ska tekniskt fel skickas.
- Misslyckas kontakt med underliggande system för varnande AFF ska kontrollen hoppas över.
5.1 Förklaring av tabell och koder
AFF-status
- 0 = Accepterat utan upptäckta fel
- 1 = Accepterat med varningar
- 2 = Avvisat, kan inte hanteras av mottagaren.
AFF Felkod
Varje AFF-kontroll kan generera en felkod som namnsätts enligt Prefix"nn". "nn'"är ett löpnummer för en specifik AFF-kontroll.
5.2 Förtydliganden avseende regeltabellen
Dynamiska felmeddelanden
Där felmeddelanden innehåller fält omslutna av <> skall fälten ersättas av aktuella värden från underliggande system.
Misslyckas kontakt med underliggande system så att komplettering av feltext inte kan göras, ska fältet istället innehålla det angivna värdet från indata.
5.3 Regeltabell humanrecept
Följande felkoder har 020 som prefix.
AFF- | AFF-MAK | AFF-Felkod | Beskrivning | Villkor | Felmeddelande | Kommentar |
2 | - | 02 | Varunummer/NPL Pack-id måste finnas i VARA | Obligatoriskt för alla varunummer eller NPL Pack-id'n. Kontrollerar om varunummer eller NPL Pack-id är ett giltigt textvärde och om varan är registrerad i VARA | En ogiltig vara med varunummer/NPL Pack-id <varunummer/NPL Pack-id> har använts för något recept. Tillägg felmeddelande för AFF-NEF: | |
2 | - | 03 | Om varan är ett läkemedel får varan inte vara avregistrerad | Kontrolleras om varan är ett läkemedel och är markerad som avregistrerad i VARA | <Varunamn> med varunummer/NPL Pack-id <varunummer/NPL Pack-id> har utgått. Tillägg felmeddelande för AFF-NEF: | Handelsvaror fångas upp i 02015 eftersom de utgår ur förmånen om de avregistreras/utgår. |
2 | 2 | 05 | Utfärdarnamn måste vara ifyllt före expediering/makulering | Obligatoriskt. Utfärdarnamn ska ha ett giltigt textvärde | Förskrivarens namn finns inte angivet. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | |
1 | - | 06 | Angivet expedieringssintervall får max sträcka sig över ett år | Obligatoriskt. Både intervall och enhet måste vara ifyllt. Gränsvärden gäller för respektive enhet. | Orimliga värden för expedieringsintervall har angivits. Tillägg felmeddelande för AFF-NEF: | |
2 | - | 08 | Enbart läkemedel kan förskrivas med flerval och då ska läkemedelsform, styrka och dosering vara gemensam | Kontrolleras om artikeln finns i VARA. Radnumreringen ska vara i sekvens enligt XML-specifikationen. Textjämförelse för varje inkommande flervalsrad av de aktuella fälten. Ska vara helt lika och inte null. | Förskrivet flerval (flera förpackningsstorlekar) avser inte samma läkemedel, läkemedelsform, styrka eller dosering. Receptsamlingen är avvisad. | |
2 | - | 09 | Doseringsanvisning krävs för vissa varor | Kontrolleras om artikeln finns i VARA, är ett läkemedel eller teknisk sprit. Kontrollerar om fält för dostext är ett giltigt textvärde. | Doseringsanvisning saknas, vilket är obligatoriskt för läkemedel eller teknisk sprit. Tillägg felmeddelande för AFF-NEF: | |
1 | - | 10 | Startförpackning får inte förskrivas/expedieras för vissa varor | Kontrolleras om artikeln finns i VARA och är ett särskilt läkemedel eller teknisk sprit. Kontrollerar så att flagga för startförpackning inte är true. | Startförpackning har felaktigt angivits för särskilda läkemedel. Tillägg felmeddelande för AFF-NEF: | |
1 | - | 13 | Max ett uttag tillåtet för teknisk sprit | Kontrollerar om varan är markerad som teknisk sprit i VARA och om antal uttag är > 1. | Fler än ett uttag har angivits för teknisk sprit. Tillägg felmeddelande för AFF-NEF: | |
1 | - | 14 | Vid förmån angiven ska för vissa varor angiven arbetsplatskod finnas i arbetsplatskodsregistret | Kontrolleras om artikeln finns i VARA och är ett läkemedel eller hjälpmedel. Vid förmån kontrolleras om arbetsplatskoden var markerad som Giltig i Arbetsplatskodsregistret vid tidpunkten för receptets utfärdande. | Ogiltig arbetsplatskod har angivits. Tillägg felmeddelande för AFF-NEF: | |
1 | - | 15 | Vid förmånstyp R ska varan vara förmånsberättigad | 1. Kontrolleras om varan är markerad Med förmån i VARA. 2. Kontrolleras om varan är ett livsmedel och om patienten är yngre än 16 år. | <Varunamn> med varunummer/ NPL Pack-id <varunummer/ NPL Pack-id > omfattas inte av förmånen. Tillägg felmeddelande för AFF-NEF: Om varan inte är utbytbar kan expedition endast ske utan förmån. | |
2 | 2 | 16 | Finns förskrivarkoden i Legitimationsregistret | Kontrolleras om förskrivarkoden finns i Legitimationsregistret. Kan vara en registrerad förskrivare eller gruppförskrivare. | Giltig förskrivarkod saknas. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Förskrivarkoden får aldrig förändras. |
1 | - | 17 | Marknadsförs/tillhandahålls varan i Sverige | Kontrolleras om varan är markerad med Tillhandahålls = "Y" enligt VARA | <Varunamn> med varunummer/NPL Pack-id <varunummer/ NPL Pack-id > marknadsförs inte av någon leverantör i Sverige. | |
2 | 2 | 18 | Är personnummer korrekt formaterat med korrekt checksiffra | Kontrolleras om personnummer är giltigt. Obligatorisk kontroll att person-nummer är giltigt med avseende på längd, värde för år, månad, dag och checksiffra. Här kontrolleras om checksiffran är fel. | Patientens personnummer är felaktigt. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Personnummer får inte ändras (korrigeras) |
2 | - | 19 | Om födelsedatum används måste receptet direktadresseras till ett specifikt apotek. Om personnummer används får receptet inte direktadresseras till ett specifikt apotek. | För födelesedatumrecept: Kontrolleras att personnummer saknas och att GLN-kod finns i Expeditionsställeregistret. Receptbrevlådan får inte anges, vilket exkluderar 2 stycken GLN-koder från Apotekslistan som giltigt värde i DesignatedMessagerReciver. För personnummerrecept: Kontrolleras att personnummer finns och att receptet inte är adresserat till något annat än Receptbrevlådan. | För födelesedatumrecept: Angiven mottagare <apoteksnamn> får inte användas då endast födelsedatum anges som identitet på patient. Receptsamlingen är avvisad. För personnummerrecept: Direktadressering till ett specifikt apotek är inte tillåtet när förskrivning utfärdas på personnummer.Receptsamlingen är avvisad. | Följande GLN-koder tillhör Receptbrevlådan i olika miljöer: 7350045514448 (Externtest) |
2 | - | 20 | Om födelsedatum används ska kön vara angivet | Kontrolleras om personnummer är ogiltigt. Kontrollerar om fält för kön = 1, 2 eller 3. | Patientens kön har inte angivits, vilket är obligatoriskt vid förskrivning med enbart födelsedatum. Receptsamlingen är avvisad. | |
2 | 2 | 21 | Finns förskrivarkod | Obligatorisk. Fältet förskrivarkod ska vara ett giltigt textvärde och skilt från '0000000'. Följande syntaktiska kontroller görs av förskrivarkoden: - koden är exakt sju (7) tecken lång - sista siffran, kontrollsiffran stämmer enligt modulus10. | Förskrivarkod saknas. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Förskrivarkoden får aldrig förändras. |
2 | 2 | 22 | Meddelandets sändare ska alltid vara samma person som är förskrivare eller makulerare | Jämförelse av förskrivarkod och sändarens förskrivarkod. Jämförelse av förskrivarkod/ gruppförskrivarkod vid nytt recept eller makuleringsbegäran och SAML-intygets innehavare och meddelandets sändare Jämförelse av förskrivarens/makulerarens förskrivarkod, sändarens förskrivarkod och säkerhetsintygets förskrivarkod | Meddelandets sändare och förskrivare är inte identiska. SAML-intygets innehavare, meddelandets sändare och förskrivare är inte identiska. Receptsamlingen är avvisad. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Kodvärde för sändande person valideras mot kodvärde för förskrivande person. Även SAML-intyget valideras - Innehavare ska vara densamme som förskrivare eller makulerare och sändare. Kodvärde för sändande person valideras mot kodvärde för förskrivande person. Om kodvärdet är en individuell förskrivarkod så valideras den även mot säkerhetsintyget. |
2 | 2 | 25 | Födelsedatum måste vara ett giltigt datum | Orimligt värde =om datum (8 första tecknen) i PNR eller FDA är > dagens datum eller < än dagens datum minus 130 år. Om något villkor uppfylls, avvisas e-receptsamlingen. | Födelsedatum måste vara ett giltigt datum. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | |
2 | - | 26 | Giltigt apotek måste vara angivet | Inträffar något av följande alternativ avvisas receptet: 1. Om GLN-kod saknas i Expeditionsställeregistret avvisas receptet med <Apoteksnamn och Ort> satt till <Namn okänt> 2. Om GLN-kod finns i Expeditionsställeregistret och om samtliga apotek som hålls samman i ett ExpoLankId har tillståndsstatus = Indraget, Saknas eller Ej tillämpbart avvisas receptet med <Apoteksnamn> och <Ort> 3. Om GLN-kod finns i Expeditionsställeregistret och om alla apotek som hålls samman i ett ExpoLankId är stängda (enligt Startdatum verksamhet och Slutdatum verksamhet i EXPO) avvisas receptet med <Apoteksnamn> och <Ort> | Angivet apotek <Apoteksnamn, Ort> är ogiltigt eller ej driftsatt. Receptsamlingen är avvisad. | Kontrollen genomförs vid all specifik adressering i fältet designated message reciever |
2 | 2 | 27 | UUID måste följa standard | Värdet är angivet enligt standard RFC 4122 Syntaxkontroll: streck på rätt ställe, att det är hexadecimala tecken, samt rätt antal tecken | Något av meddelandets Recept-ID (UUID) följer inte standard eller innehåller syntaxfel. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Enligt RFC4122 används 36 tecken Enligt XML schemat får fältet innehålla upp till 41 tecken. Kontroll sker på följande fält: PrescriptionSetId, IdOfMessageBySender och InterchangeRef. |
2 | - | 28 | Kontroll av dubbletter | Kontrollerar att värdet i PrescriptionSetId, inte har använts som en identitet på en godkänd receptsamling. Om värdet redan finns, avvisas receptsamlingen. Datum och klockslag för uppdateringen läses för att ingå i aperakens felmeddelande. | För AFF-NEF: Denna varning är orsakad av ett dubblettkontrollfel eller ett omsändningsförsök. En receptsamling med samma recept ID (UUID) är redan mottagen <dat. kl.> | |
2 | 29 | Är förskrivare behörig att makulera vald artikel | Finns en giltig förskrivarkod angiven på makuleringsbegäran kontrolleras om förskrivare har någon yrkeskod (Legitimationsregistret) som är behörig att förskriva angiven artikel enligt parametern "Forskrivningsratt" i VARA. Följande yrkeskoder kontrolleras: Tandhygienist Saknas giltig förskrivarkod på receptet kontrolleras om angiven utfärdarkategori är behörig att förskriva angiven artikel enligt parametern "Forskrivningsratt" i VARA. Följande utfärdarkategorier kontrolleras: Villkor: Om Utfardarkategori = SSK eller HJM och förskrivarkod = 9610007 eller 9600008 kontrolleras att varan inte är ett läkemedel med undantag av läkemedel med ATC-kod = V03AB15 | Ogiltig kombination av utfärdarkategori och förskriven artikel.
| Tandläkare med specialistkompetens i oral kirurgi och käkkirurgi får förskriva läkemedel till människa i den omfattning som krävs för diagnostik och behandling av sjukdomar, skador och defekter i käkar och munhåla samt omgivande vävnader | |
2 | 2 | 30 | Är förskrivarens legitimation giltig | Saknas angiven förskrivarkod på receptet utgår denna kontroll. Kontrollera om det finns någon giltig begränsning i Legitimationsregistret. 001 -Deslegitimerad och datum för indragningen < utfärdardatum 006 - Tillfällig legitimation och t.o.m.<utfärdardatum 007 -Tillfällig legitimation upphört fr.o.m < utfärdardatum | Angiven förskrivarkod är ogiltig. Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Trots ogiltig behörighet ska recept registreras enligt original (HSLF-FS 2019:32) Vid deslegitimation tar Socialstyrelsen bort checksiffran i Legitimationsregistret. Recept utfärdade innan behörighetens begränsningsdatum ska dock kunna expedieras. |
- | 2 | 31 | Är ingående receptidentiteter (UUID och radnr) unika | Kontrolleras att makuleringsbegärans ingående "Cancellation Id" är unika. | Makuleringen innehåller inte unika recept. | Gäller recept inom en makuleringsbegäran. Ingen slagning mot Nationella läkemedelslistan. |
- | 2 | 32 | Angivna receptidentiteter (UUID och radnr) måste vara registrerad på angiven patients personnummer eller födelsedatum | Kontrolleras att personnummer eller födelsedatum stämmer med utpekad receptpost i Nationella läkemedelslistan | Recepttillhörigheten stämmer inte överens med angiven patient. | |
2 | 2 | 33 | Finns personnummer med giltig status i folkbokföringen | Kontrollera att personnummer finns i FOLK och har giltig status. Giltiga statusar för AFF-NEF: Giltiga statusar för AFF-MAK: 0, 1, 2 (träffkod 73 eller 74), 3, 5, 6 | Personnumret finns inte registrerat med giltig status i folkbokföringen Tillägg felmeddelande för AFF-NEF: Tillägg felmeddelande för AFF-MAK: | Ogiltig status kan exempelvis vara Avliden |
2 | - | 34 | Kontrollerar att NPL-id och NPL Pack-id inte är motstridiga | Vid inkommande NPL-id och NPL Pack-id kontrolleras mot VARA om dessa hör ihop. Denna kontroll utförs enbart om NPL-värden angetts. Om varunummer finns angivet kontrolleras att även det hör till samma artikel | Ogiltig kombination av NPL-id <NPL-id> och NPL Pack-id <NPL Pack-id>. Tillägg felmeddelande för AFF-NEF: | Värden räknas som motstridiga om dessa inte identifierar samma artikel och produkt |
2 | 2 | 36 | Innehåller förskrivarens namn otillåtna tecken | Följande fält valideras: --- HealthcarePerson / ---- Name Om angivet namn innehåller otillåtna tecken avvisas receptet eller makuleringsbegäran. | Förskrivarens namn innehåller otillåtna tecken. Tillägg felmeddelande för AFF-NEF Tillägg felmeddelande för AFF-MAK: | |
2 | - | 37 | Avviker förskrivningsdatumet från mottagningsdatumet | Följande fält valideras: PrescriptionSetIssueTime och IssueDateAndTimeOfMessage. Mottagningsdatum får inte > än PrescriptionSetIssueTime plus 4 dygn. eller Mottagningsdatum får inte vara > IssueDateAndTimeOfMessage plus 4 dygn och Mottagningsdatum får inte vara < PrescriptionSetIssueTime eller Mottagningsdatum får inte < än IssueDateAndTimeOfMessage | Förskrivningsdatumet avviker från mottagningsdatumet. Receptsamlingen är avvisad. | En receptsamling får inte vara äldre än 4 dagar från det att det skapats till dess att det tagits emot på E-hälso-myndigheten. 4 dagar på grund av driftavbrott vid till exempel långa helger. En receptsamling kan inte skapas på ett framtida datum. |
2 | - | 38 | Är angivet begränsningsdatum för det första uttaget rimligt | Validering av datumfältet ska ske enligt följande: LatestRequestedTimeForDispensing får inte vara < än mottagningsdatum eller LatestRequestedTimeForDispensing får inte vara = mottagningsdatum | Ett ogiltigt datum har angivits för det första uttaget Receptsamlingen är avvisad. | En receptsamling kan inte ha en alltför kort giltighetstid. Patienten måste ha en möjlighet att hinna hämta ut förskrivningen. |
2 | - | 39 | Är inskickad utfärdarkategori korrekt angiven | Kontroll: Finns förskrivarkoden i Legitimationsregistret med giltig status? Kontrolleras att inskickad utfärdarkategori motsvarar någon av förskrivarens yrkeskoder i Legitimationsregistret. | Förskrivaren saknar angiven utfärdarkategori Receptsamlingen är avvisad. | |
2 | - | 40 | Får vald artikel ordineras av en förskrivare med angiven utfärdarkategori | Kontroll: Finns angiven artikel i VARA?
Följande yrkeskoder kontrolleras: Tandhygienist Villkor: Om utfärdarkategori=SSK eller HJM och förskrivarkod =9610007 eller 9600008 kontrolleras att varan inte är ett läkemedel med undantag av läkemedel med ATC-kod = V03AB15 Om Yrkeskod=TL kontrolleras om specialistkod= 04 (oral kirurgi) eller specialistkod = 0490 (käkkirurgi) | Ogiltig kombination av utfärdarkategori och vara Receptsamlingen är avvisad | Om angiven utfärdarkategori=TAN och specialistkod= 04 (oral kirurgi) eller specialist kod = 0490 (käkkirurgi) används yrkeskod =LK för kontroll av förskrivningsrätten i VARA |
| 1 | - | 41 | Om varan är ett läkemedel får varan inte vara markerad som försäljningsstoppad | Kontrolleras om varan är ett läkemedel och är markerad som försäljningsstoppad i VARA | <Varunamn> med varunummer/NPL Pack-id <varunummer/NPL Pack-id> är försäljningsstoppad. Tillägg felmeddelande för AFF-NEF: Receptet är mottaget för vidare hantering | |
| 2 | - | 42 | Om varan är ett läkemedel måste NPL Pack id och NPL-id vara angivet | Kontrolleras om varan är ett läkemedel enligt VARA och om den förskrivna varan identifierats med NPL-värden | Ogiltig varuidentitet har angivits för någon receptrad. Obligatoriskt att använda NPL-identiteter vid förskrivning av läkemedel. Receptsamlingen är avvisad. | |
| 2 | 2 | 43 | Vid e-receptförskrivning ska angiven arbetsplatskod finnas i arbetsplatskodsregistret | Kontrolleras om arbetsplatskod finns och är skild från enbart nollor, samt om angiven arbetsplatskod kan identifieras och finns i Arbetsplatskodsregistret | En okänd arbetsplatskod har angivits. Tillägg felmeddelande för AFF-NEF: Receptsamlingen är avvisad Tillägg felmeddelande för AFF-MAK: Makuleringsbegäran är avvisad. | Okända/anonyma arbetsplatskoder accepteras inte av säkerhetsskäl då dessa blir helt anonyma i kombination med gruppförskrivarkoder. Varken förskrivare, vårdande enhet eller avtalspart kan identifieras. |
5.4 Inaktiverade kontroller
AFF-NEF | AFF-MAK | AFF-Felkod | Beskrivning | Villkor | Felmeddelande | Kommentar |
1 | - | 02011 | För särskilda läkemedel bör kundinformation vara angivet | Kontrolleras om artikeln finns i VARA och är ett särskilt läkemedel. Kontrollerar om personnummer/födelsedatum, gatuadress, postnummer och ort är giltiga. | Särskilda läkemedel har förskrivits utan fullständiga patientuppgifter (personnummer/ födelsedatum, gatuadress, postnummer och ort) Tillägg felmeddelande för AFF-NEF: Receptet är mottaget för vidare hantering. | AFF 02011 har utgått efter uppdatering av receptföreskrifterna (HSLF-FS 2021:75) |
1 | - | 02012 | Max ett uttag tillåtet för vissa narkotiska varor om det inte står på receptet att det ska förvaras på namngivet apotek | Kontrolleras om artikeln finns i VARA och är ett särskilt läkemedel. Kontrollerar om varan är markerad som Narkotika och ej Itererbar enligt VARA och antal uttag är > 1. | Fler än ett uttag har angivits för narkotiska läkemedel enligt Tillägg felmeddelande för AFF-NEF: | Utgick 2016 |
1 | - | 02024 | Angivet konto måste ha rätt format. | Obligatorisk om arvode är angivet. För kontotyp BGI och PGI utförs checksiffrakontroll för konto. | Ogiltigt kontonummer har angivits för arvode. Arvode kan inte tas ut. Tillägg felmeddelande för AFF-NEF: Receptsamlingen är mottagen. | UTGÅTT - Arvode skall ej tas av kund. |
6 Felinformation
6.1 Felinformation för NEF-fel
Följande information ska loggas då fel upptäckts, för uppföljning.
Term | Beskrivning |
Tidpunkt för kontroll | ccyy-mm-ddThh:mm |
Receptid | PrescriptionSetId |
Huvudstatus på meddelandet. (AFF-status) | (0 = Accepterat utan upptäckta fel) 1 = Accepterat med varningar 2 = Avvisat, kan ej hanteras av mottagaren. Förtydligande: Får viktat värde från AFF-status på förskrivningsoriginal eller om någon av receptraderna har ett allvarligare fel som då förskrivningsoriginalet får ärva. Viktade värden 0, 1 och 2:
Viktade värden används externt då AFF-status på grund av det internt historiskt varit så att etcRR har motsvarande värden 1, 0 och 2. XML-NEF: MessageStatus |
Statuskod | Valideringsfel XML-schema: 010nn Validering av verksamhetsregler: 020nn XML-NEF: StatusCode |
Beskrivning | Beskrivning av fel. XML-NEF: Description |
Feltyp | 'nn', Feltyp enligt Schema. |
PatientID | Personnummer eller födelsedatum. För att kunna göra sökning i fellogg på fråga från kund på apotek |
Arbetsplatskod | För att kunna göra sökningar i fellogg på fråga från region |
Förskrivarkod | För att kunna göra sökningar i fellogg på fråga från region |
7 Appendix A - Kontrollstruktur förskrivning
Följande tabeller visar sambandet mellan de enskilda kontroller som ingår i AFF. För att en kontroll på en högre nivå ska utföras krävs att kontrollen på den lägre nivån lyckades.
Exempel: Har receptet en förskrivarkod (FinnsForskrivarKod) så kontrollerar man att den inte skiljer sig från avsändarens förskrivarkod (OlikaForskrKodOchAvsKod).
Fält med svart text är kontroller. Fält med blå kursiv text är samlingsbegrepp för kontroller på högre nivå.
Exempel: (pnrOgiltigt) Patientens personnummer kontrolleras avseende kontrollsiffra (PnrCheckSiffraFel). Är den felaktig så kontrolleras att kön är angivet (FinnsKonAngivet) samt att mottagande apotek är ett specifikt lokalt apotek (MottagandeApoLokaltApo).
Kontroll |
|---|
Endast fråga, ger inget fel |
7.1 Kontroller på förskrivningsoriginal
Nivå1 | Nivå2 | Nivå3 | |||
|---|---|---|---|---|---|
Utfärdarnamn finns | 02005 | ||||
Förskrivarkod angiven | 02021 | Finns förskrivarkod registrerad | 02016 | ||
| Arbetsplatskod angiven | Finns arbetsplatskod registrerad | 02043 | |||
| | Förskrivarkod identisk med sändare | 02022 | | | |
Personnummer angivet | Korrekt personnummer | 02018 | |||
Personnummer med giltig status | 02033 | ||||
Födelsedatum angivet | Direktadresserat apotek | 02019 | |||
Finns kön angivet | 02020 | ||||
Giltigt födelsedatum | 02025 | ||||
Giltigt mottagande apotek | 02026 | ||||
Giltigt UUID | 02027 | ||||
Unik receptsamling | 02028 | ||||
Unika receptidentiteter | 02031 | ||||
Recept tillhör patient | 02032 |
7.2 Kontroller på recept
Nivå1 |
| Nivå2 |
| Nivå3 |
|
Vara finns registrerad | 02002 | Vara aktiv | 02003 | ||
Giltig kombination av NPL-id och NPL Pack-id | 02034 | ||||
Vara marknadsförs i Sverige | 02017 | ||||
| | | Vara beställningsstoppad | 02041 | | |
Flerval samma produkt | 02008 | ||||
Livsmedel till barn under 16 år | Livsmedel till barn | 02015 | |||
Förmånstyp R = varan förmånsberättigad. | Vara kan expedieras utan förmån om inget utbyte finns | 02015 | |||
Giltig arbetsplatskod | 02014 | ||||
Läkemedel eller teknisk sprit | Finns doseringsanvisning | 02009 | |||
| | | Läkemedel | | Finns NPL-värden | 02042 |
Särskilt läkemedel eller teknisk sprit | Finns startförpackning angiven | 02010 | |||
Teknisk sprit | Max ett uttag teknisk sprit | 02013 | |||
Förskrivarkod angiven | Giltig legitimation | 02030 | |||
Är inskickad yrkeskod korrekt angiven? | 02039 | Får vald artikel ordineras av en förskrivare med angiven yrkeskod? | 02040 | ||
Absolut expeditionsintervall | Expeditionsintervall giltigt | 02006 |
8 Appendix B Kontrollstruktur makulering
| Nivå 1 | | Nivå 2 | |
| UUID måste följa standard. | 02027 | | |
| Är personnummer korrekt formaterat med korrekt checksiffra? | 02018 | Finns personnummer med giltig status i folkbokföringen? | 02033 |
| Utfärdarnamn måste vara ifyllt före expediering/makulering. | 02005 | | |
| Innehåller förskrivarens namn otillåtna tecken? | 02036 | | |
| Finns förskrivarkod? | 02021 | | |
| Meddelandets sändare ska alltid vara samma person som är förskrivare eller makulerare | 02022 | | |
| Är ingående receptidentiteter (UUID och radnummer) unika | 02031 | | |
| Vid e-receptförskrivning ska angiven arbetsplatskod finnas i arbetsplatskodsregistret | 02043 | | |
| Finns förskrivarkoden i Legitimationsregistret? | 02016 | | |
| Kontrollerar om förskrivarens legitimation är giltig | 02030 | | |
| Är förskrivare behörig att makulera vald artikel? | 02029 | | |
| Födelsedatum måste vara ett giltigt datum. | 02025 | | |
| För personnummer | | Är personnummer korrekt formaterat med korrekt checksiffra? | 02018 |
| Angivna receptidentiteter (UUID och radnummer) måste vara registrerad på angiven patients personnummer eller födelsedatum). | 02032 | | |
9 Versionshistorik
| Version | Datum | Release | Beskrivning |
|---|---|---|---|
10.0 | 2014-10-14 | | Dokumentet har bytt namn till Automatisk format- och författningskontroll HUMAN. |
| 11.0 | 2016-02-05 | | Uppdaterat 02003 och lagt till 02041 Lagt till 02042 och 02043 Inaktiverat 02012 Uppdaterat App. B |
| 12.0 | 2017-10-03 | | Uppdaterat hänvisningar till Läkemedelsverkets föreskrifter om förordnande och utlämnande av läkemedel och teknisk sprit. AFF-EXP tagit bort kommentarskrav vid varning och lagt till att varningar nu måste godkännas innan expedition. Uppdaterat defintion särskild läkemedelskod 2, 3 och 4 enligt Läkemedelsverkets nya definition. Tagit bort tabell med inaktiverade AFF-kontroller som försvann i release 14.1 |
| 13.0 | 2017-11-05 | | Redaktionella ändringar Förtydligat felmeddelande i AFF 02034 Lagt till villkor för SSK och HJM i AFF 02040 Uppdaterat att recept avvisas i kontrollsamling AFF-MAK för AFF 02043 Tagit bort i tabell Inaktiverade kontroller de kontroller som togs bort före 2015 |
| 14.0 | 2019-01-02 | | 02022 Lagt till avvisning i AFF-MAK, uppdaterat ändrade villkor samt text 02029, 02040 Lagt till förskrivningsrätt för specialistkod 0490 Käkkirurgi, uppdaterat och lagt till villkor för SSK och HJM 02033 Uppdaterat förklaring för statuskod 1 |
| 15.0 | 2019-07-10 | | Korrigerat versionsnummer Kap 4 Definitioner - uppdaterat definitioner och lagt till kod 6 02022, förtydligat kring förskrivarkod 02029, korrigerat föreskrift 02033, uppdaterat förklarande text status 1, lagt till status 2 |
| 16.0 | 2019-12-09 | | 02015, uppdaterat om förmånstyp och uppdaterat felmeddelande AFF-NEF som börjar gälla 2 juni 2020 |
| 17.0 | 2020-11-02 | | 02015 Tagit bort datum för införande i AFF-tabellen |
| 18.0 | 2021-09-02 | | 02033 Uppdaterat träffkoder för giltiga statusar i villkor. Redaktionella ändringar |
| 19.0 | 2023-11-16 | | 02011, tagit bort kontroll som inte längre genomförs efter föreskriftsuppdatering 7.1 Tagit bort 02011 och 02012 i kontrollsstrukturen |
| 20.0 | 2024-11-05 | 21.11 | Befintlig implementation sedan 21.0:
|
| 21.0 | 2025-02-13 | 21.12 | 02019: Lagt till hantering för direktadresserade personnummerrecept 02043: Förtydligat att det även kontrolleras att värde finns och inte är enbart nollor. Appendix B: Ersatt bild med tabell samt uppdaterat enligt implementation. |
| 22.0 | 2025-04-29 | 21.13 | 02022: Rättat felaktigt felmeddelande (tagit bort "SAML-intygets innehavare, meddelandets sändare och förskrivare är inte identiska"), samt förtydligat Villkor och Kommentar. |
