Boka demo DataCollect Dokumentation 1.0
Om detta dokument – Klicka här
Kontaktinformation – Klicka här
Om detta dokument
Detta dokument ger en fullständig översikt av DataCollect API och hur data kan integreras i Verarca.
Dokumentet innehåller riktlinjer för hur man kommer igång med att ladda in data och hur processen ska följas.
Det är mycket viktigt att du läser hela dokumentet och skickar eventuella frågor i förväg till rene@verarca.com innan du startar integrationen.
Kontaktinformation
Kontakta följande adresser om du har frågor:
Teknisk support: rene@verarca.com
Övriga frågor: contact@verarca.com
Inledning
Den första integrationen med vårt API sker via ett konto på Verarca.com. För åtkomst till ett testkonto kan du kontakta oss via rene@verarca.com.
DataCollect API består av två miljöer: staging och produktion, tillgängliga via följande endpoints:
Staging: https://staging.datacollect.verarca.com/swagger
Produktion: https://datacollect.verarca.com/swagger
Båda miljöerna kör olika säkerhetskontroller för att säkerställa stabilitet. En av dessa är rate limiting. Vid problem kan du kontakta teknisk support.
API:et använder versionshantering. Det rekommenderas starkt att använda versionsnumren för endpoints för att minimera störningar. Versionen är synlig i Swagger-dokumentationen.
Följande kapitel beskriver arbetsflödet för att ladda in data i DataCollect i specifika dataregioner.
Bokföring
Grunddatan i Verarca består av data från ERP-/bokföringssystem för att beräkna CO2 baserat på olika inköp/fakturor.
Följande arbetsflöde måste alltid följas:
1. Kunden får en token från Verarca.com.
2. Kunden matar in denna token eller ger den vidare till klientapplikationen (integrationspartner).
3. När token matas in i klientapplikationen måste applikationen skicka en totalöversikt av kontoplanen.
4. Efter att kontoplanen skickats till DataCollect måste kunden i Verarca.com markera de relevanta kontona.
– Detta är för att endast bearbeta data som rör CO2.
5. Dagligen måste klientapplikationen skicka in följande data till DataCollect:
-
- Hämta vilka konton som markerats i Verarca.com. Endpoint: /api/Accounts/Enabled
- Skapa/uppdatera kontoplan: /api/Accounts
- Skapa/uppdatera bokningar: /api/AccountEntries
- Koppla/ladda upp dokument till bokningar: /api/Documents
Vid den första synkroniseringen måste alltid data från innevarande år + föregående år skickas. Dagligen måste alla uppdateringar/nya data skickas in.
När bokningar skickas in måste typen av bokning anges via parametern ”type”. DataCollect stöder följande format:
Supplier = Leverantörsfaktura
Payment = Betalning till leverantör
Credit = Kreditnota från leverantör
Felsökning
Om problem uppstår med DataCollect API returnerar API:et ett JSON-resultat som nedan:
Vid frågor, kontakta teknisk support och ange errorId för snabbare hantering.
Ändringshistorik
| Datum | Ändringar | Typ |
