Extern insändning 

Denna handbok syftar till att informera om de förutsättningar som krävs för att skicka mätresultat råvara, insamlat i andra system än Biometrias eget mätplatssytem, via integration till VIOL 3.

Förutsättningar företagen behöver beställa eller lägga upp själva

Nedanstående information behöver företagen se till att de finns uppsatta innan affärerna sätts upp i VIOL 3. Om något saknas behöver företagen beställa uppläggning av detta från Biometria.

Mätande företag

Den aktör som ska agera som mätande företag måste ha organisationstyp Mätande företag i aktörsregistret. Om det inte finns annat behov så räcker det att göra detta på organisationens huvud-/juridiska nivå (HKOD-00000).

Mottagningsplatser och mätplatser

De platser som ska användas för extern insändning av mätresultat råvara måste finnas i platsregistret, i form av site, mottagningsplats och mätplats. Aktör som är siste köpare i råvaruaffärerna måste finnas upplagd som mottagare på mottagningsplatserna.

Erbjudna mätningstjänster

Den aktör som ska agera som mätande företag behöver beställa erbjudna mätningstjänster för respektive branschgemensam mätningstjänst i mätningsflödet. Det behöver sättas upp ett erbjudande per mätande företag som ska kunna mäta på mätplatsen.

Mätningsflöden

Mätningsflöde måste beställas av Biometria för den mottagningsplats och det handelssortiment som ska användas för att skicka in mätresultat råvara via extern insändning. Nedanstående typer av mätningsflöden går att  använda för extern insändning och beställas av Biometria. De är sammanställda utifrån olika behov som finns bland företag att kunna skicka in mätdata för redovisning. Sammanställningen visar också vilka måttslag som respektive flöde levererar och som går att använda i redovisningen (kompletterande måttslag går ej att värdeberäkna råvaruaffär på i värdeberäkningstjänsten i VIOL 3).

Förutsättningar Biometria ansvarar för

Nedanstående information ansvarar Biometria för att det finns uppsatt i VIOL 3.

Branschgemensamma mätningstjänster

Nedanstående mätningstjänster finns stöd för via extern insändning. I tabellen finns angivet vilka mätegenskaper som är obligatoriska  respektive valfria att skicka med i mätresultatet för respektive mätningstjänst. I vissa fall är mätegenskaperna obligatoriska med  villkor. Vilka värden en egenskap får ha kan bero på vilket handelssortiment (HS) eller produkt som avses i rapporteringen. Angivna  värden kommer valideras att de matchar kraven för respektive handelssortiment eller produkt. Giltiga värden kan också finnas i dokumentation Official list of papiNet codes Maintained By SDC (Se: Integrationsspecifikationer) 

Uppsättning av affärer i VIOL 3

Råvaruaffärerna behöver sättas upp på samma sätt som för leveranser som ska mätas via Biometrias mätplatsstöd. Detta görs av företagen själva. Separata handböcker och instruktioner finns publicerade för detta på Biometria.se under Användardokumentation. 

Destinering

Destinering av råvaran görs också på samma sätt som för leveranser som ska mätas via Biometrias Mätplatsstöd (MPS). Se Handbok verifiera och destinera.

Mätorder

När destineringen är genomförd (OK) skapas bland annat en råvarumätorder. Denna innehåller alla förutsättningar för de mätresultat  råvara som ska gå att sända in via extern insändning. En integration av Mätorder/Mätinstruktion går att prenumerera på, för de som vill, i form av papiNet MeasuringInstruction. Denna integration finns beskrivet på biometria.se under Integrationsspecifikationer VIOL 3, Use Case N.

Insändning av mätresultat råvara

Insändning av mätresultat råvara via integration sker enligt papiNet MeasuringTicket. Regelverket för denna integration finns beskrivet  på biometria.se under Integrationsspecifikationer VIOL 3, Use Case N. Vilket mätdata som är obligatorisk och valfritt att skicka in beror av den mätningstjänst som det avser. Under rubriken Branschgemensamma mätningstjänster framgår vilka mätegenskaper som ska skickas in för respektive mätningstjänst. Där framgår vilka mätegenskaper som är valfria att skickas in.

Identiteter i mätresultat råvara

Följande externa identiteter är viktiga vid insändning av mätresultat råvara via extern insändning. Inskickade identiteter ska vara  unika för angiven utfärdare. Om de är angivna vid insändning kommer de också med som referens i resultatet efter redovisning, dvs i  integrationen av kvantitet råvara.

Leverans

Identitet på leverans (DeliveryMessageNumber) är obligatorisk att skicka med som referens vid extern insändning. Måste vara samma  identitet i alla mätresultat för samma leverans. I VIOL 3 skapas också en intern identitet på leveransen.

Mätresultat och version

Identitet på enskilt mätresultat (MeasuringNumber) i leveransen. Obligatorisk att skicka med som referens. Mätresultat för respektive  mätningstjänst måste ha egen identitet. Unik tillsammans med version (VersionNumber) av mätresultatet. I VIOL 3 skapas också en intern identitet på mätresultatet.

[Mätorder
Valfri möjlighet att referera till identitet på mätorder (MeasuringInstructionNumber)
eller dylikt i eget system. Avser alltså inte mätorder/mätinstruktion skapad i VIOL 3
efter destinering.

Vågkvitto
Valfri möjlighet att referera till ett vågkvittonummer (ScaleTicketNumber) från ett
externt vågsystem.]

Valideringar av inskickat mätdata

Valideringar sker i VIOL 3 av det mätdata som skickas in, så att det är konsistent och följer uppsatta regler. Är något felaktigt i mätdata så skickar VIOL en negativ BusinessAcceptance, som svar i integrationen tillbaka till avsändaren, med uppgift av vad som inte är korrekt.

Följande valideringar av termer är viktiga att veta om:

Leveranstidpunkt; ska vara samma i alla mätresultat i samma leverans (tidpunkt får inte vara i framtid).
Mättidpunkt; måste vara lika eller senare än leveranstidpunkt (tidpunkt får inte vara i framtid).
Mätande företag och mätplats; måste finnas som erbjuden mätningstjänst i mätorder.
Mätande företags ombud; måste finnas i VIOLs aktörsregister som organisation.
Handelssortiment, avtalsobjekt, mottagare, mottagningsplats, transportslag; används tillsammans med leveranstidpunkt för  att identifiera mätorder.
Mätmetod; måste finnas mätningstjänst för angiven mätmetod i mätorder, får bara skickas i ett mätresultat per mätorder (annars  måste det vara en korrigering).
Mätobjektstyp; måste vara samma som i mätningstjänst.
Mätegenskapstyp; de som skickas in måste finnas i mätningstjänsten, alla obligatoriska mätegenskaper måste skickas in (se  respektive mätningstjänst), samma mätegenskap får bara finnas med en gång i samma mätresultat.
Mätvärde; måste finnas för alla mätegenskaper som skickas in, endast ett värde per mätegenskap, i övrigt se respektive  mätningstjänst.
Produkt; måste finns i giltig version av handelssortimentet.
Produktandel; summa andel av alla leveransgilla produkter måste vara 100 %, vid stockmätning får det endast finnas en produkt  (leveransgill eller ej leveransgill) per mätobjekt.

Värden i inskickade mätegenskaper (enligt branschgemensam mätningstjänst) kommer också valideras med avseende på riktighet enligt integrationsspecifikationen "Biometria specific Business rules applicable at integration".

Redovisning av inskickat mätdata

Är allt mätdata korrekt så kommer mätresultatet att gå vidare för redovisning. Redovisningsprocessen sker enligt samma mönster som för mätresultat från Biometrias eget mätplatsstöd. Notera att värdeberäkning av råvara i VIOL inte påbörjas förrän leveransen är komplett, dvs det finns ett korrekt mätresultat för varje mätningstjänst i mätningsflödet.

Korrigering av tidigare redovisat mätresultat

I VIOL 3 går det via extern insändning att skicka in korrigering av tidigare redovisat mätresultat. Korrigeringar behöver endast skickas in för det mätresultat i leveransen som behöver uppdateras. För att korrigeringar ska fungera måste extern identitet på mätresultatet vara samma som tidigare redovisat mätresultat, men med en högre version. Korrigeringsorsak ska anges med värde enligt kodbok (Official list of papiNet codes Maintained By SDC), samt tidpunkt för ändring måste vara angivet. Följande termer går att ändra vid inskickad korrigering:

• Nya mätobjekt går att skicka in.
• Värden på mätegenskaper går att ändra men valideras enligt ovan.
• Produkter och produktandelar går att uppdatera men valideras enligt ovan.

Redovisning vid korrigering

Vid inskickad korrigering av enskilt mätresultat kommer den korrigeringen att resultera i att det redovisas en kreditering av tidigare  redovisad kvantitet råvara och en debitering enligt det nya korrigerade mätresultatet. Om det finns beroende mellan mätningstjänsterna i mätningsflödet, som det finns mellan tjänst för råvikt och tjänst för torrhalt/torrvikt, som kommer det även redovisas kredit/debet för den påverkade mätningstjänsten. Alltså om inskickad råvikt korrigeras och det finns ett beroende till  torrvikt, kommer systemet automatisk beräkna en ny torrvikt och redovisa ut kredit/debet av kvantitet råvara för detta mätresultat också.

Efter redovisning av varje korrigering av enskilt mätresultat kommer det genomföras ny uppdaterad värdeberäkning av leveransen, om detta är beställt i kontrakten.

Makulering av tidigare redovisat mätresultat

Makulering av leveranser går i dagsläget inte att genomföra i VIOL 3 via extern insändning. Dessa behöver beställas via Biometerias kundservice.

Rapportering av transportuppgifter

Mätresultat råvara i VIOL 3 innehåller inga transportuppgifter, utan endast information som berör mätningen av levererad råvara. För att skicka in transportuppgifter som komplement till mätresultat råvara behöver detta ske via separata integrationer. Regelverket för dessa finns beskrivet på biometria.se under Integrationsspecifikationer VIOL 3, Use Case M.