Os produtos da negociação representam a associação entre uma negociação e um produto do seu catálogo. São fundamentais para detalhar quais itens compõem o valor total de uma negociação.
Cada vez que um produto é adicionado a uma negociação, um registro de produto da negociação é criado, especificando não apenas o produto, mas também a quantidade e o preço unitário negociado para aquela oportunidade específica. Isso permite um cálculo preciso do valor da negociação e uma gestão de inventário mais eficaz.
A manipulação deste recurso é essencial para empresas que vendem múltiplos produtos ou serviços e precisam de um controle granular sobre os itens de cada venda.
Campos personalizados do produto na linha
O array deal_product_custom_fields na API v2 é o snapshot dos campos personalizados do produto no momento em que ele foi adicionado à negociação. A resposta devolve custom_field_id, value e a definição congelada (label, type, opts, editable_on_deal, allow_new, slug).
No envio, apenas custom_field_id e value são considerados, e o valor só é aplicado em campo que estava editável na negociação. Uma opção nova (allow_new) entra no snapshot da linha e também no catálogo do produto, salvo se o campo já tiver sido excluído. Excluir o campo no catálogo não remove o snapshot da linha. Atualizar o campo vivo no catálogo também não altera o snapshot já gravado.