Skip to content

Commit 1f25469

Browse files
feat(integrations): add support for datev (NangoHQ#2223)
## 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.
1 parent 124f67c commit 1f25469

File tree

7 files changed

+62
-0
lines changed

7 files changed

+62
-0
lines changed

docs-v2/integrations/all/datev.mdx

+33
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
title: Datev
3+
sidebarTitle: Datev
4+
---
5+
6+
API configuration: [`datev`](https://nango.dev/providers.yaml)
7+
8+
## Features
9+
10+
| Features | Status |
11+
| - | - |
12+
| [Auth (OAuth)](/integrate/guides/authorize-an-api) ||
13+
| [Sync data](/integrate/guides/sync-data-from-an-api) ||
14+
| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) ||
15+
| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) ||
16+
| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: <48h) |
17+
18+
<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
19+
20+
## Getting started
21+
22+
- [OAuth related docs](https://developer.datev.de/datev/platform/en/node/133)
23+
- [REST API docs](https://developer.datev.de/datev/platform/en/online-apis)
24+
- [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)
25+
26+
<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
27+
28+
## API gotchas
29+
30+
- An `access_token` is valid for 15 minutes, while the `refresh_token` is valid for 11 hours.
31+
- At present, only DATEV partners or `DATEV Schnittstellenanbieter` have access to DATEV Online APIs. Therefore, a DATEV partner manager will handle the application registration.
32+
33+
<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>

docs-v2/integrations/hr.mdx

+1
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ sidebarTitle: HR
1010

1111
<CardGroup cols={4}>
1212
<Card title="BambooHR" href="/integrations/all/bamboohr" color="#68a063" />
13+
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
1314
<Card title="Deel" href="/integrations/all/deel" color="#68a063" />
1415
<Card title="Factorial" href="/integrations/all/factorial" color="#68a063" />
1516
<Card title="Gusto" href="/integrations/all/gusto" color="#68a063" />

docs-v2/integrations/legal.mdx

+1
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
<CardGroup cols={4}>
77
<Card title="Anrok" href="/integrations/all/anrok" color="#68a063" />
88
<Card title="BoldSign" href="/integrations/all/boldsign" color="#68a063" />
9+
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
910
<Card title="DocuSign" href="/integrations/all/docusign" color="#68a063" />
1011
<Card title="PandaDoc" href="/integrations/all/pandadoc" color="#68a063" />
1112
<Card title="Signnow" href="/integrations/all/signnow" color="#68a063" />

docs-v2/integrations/payroll.mdx

+1
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ sidebarTitle: Payroll
99
</Tip>
1010

1111
<CardGroup cols={4}>
12+
<Card title="Datev" href="/integrations/all/datev" color="#68a063" />
1213
<Card title="Deel" href="/integrations/all/deel" color="#68a063" />
1314
<Card title="Gusto" href="/integrations/all/gusto" color="#68a063" />
1415
<Card title="Payfil" href="/integrations/all/payfit" color="#68a063" />

docs-v2/mint.json

+1
Original file line numberDiff line numberDiff line change
@@ -333,6 +333,7 @@
333333
"integrations/all/coda",
334334
"integrations/all/confluence",
335335
"integrations/all/contentstack",
336+
"integrations/all/datev",
336337
"integrations/all/deel",
337338
"integrations/all/dialpad",
338339
"integrations/all/digitalocean",

packages/shared/providers.yaml

+24
Original file line numberDiff line numberDiff line change
@@ -466,6 +466,30 @@ contentstack:
466466
authorization_url: https://${connectionConfig.subdomain}.contentstack.com/apps/${connectionConfig.appId}/authorize
467467
token_url: https://${connectionConfig.subdomain}.contentstack.com/apps-api/apps/token
468468
docs: https://docs.nango.dev/integrations/all/contentstack
469+
#Untested configuration. Please reach out if you have a test account that we can use to test it.
470+
datev:
471+
categories:
472+
- legal
473+
- payroll
474+
- hr
475+
auth_mode: OAUTH2
476+
authorization_url: https://login.datev.de/openid/authorize
477+
token_url: https://api.datev.de/token
478+
token_request_auth_method: basic
479+
scope_seprator: ' '
480+
default_scopes:
481+
- openid
482+
authorization_params:
483+
response_type: code id_token
484+
response_mode: query
485+
nonce: AnotherRandomStringDatev
486+
token_params:
487+
grant_type: authorization_code
488+
refresh_params:
489+
grant_type: refresh_token
490+
proxy:
491+
base_url: https://api.datev.de
492+
docs: https://docs.nango.dev/integrations/all/datev
469493
deel:
470494
categories:
471495
- hr
Loading

0 commit comments

Comments
 (0)