DataPharm a/s Hollandsvej 12 2800 Lyngby telefon: 45 20 75 00 telefax: 45 20 75 10 Dokument D0005804.doc 24.08.2000 DataPharm ApoStat Snitflade til EDB leverandører Revision 3 Revision 1 Revision 2 Revision 3 31.07.2000 Første udgave. 14.08.2000 Rettet positioner for datafelter. 24.08.2000 Revideret af AHC
Indholdsfortegnelse. 1 Indledning...1-0 2 Håndtering af data filer...2-1 2.1 Data filers struktur...2-1 2.2 Tegn repræsentation...2-1 2.3 Navngivning af filer...2-1 2.4 Fil transport...2-1 2.5 Frekvens af fremsendelse...2-1 2.6 Lokal opbevaring af data filer...2-1 3 Data felter...3-2 3.1 Hvad skal indberettes?...3-2 3.2 Formater...3-2 4 Eksempel på datafil...4-3 D0005804.doc
Indledning 1 Indledning Nærværende snitflade beskriver regler for fremsendelse af salgstal for frihandelsvarer i f.m. DA strategi projekt 9 IT - Fælles datagrundlag til frihandelsvarer. Salgstal indberettes dagligt til statistik database placeret hos Apoteam a/s. Der indberettes oplysninger om alle varesalg, d.v.s. hver enkelt bonlinje (ekspeditionslinje). Indberetning skal ske via snitflade beskrevet i dette dokument. D0005804.doc 1-0
Håndtering af data filer 2 Håndtering af data filer 2.1 Data filers struktur Salgstal indberettes i tekstfiler med følgende struktur: Hver bonlinje er repræsenteret ved en linje i filen afsluttet med ASCII tegn 10 og 13. Hvert datafelt for bonlinjen er defineret som fast-længde felter med en nærmere angivet position og længde, se afsnit 3. 2.2 Tegn repræsentation Data filer skal anvende ISO 8859-1 tegnsættet. 2.3 Navngivning af filer Data filer skal navngives således at filnavnet er unikt og dermed ikke risikerer at overskrive andre data filer ved upload til FTP server. F.eks. på flg. måde: Data filer navngives efter formatet 99999DD.MM, hvor 99999 = apotekets 3-cifrede bevillingsnummer, afdelingens 2-cifrede nummer og DD angiver dag i måneden og MM angiver måned. DD og MM angiver ekspeditionsdato (dato for debitering / registrering i kassen). Filnavn for salgsdata fra apotek med bevillingsnummer 999 mandag d. 31.01.2000 bliver f.eks. således: 9990031.01 2.4 Fil transport Data filer uploades på Datapharms FTP server: www.datapharm.dk. For brugernavn og adgangskode kontakt Datapharm. 2.5 Frekvens af fremsendelse Salgstal for en given dag skal fremsendes i tidsrummet 00:00 til 06:00 den efterfølgende dag. 2.6 Lokal opbevaring af data filer Data filer opbevares lokalt mindst 14 dage af hensyn til support. D0005804.doc 2-1
Data felter 3 Data felter Her angives en nærmere beskrivelse samt valideringsregler for de enkelt datafelter. 3.1 Hvad skal indberettes? I skrivende stund har apotekerne ikke tilladelse til at udlevere omsætningstal for lægemidler, jvf. bekendtgørelse nr. 888 Bekendtgørelse om apotekernes videregivelse af oplysninger om omsætning af lægemidler af 07.10.1996. Såfremt apotekerne måtte opnå en dispensation m.h.t. indberetning salgstal for håndkøbslægemidler i fremtiden, skal håndkøbslægemidler indberettes sammen med frihandelsvarer via denne snitflade. Der indberettes ikke oplysninger om receptpligtige lægemidler. Salgsdata er detailoplysninger pr. transaktion, d.v.s. bonlinje. Der indberettes kun oplysninger om varesalg, ikke gebyrer og lignende. Der indberettes kun oplysninger om skrankesalg, ikke salg til f.eks. håndkøbsudsalg. 3.2 Formater N Består af cifrene 0-9 uden fortegn. Tal angives uden foranstillede 0-er. -N Består af cifrene 0-9. Negativt tal angives med foranstillet - umiddelbart foran tallet. D Dato i formatet ÅÅÅÅMMDD. Består af cifrene 0-9 uden separatorer. Felt Type Pos. Kar. Bemærkninger Apoteksnr N 1 3 Apotekets 3-cifrede bevillingsnummer. Afdelingsnr N 4 2 2-cifret kode for apoteksenhed. 00 = hovedapotek 01-09 = Filial 10-99 = Udsalg Afdelingsnummeret henviser til den omsætningsafdeling hvor varen er udleveret. Dato D 6 8 Dato for udlevering af varen til kunden Ekspeditionsnr. N 14 10 Nummer der identificerer ekpeditionen i apotekssystemet. Ordinationsnr. N 24 2 Nummer der identificerer ordinationen (bonlinjen) i apotekssystemet. Denne skal bruges til, sammen med ekspeditionsnummeret, at kunne identificere en salgstransaktion i apotekssystemet ved supportopgaver. Varenummer N 26 6 Varenummer iflg. det fælles datagrundlag, taksten. Antal pakninger -N 32 5 Antal pakninger ved udlevering. Antal pakninger må ikke være 0, der skal være tale om udlevering af mindst én vare. Antal pakninger kan være negativ, f.eks. ved returvare. AIP N 37 12 Apotekets indkøbspris pr. pakning ekskl. moms. Beløbet angives i øre. AIP bør AIP for de(n) solgte pakning(er). Hvis dette ikke er registreret i apotekssystemet indberettes AIP ved sidste hjemkøb af varen. AUP N 49 12 Apotekets udsalgspris pr. pakning inkl. moms. Beløbet angives i øre. AUP skal være apotekets faktiske udsalgspris, korrigeret for evt. udsalgsrabatter. Momspct. N 61 3 Momsprocent af AUP. Afslutningstegn 64 2 CR/LF. D.v.s. ASCII tegn 13 og 10. D0005804.doc 3-2
Eksempel på datafil 4 Eksempel på datafil 9990020000106 60091 1791798 1 000 300 25 9990020000106 60092 1414979 1 924 1870 25 9990020000106 60093 1413955 1 12208 18310 25 9990020000106 60094 1773994 1 000 100 25 9990020000106 60098 1142612 1 11194 18100 25 9990020000106 60098 2142554-1 11194 18100 25 9990020000106 60099 1137539 1 1659 3220 25 D0005804.doc 4-3