office-alexander-logistics/doc/zoho/README.md

Zoho Web API

AGL Dubai nutzt Zoho als Platform zusammen mit einer lokalen Steuerkanzlei

Test/Prod Account Imixs

https://api-console.zoho.eu/ https://api-console.zoho.eu/client/1000.NLTM2KUEHI696MSLGEIANATVGGX7IN

OrganizationID=20105697367
client ID= 1000.NLTM2KUEHI696MSLGEIANATVGGX7IN
client secret= ee9ba49f16e77c64abb89cea13542d2326d8d03ce8

Testumgebung

https://books.zoho.eu/app/20105697367 https://accounts.zoho.eu/home#

API Docu:

https://www.zoho.com/books/api/v3/introduction/

Authentication:

https://www.zoho.com/books/api/v3/oauth/

Base API URI= https://accounts.zoho.eu/

1. Client Einrichten

https://api-console.zoho.eu/client/1000.NLTM2KUEHI696MSLGEIANATVGGX7IN

2. Generating Grant Token

https://accounts.zoho.com/oauth/v2/auth?scope=ZohoBooks.invoices.CREATE,ZohoBooks.invoices.READ,ZohoBooks.invoices.UPDATE,ZohoBooks.invoices.DELETE&client_id=1000.NLTM2KUEHI696MSLGEIANATVGGX7IN&state=testing&response_type=code&redirect_uri=https://alexander-logistics-dwc.office-workflow.de/api/zoho/grant

1000.NLTM2KUEHI696MSLGEIANATVGGX7IN ee9ba49f16e77c64abb89cea13542d2326d8d03ce8

3. Generate Access and Refresh Token

https://accounts.zoho.com/oauth/v2/token?code=1000.dd7exxxxxxxxxxxxxxxxxxxxxxxx9bb8.b6c0xxxxxxxxxxxxxxxxxxxxxxxxdca4&client_id=1000.NLTM2KUEHI696MSLGEIANATVGGX7IN&client_secret=ee9ba49f16e77c64abb89cea13542d2326d8d03ce8&redirect_uri=http://www.zoho.com/books&grant_type=authorization_code

Self Client

Man kann bei zoho mit einem sogenannten 'Self Client' arbeiten. Dieser erlaubt es ohne Redirect auf die Zoho Webseite einen Code anzufordern:

1. Self Client einrichten

Auf die API COnsole von Zoho zugreifen:

https://api-console.zoho.eu/client/1000.GR5FTPZYB06HEWSFSSX4DJU3OBD4EJ

Es kann maximal ein Client eingerichtet werden

Unter Scope trägt man dann den gewünschten Scope ein. Z.B.:

ZohoBooks.invoices.CREATE,ZohoBooks.invoices.READ,ZohoBooks.invoices.UPDATE,ZohoBooks.invoices.DELETE

und eine Description

Den generierten Code nun in Anwendung übertragen und innerhalb (!!) der 'Time Duration' den Access und Refresh Token generieren!

Siehe Junit Test TestUpdateTokens

Find details also here

Example for JUnit Test

Der Junit Test TestUpdateTokens zeigt das Prinzip

client ID= 1000.GR5FTPZYB06HEWSFSSX4DJU3OBD4EJ
client secret= 3f3e74c5212bbc924a7ebf77f887c6296db1106c47

In der Web GUi einen neuen Code generieren:

Scope=ZohoBooks.invoices.CREATE,ZohoBooks.invoices.READ,ZohoBooks.invoices.UPDATE,ZohoBooks.invoices.DELETE

Danach den Code token kopieren:

1000.7fe6315e8848b92a2f281b885677d37a.428c02dc2309606c86271842f1f67de4

Note: Der Code muss für Test immer wieder neu erstellt werden, da er nur für einige Minuten gültig ist!