Concluir Venda

Este endpoint conclui uma venda previamente criada com NewSale, desde que todos os pré-requisitos estejam atendidos (incluindo upload de evidências obrigatórias).

🔐 Autenticação

A API exige autenticação via token JWT no cabeçalho:

Authorization: Bearer {token}

📬 Endpoint

POST /sales/{saleId}/checkout
Content-Type: application/json
Authorization: Bearer {token}

Substitua {saleId} pelo ID da venda retornado na criação da venda.

🧾 Exemplo de Requisição

POST /sales/5e9183cb-56c3-4f03-8bbf-f3b12e932ab8/checkout

Sem corpo na requisição (body vazio).

📤 Resposta de Sucesso

{
  "message": "Sale concluded successfully!",
  "sale": {
    ... // dados da venda concluída
  }
}

✅ Requisitos para Conclusão

A venda só pode ser concluída se:

Estiver com status DRAFT
Todos os documentos obrigatórios forem enviados
A venda estiver associada ao mesmo providerId do usuário autenticado

Evidências obrigatórias por tipo de cliente:

Para concessionárias do grupo NEOENERGIA, é obrigatório que os seguintes arquivos sejam enviados antes da conclusão da venda:

Cliente com responsável financeiro

POV – Áudio do contratante
AUT – Áudio do responsável financeiro
DOC_CONTRATANTE – Documento do contratante
DOC_RESPONSAVEL_FINANCEIRO – Documento do responsável financeiro

Cliente sem responsável financeiro

POV – Áudio do contratante
DOC_CONTRATANTE – Documento do contratante

❌ Erros Comuns

Código	Motivo
400	Falta o parâmetro `saleId` na URL
404	Venda não encontrada ou não pertence ao `providerId` do usuário
422	Venda não está com status `DRAFT`
422	Evidências obrigatórias ausentes

🛠️ Observações Técnicas

A lógica de validação de evidências é dinâmica com base no schema de evidências por grupo e tipo de produto/concessionária.
Após a conclusão, uma mensagem é enviada para a fila SQS respectiva da concessionária.

🧑‍💼 Suporte

Entre em contato com o time responsável pela API de vendas caso surjam dúvidas ou problemas com a conclusão da venda.

Adicionar Evidências Sobre