Pular para o conteúdo principal

Digitally sign an awarded auction

POST 
/company/bid-auctions/:service_code/sign

Permite ao transportador vencedor assinar digitalmente a adjudicação de um leilão.
A assinatura é realizada por meio de uma imagem de assinatura manuscrita carregada pelo usuário.

Objetivo​

Formalizar legalmente a aceitação do transporte pelo transportador vencedor,
gerando automaticamente os documentos e registros necessários para o processo logístico.

Efeitos Secundários Automáticos ⚠️​

Este endpoint realiza automaticamente as seguintes operações ao ser concluído:

  1. Criação do Delivery:

    • É criado um registro de delivery associado ao leilão
    • O delivery é inicializado com os dados do leilão
    • É estabelecida a relação auction.delivery → delivery._id

  2. Geração do eCMR:

    • É gerado automaticamente o documento eCMR (Carta de Porte Digital)
    • O eCMR é associado ao delivery recém-criado
    • É inicializado com os dados de transporte do leilão

  3. Atualização de Estados:

    • O leilão é marcado como assinado
    • É definido signed_by_trucker: true
    • É registrada a data e hora da assinatura

  4. Relações entre Entidades:

    Auction → Delivery → eCMR  
    (auction._id) (delivery.auction) (ecmr.delivery)

Requisitos do Arquivo de Assinatura​

  • Formato: JPEG ou PNG
  • Tamanho máximo: 5MB
  • Resolução mínima: 300x100px
  • Conteúdo: Imagem de assinatura manuscrita legível

Casos de Uso​

  • Transportador vencedor assina a aceitação de um leilão adjudicado
  • Sistema gerando automaticamente delivery e eCMR após a assinatura
  • Integração com fluxos automatizados de gestão de transporte

Notas Importantes​

  • Apenas o transportador vencedor pode assinar
  • O leilão deve estar no estado awarded
  • A assinatura é irreversível

Request​

Responses​

Assinatura registrada com sucesso. O leilão passa para o estado 'completed' e a entrega é criada.

Response Headers