---
title: "Atualizar proposta"
method: PUT
path: "/proposals/{proposal_id}"
---

# Atualizar proposta

`PUT /proposals/{proposal_id}`

## Path parameters

- `proposal_id` integer, required

## Request body

- object
  - `deal_id` integer — ID da oportunidade atrelada.
  - `user_id` integer — ID do usuário responsável pela proposta.
  - `name` string — Nome da proposta
  - `proposal_counter_id` integer — ID do contador de proposta (para siglas sequenciais).
  - `proposal_model_id` integer — ID do modelo de proposta.
  - `payment_method_id` integer — ID do método de pagamento dos itens de produtos e serviços (P&S) da proposta.
  - `payment_method_mrr_id` integer — ID do método de pagamento dos itens de receitas recorrentes (MRR).
  - `currency_id` integer — ID da moeda de pagamento: 1: real brasileiro, 2: dólar americano, 3: euro.
  - `brand_id` integer — ID da marca utilizada na proposta.
  - `shipping_company_id` integer — ID da empresa de transporte responsável pela entrega.
  - `billing_company_id` integer — ID da empresa de faturamento.
  - `triangular_company_id` integer — ID da empresa de entrega triangular.
  - `purchase_order` string — Identificador do pedido de compra.
  - `commission_type` integer — Tipo de comissão para pagamento de itens de produtos e serviços (P&S): 0: valor percentual, 1: valor absoluto.
  - `commission_value` number, float — Valor da comissão para itens de produtos e serviços (P&S).
  - `comission_type_mrr` integer — Tipo de comissão para pagamento de itens de receitas recorrentes (MRR): 0: valor percentual, 1: valor absoluto.
  - `comission_value_mrr` number, float — Valor da comissão para itens de receitas recorrentes (MRR).
  - `status` integer — Status da proposta: 0: aberto, 1: aprovado, 2: negado, 3: cancelado, 4: aguardando assinatura, 5: assinado.
  - `introduction` string — Texto de introdução da proposta.
  - `observation` string — Texto de observações da proposta.
  - `expiration_date` string, date — Data de validade da proposta.
  - `first_payment_date` string, date — Data do pagamento da entrada dos itens de produtos e serviços (P&S).
  - `first_payment_mrr_date` string, date — Data do pagamento da entrada dos itens de receitas recorrentes (MRR).
  - `first_payment_interval` integer — Prazo (em dias) para a primeira parcela
  - `due_date` string, date — Dia do mês de vencimento das parcelas dos itens
  - `parcels` integer — Quantidade de parcelas de pagamento de itens de produtos e serviços (P&S)
  - `parcels_mrr` number, float — Quantidade de parcelas de pagamento de itens de receitas recorrentes (MRR).
  - `down_payment_percent` number, float — Valor percentual que será pago na entrada.
  - `interval` integer — Intervalo (em dias) entre as parcelas.
  - `payment_comment` string — Comentários sobre o pagamento de itens de produtos e serviços (P&S)
  - `payment_comment_mrr` string — Comentários sobre o pagamento de itens de receitas recorrentes (MRR)
  - `proposal_layout_id` integer — ID do layout de propostas para geração de PDF customizado.
  - `shipping_type` integer — Tipo do frete: 0: sem frete, 1: FOB, 2: CIF.
  - `shipping_value` number, float — Valor do frete.
  - `discount_value` number, float — Valor do percentual de desconto da forma de pagamento de itens de produtos e serviços (P&S).
  - `delivery_forecast_date` integer — Dia do mês de previsão de entrega.
  - `items` object[] — Array contendo os dados dos itens vinculados à proposta.
    - `item` object — Objeto contendo informações do item
      - `id` integer — ID do item
      - `name` string — Nome do item
    - `quantity` integer — Quantidade de itens
    - `characteristics` object
      - `id` integer — ID da característica do item.
      - `options` object — Array contendo os IDs das opções de características dos item.
        - `id` integer — ID do tipo de característica do item.
    - `delivery_forecast_date` string — Data de previsão de entrega
    - `cost` number, float — Custo do item
    - `markup_type` string — Tipo de valor de markup (0= valor percentual / 1= valor absoluto)
    - `markup_value` integer — Valor de markup
    - `value` number, float — Valor unitário do item
    - `discount_type` integer — Tipo de desconto do item (0= valor percentual / 1= valor absoluto)
    - `discount_value` number, float — Valor de desconto do item
    - `commission_type` integer — Tipo de comissão do item (0= valor percentual / 1= valor absoluto)
    - `commission_value` number, float — Valor da comissão do item
    - `commission_incidence_type` integer — Incidência da comissão do item (1= primeira mensalidade / 2= doze primeiras mensalidades / 3= primeira e última mensalidade / 4= todas as mensalidades)
    - `duration` integer — Duração da recorrência do item de recorrência (MRR)
    - `ipi_tax` number, float — Valor percentual do imposto IPI do item
    - `contract_start_at` string, date — Data de início da vigência do contrato dos itens de recorrência (MRR)
    - `contract_end_at` string, date — Data de término da vigência do contrato dos itens de recorrência (MRR)
    - `type_of_charge` integer — Tipo de cobrança para itens de recorrência (MRR) (1= antecipada / 2= mensal / 3= trimestral / 4= semestral / 5= anual)
  - `proposalParcels` object[] — Divisão de parcelas da proposta
    - `value` number, float — Valor da parcela
    - `due_date` string, date — Data de vencimento da parcela
    - `payment_method_type_id` integer — O código (ID) correspondente ao meio de pagamento. Lembrar que é do meio de pagamento e não da forma de pagamento.
    - `parcel` string — Parcela correspondente. Esta pode ser definida em números (1, 2, 3...) ou com especificação de "Entrada" ou "À Vista" caso seja uma única parcela.

## Response `200`

200

## Other responses

- `400` — 400
- `422` — 422

---

[API](https://skmtc.net/pipe/apis/application-json.md) · [All operations](https://skmtc.net/pipe/apis/application-json/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipe/application-json/versions/0a130198f0a3/schema)