ApoStat Snitflade til EDB leverandører

Transkript

1 DataPharm a/s Hollandsvej Lyngby telefon: telefax: Dokument D doc DataPharm ApoStat Snitflade til EDB leverandører Revision 3 Revision 1 Revision 2 Revision Første udgave Rettet positioner for datafelter Revideret af AHC

2 Indholdsfortegnelse. 1 Indledning Håndtering af data filer Data filers struktur Tegn repræsentation Navngivning af filer Fil transport Frekvens af fremsendelse Lokal opbevaring af data filer Data felter Hvad skal indberettes? Formater Eksempel på datafil D doc

3 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. D doc 1-0

4 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 Tegn repræsentation Data filer skal anvende ISO 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 = 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 bliver f.eks. således: Fil transport Data filer uploades på Datapharms FTP server: 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. D doc 2-1

5 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 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 cifret kode for apoteksenhed. 00 = hovedapotek = Filial = Udsalg Afdelingsnummeret henviser til den omsætningsafdeling hvor varen er udleveret. Dato D 6 8 Dato for udlevering af varen til kunden Ekspeditionsnr. N 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 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 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. D doc 3-2

6 Eksempel på datafil 4 Eksempel på datafil D doc 4-3