---
agentTools:
projectIndex: https://atendare.readme.io/llms.txt
---
# Editar negociação
Realiza uma edição de informações na negociação específicada pelo ID
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "Atendare API - v2",
"version": "2.0"
},
"servers": [
{
"url": "https://api.atendare.com/v2"
}
],
"security": [
{}
],
"paths": {
"/deals/{id}": {
"patch": {
"summary": "Editar negociação",
"description": "Realiza uma edição de informações na negociação específicada pelo ID",
"operationId": "edit-deals",
"parameters": [
{
"name": "Access-Token",
"in": "header",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "id",
"in": "path",
"schema": {
"type": "integer",
"format": "int64",
"default": null
},
"required": true
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Nome da negociação"
},
"start_date": {
"type": "string",
"description": "Data de início",
"format": "date"
},
"end_date": {
"type": "string",
"description": "Data de fim",
"format": "date"
},
"estimated_value": {
"type": "number",
"description": "Valor estimado",
"format": "double"
},
"visibility": {
"type": "string",
"description": "Visibilidade da negociação",
"default": "2 = private",
"enum": [
"1 = organization",
"2 = private",
"3 = team"
]
},
"currency_id": {
"type": "integer",
"description": "ID da moeda",
"format": "int64"
},
"company_id": {
"type": "integer",
"description": "ID da empresa",
"format": "int64"
},
"qualification_id": {
"type": "integer",
"description": "ID da qualificação",
"format": "int64"
},
"contact_id": {
"type": "integer",
"description": "ID do contato",
"format": "int64"
},
"pipeline_id": {
"type": "integer",
"description": "ID do pipeline",
"format": "int64"
},
"stage_id": {
"type": "integer",
"description": "ID da etapa do pipeline",
"format": "int64"
},
"source_id": {
"type": "integer",
"description": "ID da fonte",
"format": "int64"
},
"responsible_id": {
"type": "integer",
"description": "ID do usuário responsável",
"format": "int64"
},
"participants": {
"type": "array",
"description": "Lista de participantes",
"items": {
"properties": {
"person_id": {
"type": "integer",
"format": "int32"
},
"user_id": {
"type": "string"
}
},
"type": "object"
}
},
"products": {
"type": "array",
"description": "Lista de produtos
Se informado parâmetro: null ou array vazio serão removido todos os produtos da negociação
Produtos que não estiverem nesta lista serão removidos!",
"items": {
"properties": {
"id": {
"type": "integer",
"description": "ID de relação entre negociação e produto.
Se não informado um novo produto será adicionado.",
"format": "int64"
},
"product_id": {
"type": "integer",
"description": "ID do produto",
"format": "int64"
},
"order": {
"type": "integer",
"description": "Campo de ordenação, caso não passado será a ordem do item na lista",
"format": "int32"
},
"amount": {
"type": "integer",
"description": "Campo quantidade",
"format": "int32"
},
"cost_price": {
"type": "number",
"description": "Quando o preço de custo é personalizado",
"format": "double"
},
"unit_price": {
"type": "number",
"description": "Quando o preço unitário é personalizado",
"format": "double"
},
"discount": {
"type": "number",
"description": "Desconto em valor monetário",
"format": "double"
},
"discount_percent": {
"type": "number",
"description": "Desconto em percentual (valor entre 0 e 100)",
"format": "double"
},
"description": {
"type": "string",
"description": "Descrição do item"
},
"notes": {
"type": "string",
"description": "Notas adicionais"
},
"supplier_id": {
"type": "integer",
"description": "ID do fornecedor, caso especificar algum",
"format": "int64"
}
},
"required": [
"product_id",
"amount",
"unit_price"
],
"type": "object"
}
}
}
}
}
}
},
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n\t\"success\": true,\n\t\"data\": {\n\t\t\"id\": 1\n\t}\n}"
}
},
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": true,
"default": true
},
"data": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 1,
"default": 0
}
}
}
}
}
}
}
},
"400": {
"description": "400",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n\t\"success\": false,\n\t\"errors\": [\n\t\t\"Erros\"\n\t]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"example": false,
"default": true
},
"errors": {
"type": "array",
"items": {
"type": "string",
"example": "Erros"
}
}
}
}
}
}
},
"404": {
"description": "404",
"content": {
"application/json": {
"examples": {
"Result": {
"value": ""
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true,
"_id": "61f3f7309a3abf0010b92516:62c6cb507bf2c1008542e9a6"
}
```