FAQ 69: Uddybende vejledning til BI linjer i OIOUBL

FAQ 69: Uddybende vejledning til BI
linjer i OIOUBL
-124. August 2015
Katalog og ønsker til leverandører, som leverer katalog i OIOUBL format
Der er til Digitaliseringsstyrelsen kommet ønsker til en uddybende vejledning til brugen af
linjer i OIOUBL dokumenterne. Ønsket går på, at få beskrevet, hvordan man på linjeniveau
kan angive yderligere information omkring køb på aftaler i elektroniske kataloger, ordrer og
fakturaer fra leverandørerne.
Der er også et ønske om at løsningen på sigt vil kunne bruges i OpenPEPPOL. I
OpenPEPPOL anbefales brug af Item.AdditionalItemProperty.Name og
Item.AdditionalItemProperty.Value til dette formål.
De overordnede ønsker er, at indkøbere gerne vil have mere struktureret information med
udgangspunkt i de kontrakter/rammeaftaler, der bliver indgået. Primært i varekatalogerne,
men med efterfølgende afledt effekt i ordre, faktura og kreditnota.
Dette dokument indeholder et forslag til, hvorledes det kan gøres på en ensartet vis i
OIOUBL, for de myndigheder som ønsker at stille disse yderligere krav til deres
leverandører. Såfremt forslaget vinder indpas forventes det at blive en del af høringen om
den næste version af OIOUBL Schematronen.
Forslag til løsning
Målet er at blive enige om anvende et felt i OIOUBL standarden til aftaleoplysninger
(Aftaletype, fx en SKI-aftale; AftaleID, nummer og versionsID; samt Aftalenavn), og et felt
til kundens ”aftale”-varenummer.
Digitaliseringsstyrelsen foreslår på opfordring fra OpenPEPPOL at følgende felter
anvendes til angivelse af aftalens varenummer (ihht pågældende aftale):
Aftalens varenr. på fakturalinjer:
Invoice.InvoiceLine.Item.AdditionalItemProperty.Name
Invoice.InvoiceLine.Item.AdditionalItemProperty.Value
Aftalens varenr. på kreditnotalinjer:
CreditNote.CreditNoteLine.Item. AdditionalItemProperty.Name
CreditNote.CreditNoteLine.Item. AdditionalItemProperty.Value
-2Aftalens varenr. på ordrelinjer:
Order.OrderLine.LineItem.Item. AdditionalItemProperty.Name
Order.OrderLine.LineItem.Item. AdditionalItemProperty.Value
Aftalens varenr. på kataloglinjer:
Catalogue.CatalogueLine.Item. AdditionalItemProperty.Name
Catalogue.CatalogueLine.Item. AdditionalItemProperty.Value
Digitaliseringsstyrelsen foreslår på opfordring fra OpenPEPPOL at følgende felter
anvendes til angivelse af kundens aftalenr. (dvs. den rammeaftale der købes ind på):
Kundens aftalenummer på fakturalinjer:
Invoice.InvoiceLine. AdditionalItemProperty.Name
Invoice.InvoiceLine. AdditionalItemProperty.Value
Kundens aftalenummer på kreditnotalinjer:
CreditNote.CreditNoteLine. AdditionalItemProperty.Name
CreditNote.CreditNoteLine. AdditionalItemProperty.Value
Kundens aftalenummer på ordrelinjer:
Order.OrderLine. AdditionalItemProperty.Name
Order.OrderLine. AdditionalItemProperty.Value
Kundens aftalenummer på kataloglinjer:
Catalogue.CatalogueLine. AdditionalItemProperty.Name
Catalogue.CatalogueLine. AdditionalItemProperty.Value
Til illustration af forslagene kan vi i et OIOUBL katalog have følgende eksempel med Note
Post-it blokke (det med rødt er eksempler på udfyldelse af de ekstra informationer)
<cac:CatalogueLine>
<cac:Item>
<cbc:Description>Fremstillet af 100% genbrugspapir-Certificeret efter miljømærket Blå EngelMiljøvenlige indkøbspakninger-Ingen individuel indpakning af blokkene-Blokke à 100 blade-Farve: AssFormat: 38 x 51 mm-Pakning: 12 stk. pr. pakke</cbc:Description>
<cbc:Name>Note Post-it Recycled 38x51 ass (12)</cbc:Name>
<cbc:Keyword>100.045</cbc:Keyword>
-3<cac:BuyersItemIdentification>
<cbc:ID schemeAgencyID="9" schemeID="GTIN">4011462715322</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
<cbc:ID>3700655</cbc:ID>
</cac:SellersItemIdentification>
<cac:CommodityClassification>
<cbc:ItemClassificationCode listAgencyID="113" listID="UNSPSC"
listVersionID="7.0401">14111530</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementCode</cbc:Name>
<cbc:Value> STAT05600013</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementItemNumber</cbc:Name
<cbc:Value>K2-PAK-1216</cbc:Value>
</cac:AdditionalItemProperty>
Når så den offentlige myndighed skal bestille varen – kan det se ud som følger på den
elektroniske OIOUBL ordre:
<cac:OrderLine>
<cac:LineItem>
<cac:Item>
<cac:BuyersItemIdentification>
<cbc:ID schemeAgencyID="9" schemeID="GTIN">4011462715322</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
<cbc:ID>3700655</cbc:ID>
</cac:SellersItemIdentification>
<cac:CommodityClassification >
<cbc:ItemClassificationCode listID="UNSPSC" listAgencyID="113" listVersionID="7.0401"
>14111530</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementCode</cbc:Name>
<cbc:Value> STAT05600013</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementItemNumber</cbc:Name>
<cbc:Value>K2-PAK-1216</cbc:Value>
</cac:AdditionalItemProperty>
-4</cac:Item>
</cac:LineItem>
Når leverandøren skal fakturere ordren, så skal han levere katalogoplysningerne med på
følgende måde I OIOUBL:
<cac:InvoiceLine>
<cac:Item>
<cac:BuyersItemIdentification>
<cbc:ID schemeAgencyID="9" schemeID="GTIN">4011462715322</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
<cbc:ID>3700655</cbc:ID>
</cac:SellersItemIdentification>
<cac:CommodityClassification >
<cbc:ItemClassificationCode listID="UNSPSC" listAgencyID="113" listVersionID="7.0401"
>14111530</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementCode</cbc:Name>
<cbc:Value> STAT05600013</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementItemNumber</cbc:Name>
<cbc:Value>K2-PAK-1216</cbc:Value>
</cac:AdditionalItemProperty>
</cac:Item>
</cac:LineItem>
Skulle det ske, at leverandøren bliver nødt til at sende en kreditnota skal det ske på
følgende måde:
<cac:CreditNoteLine>
<cac:Item>
<cac:BuyersItemIdentification>
<cbc:ID schemeAgencyID="9" schemeID="GTIN">4011462715322</cbc:ID>
</cac:BuyersItemIdentification>
<cac:SellersItemIdentification>
-5<cbc:ID>3700655</cbc:ID>
</cac:SellersItemIdentification>
<cac:CommodityClassification >
<cbc:ItemClassificationCode listID="UNSPSC" listAgencyID="113" listVersionID="7.0401"
>14111530</cbc:ItemClassificationCode>
</cac:CommodityClassification>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementCode</cbc:Name>
<cbc:Value> STAT05600013</cbc:Value>
</cac:AdditionalItemProperty>
<cac:AdditionalItemProperty>
<cbc:Name> AgreementItemNumber</cbc:Name>
<cbc:Value>K2-PAK-1216</cbc:Value>
</cac:AdditionalItemProperty>
</cac:Item>
Nedenstående illustrerer sammenhængen mellem en aftales vare informationer og
leverandørens tilsvarende vare/produkt informationer.
Aftalens varenummer
Aftalens varebeskrivelse
Aftalens enheder
K2-PAK-1214
Memoblokke. 76 x 127 mm/75 x 125
mm. Alle farver. 100 blade pr. blok.
Pakke
Leverandørens
varenummer
(unikt)
3700697
K2-PAK-1215
Memoblokke. 76 x 76/75 x 75 mm. Alle
farver. 100 blade pr. blok.
Pakke
3700671
K2-PAK-1216
Memoblokke. 38 x 51 mm/40 x 50 mm.
Alle farver. 100 blade pr. blok.
Pakke
3700655
Leverandørens varebeskrivelse
Memoblokke med selvklæbende blade Kan
tages af og sættes på mange gange Blokke á
100 blade
Memoblokke med selvklæbende blade Kan
tages af og sættes på mange gange Blokke á
100 blade
Memoblokke med selvklæbende blade Kan
tages af og sættes på mange gange Blokke á
100 blade
Syntaks ved angivelse af aftaleoplysninger
Til angivelse af oplysninger i feltet omkring Aftalen anbefales det at anvende alphanumeriske koder. som kunden definerer (dvs. den part der indgår aftalen på kundesiden,
fx Statens Indkøb eller SKI). Det vil være op til kunden at vedligeholde mapningstabeller.
Eksempler på koder:
FM123456
SKI123456
IFIRS123456