# PANTHEON Web Service (API) — integracije po mjeri

> PANTHEON Web Service (PAWS) je Datalabov REST API za razmjenu podataka s PANTHEON ERP-om. Preko njega povezujemo sustave za koje ne postoji gotova integracija: partneri, artikli, narudžbe, dokumenti, zalihe i zadaci. Mi ga postavljamo, osiguravamo i po potrebi gradimo cijelu integraciju.

## Kada koristiti API

API je pravi izbor kad sustav s kojim se povezujete nema gotovu integraciju s PANTHEONOM ili kad gradite vlastitu aplikaciju: portal za kupce, mobilnu aplikaciju za teren ili vezu sa specijaliziranim alatom. Na PANTHEON Web Serviceu radimo i vlastita rješenja, na primjer [B2B portal](https://www.pantheon.hr/dorade-i-rjesenja/b2b-portal/) i [web portal za kontrolu pakiranja](https://www.pantheon.hr/dorade-i-rjesenja/kontrola-pakiranja/).

## Što API nudi

API je REST s JSON podacima, a dokumentiran je u Swaggeru (OpenAPI), gdje su opisane sve metode: [paws.datalab.eu](https://paws.datalab.eu/index.html). Glavna područja:

- **Partneri (subjekti):** dohvat, unos i izmjena partnera, uključujući kontakte.
- **Artikli:** dohvat svih podataka o artiklu, unos, izmjena, slika artikla i kalkulacije.
- **Narudžbe:** dohvat, unos i izmjena narudžbe i pojedine stavke, brisanje, izrada dokumenta (npr. računa) iz narudžbe ili nove narudžbe iz postojeće.
- **Dokumenti robnog poslovanja:** dohvat, unos i izmjena dokumenata i stavki (primke, izdatnice, međuskladišnice), vrste i statusi dokumenata, promjena statusa te dodavanje stavki iz drugih dokumenata.
- **Zalihe:** trenutno stanje zaliha uz filtre (artikl, datum, kategorije, vrsta cijene).
- **Zadaci (ToDo):** dohvat i kreiranje PANTHEON zadataka te pripadni šifranti.
- **Kalendari:** kreiranje događaja u Google i Outlook kalendaru, i iz PANTHEON zadatka.
- **Baza:** pozivanje pohranjenih procedura te odabir, unos, izmjena i brisanje podataka u tablicama, za slučajeve koje gotove metode ne pokrivaju.

## Sigurnost i prijava

Svaki poziv ide prijavljenim PANTHEON korisnikom u odabranoj bazi (tvrtki). Podržana je prijava tokenom ili kolačićem, provjera valjanosti sesije i promjena baze. Servis postavljamo iza HTTPS veze, a ovlasti API korisnika ograničavamo na ono što integracija treba. Pristupni podaci nikad ne idu u kod ni u repozitorij, nego se drže u konfiguraciji na serveru.

## Što radimo

- instalacija i sigurno postavljanje PANTHEON Web Servicea,
- razvoj integracije na strani PANTHEONA,
- izrada cijele integracije, kad ne želite angažirati developera,
- podrška vašem developeru pri korištenju API-ja,
- praćenje rada i prilagodba novim verzijama PANTHEONA.

Za svako vanjsko rješenje koje se automatski povezuje s PANTHEON bazom potrebna je Datalabova Konektor licenca.

## Ključne točke

- Partneri i artikli ↔ vanjski sustav
- Narudžbe i dokumenti → PANTHEON
- Zalihe i cijene → vanjski sustav
- Zadaci i ostali podaci po potrebi

## Česta pitanja

### Gdje se PANTHEON Web Service instalira?

Najčešće na vašem serveru uz PANTHEON bazu, iza sigurne HTTPS veze. Instalaciju, pristupne podatke i ovlasti postavljamo mi.

### Kako se korisnik prijavljuje na API?

Prijavom PANTHEON korisnika uz odabir baze (tvrtke). API nudi prijavu putem tokena ili kolačića te provjeru valjanosti sesije, a poziv se izvršava u kontekstu prijavljenog korisnika.

### Može li naš developer sam koristiti PANTHEON API?

Može. API ima javnu Swagger (OpenAPI) dokumentaciju, a mi postavimo i osiguramo API te vašem developeru damo podršku. Ako ne želite angažirati developera, cijelu integraciju radimo mi.

### Može li API kreirati narudžbe i račune?

Da. Preko API-ja se narudžbe unose i mijenjaju (zaglavlje i pojedine stavke), a iz narudžbe se može kreirati dokument (npr. račun) ili nova narudžba.

---
Izvor: https://www.pantheon.hr/integracije/pantheon-api/
Ars Pantheon — Datalab Premium Partner za PANTHEON ERP u Hrvatskoj