Fluxo de sinistro — API

Na API Sagas, o fluxo de sinistro envolve entidades que se relacionam da seguinte forma:

• Venda: apólice emitida e ativa, obtida após conclusão de uma proposta
• Sinistro: aviso de sinistro aberto para uma cobertura específica da apólice
• Documentação: documentos exigidos conforme cobertura/natureza e arquivos enviados
• Pagamento: indenização após aprovação e regulação

sequenceDiagram
  participant Canal
  participant Sagas as Sagas API

  Canal->>Sagas: POST /vendas (listar)
  Sagas-->>Canal: id-venda

  Canal->>Sagas: POST /vendas/{id-venda}/abrir-sinistro
  Sagas-->>Canal: numero-sinistro, documentacao

  Canal->>Sagas: POST /sinistros/{numero}/enviar-documento
  Sagas-->>Canal: url-envio
  Canal->>Sagas: PUT url-envio (arquivo)
  Note over Canal,Sagas: Repetir para cada documento

  Canal->>Sagas: GET /sinistros/{numero}
  Sagas-->>Canal: status atualizado

  opt Saldo devedor
    Canal->>Sagas: POST /sinistros/{numero}/saldo-devedor
  end

  opt Webhooks
    Sagas-->>Canal: sinistro-criado, sinistro-finalizado, etc.
  end

1. Obter id-venda

Liste as vendas do cliente segurado:

curl --request POST \
  --url https://sagas.staging.180s.com.br/sagas/v1/vendas \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "tipo-cliente-segurado": "pessoa-fisica",
    "cpf": "87821357626"
  }'

Use uma venda com status: completa cujo produto possua a cobertura que será acionada.

2. Abrir sinistro

Com o id-venda, abra o sinistro informando cobertura, datas, solicitante e pessoa para contato. Veja exemplos completos em Abrir sinistro.

A resposta inclui numero-sinistro — guarde esse valor para os passos seguintes.

3. Consultar sinistro

Detalhes em Consultar sinistro.

curl --request GET \
  --url https://sagas.staging.180s.com.br/sagas/v1/sinistros/{NUMERO_SINISTRO} \
  --header 'Authorization: Bearer SEU_TOKEN'

4. Enviar documentos

Para cada documento pendente:

1. POST /sinistros/{numero-sinistro}/enviar-documento → recebe url-envio
2. PUT do arquivo na url-envio
3. Consulte o sinistro novamente para verificar documentacao atualizada

Detalhes em Enviar documento e Documentação.

5. Atualizar saldo devedor (opcional)

Para coberturas que dependem de saldo devedor (ex.: prestamista), informe o valor atualizado:

curl --request POST \
  --url https://sagas.staging.180s.com.br/sagas/v1/sinistros/{NUMERO_SINISTRO}/saldo-devedor \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "saldo-devedor": 2500
  }'

Veja Atualizar saldo devedor.

6. Whitelabel (opcional)

Canais com experiência whitelabel podem gerar uma URL temporária para o segurado gerenciar o sinistro:

curl --request POST \
  --url https://sagas.staging.180s.com.br/sagas/v1/sinistros/whitelabel/gerar-url \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "id-venda": "{ID_VENDA}",
    "segurado": {
      "cpf-ou-cnpj": "00000000000",
      "tipo-documento": "cpf",
      "nome": "João da Silva",
      "numero-telefone": {
        "codigo-area": "11",
        "numero-telefone": "987654321"
      },
      "email": "[email protected]",
      "endereco": {
        "logradouro": "Rua das Flores",
        "numero": "123",
        "bairro": "Centro",
        "cidade": "São Paulo",
        "estado": "SP",
        "cep": "01310100"
      }
    }
  }'

Veja Gerar URL whitelabel.

Webhooks

Eventos de sinistro disponíveis para assinatura:

• sinistro-criado
• sinistro-ajuste-de-reserva
• sinistro-pagamento
• sinistro-pagamento-concluido
• sinistro-finalizado
• sinistro-negado

Configure webhooks via /sagas/v1/webhooks. Consulte a documentação de eventos da Sagas API.