Dokumentacija za programere
Gradite na Morffeusu.
Povežite ERP, magacin, kasu ili prodavnicu sa platformom na kojoj vaš posao već radi. Jedan JSON API, jedan token za celu aplikaciju i vaše sopstvene oznake na svakom zapisu, pa u vašim sistemima ništa ne mora da se menja.
Počnite ovde
Tri koraka od praznog terminala do prve izmene zaliha.
Nabavite API token
U Admin-u otvorite User › Tokens i napravite token. Token pripada vašem korisniku i važi za celu aplikaciju koju povezujete. Za svaki sistem koji razgovara sa nama koristite poseban token, da biste jedan mogli da opozovete bez diranja ostalih.
AutentifikacijaPošaljite prvi zahtev
Svaki poziv ide na https://api.morffeus.com/api/v2 sa zaglavljem Authorization: Bearer. Počnite sa GET /products da vidite svoj katalog onako kako ga vidi API. Odgovori su JSON sa sadržajem pod data.
Pošaljite prvu izmenu
Pošaljite izmenu zaliha preko PUT /int/stocks. Redovi se uparuju sa vašim varijantama po code, barcode ili vašem external_ref, a sa magacinom po njegovoj šifri. Količina koju pošaljete dodaje se onome što magacin ima.
# pet proizvoda aplikacije kojoj token pripada curl "https://api.morffeus.com/api/v2/products?limit=5" \ -H "Authorization: Bearer $MORFFEUS_TOKEN" \ -H "Accept: application/json"
const res = await fetch('https://api.morffeus.com/api/v2/products?limit=5', { headers: { Authorization: `Bearer ${process.env.MORFFEUS_TOKEN}` } }); const { data } = await res.json(); console.log(data.products[0].code);
$ch = curl_init('https://api.morffeus.com/api/v2/products?limit=5'); curl_setopt($ch, CURLOPT_HTTPHEADER, [ 'Authorization: Bearer ' . getenv('MORFFEUS_TOKEN'), 'Accept: application/json', ]); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $products = json_decode(curl_exec($ch), true)['data']['products'];
{
"data": {
"products": [
{
"id": 48213,
"code": "SKU-1001",
"slug": "espresso-beans-1-kg",
"variants": [
{
"id": 91120,
"code": "SKU-1001",
"barcode": "8600123456789",
"external_ref": "ERP-778",
…
}
],
"prices": [ { "price": 1890.0, … } ],
…
},
…
],
"product_attributes": [ … ],
"product_data_values": [ … ]
}
}
Dva API-ja, jedna platforma
Isti host, isti oblik tokena, isti JSON. Razlikuju se po tome ko ih poziva i čemu služe.
Vaši sistemi razgovaraju sa Morffeusom
Za ERP, magacin, knjigovodstvo i kasu. Šaljite proizvode, cene, atribute, zalihe, završene porudžbine, kupce i kartice u paketima. Upisi se uparuju po vašim sopstvenim oznakama, pa vam naši identifikatori ne trebaju.
- Proizvodi
- Atributi
- Katalozi
- Zalihe
- Magacini
- Porudžbine
- Kupci
- Kartice
- Lokacije
/api/v2/int/*Vi pravite aplikaciju ili sajt
Za sopstvenu internet prodavnicu, mobilnu aplikaciju ili kiosk. Katalog i pretraga, korpa na serveru, naplata i plaćanje, nalog kupca, novčanici i pogodnosti, rezervacije. Isti API koji svakodnevno koriste naši Quest sajtovi i Flutter aplikacije.
- Sesije
- Katalog i pretraga
- Korpa
- Naplata
- Plaćanja
- Nalog
- Novčanici
- Rezervacije
/api/v2/session/*Referenca za Integration API
Endpointi koji trebaju većini integracija. Svaka stranica ima objekat, svako polje, primere zahteva i odgovora i greške koje možete dobiti.
Proizvodi
Proizvodi, varijante, cene i slike. Kreirajte ili menjajte u paketima iz svog ERP-a.
Atributi proizvoda
Boja, veličina, materijal, brend. Atribute definišete jednom, a vrednosti dodeljujete po proizvodu.
Katalozi
Cenovnici i asortimani po tržištu i valuti, i kako proizvodi iz njih dobijaju cene.
Zalihe
Količina po varijanti po magacinu. Šaljite izmene i popise iz svog WMS-a, čitajte ukupno stanje po magacinima.
Porudžbine
Porudžbine iz prodavnice, radnji i prodajnih kanala: pretraga, statusi, otkazivanje i refundacija.
Kupci
Profili, kontakt podaci, saglasnosti i vaša sopstvena oznaka kupca. Čitanje i izmena.
Kartice
Kartice lojalnosti i njihovi brojevi. Uvezite postojeću bazu kartica ili izdajte kartice sa kase.
Lokacije
Prodavnice i mesta preuzimanja sa radnim vremenom i koordinatama, povezani sa magacinima koji ih snabdevaju.
Osnove
Četiri stvari koje svaka integracija mora da uradi kako treba.
Osnovni URL
https://api.morffeus.com/api/v2Test aplikaciju za testiranje dogovarate sa nama.
Autentifikacija
Authorization: Bearer <token>Pripada korisniku, važi za jednu aplikaciju. Pravi se i opoziva u User › Tokens.
Greške
{ "errors": { "field": "message" } }HTTP status kaže kakva je greška. Telo kaže koje polje.
Endpointi za pakete
Liste, ne petljeProizvodi, zalihe, atributi, lokacije i porudžbine idu kao liste, pa je sinhronizacija nekoliko poziva, ne hiljade.
Vodiči
Od početka do kraja, redom kojim se odvija prava integracija. Svaki vodič navodi endpointe, pravila uparivanja i greške koje najčešće viđamo.
Sinhronizacija kataloga iz ERP-a
Proizvodi, varijante, cene, atributi i slike. Prvo puno učitavanje, zatim samo izmene.
Usklađivanje zaliha
Izmene naspram prebrojanih količina, jedan magacin ili više njih, minimalne količine i šta prodavnica prikazuje.
Slanje porudžbina sa kase
Završeni računi sa stavkama i plaćanjima, upareni sa kupcem, i šta je bezbedno poslati dvaput.
Uvoz kupaca i kartica
Prenesite postojeću bazu kupaca i kartica: uparivanje, saglasnosti i duplikati.
Izrada sopstvene prodavnice
Prijavite kupca, pretražite katalog, držite korpu na serveru i platite. Put kojim idu i naše aplikacije.
Lista za puštanje u rad
Prvo testiranje, token po sistemu, ponovni pokušaji, praćenje i kome da pišete kad nešto ne izgleda kako treba.
Šta se promenilo
Svako dodavanje i svako zastarevanje, sa datumom.
GET /stocks/aggregate vraća zalihe na stanju, rezervisane i raspoložive, po varijanti i po prodavnici. Ukupno po magacinimaDodatoPUT /int/stocks menja zalihe po varijanti i magacinu, uparene po vašim šiframa. min_qty postavlja minimum novog reda zaliha. Izmena stanja zalihaDodatoPOST /stock/reconcile postavlja magacin na količine koje ste prebrojali, jednim kretanjem zaliha. Usklađivanje magacinaDodato