Företagsmarknad - Beställning API
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:
- Logga in på Mina Sidor.
- Välj aktuell rapport.
- Exportera rapporten i önskat format.
- Skicka filen till kunden via e-post.
