Produtos: consulta e cadastro na API V1

Permissões: products.read para consultar, products.create para cadastrar.

Consultar produtos

GET /api/v1/products aceita, entre outros filtros: search, code, barcode, type, enable, per_page, updated_since, sort, direction. O include permite solicitar barcodes, images, image_meta, content e technical_sheet.

curl "https://audacia.com.br/api/v1/products?search=camiseta&per_page=20" \
  -H "Authorization: Bearer SEU_TOKEN" -H "Accept: application/json"

A resposta contém success, lista data, metadados em meta e URLs de paginação em links. O limite máximo de per_page depende da configuração da instalação.

Cadastrar produto simples

POST /api/v1/products valida obrigatoriamente manage_stock, code, name, price e unit. O tipo padrão é SIMPLE e a condição padrão é NOT_SPECIFIED quando ausentes.

curl -X POST "https://audacia.com.br/api/v1/products" \
  -H "Authorization: Bearer SEU_TOKEN" -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  --data '{"code":"EXEMPLO-001","name":"Produto de exemplo","unit":"UN","price":19.9,"manage_stock":false}'

O code deve ser exclusivo dentro da empresa do token. Produtos montáveis (ASSEMBLY) exigem regras próprias de montagem; o exemplo acima não cobre essa modalidade. Confira também os endpoints de atualização e imagens na referência da API.