Interconnect.API

Za jednostavnu integraciju s vašim ERP ili EDI sustavima, razvili smo Interconnect.API (RESTful API) koji omogućuje slanje i primanje dokumenata izravno iz tih sustava. Kako bi razmjena dokumenata bila što brža, Interconnect koristi webhookove. Interconnect.Webhooks automatski obavještavaju API primatelja čim se dokument pošalje, omogućujući mu automatsko preuzimanje poslanog dokumenta.

Autorizacija

Za autorizaciju vaših zahtjeva prema Interconnect.API, koristimo OAuth 2.0 protokol s Bearer tokenima.

Kako doći do Bearer tokena?

Pošaljite HTTP POST zahtjev na adresu za dohvat tokena:

Content-Type zahtjeva treba biti: application/x-www-form-urlencoded

Parametri zahtjeva

• grant_type: "password"

• client_id: vaš jedinstveni ID klijenta

• client_secret: vaša tajna klijenta

• username: vaše korisničko ime

• password: vaša lozinka

• scope: "Tomsoft.Interconnect.Api"

Primjer zahtjeva

POST https://identity.luceed.dev/connect/token
Content-Type: application/x-www-form-urlencoded

grant_type=password&client_id=VAŠ_CLIENT_ID&client_secret=VAŠ_CLIENT_SECRET&username=VAŠ_USERNAME&password=VAŠ_PASSWORD&scope=Tomsoft.Interconnect.Api

Primanje Bearer tokena

Nakon slanja ovog zahtjeva, dobit ćete odgovor u JSON formatu koji sadrži access token kojim ćete autorizirati API poziv. Valjanost tokena je kratka pa ga treba dohvaćati prije svakog novog poziva.

Primjer odgovora

{
    "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjQ1MTA4RjA5RUNFMkE3...",
    "expires_in": 60,
    "token_type": "Bearer",
    "scope": "Tomsoft.Interconnect.Api"
}

Slanje zahtjeva s Bearer tokenom

Kada imate Bearer token, jednostavno ga dodajte u zaglavlje svakog HTTP zahtjeva prema Interconnect.API na sljedeći način.

Primjer zahtjeva s Bearer tokenom

POST https://interconnect.luceed.dev/api/documents
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IjQ1MTA4RjA5RUNFMkE3...
Content-Type: application/json

{
    "DocumentSenderId": "[NA:1234,7531]",
    "DocumentType": "UBL:ORDER",
    "DocumentFormat": "XML",
    "DocumentTransformation": "base64",
    "DocumentContent": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTg..."
}

Interconnect.API dokumentacija

Interconnect.API dokumentaciji možete pristupiti ovdje:

🔗 interconnect.luceed.com/api