Os produtos e serviços são os itens que sua empresa oferece aos clientes, ou seja, o que você vende. Os produtos nas negociações são os itens negociados na oportunidade de venda.
Com essa API é possível consultar os Produtos e Serviços vinculados a uma Negociação, bem como, criar e atualizá-los.
Query params
Parâmetros utilizados para listar produtos nas Negociações.
| Nome | Tipo | Descrição |
|---|---|---|
| token | String | Token do usuário |
| deal_id | String | ID da negociação |
| deal_product_id | String | ID da referência entre produto e negociação |
Body params
Parâmetros utilizados para criar ou atualizar produtos nas negociações.
| Nome | Tipo | Descrição | Obrigatório | Observação |
|---|---|---|---|---|
| product_id | String | ID do produto | ✓ | Obtido a partir da consulta pela API de Listar produtos |
| price | Float | Preço do produto | ✘ | Valor padrão é 0.0 |
| amount | Integer | Quantidade de produtos | ✘ | Valor padrão é 1 |
| discount_type | String | Tipo de desconto aplicado ao produto | ✓ | Valores aceitos: "value" (valor) ou "percent" (porcentagem). Não pode ser enviado vazo, se você não quiser aplicar um desconto, basta enviar o "discount"= 0. |
| discount | Number | Desconto aplicado ao produto | ✓ | Se o tipo de desconto for discount_type = "value", aceita um valor entre 0 e o valor declarado no parâmetro "price". Se o discount_type = "percent", aceita um valor entre 0 e 100. |
| recurrence | String | Recorrência de compra do produto | ✘ | Valores aceitos: "spare" (único) ou "monthly" (recorrente) |
Para criar, atualizar ou excluir Produtos em massa associados à uma Negociação, é necessário utilizar os endpoints específicos. O limite é de 100 Produtos por requisição.