Bestill demo DataCollect Dokumentasjon 1.0
Om dette dokumentet – Klikk her
Kontaktinformasjon – Klikk her
Om dette dokumentet
Dette dokumentet gir en fullstendig oversikt over DataCollect API og hvordan data kan integreres i Verarca.
Dokumentet gir retningslinjer for å starte med innlasting av data og hvordan denne prosessen skal følges.
Det er svært viktig at du leser hele dokumentet og sender eventuelle spørsmål på forhånd til rene@verarca.com før du starter integrasjonen.
Kontaktinformasjon
Ta kontakt på følgende adresser hvis du har spørsmål:
Teknisk support: rene@verarca.com
Andre spørsmål: contact@verarca.com
Innledning
Den første integrasjonen med vårt API skjer via en konto på Verarca.com. For tilgang til en testkonto kan du kontakte oss via rene@verarca.com.
DataCollect API består av to miljøer: staging og produksjon, tilgjengelig via følgende endepunkter:
Staging: https://staging.datacollect.verarca.com/swagger
Produksjon: https://datacollect.verarca.com/swagger
Begge miljøene kjører ulike sikkerhetskontroller for å sikre stabilitet. En av disse er rate limiting. Ved problemer kan du kontakte teknisk support.
API-et bruker versjonskontroll. Det anbefales sterkt å bruke versjonene av endepunktene for å minimere forstyrrelser. Versjonen er synlig i Swagger-dokumentasjonen.
De neste kapitlene beskriver arbeidsflyten for innlasting av data i DataCollect i spesifikke dataområder.
Regnskap
Grunnlagsdataene i Verarca består av data fra ERP-/regnskapssystemer for å beregne CO2 basert på ulike kjøp/fakturaer.
Følgende arbeidsflyt må alltid følges:
1. Kunden mottar et token fra Verarca.com.
2. Kunden legger inn dette tokenet eller gir det videre til klientapplikasjonen (integrasjonspartner).
3. Når tokenet legges inn i klientapplikasjonen, må applikasjonen sende et totaloversikt over kontoplanen.
4. Etter at kontoplanen er sendt til DataCollect, må kunden i Verarca.com merke de relevante kontoene.
– Dette er for å bare behandle data relatert til CO2.
5. Daglig må klientapplikasjonen sende inn følgende data til DataCollect:
-
- Hente hvilke kontoer som er merket i Verarca.com. Endepunkt: /api/Accounts/Enabled
- Opprette/oppdatere kontoplan: /api/Accounts
- Opprette/oppdatere posteringer: /api/AccountEntries
- Knytte/laste opp dokumenter til posteringer: /api/Documents
Ved første synkronisering må alltid data fra inneværende år + foregående år leveres. Daglig skal alle oppdateringer/ny data sendes inn.
Ved innsending av posteringer må typen av posteringen oppgis via parameteren “type”. DataCollect støtter følgende formater:
Supplier = Leverandørfaktura
Payment = Betaling til leverandør
Credit = Kreditnota fra leverandør
Feilhåndtering
Hvis det oppstår problemer med DataCollect API, returnerer API-et et JSON-resultat som vist nedenfor:
Ta kontakt med teknisk support og oppgi errorId for raskere behandling dersom du har spørsmål.
Endringshistorikk
| Dato | Endringer | Type |
