Naar inhoud springen
Tibata
Docs

Integraties

Wat koppelingen en mappings zijn, en hoe je een Space aan een administratie koppelt.

Integraties verbinden Tibata met je boekhoud- en documentsystemen. Een koppeling is de verbinding van je organisatie met zo'n systeem; een mapping verbindt een Space met één administratie, map of bestand daarin.

Koppeling

Een koppeling (connection) is de verbinding van je organisatie met Exact Online, Twinfield of SharePoint. Je legt koppelingen aan in Tibata zelf; de API toont ze met hun provider en externalId.

Mapping

Een mapping verbindt een Space met een administratie, map of bestand binnen een koppeling:

externalTypeWaar de Space aan gekoppeld wordt
exact_divisionEen divisie in Exact Online
twinfield_officeEen office in Twinfield
sharepoint_folderEen map in SharePoint
sharepoint_fileEén los bestand in SharePoint

Meerdere Spaces mogen dezelfde administratie delen, bijvoorbeeld een Space voor de jaarrekening en een voor de belastingaangifte van dezelfde onderneming.

PUT op de mappings van een koppeling vervangt alle mappings van die koppeling. Haal eerst de bestaande op met GET en stuur de volledige lijst terug.

Een mapping van een Space die niet elk lid kan bewerken toevoegen of verwijderen vraagt de rol Kan bewerken of Kan beheren in die Space, en mislukt anders met 403; zie Spaces die niet elk lid kan bewerken. Een mapping die de PUT ongewijzigd herhaalt, vraagt geen rol.

SharePoint-mappings

Een SharePoint-mapping verbindt een Space met een map of met één los bestand. De externalId is het drive-ID van de documentbibliotheek en het ID van het item in Microsoft Graph, met een dubbele punt ertussen: {driveId}:{itemId}.

  • Een sharepoint_folder-mapping geeft de Space de bestanden die direct in die map staan. Of hij ook alles in de submappen meeneemt (Met submappen in Tibata), stel je in Tibata in, niet via de API. GET toont de map in beide gevallen als sharepoint_folder.
  • Een sharepoint_file-mapping geeft de Space dat ene bestand.
  • Een PUT die een mapping herhaalt, laat die zoals hij is, met wat er in Tibata voor is ingesteld: of hij de submappen meeneemt, de bestanden die eronder zijn weggelaten, en de stand van het bijwerken. Een mapping die de PUT weglaat, verdwijnt, met de bestanden die eronder waren weggelaten.
  • Een map of bestand dat de Space al via een andere koppeling heeft, zoals het Microsoft-account van een collega, wordt niet twee keer opgeslagen. Het antwoord noemt de mapping wel, omdat het de aanvraag herhaalt.
  • De API-sleutel leest SharePoint nooit. Tibata leest de bestanden van een mapping met het Microsoft-account van iemand die de Space gebruikt en er een heeft verbonden, net als bij een mapping die in Tibata is gemaakt. Zie SharePoint koppelen.

Een Space aan een administratie koppelen

  1. Vraag de koppelingen van je organisatie op met List Connections en noteer de id van de koppeling.
  2. Maak een Space aan met Create Space, of zoek hem op met List Spaces, en noteer de id van de Space.
  3. Koppel de Space met Update Mappings: internalType is space, internalId is de id van de Space en externalId is het ID van de administratie, zoals het divisienummer in Exact Online.

Op deze pagina