Copyright

Copyright © 2016-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 destinering av råvaran i råvaruaffären samt transportunderlag och transportinstruktion i transportaffären.

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 K – Initiate Logistics & Main Carrier Allocation”, härefter refererat som “PTO SDC Use Case K” 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. Dessutom finns för detta use case ett s k webb-API som erbjuder information för val av effektiv rutt vid vägtransport.

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 LogisticsBuyerAgent. 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.

Transportinstruktion 

Det är viktigt att förstå att Biometrias användning av begreppet ”Transportinstruktion” inte avser det uppdrag som en transportköpare ger till en transportleverantör om att utföra en transport utan är en detaljerad bekräftelse på att Biometria kommer att utföra tjänsten Transportredovisning. papiNet-standarden tillhandahåller e-dokumentet DeliveryInstruction som kan användas för att förmedla ett uppdrag från en transportköpare till en transportleverantör om att utföra en transport. Detta dokument hanteras inte av VIOL 3.             

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.

Eftersom detta use case avser transportaffärernas första led så är i dokumentet “PTO SDC Use Case K” parten LogisticsSupplier alltid den utförande säljaren av transport i det första ledet räknat från råvaruaffären, medan LogisticsBuyerAgent alltid är den som utför köpet som ombud på uppdrag av den juridiske köparen (LogisticsBuyer) i det första ledet i transportaffären.

* Lägg märke till att papiNet-rollen OrderParty används inom både råvaruaffären och transportaffären och att det då troligen inte är samma part i de båda affärerna.

** Notera att för rollen ’Transportunderlagsansvarig’’ används för en aktör som administrerar transportunderlag. Den rollen kan innehas av en annan part än befraktaren eller transportansvarige råvaruköparen, de är annars de vanligaste aktörerna som administrerar transportunderlag.

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 K finns här ett motsvarande avsnitt som textuellt förtydligar bilden samt refererar till den/de integrationsfunktion(er) som där kan medverka.

Destinera och initiera tjänster för mätning

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden "Request Measuring Services for contracted products".

Den destineringsansvarige (OrderParty) mottar en PurchaseOrder där råvarubehov finns definierat. Informationen som skall delges Biometria, och som i VIOL 3 utgör ett ”destinerat sortiment”, finns i orderbekräftelser som utväxlas mellan parterna i råvaruaffären.

Att destinera sortiment (destinering) innebär att besluta att ett sortiment på förstaledskontraktet ska kunna levereras till en specifik mottagningsplats, vilket inte nödvändigtvis medför att det senare blir någon leverans dit. Det är denna aktivitet som ”knyter samman” råvaran från avtalsobjektet med en industri som har ett råvarubehov och initierar Biometrias tjänster för mätning där bland annat mätorder för råvara och transport ställs ut till mätstationen. I och med att mätorder initieras av en destinering kommer en leverans av råvara först att kunna tas emot och mätas in på en mätstation då den föregåtts av aktiviteten destinera sortiment.

Den part i råvaruaffärens första led som hanterar inköpsorder och orderbekräftelser som leder till att mottagare av råvara utses benämns i processerna i detta use case ”destineringsansvarig”. Det är den destineringsansvarige (OrderParty) som ansvarar för att tillhandahålla information till Biometria om till vilken, eller vilka, mottagare ett sortiment från ett förstaledskontrakt skall kunna levereras till. Läs vidare i ”SDC Use Case H – Initiate and manage raw material deal” för mer information om destineringsansvarig.

Destinering kan ske via integration med e-dokumentet OrderConfirmation eller direkt i VIOL 3-klienten. Genom att ange en redovisningshänvisning vid destineringen bestämmer man indirekt bland annat mottagare, mottagningsplats och befraktare för ett handelssortiment. Läs vidare i ”SDC Use Case G – Product Business Preparation” för mer information om objektet redovisningshänvisning. I VIOL 3-klienten är det möjligt att i stället för att använda sig av redovisningshänvisning direkt ange mottagare och mottagningsplats.

Transaktionerna mellan processerna ’Request Measuring Services via e-document’ till ’Process Order Confirmation and product related service information’ stödjs av integrationsfunktionen ’Destinera sortiment IN’ (se vidare kapitel ’Integrationsfunktioner’).

Underlag till befraktare för transportbokning

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden "Determine Logistics Buyer Agent for contracted product".

Om förstaledskontraktet stipulerar att förberedelser för råvaruaffärens logistik ska initieras så fortsätter ServiceProvider med att förbereda ett ’Transportunderlag’ som håller styrande information om vidare hantering av råvaruaffärens logistik. ServiceProvider distribuerar därefter ut ett underlag till den befraktare som finns angiven i redovisningshänvisning att kunna användas som en del av transportbokning för råvaruaffärens logistik. Detta underlag benämns ’Befraktarunderlag’ och ställs ut i form av e-dokumentet OrderConfirmation av Biometria.

Transaktionerna mellan processerna ’Provide prerquisites to Logistics Buyer Agent’ till ’Update prerequisites for Load Tender Preparation’ stöds av integrationsfunktionen ’Befraktarunderlag UT’ (se vidare kapitel ’Integrationsfunktioner’).

Byte av befraktare i befintlig destinering

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden ”Change Logistics Buyer Agent for contracted product”.

Då den destineringsansvarige (OrderParty) har gjort en destinering av något sortiment kan denne senare vilja byta ut den befraktare som har blivit registrerad för destineringen. Ett inledande steg är att den destineringsansvarige på något sätt begär av ServiceProvider att denne byter till den ersättande befraktaren i de befraktarunderlag och transportinstruktioner som ServiceProvider har utfärdat till följd av destineringen.

ServiceProvider utför detta byte i sin process ”Change Logistics Buyer Agent for contracted product information” och informerar den befraktare som har utgått om att den inte längre ska hantera det tidigare skickade befraktarunderlaget.

Notera att detta use case varken beskriver hur den destineringsansvarige ska meddela ServiceProvider sin begäran om befraktarbyte eller hur den tidigare befraktaren ska delges att den inte längre är befraktare enligt utsänt befraktarunderlag. Förmedlingen av sådan information sker inte med någon integrationsfunktion som ingår i detta use case.

Därefter initierar ServiceProvider distribution av utställda befraktarunderlag och transportinstruktioner till ny befraktare (LogisticsBuyerAgent) och transportansvarig råvarupart (LogisticsPlanningParty) enligt;

• Diagrambild ”Determine Logistics Buyer Agent for contracted product” och
• Diagrambild ”Prepared Logistics Services for contracted products”

Planering av vägval för transporter

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden ”Route calculation for logistics planning”.

En del av arbetet med att förbereda och upprätta underlag för transportbeordring i samband med råvaruaffärens logistik är att planera vägval för transporter.

Ett sätt att få information om olika vägval vid vägtransport är att den transportunderlagsansvarige (OrderParty) använder API ’Krönt vägval webbtjänst’. Detta API erbjuder information om det effektivaste vägvalet för en given transport. Det levererade vägvalet är anpassat för skogsbranschens transporter och tar hänsyn till vägnätets egenskaper och i svaret ingår avstånd, geometri och energivärde.

Transaktioner mellan processerna ’Route calculation for logistics planning’ till ’Route calculation’ stödjs av integrationsfunktionen ’Krönt vägval webbtjänst IN’ (se vidare kapitel ’Integrationsfunktioner’).

Underlag för transportbeordring

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden ”Request Logistics Services for contracted products”.

Det är transportunderlagsansvarig (OrderParty) som är den ansvariga parten för att upprätta underlag för transportbeordring i samband med råvaruaffärens logistik.

Transportunderlagsansvarig uppdaterar ServiceProviders transportunderlag med att utfärda e-dokumentet LoadTender av typen PreBooking.

Notera att en påföljande bokning av transport kan hanteras i form av e-dokumentet LoadTender av typen Booking som då enbart skickas mellan parterna i transportaffären. Den ingår därför inte i detta Use Case.

Alternativt kan sekvensen initieras genom att registrera ett nytt transportunderlag eller uppdatera ett befintligt via VIOL 3-klienten till ServiceProviders process ”Request Logistics Services for contracted products via VIOL 3 client”.

Transaktionerna mellan processerna ’Request Logistics Services for contracted products via e-document’ till ’Requirements for Original Logistics Supplier related service information’ stöds av integrationsfunktionen ’Transportunderlag IN’ (se vidare kapitel ’Integrationsfunktioner’).

Sammanställning av transportunderlag för transportbeordring

Integrationssekvensen visas i dokumentet “PTO SDC Use Case K” i diagrambilden ”Prepared Logistics Services for contracted products”.

ServiceProvider sammanställer de transportunderlag per unik kombination av Avtalsobjekt-Befraktare-Ansvarigt transportföretag-Transportansvarig råvarupart till en ’Transportinstruktion’. Denna transportinstruktion förmedlar även information från förstaledskontrakt, avtalsobjekt, avlägg och godkända mätplatser. Transportinstruktionen utfärdas av ServiceProvider i form av e-dokumentet LoadTender(PreBooking) till parter i transportaffären.

Observera att underlag för transportbeordring som skickas av parten OrderParty och transportinstruktion som distribueras av ServiceProvider är två olika dokument.

Transaktionerna mellan processerna ’Provide prepared requirements for Original Logistics Supplier’ till ’Update Original Logistics Supplier allocation’ stödjs av integrationsfunktionen ’Transportinstruktion 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 detaljerad beskrivning av dessa integrationsfunktioner finns i respektive integrationsfunktions specifikationer.

Use case integrationsfunktioner;

• Befraktarunderlag UT
• Destinera sortiment IN
• Krönt vägval webbtjänst IN
• Transportinstruktion UT
• Transportunderlag IN

Avgränsningar

Biometrias system VIOL 3 hanterar inte juridiska affärsparter i transportaffären, LogisticsBuyer och LogisticsSeller, i e-dokument som skickas till eller från VIOL 3. För köpare och säljare av transport används därför alltid LogisticsBuyerAgent respektive LogisticsSupplier oavsett om affärsparten är ombud för en juridisk part eller själv är den juridiske affärsparten.