Skellefteå Kraft

Företagsmarknad - Beställning API

Uppdaterad

Ansvarig över guide: Företagsmarknad

Berörda avdelningar: Företag

Innehåll: Denna rutin beskriver hur beställningar av automatisk överföring av förbrukningsdata till kundens egna system hanteras via API eller FTP.

Information: 

API (Application Programming Interface): 

Ett API är en direkt koppling mellan två system där data hämtas automatiskt via internet.

FTP (File Transfer Protocol):

FTP är ett sätt att överföra filer mellan system.

I stället för att kundens system hämtar data via ett API skapas rapportfiler som levereras till en FTP-server där kunden kan hämta dem.


Börja alltid med att säkerställa om kunden eller kundens leverantör har kunskap och erfarenhet av integrationer.

  • Ja → Rekommendera API.
  • Nej → Rekommendera FTP.

API

1. Skapa användare

Lägg upp en ny användare i individdatabasen.

  • Skriv API i slutet av användarnamnet.
  • Markera rutan API Förbrukning.
  • Lägg till de anläggningar och/eller kundnummer vars mätdata ska exporteras.

2. Delge kunduppgifter

Skicka följande uppgifter till kunden:

  • API Client ID
  • API Client Secret
  • Länk till Swagger

I Swagger kan kunden genomföra integrationen och välja önskad upplösning på mätdatan.

3. Slutförande

När ovanstående uppgifter har lämnats över ansvarar kunden för att slutföra integrationen i sitt eget system.

FTP

1. Skapa en beställning i ServiceDesk.

Följande information ska anges:

  • Kundnummer
  • Önskat filformat (Vitec använder TAB)
  • Önskad upplösning på mätdatan (månad rekommenderas)

Följande uppgifter ska kunden lämna och anges i beställningen:

  • Typ
  • URL
  • Användarnamn
  • Lösenord

OBS! Endast standardrapporter kan levereras via FTP. Samtliga standardrapporter finns tillgängliga i flera exportformat.

2. När beställningen är klar

IT återkopplar när uppsättningen är genomförd. Därefter informeras kunden.

3. Tillfällig rapport

Fram tills FTP-lösningen är driftsatt kan förbrukningsdata skickas manuellt till kunden.

Gör så här:

  1. Logga in på Mina Sidor.
  2. Välj aktuell rapport.
  3. Exportera rapporten i önskat format.
  4. Skicka filen till kunden via e-post.
Guide taggad med: FTP API
warning Warning.