Atualizar uma venda por id

API/

Vendas

Atualizar uma venda por id

Request

Permite atualizar uma venda existente. Útil se sua aplicação permite editar vendas depois que foram criadas no ERP.

Security

BearerAuth

Path

idstringrequired

O uuid da venda a ser editada

Example:123e4567-e89b-12d3-a456-426614174000

Bodyapplication/jsonrequired

id_clientestring, (uuid)required

uuid do cliente

Example:"550e8400-e29b-41d4-a716-446655440000"

id_vendedorstring, (uuid)

ID do vendedor

Example:"123e4567-e89b-12d3-a456-426614174000"

numerointegerrequired

Número da venda

Example:1

data_vendastring, (date)required

Data da venda

Example:"2023-12-31"

situacaostringrequired

Situação da venda

Enum:"EM_ANDAMENTO""APROVADO""FATURADO""CANCELADO"

Example:"APROVADO"

observacoesstring

Observações sobre a venda

Example:"Cliente solicitou entrega rápida"

observacoes_pagamentostring

Observações sobre o pagamento

Example:"Pagamento realizado em 3 parcelas"

id_natureza_operacaostring, (uuid)

id da natureza da operação

Example:"550e8400-e29b-41d4-a716-446655440000"

versaointegerrequired

Versão da venda é obrigatório na edição

Example:1

itensArray of any(ItemVendaRequest)required

composicao_de_valorobject(ValorComposicaoRequest)

condicao_pagamentoobject(CondicaoPagamentoRequest)required

curl -i -X PUT \
  https://api-v2.contaazul.com/v1/venda/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id_cliente": "550e8400-e29b-41d4-a716-446655440000",
    "id_vendedor": "123e4567-e89b-12d3-a456-426614174000",
    "numero": 1,
    "data_venda": "2023-12-31",
    "situacao": "APROVADO",
    "observacoes": "Cliente solicitou entrega rápida",
    "observacoes_pagamento": "Pagamento realizado em 3 parcelas",
    "id_natureza_operacao": "550e8400-e29b-41d4-a716-446655440000",
    "versao": 1,
    "itens": {
      "descricao": "Produto A",
      "quantidade": 2,
      "valor": 50,
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "valor_custo": 40,
      "itens_kit": [
        {
          "id_produto": "568e8400-e29b-41d4-a716-446655440000",
          "id_kit": "550e8400-e29b-41d4-a716-446655440000",
          "quantidade": 2,
          "valor": 50
        }
      ]
    },
    "composicao_de_valor": {
      "frete": 100,
      "desconto": {
        "tipo": "VALOR",
        "valor": 5
      }
    },
    "condicao_pagamento": {
      "tipo_pagamento": "CARTAO_CREDITO",
      "id_conta_financeira": "567e8400-e29b-41d4-a716-446655440000",
      "opcao_condicao_pagamento": "À vista",
      "nsu": "1234567890",
      "parcelas": [
        {
          "data_vencimento": "2023-12-31",
          "valor": 100,
          "descricao": "Parcela 1"
        }
      ]
    }
  }'

Responses

Bodyapplication/json

idstring, (uuid)

uuid da venda editada

Example:"123e4567-e89b-12d3-a456-426614174000"

id_legadointeger

id legado

Example:123456

Response

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "id_legado": 123456
}