Integrações privadasComercialOportunidades

Gerar venda a partir da oportunidade

View as Markdown
Cria uma venda em aberto a partir de uma oportunidade ativa e pendente. Regras: - a oportunidade precisa estar ativa e pendente; - a venda nasce com os itens ativos da oportunidade; - você pode enviar pagamentos junto com a geração da venda; - o total dos pagamentos não pode ser maior que o total da venda; - a rota gera a venda, mas não finaliza a venda automaticamente. Exemplo de uso: ```http POST {{base_url}}/simplificav2/oportunidade/29627/venda Authorization: Bearer {{bearer_token}} Content-Type: application/json { "data_venda": "2026-04-06", "data_previsao_entrega": "2026-04-10", "pagamentos": [ { "forma_pagamento_id": 3, "numero_parcela": 1, "valor_parcela": 1400, "data_vencimento": "2026-04-06" } ] } ```

Authentication

AuthorizationBearer
Token privado usado para consultar dados da plataforma. Como usar: - obtenha o token privado da sua empresa; - envie `Authorization: Bearer SEU_TOKEN_PRIVADO`; - não use `x-api-key` neste módulo.

Path parameters

idintegerRequired
Identificador da oportunidade.

Request

This endpoint expects an object.
data_vendastring or nullOptional

Data da venda no formato YYYY-MM-DD.

data_previsao_entregastring or nullOptional

Data prevista de entrega no formato YYYY-MM-DD.

endereco_entrega_idinteger or nullOptional

Endereço de entrega da venda gerada.

observacaostring or nullOptional

Observação visível no documento da venda.

observacao_internastring or nullOptional

Observação interna da venda.

vl_acrescimodouble or nullOptional

Valor adicional aplicado à venda gerada.

vl_fretedouble or nullOptional

Valor de frete aplicado à venda gerada.

pagamentoslist of objects or nullOptional
Lista opcional de pagamentos iniciais da venda gerada.

Response

Venda gerada com sucesso.
statusstring
mensagemstring
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error