Eigen koppeling

Het is mogelijk om eigen koppelingen te maken in het App Center. Met een eigen koppeling kan je gegevens uit SB lezen om te gebruiken in een applicatie die wij (nog) niet met een meegeleverde koppeling ondersteunen. Voor een dergelijke koppeling is technische kennis vereist. Het kan nodig zijn hier een derde partij voor in te schakelen.

Een eigen koppeling toevoegen kan op twee plekken:

  • Admin Center: deze koppeling wordt beschikbaar in alle administraties van alle klanten.
  • Administratie: deze koppeling wordt beschikbaar voor alle administraties van één klant.

    Let op

    Wij zullen het niet mogelijk maken om inkoopfacturen via een eigen koppeling toe te voegen. Hiervoor bieden wij de Scanbox of Inkoopfactuur.

    Wil je andere gegevens vanuit een applicatie van derden in SB toevoegen of bewerken? Laat het ons weten via de wensenlijst.

  1. Ga met de zoekhulp (Ctrl+Spatie) naar App Center.
  2. Klik op Nieuw (N).
  3. Selecteer een herkenbaar Logo.
  4. Selecteer een Connector bundel.

    Een connector bundel bepaalt welke set van gegevens gelezen kan worden. Op dit moment zijn de volgende bundels beschikbaar:

    • Externe facturatie: Bedoeld om verkoopjournaalposten toe te voegen vanuit een andere applicatie.
      Lezen:
      - Klanten
      - Diverse klanten
      - Grootboekrekeningen
      - Betaalvoorwaarden
      - Openstaande saldi (debiteur)
      Toevoegen:
      - Verkoopjournaalposten
      Wijzigen:
      - Klanten
      Verwijderen:
      - Verkoopjournaalposten
    • Externe verkoopregels: Beschikbaar vanaf SB Versie 5.0. Bedoeld om uren en artikelen als te factureren verkoopregels toe te voegen vanuit een andere applicatie.
      Lezen:
      - Klanten
      - Diverse klanten
      - Projecten
      - Verkoopproducten
      - Verkoopprijzen
      - Verkoopregels.
      Toevoegen:
      - Klanten
      - Verkoopregels
      Wijzigen:
      - Klanten
      - Verkoopregels
      Verwijderen:
      - Verkoopregels
    • Financiële dashboarding: geeft inzicht in de huidige stand van zaken van een onderneming. Bruikbaar voor visualisaties zoals op de Startpagina.
      Lezen:
      - Financiële periodetabel
      - Grootboekrekeningen
      - Grootboeksaldi per periode
      - Boekjaar
    • Financiële rapportage: geeft inzicht in de begin- en eindsituatie van een onderneming over een bepaald boekjaar. Bruikbaar voor jaarrapportage, zoals een Jaarrekening. Op dit moment leest deze bundel dezelfde gegevens uit als hierboven.
    • Relatiemanagement: haalt gegevens van klanten en crediteuren op.
      Lezen:
      - Organisaties
      - Contactpersonen
      - Personen
      - Landen
      - Adressen
      - Bankrekeningen

    Meer informatie over de inhoud van deze connectorbundels vind je hier. Scroll in de inhoudsopgave naar de connectoren die beginnen met Publiek.

  5. Selecteer een Autorisatie.

    Token: SB genereert een token dat je gebruikt voor autorisatie in je eigen applicatie. Dit is de simpelste manier.

    OAuth: deze manier is wat complexer om in te richten, maar wel veiliger in het gebruik.

    • Klik op Client Redirect Url's.
    • Vul minimaal één Client Redirect Url in.

      Dit is de url waar naartoe wordt genavigeerd als je de OAuth-flow hebt afgerond op de Client landingpage. Hier worden de gegenereerde tokens opgeslagen.

    • Klik op Koppeling activeren.
    • Vul een Client landingpage in.

      Dit is de url waar naartoe wordt genavigeerd als iemand deze app activeert. Op deze url richt je de OAuth flow in die vervolgens met de juiste parameters weer bij deze administratie uitkomt.

    • Vul een Tekst voor rechten bij activeren in.

  6. Klik op Opslaan (Ctrl+S).

    De koppeling is nu gelegd.

  7. Implementeer de gelegde koppeling in jouw eigen applicatie.

    Meer informatie over hoe je de gegevens uit de connector bundel kunt gebruiken in jouw applicatie vind je hier.

Zie ook