Online APIs hr:files

hr:files

2.0.0
API-Reference API-Documentation

Collection for API Client Bruno

Collection for API Client Bruno

Bruno is an API client app similar to Postman or Insomnia. 

To enable a quick start with our APIs, we have created a collection with all available DATEV data services for this app.

 

Download the app (usebruno.com)

Download the collection 

 

Quick guide for sandbox:

  1. Creation of an API client via the DATEV Developer Portal (Organization > Manage Apps) for communication with the DATEV API Gateway
  2. Installation of the Bruno app & import of the collection
  3. Configuration of the environment variables for sandbox (e.g. client ID & client secret)
  4. Selection of the "Sandbox" environment

  5. Token via calls from the "Authentification..." folder Get

    Note: OAuth2.0 is currently not directly supported by Bruno, which is why the authentication steps must be run through manually

    1. "GET 1 Request....for sandbox...": Customize query param "redirect_uri" and "scope" according to subscriptions of the own API client from the DATEV Developer Portal
    2. "GET 1 Request....for sandbox...": Send request via Bruno (an error will appear) and open the "Timeline" tab in the response area
    3. "GET 1 Request....for sandbox...":Copy the URL including all query parameters from the timeline and call up the URL via a browser (incognito window recommended)
    4. The DATEV login page should appear in the browser Selection of point 3 - "DATEV user account"
    5. Perform authentication with user: "Test6" Password: "bTomu4cTKg"
    6. The DATEV Consent page should appear in the browser
    7. After confirming with "I agree", the redirect to the previously specified redirect URL takes place
    8. In the browser, the authorization code can then be copied from the URL line "...code=123that...9&..." Attention: The authorization code only goes up to the first "&" character
    9. Paste the copied authorization code at Bruno into the variable "authorization code" from Environment Sandbox
    10. "POST 2 Request...Token": Send request via Bruno. The generated tokens are automatically written to variables for the selected environment
    11. "POST 3 Refresh...Token": Can be used to refresh the access token if the first access token has expired (15min)
  6. Use DATEV data service
    1. Select the folder with the name of the desired DATEV data service and usually the requests are prepared in such a way that you receive a 200 response