Imixs/office-alexander-logistics
3
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
office-alexander-logistics/doc/zoho
History
Ralph Soika 4b9da4d98a update zoho interface
2025-05-07 13:12:45 +02:00
..
contact-create-example.json zoho invoice export 2025-04-30 11:25:08 +02:00
disable-auto-generated-number-01.png neue Code Formatierung 2025-05-07 11:37:31 +02:00
disable-auto-generated-number-02.png neue Code Formatierung 2025-05-07 11:37:31 +02:00
image.png zoho self client - new test code 2025-04-22 22:20:13 +02:00
invoice-create-example.json zoho attachments 2025-05-02 14:27:02 +02:00
README.md update zoho interface 2025-05-07 13:12:45 +02:00
SECRETS.md update zoho interface 2025-05-07 13:12:45 +02:00

README.md

Zoho Web API

AGL Dubai nutzt Zoho als Platform zusammen mit einer lokalen Steuerkanzlei

Testaccount - siehe SECRETS.md

API Dokumentation

Testumgebung

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

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!

Disable auto-generated invoice number

Um die Automatische Vergabe von Rechnungsnummern in Zoho zu deaktivieren kann wie folgt vorgegangen werden:

  1. Unter 'Invoices' eine neue Rechnung anlegen#
  2. Im Feld 'Invoice#' das Zahnrad anklicken:
  1. Und dort die Option "Enter invoice numbers manually" auswählen