Copyright

Copyright © 2017-2025 Biometria ekonomisk förening, which is “Copyright Owner” below. All rights reserved by the Copyright Owner under the laws of the United States, Sweden, the European Economic Community, and all states, domestic and foreign. This document may be downloaded and copied provided that all copies retain and display the copyright and any other proprietary notices contained in this document. This document may not be sold, modified, edited, or taken out of context such that it creates a false or misleading statement or impression as to the purpose or use of the specification. Use of this Standard, in accord with the foregoing limited permission, shall not create for the user any rights in or to the copyright, which rights are exclusively reserved to the Copyright Owner.

Biometria, the Confederation of European Paper Industries AISBL ("papiNet"), and the members of all papiNet^® Groups (collectively and individually, "Presenters") make no representations or warranties, express or implied, including, but not limited to, warranties of merchantability, fitness for a particular purpose, title, or noninfringement. The presenters do not make any representation or warranty that the contents of this document are free from error, suitable for any purpose of any user, or that implementation of such contents will not infringe any third party patents, copyrights, trademarks or other rights. By making use of this document, the user assumes all risks and waives all claims against Presenters.

In no event shall Presenters be liable to user (or other person) for direct, indirect, special or consequential damages arising from or related to any use of this document, including, without limitation, lost profits, business interruption, loss of programs, or other data on your information handling system even if Presenters are expressly advised of the possibility of such damages.

Use of Documents in papiNet Implementations

Documents may be used as templates for a papiNet implementation. The Presenters grant the right to modify and edit them to fit an actual implementation project provided all copies display the copyright and any other proprietary notices contained in this document. Such modified documents must not be distributed beyond the trading partners implementing or maintaining a papiNet connection.

Översikt

Detta use case beskriver hur kunder administrerar råvaru- och tjänsteaffär för att kunna nyttja Biometria tjänster. De delar som hanteras är t.ex. förstaledskontrakt, avtalsobjekt och destineringsunderlag.

Läsaren behöver vara medveten om att Biometrias gränssnitt förmedlar data om två olika slags affärer; virkesaffären för råvaran samt transportaffären för förflyttningen av råvaran från ett hämtställe till en mottagningsplats.

Läsanvisning

Denna beskrivning läses med fördel tillsammans med Process and Transaction Overview (PTO) dokumentet ”SDC Use Case H – Initiate and Manage Raw Material Deal” härefter refererat som “PTO SDC Use Case H” i det här dokumentet.

Då det står råvara i detta dokument, innebär det råvara för en mottagare. För levererande part kan det vara dennes färdigvara (stockar, grotflis, bränslekross etc.) eller biprodukt (spån, cellulosaflis, returträ etc).

Biometrias system VIOL 3 erbjuder gränssnitt för att ta emot respektive skicka information. Dessa integrationsgränssnitt förmedlar data från externa parter till VIOL 3 respektive från VIOL 3 till externa parter. Detta use case beskriver hur motsvarande uppgifter kommer att förmedlas mellan Biometria och externa parter i elektroniska affärsdokument (e-dokument) som följer standarden papiNet, vilken använder märkspråket XML och dokumentscheman.

Begrepp

papiNet-begrepp

papiNet-standardens termer är på engelska och används flitigt i det dokument du just nu läser. Var god referera till dokumentet papiNet Data Dictionary för att se definitionerna för respektive term, exempelvis termerna OrderParty och

ContractParty. Detta uppdateras regelbundet och kan laddas hem från webbplatsen http://www.papiNet.org via menyvalet THE STANDARD → Download Current Version → V2R40 - namespaced version → Documentation. Branschgruppen Forest Wood Supply & Bioproducts inom papiNet har utarbetat verksamhetsregler och publicerat dem i dokumentet FWS Business Rules. Dessa ska följas och kan laddas hem i senaste version på webbplatsen http://www.papiNet.org under menyvalet USER GROUPS → Forest Wood Supply & Bioproducts → Helpful Implementation Material.

Varje e-dokument ska valideras OK mot sitt dokumentschema innan det sänds till VIOL 3. Då det i dokumentet beskrivs att ett e-dokument ”sänds/skickas till VIOL 3” menas att Biometria mottar ett e-dokument i egenskap av TransmissionReceiver.

Produkt

I detta use case förekommer elementet Product i de flesta av Biometrias e-dokument för standarden papiNet. För de produkter och handelssortiment som Biometria klassificerar som ”icke-skogliga” förmedlar Biometria i elementet Product utöver ProductIdentifier och namn (ProductDescription) inte någon annan information än attributet med icke-skoglig produkttyp (OtherProductsType) i elementet OtherProducts.

Roller

Tabell 1 visar de roller som kan användas för involverade aktörer (parter) i detta use case. Med ’papiNet-roll’ avses den PartyType i papiNet som en viss verksamhetsroll i Biometrias system motsvarar.

Tabell 1

Biometria agerar i rollen ’Tjänsteleverantör’ (ServiceProvider) och realiserar sina tjänster i systemet VIOL 3.

Supplier är alltid den utförande säljaren i det första ledet räknat från råvarukällan. Buyer är alltid juridisk köpare i första led medan BuyerAgent utför som ombud för Buyer köpet på uppdrag av den juridiske köparen i det första ledet. BuyerAgent kan exempelvis vara en distriktsförvaltning eller en enskild virkesköpare vars virkeshandel ska följas upp separat i virkesredovisningen. BuyerAgent saknas om det är den juridiske köparen som utför köpet med egen identitet, eftersom det då inte finns något ombud. BuyerAgent finns alltid om köpet utförs av en annan aktör inom köparens organisation med eget ID hos Biometria eller av något externt ombud.     

Transaktioner och kvittenser

Samarbete mellan processer sker i form av transaktioner för att uppnå en kontrollerad överlämning av ansvar vid övergång mellan olika processer.

För papiNet-baserade e-dokument används kvittenserna BusinessAcknowledgement och BusinessAcceptance för att kontrollera och styra överlämningen. Dessa kvittenser och deras mekanismer vid överlämningen beskrivs mer detaljerat i dokumentet “Appendix 1, Biometria Technical Communication Guidelines for VIOL 3”.

Beskrivning av processer och deras samverkan via transaktioner

För varje diagrambild i PTO SDC Use Case H finns här ett motsvarande avsnitt som textuellt förtydligar bilden samt refererar till den/de integrationsfunktion(er) som där kan medverka.

Förstaledskontrakt

Affärsöverenskommelse skickas in till Biometria

Integrationssekvensen visas i dokumentet “PTO SDC Use Case H” i diagrambilden med underrubriken “Original Contract from Contract Party”.

Ett kontrakt skrivs i samband med en råvaruaffär som initieras i processen ’Sign contract’. ContractParty förbereder de delar från kontraktet som behöver förmedlas till ServiceProvider och sänder därefter in dessa i form av en affärsöverenskommelse i e-dokumentet Contract(OriginalContract) till ServiceProvider. ServiceProvider kvitterar transaktionen med ett BusinessAcknowledgement.

ServiceProvider upprättar eller uppdaterar därefter förstaledskontraktet i sin databas i processen ”Process original contract related service information” utifrån de delar av inskickad information som är relevant för förstaledskontraktet. I den informationen ingår också identiteten på insänt Contract(OriginalContract), dvs identiteten på affärsöverenskommelsen.

Om den avsändande parten har ett avtal med Biometria för att bli delgiven resultatet från processeringen av affärsinnehållet, förmedlas detta av ServiceProvider med BusinessAcceptance. ContractParty kvitterar detta med BusinessAcknowledgement.

Transaktionerna mellan processerna ’Issue original contract’ till ’Process original contract related service information’ stöds av integrationsfunktionen ’Förstaledskontrakt IN’ (se vidare kapitel ’Integrationsfunktioner’).

Förstaledskontrakt skickas ut av Biometria

Integrationssekvensen visas i dokumentet ”PTO SDC Use Case H” i diagrambilden med underrubriken ”Original Contract from Service Provider”.

Sekvensen initieras genom att registrera ett nytt förstaledskontrakt eller uppdatera ett befintligt förstaledskontrakt via antingen integrationsfunktion ’Förstaledskontrakt IN’ eller VIOL 3-klienten till ServiceProviders process ”Manage original contract related service information”. I båda fallen ingår den identitet som ContractParty har tilldelat affärsöverenskommelsen i informationen i förstaledskontraktet.

Den distribution av förstaledskontraktet som görs i ServiceProviders process “Issue document with original contract related service information”, oavsett hur sekvensen initieras, innebär att de olika kontraktsparterna i förstaledskontraktet Buyer, BuyerAgent, ContractParty, Seller samt Supplier kan få kännedom om den information som ServiceProvider har avseende ett förstaledskontrakt. För att få tillgång till informationen krävs att parten prenumererar på förstaledskontrakt från

ServiceProvider. Vid distribution ingår identiteten på förstaledskontraktet samt en referens till identiteten på affärsöverenskommelsen. Prenumeranten kvitterar transaktionen med ett BusinessAcknowledgement.

Transaktionerna mellan processerna ’Issue document with original contract related service information’ till ’Update original contract’ stöds av integrationsfunktionen ’Förstaledskontrakt UT’ (se vidare kapitel ’Integrationsfunktioner’).

Observera att affärsöverenskommelsen som skickas av parten ContractParty i integrationsfunktion Förstaledskontakt IN och förstaledskontraktet som distribueras av ServiceProvider är två olika dokument.

Avtalsobjekt

Plan för råvarukälla skickas in till Biometria

Integrationssekvensen visas i PTO-dokumentet i diagrambilden med underrubriken ”Delivery Source from Contract Party”.

ContractParty förbereder ett avtalsobjekt (ämnat för ett förstaledskontrakt) som därefter förmedlas in som en plan för råvarukällan i e-dokumentet OtherDocument(DeliverySource) till ServiceProvider.

ServiceProvider kvitterar transaktionen med en BusinessAcknowledgement.

ServiceProvider upprättar eller uppdaterar därefter avtalsobjektet i processen ”Process delivery source related service information” utifrån de delar av inskickad information som är relevant för avtalsobjektet. I den informationen ingår identiteten på insänt OtherDocument(DeliverySource), dvs identiteten på planen för råvarukällan.

Information till transport- och logistikkedjan, såsom planerade kvantiteter, producerade kvantiteter och leveransvirkeskvantiteter, hanteras som rader i avtalsobjektet tillsammans med uppgift om NotifyParty.

Om den avsändande parten har ett avtal med Biometria för att bli delgiven resultatet från processeringen av planen för råvarukällan, förmedlas detta av ServiceProvider med BusinessAcceptance. ContractParty kvitterar detta med BusinessAcknowledgement.

Transaktionerna mellan processerna ’Issue delivery source’ till ’Process delivery source related service information’ stöds av integrationsfunktionen ’Avtalsobjekt IN’ (se vidare kapitel ’Integrationsfunktioner’).

Avtalsobjekt skickas ut av Biometria

Integrationssekvensen visas i PTO-dokumentet i diagrambilden med underrubriken ”Delivery Source from Service Provider”.

Sekvensen kan initieras genom att registrera ett nytt avtalsobjekt eller genom att uppdatera ett befintligt avtalsobjekt via antingen integrationsfunktionen ’Avtalsobjekt IN’ eller VIOL 3-klienten till ServiceProviders process ”Manage delivery source related service information”. I båda fallen ingår den identitet som ContractParty har tilldelat planen för råvarukällan.

Den distribution av avtalsobjektet som görs i ServiceProviders process ”Issue document with delivery source related service information”, oavsett hur sekvensen initieras, innebär att de olika parterna i avtalsobjektet Buyer, BuyerAgent,

ContractParty, NotifyParty, Seller samt Supplier kan få kännedom om den information som ServiceProvider har avseende ett avtalsobjekt. För att få tillgång till informationen krävs att parten prenumererar på avtalsobjekt från ServiceProvider. Vid distribution ingår identiteten på avtalsobjektet samt en referens till identiteten på planen för råvarukällan. Prenumeranter kvitterar respektive transaktion med ett BusinessAcknowledgement.

Observera följande:

• Dokumentet med planen för råvarukällan, utfärdat av parten ContractParty, och dokumentet med avtalsobjektet, utfärdat av ServiceProvider, är två olika
• I dokumentet som distribueras till NotifyParty ingår endast avtalsobjektets huvuduppgifter (inklusive avlägg samt vägnätsanslutning) samt de avtalsobjektsrader (sortiment och planerad kvantitet) där respektive NotifyParty finns angiven.

Om en tidigare NotifyParty (logistikinformationsmottagare) ”plockas bort” från en avtalsobjektsrad är den parten inte längre berättigad att i den rollen få information om avtalsobjektsraden och tidigare förmedlad information ska ignoreras.

För borttagen part gäller följande för ett så kallat borttagningsbesked från VIOL 3:

• Dokumentet OtherDocument(Notification) distribueras till föregående NotifyParty i de fall den parten endast fanns angiven på avtalsobjektsraden med en prenumeration och numera inte har någon kvarvarande prenumererande roll i avtalsobjektet.
• Om parten efter uppdatering av Avtalsobjektsraden fortfarande har någon kvarvarande prenumererande roll i Avtalsobjektet kommer denne istället för OtherDocument(Notification) att få Avtalsobjektet i den uppdaterade versionen med OtherDocument(DeliverySource).
• Notera att om NotifyParty väljer att få tillgång till information om avtalsobjektet genom prenumeration från ServiceProvider (se ovan) måste den parten stödja mottagande av OtherDocument(Notification) samt kvittera detta med ett BusinessAcknowledgement.

Transaktionerna mellan processerna ’Issue document with delivery source related service information’ till ’Verify OtherDocument’ stöds av integrationsfunktionen ’Avtalsobjekt UT’ (se vidare kapitel ’Integrationsfunktioner’).

Destineringsunderlag

Integrationssekvensen visas i PTO-dokumentet i diagrambilden med underrubriken ”Product Destining Instruction from Service Provider”.

Här beskrivs hur ServiceProvider skickar ut ett destineringsunderlag i form av e-dokumentet ServiceInstruction(ProductDestiningInstruction) till destineringsansvarig part (OrderParty).

Efter att VIOL 3-processerna för att lagra och/eller uppdatera förstaledskontraktet och avtalsobjekt utförts, kan destineringsunderlag distribueras med e-dokument till parter som ansvarar för att destinera sortiment och som prenumererar på dessa e-dokument. Prenumeranterna kvitterar transaktionerna med BusinessAcknowledgement. Tillåtna prenumeranter för distribution är endast aktörer av typen OrderParty som anges per rad i förstaledskontraktet.

Transaktionerna mellan processerna ’Provide product destining instruction’ till ’Update product destining instruction’ stöds av integrationsfunktionen ’Destineringsunderlag UT’ (se vidare kapitel ’Integrationsfunktioner’).

Integrationsfunktioner

I detta kapitel summeras och listas de integrationsfunktioner som används i detta use case. Användning av dessa finns omnämnda i föregående kapitel ’Beskrivning av processer och deras samverkan via transaktioner’.

Mer detaljerade beskrivningar av dessa integrationsfunktioner finns i respektive integrationsfunktions specifikationer.

Use case integrationsfunktioner;

• Avtalsobjekt IN
• Avtalsobjekt UT
• Destineringsunderlag UT
• Förstaledskontrakt IN
• Förstaledskontrakt UT