Morffeus Docs
ENSR morffeus.com

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.

Ceo postupak
1

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.

Autentifikacija
2

Poš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.

Vaš prvi zahtev
3

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.

Referenca za zalihe
# 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": [ … ]
  }
}

Šta se promenilo

Svako dodavanje i svako zastarevanje, sa datumom.

Sve promene
GET /stocks/aggregate vraća zalihe na stanju, rezervisane i raspoložive, po varijanti i po prodavnici. Ukupno po magacinimaDodato
PUT /int/stocks menja zalihe po varijanti i magacinu, uparene po vašim šiframa. min_qty postavlja minimum novog reda zaliha. Izmena stanja zalihaDodato
POST /stock/reconcile postavlja magacin na količine koje ste prebrojali, jednim kretanjem zaliha. Usklađivanje magacinaDodato