Skip to content

Commit

Permalink
feat(integrations): add support for datev (#2223)
Browse files Browse the repository at this point in the history
## Describe your changes

- Added configuration for datev in providers.yaml
- Added datev to docs-v2.
- Added datev pages for Supported API groups in mint.json.
- Added datev SVG file in template-logos folder.
- Consolidate datev docs pages

## Issue ticket number and link

[EXT-76](https://linear.app/nango/issue/EXT-76/add-support-for-datev-api)
## Test
The documentation update was reviewed using `npm run docs` and verifying
on localhost.
  • Loading branch information
hassan254-prog authored Jun 4, 2024
1 parent 124f67c commit 1f25469
Show file tree
Hide file tree
Showing 7 changed files with 62 additions and 0 deletions.
33 changes: 33 additions & 0 deletions docs-v2/integrations/all/datev.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: Datev
sidebarTitle: Datev
---

API configuration: [`datev`](https://nango.dev/providers.yaml)

## Features

| Features | Status |
| - | - |
| [Auth (OAuth)](/integrate/guides/authorize-an-api) ||
| [Sync data](/integrate/guides/sync-data-from-an-api) ||
| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) ||
| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) ||
| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: <48h) |

<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>

## Getting started

- [OAuth related docs](https://developer.datev.de/datev/platform/en/node/133)
- [REST API docs](https://developer.datev.de/datev/platform/en/online-apis)
- [DATEV Postman collection](https://www.postman.com/adil-linuxbean/workspace/data/documentation/21088764-d2d642eb-6eea-4be6-8689-3d83c97d00ac?entity=request-21088764-842e0cb7-33bb-4263-8ec3-9244cbd547d3)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## API gotchas

- An `access_token` is valid for 15 minutes, while the `refresh_token` is valid for 11 hours.
- At present, only DATEV partners or `DATEV Schnittstellenanbieter` have access to DATEV Online APIs. Therefore, a DATEV partner manager will handle the application registration.

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/datev.mdx)</Note>
1 change: 1 addition & 0 deletions docs-v2/integrations/hr.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ sidebarTitle: HR

<CardGroup cols={4}>
<Card title="BambooHR" href="/integrations/all/bamboohr" color="#68a063" />
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
<Card title="Deel" href="/integrations/all/deel" color="#68a063" />
<Card title="Factorial" href="/integrations/all/factorial" color="#68a063" />
<Card title="Gusto" href="/integrations/all/gusto" color="#68a063" />
Expand Down
1 change: 1 addition & 0 deletions docs-v2/integrations/legal.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
<CardGroup cols={4}>
<Card title="Anrok" href="/integrations/all/anrok" color="#68a063" />
<Card title="BoldSign" href="/integrations/all/boldsign" color="#68a063" />
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
<Card title="DocuSign" href="/integrations/all/docusign" color="#68a063" />
<Card title="PandaDoc" href="/integrations/all/pandadoc" color="#68a063" />
<Card title="Signnow" href="/integrations/all/signnow" color="#68a063" />
Expand Down
1 change: 1 addition & 0 deletions docs-v2/integrations/payroll.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ sidebarTitle: Payroll
</Tip>

<CardGroup cols={4}>
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
<Card title="Deel" href="/integrations/all/deel" color="#68a063" />
<Card title="Gusto" href="/integrations/all/gusto" color="#68a063" />
<Card title="Payfil" href="/integrations/all/payfit" color="#68a063" />
Expand Down
1 change: 1 addition & 0 deletions docs-v2/mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -333,6 +333,7 @@
"integrations/all/coda",
"integrations/all/confluence",
"integrations/all/contentstack",
"integrations/all/datev",
"integrations/all/deel",
"integrations/all/dialpad",
"integrations/all/digitalocean",
Expand Down
24 changes: 24 additions & 0 deletions packages/shared/providers.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -466,6 +466,30 @@ contentstack:
authorization_url: https://${connectionConfig.subdomain}.contentstack.com/apps/${connectionConfig.appId}/authorize
token_url: https://${connectionConfig.subdomain}.contentstack.com/apps-api/apps/token
docs: https://docs.nango.dev/integrations/all/contentstack
#Untested configuration. Please reach out if you have a test account that we can use to test it.
datev:
categories:
- legal
- payroll
- hr
auth_mode: OAUTH2
authorization_url: https://login.datev.de/openid/authorize
token_url: https://api.datev.de/token
token_request_auth_method: basic
scope_seprator: ' '
default_scopes:
- openid
authorization_params:
response_type: code id_token
response_mode: query
nonce: AnotherRandomStringDatev
token_params:
grant_type: authorization_code
refresh_params:
grant_type: refresh_token
proxy:
base_url: https://api.datev.de
docs: https://docs.nango.dev/integrations/all/datev
deel:
categories:
- hr
Expand Down
1 change: 1 addition & 0 deletions packages/webapp/public/images/template-logos/datev.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 1f25469

Please sign in to comment.