Venty API — Catálogo & Estoque para ERP

# form-urlencoded (padrão OAuth)
curl -X POST https://api.venty.me/api/v2/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=vk_live_ab12cd34 \
  -d client_secret=$VENTY_SECRET \
  -d 'scope=catalog:read inventory:write'

package main
import ("net/http"; "net/url"; "io"; "fmt")
func token() string {
  form := url.Values{"grant_type":{"client_credentials"},
    "client_id":{"vk_live_ab12cd34"}, "client_secret":{secret}}
  r, _ := http.PostForm("https://api.venty.me/api/v2/oauth/token", form)
  defer r.Body.Close(); b, _ := io.ReadAll(r.Body)
  // parse {"access_token": "..."} → devolve o token
  return parseAccessToken(b)
}

// reqwest = { version = "0.12", features=["json"] }
let res = client.post("https://api.venty.me/api/v2/oauth/token")
    .form(&[("grant_type","client_credentials"),
            ("client_id","vk_live_ab12cd34"),
            ("client_secret",&secret)])
    .send().await?.json::<Token>().await?;
let access = res.access_token;

const body = new URLSearchParams({
  grant_type:'client_credentials',
  client_id:'vk_live_ab12cd34', client_secret:process.env.VENTY_SECRET });
const r = await fetch('https://api.venty.me/api/v2/oauth/token',{method:'POST',body});
const { access_token } = await r.json();

{"access_token":"eyJ…","token_type":"Bearer","expires_in":600,"scope":"catalog:read inventory:write"}

curl https://api.venty.me/api/v2/catalog/products/$PID/inventory \
  -H "Authorization: Bearer $TOKEN"

req, _ := http.NewRequest("GET",
  base+"/api/v2/catalog/products/"+pid+"/inventory", nil)
req.Header.Set("Authorization", "Bearer "+token)
res, _ := http.DefaultClient.Do(req) // → 200 Inventory JSON

let inv = client.get(format!("{base}/api/v2/catalog/products/{pid}/inventory"))
    .bearer_auth(&token).send().await?.json::<Inventory>().await?;

const inv = await (await fetch(
  `${base}/api/v2/catalog/products/${pid}/inventory`,
  { headers:{ Authorization:`Bearer ${token}` } })).json();

{"stock_mode":"per_location","manage_stock":true,"stock":0,"reserved":0,"available":0,
 "levels":[{"origin_id":"eae8…","origin_name":"Bonsucesso","origin_type":"store","on_hand":40,"reserved":3,"available":37}]}

# ENTRADA por loja: Bonsucesso passa a 45 on_hand
curl -X PUT https://api.venty.me/api/v2/catalog/products/$PID/inventory \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"levels":[{"origin_id":"eae8154e-…","on_hand":45}]}'

// read-modify-write: leia (GET) → novo = atual + entrada → PUT
body := `{"levels":[{"origin_id":"eae8154e-…","on_hand":45}]}`
req, _ := http.NewRequest("PUT", base+"/api/v2/catalog/products/"+pid+"/inventory",
  strings.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req) // 200 = ok; 409 = abaixo do reservado

let res = client.put(format!("{base}/api/v2/catalog/products/{pid}/inventory"))
    .bearer_auth(&token)
    .json(&json!({"levels":[{"origin_id":oid,"on_hand":45}]}))
    .send().await?;
if res.status()==409 { /* abaixo do reservado */ }

const res = await fetch(`${base}/api/v2/catalog/products/${pid}/inventory`,{
  method:'PUT',
  headers:{ Authorization:`Bearer ${token}`, 'Content-Type':'application/json' },
  body: JSON.stringify({ levels:[{ origin_id:oid, on_hand:45 }] }) });
if (res.status===409) { /* estoque_abaixo_do_reservado */ }

# 200: devolve o estoque recalculado (mesmo shape do GET)
{"stock_mode":"per_location","levels":[{"origin_id":"eae8…","on_hand":45,"reserved":3,"available":42}]}

curl -X POST https://api.venty.me/api/v2/catalog/products \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Placa ST 13","slug":"placa-st-13","sku":"PLST13","price":18.03,"stock":120}'

body := `{"name":"Placa ST 13","slug":"placa-st-13","sku":"PLST13","price":18.03,"stock":120}`
req, _ := http.NewRequest("POST", base+"/api/v2/catalog/products", strings.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req) // 201 {"id":"…"}; 409 slug/sku

let r = client.post(format!("{base}/api/v2/catalog/products"))
    .bearer_auth(&token)
    .json(&json!({"name":"Placa ST 13","slug":"placa-st-13",
        "sku":"PLST13","price":18.03,"stock":120}))
    .send().await?; // 201 { id }

const r = await fetch(`${base}/api/v2/catalog/products`,{ method:'POST',
  headers:{ Authorization:`Bearer ${token}`, 'Content-Type':'application/json' },
  body: JSON.stringify({ name:'Placa ST 13', slug:'placa-st-13',
    sku:'PLST13', price:18.03, stock:120 }) });
const { id } = await r.json(); // 201

{"id":"88cfc492-ad6d-405c-8bbf-d582b3e21b83"}