Propostas de preço
Consulta e registra as propostas de preço (make_an_offer) de clientes B2B pela API legada, compatível com a Venddor 1.0.
Uma proposta de preço é um pedido de negociação: o cliente B2B diz quais produtos quer, em que quantidade e a que preço, e o lojista responde com uma cotação. Na Venddor 1.0 esse fluxo se chamava make an offer. Aqui ele é a mesma solicitação de cotação do módulo B2B da loja.
Como funciona
Para acompanhar as propostas de um cliente, chame Consultar propostas com o user_id. Para ver uma só, acrescente o common_id.
Conceitos-chave
Duas formas de resposta
Sem common_id, a resposta é {"offers_groups":[...],"params":{...}} e traz todas as propostas do cliente, em páginas. Com common_id, é {"offers":[...]} com uma única proposta.
Formato de erro
Os erros chegam como {"message":"...","status":N}. Atenção: dados que faltam na requisição chegam como 404, não 400.
Endpoints
| Método | Caminho | Para quê | Autenticação | Página |
|---|---|---|---|---|
| GET | /api/v1.0/make_an_offer | Consulta as propostas de um cliente | Administrador | Consultar propostas |
| POST | /api/v1.0/make_an_offer | Registra uma proposta | Administrador | Criar proposta |
| PUT | /api/v1.0/make_an_offer/{id} | Sempre 405 | Administrador | Alterar e excluir |
| DELETE | /api/v1.0/make_an_offer/{id} | Sempre 405 | Administrador | Alterar e excluir |
Erros comuns
- Consultar sem
user_id. A resposta é 404user_id is required. - Mandar um
user_idque não é UUID. A resposta é 500 com a mensagem do banco. - Mandar um
common_idque não é número. A resposta é 400invalid common_id. - Tentar alterar ou excluir uma proposta.
PUTeDELETErespondem 405.