For the complete documentation index, see llms.txt. This page is also available as Markdown.

Produtos da negociacao

/v1/deals/{dealId}/products · as linhas de produto que determinam o valor da negociação.

As linhas de produto/serviço de uma negociação: quantidade, preço e desconto de cada item. São elas que determinam o valor exibido no cartão da negociação.

Método
Rota
Operação

GET

…/products, …/products/{id}

read

POST

…/products

insert

PUT

…/products/{id}

update

DELETE

…/products/{id}

delete

discount_type é amount (valor fixo), percentage (percentual) ou none (sem desconto); discount traz o valor correspondente (null quando none); total_price é o total calculado da linha.

Filtro: product_id (inteiro ou lista). Ordenação: product_id (padrão).

curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/products"
curl -H "Authorization: Bearer $KEY" "https://app-api.atendeserver.com.br/v1/deals/310/products?product_id=15"

Payload

{
  "data": [
    {
      "id": 991,
      "product_id": 15,
      "quantity": 2,
      "price": 199.9,
      "discount_type": "percentage",
      "discount": 10,
      "total_price": 359.82
    }
  ],
  "meta": { "page": 1, "per_page": 30, "total": 1, "total_pages": 1 }
}

Escrita

Campo
Tipo
Observações

product_id

inteiro

obrigatório no POST (produto do catálogo da conta); imutável no PUT (422). Remova a linha e adicione o produto desejado

quantity

inteiro ≥ 1

padrão 1

price

número ≥ 0

padrão: o preço de catálogo no momento da inclusão

discount_type

enum none / amount / percentage

padrão none; usar amount/percentage exige discount; enviar discount sozinho em uma linha none retorna 422

discount

número ≥ 0

valor fixo ou percentual, conforme discount_type

As alterações atualizam o valor calculado da negociação. O cartão no quadro reflete a mudança em tempo real.