|
Specifikation af prisforespørgsel |
|
Identifier: http://biblstandard.dk/acq/doc/prisforesp.htm Publiceret:
27. september 2010 Sidst opdateret: 9. december 2010 Udgivet af
Styrelsen for Bibliotek og Medier |
Indledning
Baggrunden er som nok de fleste bekendt at priser i de
nationalbibliografiske poster udgår efter at de faste bogpriser forsvinder helt
med dette år. Der er derfor behov for at biblioteker kan få oplyst en ”bedst
mulig” pris til brug for disponering af budget.
På danZIG-mødet 1.9.2010 var der tilslutning
til dedikeret web service med et simpelt indhold. Overvejelser om en EDItX baseret model hensættes til senere.
Denne specifikation har været til afprøvning og kommentar
i en måned og der er sket nogle justeringer udfra
modtagne kommentarer. Se afsluttende afsnit Ændringer.
Specifikationen vil senere blive publiceret som danZIG-specifikation.
Prisforespørgsel web service
SOAP-baseret forespørgsel alene på f.eks. ID på forespørgsel ISBN og tilsvarende
standardnumre og FAUST som mulige typer. Og et simpel svar med blot elementer
til ID på forespørgsel, pristype og pris som svar. Denne model vil overlade til
biblioteket / den enkelte systemleverandør at bruge dette til at estimere
belastning af budget.
Biblioteket forespørger en materialeleverandør. I det omfang at der
ikke modtages færdigt svar med pristype NoPriceYet, er det biblioteket som på et senere tidspunkt gentager
forespørgsel.
WSDL for webservice: http://biblstandard.dk/acq/serviceman/pricequery.wsdl
I tilfælde af uoverensstemmelser mellem nedenstående beskrivelse af WSDL’en og selve WSDL-filen, er
det WSDL som er den autoritative kilde.
Materialeleverandør henholdsvis bibliotek har ansvaret for
at der leveres valide data som f.eks. valutakode og at der ikke sker
unødvendige gentagelser.
Forespørgsel
|
Forespørgsel |
Beskrivelse |
Noter |
|
PriceQuery |
Prisoplysninger |
Elementer: Customer Material |
En forespørgsel indeholder følgende elementer:
|
Element |
Beskrivelse |
Noter |
|
Customer |
Identifikation
af forespørgende bibliotek |
Delelementer: CustomerIDType CustomerID |
|
Material |
Identifikation
af materiale, som der spørges om pris på. Kan
gentages. |
Delelementer: MatIDType MatID |
Ovenfor definerede delelementer
|
Delelement |
Tilhører
element |
Beskrivelse |
Noter |
|
CustomerIDType |
Customer |
Type af identifikator |
Se Kunde identifikator nedenfor |
|
CustomerID |
Customer |
Identifikator |
ISIL
eksempel: DK-737600 = Guldborgsund-bibliotekerne |
|
MatIDType |
Material |
Type af identifikator |
Se
Materiale identifikator nedenfor |
|
MatID |
Material |
Identifikator |
|
Svar
Et svar indeholder følgende elementer:
|
Element |
Beskrivelse |
Noter |
|
PriceQueryResponse |
Prisoplysninger
|
Delelementer: MaterialPrice, kan
gentages |
materialPrice indeholder følgende elementer:
|
Element |
Beskrivelse |
Noter |
|
Material |
Identifikation
af materiale der leveres pris på |
Delelementer: MatIDType MatID |
|
Price |
Prisangivelse |
Delelementer: PriceType Amount Currency ValidToDate |
Delelementer for price:
|
Delelement |
Tilhører
element |
Beskrivelse |
Noter |
|
PriceType |
Price |
|
Se
pristype nedenfor |
|
Amount |
Price |
Pris valuta angivet i Currency |
Beløb anføres ekskl. moms |
|
Currency |
Price |
Valutakode
– tre tegn |
ISO 4217 Codes for the
representation of currencies and funds |
|
ValidToDate |
Price |
Gyldighedsdato
for angivet pris |
|
Kunde identifikator
|
Værdi
CustomerIDType |
Beskrivelse |
Noter |
|
ISIL |
Biblioteksnummer
tildelt af Styrelsen for Bibliotek og Medier for danske biblioteker |
ISIL
eksempel: DK-737600 = Guldborgsund-bibliotekerne |
|
EAN |
EAN-lokationsnummer |
|
|
OtherID |
Andet
id aftalt imellem bibliotek og materialeleverandør |
|
Materiale identifikator
|
Værdi
MatID Type |
Beskrivelse |
Noter |
|
FAUST |
Faust-nummer
tildelt af DBC |
Reference: http://www.danbib.dk/index.php?doc=standarder#identifikatorer |
|
ISBN10 |
International
standard bog nummerering (DS/ISO 2108) |
Jævnfør
danMARC2 021 *a |
|
ISBN13 |
International
standard bog nummerering (DS/ISO 2108) |
Jævnfør
danMARC2 021 *e |
|
ISSN |
International
standard serial number
(ISO 3297) |
Jævnfør
danMARC2 022 *a |
|
ISMN |
International standard music number (ISO
10957) |
Jævnfør
danMARC2 028 *a |
|
EAN |
Producentens stregkode = EAN nummer |
Jævnfør
danMARC2 023 *a |
Pristype
|
Værdi PriceType |
Beskrivelse |
Noter |
|
LockedPrice |
Faktisk
pris |
Prisen er
udtryk for et bindende tilbud i henhold til den enkelte leverandørs
standardbetingelser |
|
ExpectedPrice |
Forventet
pris præcis |
Ikke
bindende pris, men den angivne pris forventes at være præcis |
|
EstimatedPrice |
Forventet
pris overslag |
Ikke
bindende pris, kun et overslag |
|
NetPricePublisher |
Forlagets
nettopris |
Forlagets nettopris
som oplyst af forlaget. Anvendes i henhold til SKI-aftalen |
|
NoPriceYet |
Pris kan
ikke oplyses endnu |
Spørg igen
lidt senere |
|
NoDelivery |
Kan ikke
leveres |
Leverandøren
afviser at modtage ordre på denne titel |
For NoPriceYet og NoDelivery
oplyses i sagens natur ikke en pris, d.v.s. at Price
alene indeholder PriceType.
Support
Systemleverandører og materialeleverandører bedes oplyse i
hvilket omfang at nærværende specifikation understøttes. Dette skal ske til
nedenstående kontakt og vil blive offentliggjort på http://biblstandard.dk/acq/support_prisforesp.htm, hvor en template
til afgivelse af oplysninger kan ses.
Ændringer
I udgaven af 27. september 2010 er i udgaven af 1.
november 2010 sket følgende justeringer i beskrivelsen og WSDL’en.
- flere pristyper kan oplyses
- pristype også i WSDL’en ikke
obligatorisk
- der er tilføjet en ny CustomerIDType,
OtherID
- der er tilføjet ValidToDate
til typen Price
- der er defineret en ny type, MaterialPrice,
som indeholder Price og Material
- Material kan gentages i PriceQuery
- i PriceQueryResponse
returneres MaterialPrice - kan gentages - istf. Price
- ISBN delt i ISBN10 og ISBN13
Ændring 9. december 2010:
- Note ” Beløb anføres ekskl. moms” tilføjet til Amount.
Referencer
Web Services Description Language
(WSDL) 1.1
W3C’s introduction til WSDL
http://www.w3schools.com/wsdl/wsdl_intro.asp
Wikipedia om WSDL
http://en.wikipedia.org/wiki/Web_Services_Description_Language
Kontakt
Chefkonsulent
Digital Udvikling og
Infrastruktur
Styrelsen for Bibliotek og
Medier
Chief Adviser
Digital
Development and Infrastructure
Danish
Agency for Libraries and Media
Email: LEA@bibliotekogmedier.dk
1553 Copenhagen V
Telefon direkte: 3373 3354
Telefon:
3373 3373
Telefax:
3373 3372