Copyright

Copyright © 2022-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 Biometria utfärdar mätorder på uppdrag av  destineraren till ett mätande företag. Det mätande företaget förmedlar resultat från utförs mätning till Biometria vilket blir där ett underlag för den redovisning som görs till olika parter, t.ex. värdeberäkning av råvaran samt transportvärdeberäkning. 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 N – Report measured quantities”, härefter refererat som “PTO SDC Use Case N” 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 EndUser och MeasuringParty. 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 som kan användas för involverade aktörer (parter) i detta use case. Med ’papiNet-roll’ avses den roll i papiNet som motsvarar en Biometria verksamhetsroll.

Tabell 1

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

I detta use case är det mätande företaget (MeasuringParty) den huvudsakliga aktören.

Biometria (ServiceProvider) utfärdar mätorder på uppdrag av destineraren (OrderParty). Råvarumottagaren (EndUser) har också intresse av att få kännedom om resultatet av destineringen. Läs vidare om destinering i SDC Use Case K ”Hantera råvaruaffärens logistik”.

”Delivery handling party” är ett symboliskt namn på aktörer som hanterar leveranser av råvara som skall mätas vid en mätplats. Exempel på dessa är Råvaruleverantör (Supplier), utförande transportföretag (Carrier) ,säljare/leverantör av transporttjänster (LogisticsSupplier) och de som tillhandahåller administration av logistiktjänster (LogisticsServiceProvider).

”Shipment handling party” är ett symboliskt namn på aktörer som hanterar information om transport av råvaruleverans till en mätplats. Exempel på dessa är Carrier, LogisticsSupplier och LogisticsServiceProvider . 

Mer om dessa finns att läsa vidare om i SDC Use Case M "Hantera transportuppgifter".

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

Instruktion för råvarumätning

Integrationssekvensen visas i dokumentet ”PTO SDC Use Case N” i diagrambilden med underrubriken "Issue Measuring Instruction requesting measuring service". E-dokumentet MeasuringInstruction(MeasuringInstruction) utfärdas av ServiceProvider på uppdrag av OrderParty när destinering av ett handelssortiment har genomförts.

Syftet med att ta emot e-dokumentet från ServiceProvider är att MeasuringParty på detta sätt kan få kännedom om hur respektive handelssortiment ska hanteras, det vill säga vad som ska bedömas/mätas och om det finns särskilda regler för hur mätningen ska ske samt vad som ska rapporteras tillbaka till ServiceProvider. EndUser kan genom att ta emot e-dokumentet se resultatet av den destinering som genomförts. E-dokumentet MeasuringInstruction(MeasuringInstruction) kvitteras med e-dokumentet BusinessAcknowledgement.

Transaktionerna mellan processerna ”Issue measuring instruction” till ”Update measuring instruction information” stöds av integrationsfunktionen ”Mätinstruktion UT” (se vidare kapitel ”Integrationsfunktioner”).

Rapportering av mätresultat leveranstillfälle, transportaffären

Integrationssekvensen visas i dokumentet ”PTO SDC Use Case N” i diagrambilden med underrubriken "Issue Measuring Ticket with logistics arrival measurement results". E-dokumentet MeasuringTicket av typen ArrivalTicket för transportaffären (LogisticsService) utfärdas av MeasuringParty i samband med ankomst med råvara för mätning hos MeasuringParty. E-dokumentet utfärdas när ett ekipage ankommit en mätplats och MeasuringParty har noterat de leveranser som skall hanteras på mätplatsen samt i förekommande fall utfört ekipagevägning för transportaffärens räkning.

ServiceProvider hanterar dokumentet i processen ”Verify document and store content” och kvitterar transaktionen med ett BusinessAcknowledgement. ServiceProvider upprättar eller uppdaterar därefter innehållet i följesedeln i processen ”Process measuring data”, resultatet förmedlas genom e-dokumentet BusinessAcceptance. Sändande part kan välja att uppdatera status och ska kvittera detta genom BusinessAcknowledgement.

Transaktionerna mellan processerna ”Report logistics arrival measuring results” till ”Process measuring data information” stöds av integrationsfunktionen ”Mätresultat leveranstillfälle IN” (se vidare kapitel ’Integrationsfunktioner’).

Ett leveranstillfälle håller ihop en eller flera leveranser som alla mäts vid samma mätplats, och är utfärdade av samma aktör. Det kan t.ex. vara ett transportföretag med eget system som lastar råvara för två olika uppdrag. Notera att om samma transportföretag lastar ytterligare råvara för ett tredje uppdrag och registrerar detta i en logistiktjänsteleverantörs system ska detta hanteras som ett annat leveranstillfälle.

Syftet med att skicka e-dokumentet till ServiceProvider är att ge Biometria kännedom om vilka leveranser som transporteras och levereras tillsammans för att Biometria ska kunna göra en samlad bearbetning och redovisning till råvaru- och transportaffärerna. I samband med detta utfärdar Biometria, för varje leveranstillfälle, ett TransportArrivalNumber som används i redovisningen. Läs vidare om Biometrias redovisning till intressenter i råvaru- respektive transportaffären i SDC Use Case L ”Beräkna råvaru- och tjänsteaffär”.

Rapportering av mätresultat råvara

Integrationssekvensen visas i dokumentet ”PTO SDC Use Case N” i diagrambilden med underrubriken "Issue Measuring Ticket with measuring results".

E-dokumentet MeasuringTicket av typen ArrivalTicket eller MeasuringTicket utfärdas av MeasuringParty när mätning av handelssortiment har genomförts.

Syftet med att skicka e-dokumentet till ServiceProvider är att ge Biometria ett underlag för den redovisning som görs till olika parter. Uppgifterna kan också vara underlag för värdeberäkning av råvaran samt transportvärdeberäkning, i de fall sådan beräkning ska göras.

Läs vidare om Biometrias redovisning till intressenter i råvaru- respektive transportaffären i SDC Use Case L ”Beräkna råvaru- och tjänsteaffär”. ServiceProvider hanterar dokumentet i processen ”Verify document and store content” och kvitterar transaktionen med ett BusinessAcknowledgement.

ServiceProvider upprättar eller uppdaterar därefter leveransinnehållet i processen

”Process measuring data”, resultatet förmedlas genom e-dokumentet

BusinessAcceptance. Sändande part kan välja att uppdatera status och ska kvittera detta genom BusinessAcknowledgement.

Transaktionerna mellan processerna ”Report measuring results” till

”Process measuring data” stöds av integrationsfunktionen ”Mätresultat råvara IN” (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;

• Mätinstruktion UT
• Mätresultat leveranstillfälle IN
• Mätresultat råvara IN

Varianter i detta Use Case

Syftet med varianter är att illustrera för dig som läser hur detta use case kan användas när vissa specifika förutsättningar gäller för processerna och hur detta då resulterar i olika varianter av och innehåll i transaktionerna som då utväxlas mellan processerna. Vid behov kan en variant delas upp i flera sekvenser.

Variant N1 – Sågtimmer till Woodstock AB

Följande exempelfiler finns. De beskrivs inte närmare här.

SDCUseCaseN1-MeasuringInstruction-MeasuringInstruction-1-yyyymmdd.xml

SDCUseCaseN1-MeasuringTicket-ArrivalTicket-LogisticsService-1-yyyymmdd.xml

SDCUseCaseN1-MeasuringTicket-MeasuringTicket-Product-1-yyyymmdd.xml

Variant N2

Reserverad för framtida exempelfiler.

Variant N3

Reserverad för framtida exempelfiler.

Variant N4 – GROT-flis till ett värmeverk

Värmeverket Storstad energi AB är råvarumottagare (EndUser) och i denna variant också det mätande företag (MeasuringParty) som ansvarar för de mätningstjänster som kan utföras i samband med leveranser av råvara till värmeverket.

Transportföretaget Timbertrans är Measurer och utför råvaruvägning som ombud för Storstad energi AB. Storstad energi AB tillhandahåller i egenskap av LogisticsServiceProvider IT-system till Timbertrans för registrering av transportuppgifter att förmedla till VIOL 3. IT-systemet tilldelar då råvaruleveransen ett DeliveryMessageNumber utfärdat av LogisticsServiceProvider.

Läs vidare om råvarutransporter för denna variant i beskrivningen av variant M4 i SDC Use Case M.

Alla exempelfiler i denna variant antas bli kvitterade (BusinessAcknowledgement) med status Success av mottagaren av respektive e-dokument.

Mätinstruktion till mätande företaget Storstad energi

Biometria är ServiceProvider som utfärdar en MeasuringInstruction till det mätande företaget Storstad energi AB (MeasuringParty) som där även är råvarumottagare (EndUser). Skogsbolaget AB Virke är Supplier i affären med råvarumottagaren. Den destinerade råvaran (MeasuringProduct) från avtalsobjektet med DeliverySourceNumber=12345678 skall mätas med två mätningstjänster; dels vägning, dels torrhaltsbestämning. Hur råvaran skall mätas anges i en separat MeasuringInstructionSequence för respektive mätningstjänst.

SDCUseCaseN4-MeasuringInstruction-MeasuringInstruction-1-yyyymmdd.xml

Mätresultat leveranstillfälle för ett ankommet ekipage

Då ett ekipage har anlänt till PlaceOfMeasuring vägs det för transportaffärens skull och man registrerar samtidigt vilka leveranser (DeliveryMessageNumber) som har ankommit med ekipaget till mätplatsen. Storstad energi AB (MeasuringParty) utfärdar en MeasuringTicket av typen ArrivalTicket med referenser till den, i detta fall enda, DeliveryMessageNumber samt uppgift om ekipagets vikt med och utan last.

SDCUseCaseN4-MeasuringTicket-ArrivalTicket-LogisticsService-1-yyyymmdd.xml

Mätresultat råvara vid utförd vägning

Transportföretaget Timbertrans agerar ombud (Measurer) åt det mätande företaget Storstad energi AB (MeasuringParty) och utför för råvaruaffärens skull mätningstjänsten vägning av levererad råvara, som kan ingå i underlag för beräkning av ersättningen i råvaruaffären. MeasuringParty utfärdar därför en MeasuringTicket av typen MeasuringTicket med referens till leveransen (DeliveryMessageNumber) och mätinstruktionen (MeasuringInstructionNumber) samt uppgift om råvarans vikt.

SDCUseCaseN4-MeasuringTicket-MeasuringTicket-Product-1-yyyymmdd.xml

Mätresultat råvara vid utförd torrhaltsbestämning

Storstad energi AB (MeasuringParty) utför för råvaruaffärens skull mätningstjänsten torrhaltsbestämning av levererad råvara, som kan ingå i underlag för beräkning av ersättningen i råvaruaffären. MeasuringParty utfärdar därför en MeasuringTicket av typen MeasuringTicket med referens till leveransen (DeliveryMessageNumber) och mätinstruktionen (MeasuringInstructionNumber) samt uppgift om råvarans torrhalt.

SDCUseCaseN4-MeasuringTicket-MeasuringTicket-Product-2-yyyymmdd.xml

Logg revisionshistorik

Här finns versioner, datum, ändringsbeskrivningar och författare/redaktörer för alla tidigare publicerade officiella utgåvor av detta dokument.