Venty API — Administração completa 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=venty_ci_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":{"venty_ci_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","venty_ci_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:'venty_ci_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"}

# criar loja com retirada
curl -X POST https://api.venty.me/api/v2/inventory/locations \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Loja Centro","type":"store","cep":"20221030","city":"Rio de Janeiro","state":"RJ","pickup_enabled":true,"pickup_ready_hours":24}'
# → {"id":"<location id = origin_id>","geocoded":true}

body := `{"name":"Loja Centro","type":"store","cep":"20221030","pickup_enabled":true}`
req, _ := http.NewRequest("POST", base+"/api/v2/inventory/locations", strings.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req) // 201 {id, geocoded}

const r = await fetch(`${base}/api/v2/inventory/locations`,{ method:'POST',
  headers:{ Authorization:`Bearer ${token}`, 'Content-Type':'application/json' },
  body: JSON.stringify({ name:'Loja Centro', type:'store', cep:'20221030', pickup_enabled:true }) });
const { id } = await r.json(); // id = origin_id p/ os níveis de estoque

# criar cliente PJ
curl -X POST https://api.venty.me/api/v2/customers \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"email":"compras@acme.com","name":"ACME","person_type":"pj","document":"12345678000199","legal_name":"ACME LTDA","trade_name":"ACME"}'
# → {"id":"…","email":"compras@acme.com"};  GET/PUT /api/v2/customers/{id}

body := `{"email":"compras@acme.com","person_type":"pj","document":"12345678000199","legal_name":"ACME LTDA"}`
req, _ := http.NewRequest("POST", base+"/api/v2/customers", strings.NewReader(body))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req) // 201 {id, email}

const r = await fetch(`${base}/api/v2/customers`,{ method:'POST',
  headers:{ Authorization:`Bearer ${token}`, 'Content-Type':'application/json' },
  body: JSON.stringify({ email:'compras@acme.com', person_type:'pj',
    document:'12345678000199', legal_name:'ACME LTDA' }) });

# por URL (o Venty baixa e re-hospeda + deduplica)
curl -X POST https://api.venty.me/api/v2/catalog/media \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"url":"https://erp.exemplo/img/1001.jpg","external_id":"MATNR-1001"}'
# → {"id":"…","url":"/media/…","checksum":"…","deduped":false}

curl -X PUT https://api.venty.me/api/v2/catalog/products/$PID/gallery \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"items":[
    {"external_id":"MATNR-1001","url":"https://erp/1001.jpg","checksum":"","is_main":true},
    {"external_id":"MATNR-1002","media_id":""}
  ]}'
# → {"synced":2,"pruned":0}