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/checkoutSem 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
providerIddo 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 contratanteAUT– Áudio do responsável financeiroDOC_CONTRATANTE– Documento do contratanteDOC_RESPONSAVEL_FINANCEIRO– Documento do responsável financeiro
Cliente sem responsável financeiro
POV– Áudio do contratanteDOC_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.