API atual/Referência completa/ERP Compras

Configuração de compras

Lê e grava o limite de valor a partir do qual um pedido de compra exige aprovação.

Ler configuração

A configuração de compras tem um único campo: o valor a partir do qual um pedido precisa de aprovação antes de poder ser enviado. Com 0 (padrão) tudo é aprovado automaticamente ao submeter.

GET/api/v1/vendor/erp/compras/settingsSeller

Lê a configuração de compras

Exemplo de requisição: Ler configuração

bash

curl "$BASE_URL/api/v1/vendor/erp/compras/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta: Ler configuração

200Configuração

json

{
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "po_approval_min_cents": 500000,
  "updated_at": "2026-10-11T14:30:00Z"
}

Campos da resposta

vendor_iduuid

Seller.

po_approval_min_centsinteger

Limite de aprovação em centavos. 0 desliga a aprovação.

updated_atdatetime

Última gravação. Vale 0001-01-01T00:00:00Z enquanto o seller nunca gravou.

Erros: Ler configuração

Status	Quando	Corpo
401	Cabeçalho `Authorization` ausente, token inválido, expirado ou revogado.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller (por exemplo, é de administrador).	`{"error":"insufficient permissions"}`
403	O usuário não está vinculado a um seller, ou o cadastro do seller ainda está em análise (`vendor_pending_review`).	`{"error":"no vendor account associated with this user"}`

Gravar configuração

PUT/api/v1/vendor/erp/compras/settingsSeller

Grava a configuração de compras

Corpo da requisição

po_approval_min_centsintegerobrigatório

Limite em centavos, zero ou mais. Pedidos com total_cents maior ou igual a este valor vão para pending_approval. 0 desliga.

Exemplo de requisição: Gravar configuração

bash

curl -X PUT "$BASE_URL/api/v1/vendor/erp/compras/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "po_approval_min_cents": 500000
}'

Resposta: Gravar configuração

200Configuração gravada

json

{
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "po_approval_min_cents": 500000,
  "updated_at": "2026-10-11T14:30:00Z"
}

Campos da resposta

vendor_iduuid

Seller.

po_approval_min_centsinteger

Limite de aprovação em centavos. 0 desliga a aprovação.

updated_atdatetime

Última gravação. Vale 0001-01-01T00:00:00Z enquanto o seller nunca gravou.

Erros: Gravar configuração

Status	Quando	Corpo
400	Corpo não é um JSON válido.	`{"error":"invalid request body","detail":"invalid character 'b' looking for beginning of object key string"}`
400	Valor negativo.	`{"error":"vendorerp: limite de aprovação deve ser >= 0"}`
401	Cabeçalho `Authorization` ausente, token inválido, expirado ou revogado.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller (por exemplo, é de administrador).	`{"error":"insufficient permissions"}`
403	O usuário não está vinculado a um seller, ou o cadastro do seller ainda está em análise (`vendor_pending_review`).	`{"error":"no vendor account associated with this user"}`

Veja também

Ciclo do pedido

Configuração de compras

Lê e grava o limite de valor a partir do qual um pedido de compra exige aprovação.

Ler configuração

A configuração de compras tem um único campo: o valor a partir do qual um pedido precisa de aprovação antes de poder ser enviado. Com 0 (padrão) tudo é aprovado automaticamente ao submeter.

GET/api/v1/vendor/erp/compras/settingsSeller

Lê a configuração de compras

Exemplo de requisição: Ler configuração

bash

curl "$BASE_URL/api/v1/vendor/erp/compras/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta: Ler configuração

200Configuração

json

{
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "po_approval_min_cents": 500000,
  "updated_at": "2026-10-11T14:30:00Z"
}

Campos da resposta

vendor_iduuid

Seller.

po_approval_min_centsinteger

Limite de aprovação em centavos. 0 desliga a aprovação.

updated_atdatetime

Última gravação. Vale 0001-01-01T00:00:00Z enquanto o seller nunca gravou.

Erros: Ler configuração

Status	Quando	Corpo
401	Cabeçalho `Authorization` ausente, token inválido, expirado ou revogado.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller (por exemplo, é de administrador).	`{"error":"insufficient permissions"}`
403	O usuário não está vinculado a um seller, ou o cadastro do seller ainda está em análise (`vendor_pending_review`).	`{"error":"no vendor account associated with this user"}`

Gravar configuração

PUT/api/v1/vendor/erp/compras/settingsSeller

Grava a configuração de compras

Corpo da requisição

po_approval_min_centsintegerobrigatório

Limite em centavos, zero ou mais. Pedidos com total_cents maior ou igual a este valor vão para pending_approval. 0 desliga.

Exemplo de requisição: Gravar configuração

bash

curl -X PUT "$BASE_URL/api/v1/vendor/erp/compras/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "po_approval_min_cents": 500000
}'

Resposta: Gravar configuração

200Configuração gravada

json

{
  "vendor_id": "94bd7e9a-fdad-4d01-8fc2-ba9d677d8b36",
  "po_approval_min_cents": 500000,
  "updated_at": "2026-10-11T14:30:00Z"
}

Campos da resposta

vendor_iduuid

Seller.

po_approval_min_centsinteger

Limite de aprovação em centavos. 0 desliga a aprovação.

updated_atdatetime

Última gravação. Vale 0001-01-01T00:00:00Z enquanto o seller nunca gravou.

Erros: Gravar configuração

Status	Quando	Corpo
400	Corpo não é um JSON válido.	`{"error":"invalid request body","detail":"invalid character 'b' looking for beginning of object key string"}`
400	Valor negativo.	`{"error":"vendorerp: limite de aprovação deve ser >= 0"}`
401	Cabeçalho `Authorization` ausente, token inválido, expirado ou revogado.	`{"error":"missing authorization header"}`
403	O token não é de um usuário seller (por exemplo, é de administrador).	`{"error":"insufficient permissions"}`
403	O usuário não está vinculado a um seller, ou o cadastro do seller ainda está em análise (`vendor_pending_review`).	`{"error":"no vendor account associated with this user"}`

Veja também

Ciclo do pedido