V2
Vendas
Concluir Venda

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 na conclusão por grupo:

Para todas as concessionárias, é obrigatório que os arquivos listados abaixo sejam enviados e classificados corretamente 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 (Frente e verso / ou CNH)
  • DOC_RESPONSAVEL_FINANCEIRO – Documento do responsável financeiro a depender da concessionária (Frente e verso / ou CNH)

Nota: DOC_CONTRATANTE e DOC_RESPONSAVEL_FINANCEIRO podem ser substituídos por um único arquivo do tipo DOC_CONTRATANTE_E_RESPONSAVEL_FINANCEIRO.

Cliente sem responsável financeiro

  • POV – Áudio do contratante
  • DOC_CONTRATANTE – Documento do contratante (Frente e verso / ou CNH)

Evidência KYC (Exceção)

Se for enviado apenas 1 arquivo e este for do tipo KYC (Know Your Customer / Biometria Facial), a venda poderá ser concluída com sucesso ignorando a obrigatoriedade dos documentos listados acima, visto que o processo de validação de identidade já foi feito na ponta pelo parceiro.

(O envio de KYC juntamente com outras evidências resultará em erro 422 ao concluir a venda)

❌ Erros Comuns

CódigoMotivo
400Falta o parâmetro saleId na URL
404Venda não encontrada ou não pertence ao providerId do usuário
422Venda não está com status DRAFT
422Evidê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ênciasCancelar Venda