Primeiros passos — Sinistros

Entenda por onde começar com a Sagas API para abrir e acompanhar sinistros com a 180.

A API de sinistros permite que canais parceiros abram sinistros para apólices emitidas via Sagas, enviem documentação, consultem status e recebam notificações em tempo real via webhooks.

Fluxo geral

Obter o id-venda de uma apólice ativa (via Listar vendas)
Abrir sinistro para a cobertura acionada
Consultar o sinistro pelo numero-sinistro retornado
Enviar documentos solicitados
Acompanhar status até conclusão (consultas ou webhooks)

Consulte também:

Fluxo de sinistro — visão detalhada passo a passo
Documentação — como funcionam documentos pendentes e recebidos

Autenticação

A Sagas API usa o fluxo OAuth2 client credentials. Você receberá um client_id e um client_secret usados para obter um token de acesso enviado em todas as chamadas.

Para obter um token de acesso:

curl --request POST \
  --url https://180s-staging.us.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

Inclua o token em todas as chamadas:

Authorization: Bearer SEU_TOKEN_DE_ACESSO
Content-Type: application/json

Reutilize tokens de acesso enquanto forem válidos (por padrão, 12 horas). Obter tokens desnecessariamente pode resultar em limitações nas chamadas.

Hosts

Ambiente	Host
Staging	`sagas.staging.180s.com.br`
Production	`sagas.production.180s.com.br`

Base path: /sagas/v1

Entidades principais

Entidade	Descrição
Venda	Apólice emitida e ativa vinculada a um cliente
Sinistro	Aviso de sinistro aberto para uma cobertura da apólice
numero-sinistro	Identificador público do sinistro (usado nos demais endpoints)
Documentação	Documentos exigidos e arquivos enviados pelo canal/segurado

Status do sinistro

Status	Descrição
`criado`	Sinistro registrado, aguardando próximas etapas
`abertura-rejeitada`	Abertura rejeitada (valor reservado no contrato da API; não retornado nas respostas atuais)
`pendente-de-documentacao`	Aguardando envio de documentos
`documentacao-em-analise`	Documentos recebidos, em análise pela seguradora
`em-regulacao`	Sinistro em análise/regulação
`pendente-de-dados-de-pagamento`	Aguardando dados de pagamento do beneficiário
`recusado`	Sinistro negado
`finalizado`	Sinistro concluído (ex.: pagamento realizado)

Para iniciar a integração, entre em contato com o time da 180 para obter credenciais e acesso ao ambiente de staging.