Gå till innehållet

MIVO Connect System Integration

Integration via JSON – MIVO Connect#

MIVO Connect kan automatiskt skicka mätdata från anslutna mätare och sensorer till externa system. Detta sker via en HTTPS-anslutning i JSON-format, enligt en fast struktur som dokumenteras här.

Denna guide är till för dig som ska bygga en integration mot MIVO och vill förstå hur formatet fungerar, vad som skickas och hur du tar emot datan.

Översikt – hur fungerar det?#

  • MIVO Connect agerar klient som pushar data ut till en server (ditt system).
  • Varje gång ny data är tillgänglig (t.ex. varje minut eller varje timme) skickas ett HTTPS POST-anrop.
  • Innehållet i anropet är JSON-formaterat enligt ett standardiserat schema.
  • Mottagaren (du) returnerar HTTP-status 204 No Content som bekräftelse.
  • Om ett annat svar eller fel uppstår kommer MIVO försöka skicka om datan automatiskt.

Autentisering#

Mottagarsystemet förväntas kräva autentisering via en Bearer Token.

Header i varje anrop ser ut så här:

Innehåll i datan#

Varje JSON-anrop innehåller:

  • UnitSerial: Serienummer på MIVO Connect-enheten
  • ProtocolVersion: För närvarande alltid 2
  • Readings: Lista över enheter (mätare/sensorer) som avlästs

Varje Reading innehåller:

  • ID: Unikt ID för sensorn
  • Name: Namn på mätpunkten
  • MeterNumber: Angivet mätarnummer (kan vara icke-unikt)
  • MType: Typ av mätare (t.ex. Heat, Electricity – se tabell)
  • Time: Tidsstämpel i ISO 8601-format (UTC)
  • Values: En lista med uppmätta värden

Varje Value innehåller:

  • Code: Standardiserad kod för mätvärdet (se Appendix C)
  • Unit: Enhet, t.ex. Wh, m3, Celcius
  • Value: Själva mätvärdet (float)

Exempel på JSON#

json1

Vad är "Code"-värden?#

Alla värdekoder (t.ex. RoomSensorTemperature, HeatEnergy, ElectricityActivePowerTotal) är dokumenterade i vår kodtabell.

  • De är plattformsoberoende – samma kod gäller oavsett tillverkare eller kommunikationsteknik.
  • Koderna är standardiserade och förenklar integrationer oavsett om mätaren pratar M-Bus, Wireless M-Bus eller Modbus.

Koderna är uppdelade i tre huvudgrupper:

  • Standard codes – vanliga värden som temperatur, energi, flöde etc.
  • Advanced codes – utökade värden, statistik och detaljerade eldata.
  • Status codes – larm, varningar och felindikatorer (t.ex. låg batterinivå, omvänd flödesriktning).

Se Appendix C

Tips för implementation#

  • Svara alltid med HTTP 204 No Content – annars försöker MIVO skicka datan igen.
  • Spara Time och ID om du vill undvika att lagra samma datapunkt flera gånger.
  • Logga alla inkommande anrop – särskilt om du filtrerar bort vissa Code-värden.
  • JSON-formatet är stabilt men kan i framtiden innehålla fler fält – bygg din parser så att den ignorerar okända fält istället för att krascha.
  • Alla mätare följer samma struktur – använd fältet MType för att förstå om det rör sig om t.ex. en värmemätare, elmätare eller rumssensor.

Dokumentation och bilaga#

För att se den kompletta tekniska dokumentationen – inklusive alla sensortyper och värdekoder –
kan du ladda ner hela protokollet här:

MIVO Integration Protocol JSON (PDF)

Integration via CSV – MIVO Connect#

MIVO Connect kan exportera mätdata till externa system som CSV-filer, exempelvis via FTP eller filöverföring.
Denna guide visar hur formatet ser ut och hur du som systemutvecklare tolkar innehållet.

Översikt – hur fungerar det?#

  • MIVO Connect genererar en CSV-fil med aktuell mätdata.
  • Filen innehåller en rad per mätpunkt (värde), inte per mätare.
  • Filen levereras via t.ex. FTP, lokal lagring eller överföring till kunds filserver.
  • Alla mätare och sensorer levereras i samma fil och format.

Exempel på CSV-struktur#

CSV1

Value codes (JSON Integration)#

Nedan visas samtliga aktuella value codes i MIVO Connects JSON-protokoll. Använd söket för att filtrera och bläddra med paginering.

Id Code Device type Text Quantity Unit Description