Apin määrittely Easoftiin
- Klikkaa Easoftissa oikeasta yläkulmasta "ukkelin" kuvaa.
- Valitse "Rajapinta-avaimet"
- Luo uusi rajapinta klikkaamalla "Luo uusi"
- Nimeä rajapinta esim "KodinPro"
- Määrittele alla olevat oikeudet rajapinnalle ja Tallenna rajapinta sivun alalaidasta klikkaamalla "Tallenna"
- Kopioi rajapinnan "Token" ja toimita tai liitä se KodinPro:n järjestelmään.
- KodinPro rajapintaa varten tarvitaan myös teidän Easoftin domain, joka löytyy selaimen osoiteriviltä esim https://remonttix.easoft.eu/
-
KodinPro:sta voidaan tuoda työpyynnöt ja tarjouspyynnöt eri vaiheille Easoftin myyntiputkelle. Tätä varten tarvitaan
myyntiputken vaiheen (työpyyntö) idmyyntiputken vaiheen (tarjouspyyntö) id
Rajapintaoikeudet
Asiakkaat
| ON |
POST /customers/uploadFile
Lisää tiedoston asiakkaalle |
| ON |
POST /customers/createDeliveryAddress/{id}
Luo asiakkaalle toimitusosoitteen |
| ON |
POST /customers/createContact/{id}
Luo asiakkaalle yhteyshenkilön |
| ON |
POST /customers
Luo uuden asiakkaan |
| ON |
PUT /customers/{number}
Muokkaa asiakasta |
| ON |
GET /customers
Palauttaa asiakaslistauksen |
| ON |
GET /customer_details
Palauttaa id:tä vastaavat asiakastiedot |
| EI |
DELETE /customers/{id}
Poistaa id:tä vastaavan asiakkaan |
| ON |
PUT /customers/merge/{toCustomerId}
Yhdistää asiakastiedot |
Käyttäjät
| ON |
GET /users/{id}
Palauttaa id:tä vastaavan käyttäjän |
| ON |
GET /users
Palauttaa käyttäjälistauksen |
Liidi
| ON |
GET /pipeline_items
Liidin tietojen haku |
| ON |
POST /pipeline_items
Luo uuden liidin |
| ON |
PUT /pipeline_items/{id}
Muokkaa liidiä |
Myyntiputki
| ON |
GET /pipelines
Palauttaa myyntiputket ja niiden sarakkeet |
Tilaukset
| EI |
POST /orders/passOffer/{id}
Asettaa id:tä vastaavan tarjouksen menetetyksi |
| EI |
POST /orders
Luo tilauksen |
| EI |
POST /orders/acceptOffer/{id}
Muuttaa id:tä vastaavan tarjouksen tilaukseksi |
| ON |
GET /orders/{id}
Palauttaa id:tä vastaavan tilauksen tiedot |
| ON |
GET /orders
Palauttaa tilauksien tiedot |
| EI |
GET /order/{id}
Poistuva API, älä käytä! |
| EI |
PUT /orders/{id}
Päivittää tilauksen |
| EI |
POST /orders/deliverOrder/{id}
Toimittaa tilauksen |
Rajapinnan avauspyynnössä pyydetään myös myyntiputken sarakkeiden id:t. Ne voi hakea seuraavasti:
Avaa api-doc.easoft.eu
Alhaalta subdomain kenttään asiakkaan kirjautumissivun etuosa -> Authoeize -> bearer tokeniin äsken luodusta rajapinta-avaimista token -> Authorize Ja Close
Rullaa alas -> Pipeline -> Avaa -> Try it out -> Excecute
Kopioi "Response body" kohdasta pyydetyt myyntiputken sarakkeiden id:t