Abrir sinistro para apólice vinculada a venda

POST /sagas/v1/vendas/{id-venda}/abrir-sinistro

Realiza a abertura de um sinistro para a apólice de seguro vinculada a uma venda.

Campos obrigatórios

Campo	Descrição
`pessoa-para-contato`	Dados de quem a seguradora deve contatar (nome + email ou telefone)
`solicitante`	Identificação do solicitante do sinistro
`cobertura`	Cobertura acionada — deve corresponder a uma cobertura ativa da apólice (ex.: `cobertura/morte`)
`data-ocorrencia`	Data em que o evento ocorreu
`natureza`	Obrigatório para `cobertura/morte` e `cobertura/perda-de-renda`

Valores de natureza

Valor	Descrição
`morte-acidental`	Morte por acidente
`morte-natural`	Morte por causas naturais
`perda-de-renda-desemprego`	Perda de renda por desemprego
`perda-de-renda-invalidez-fisica`	Perda de renda por invalidez física

Campos opcionais

Campo	Descrição
`relato-do-ocorrido`	Narrativa do evento
`saldo-devedor`	Saldo devedor atual (coberturas prestamista)
`detalhes-pagamento`	Beneficiário e método de pagamento, se já conhecidos
`dados-adicionais`	Dados complementares do sinistro

Exemplo mínimo

curl --request POST \
  --url https://sagas.staging.180s.com.br/sagas/v1/vendas/{ID_VENDA}/abrir-sinistro \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "pessoa-para-contato": {
      "nome": "Maria da Silva",
      "email": "[email protected]",
      "telefone": {
        "codigo-area": "11",
        "numero-telefone": "987654321"
      }
    },
    "solicitante": {
      "nome": "Maria da Silva"
    },
    "cobertura": "cobertura/morte",
    "natureza": "morte-acidental",
    "data-ocorrencia": "2026-03-01T10:00:00.000-00:00"
  }'

Exemplo completo (com campos opcionais)

curl --request POST \
  --url https://sagas.staging.180s.com.br/sagas/v1/vendas/{ID_VENDA}/abrir-sinistro \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "pessoa-para-contato": {
      "nome": "Pessoa para Contato",
      "email": "[email protected]",
      "telefone": {
        "codigo-area": "11",
        "numero-telefone": "987654321"
      }
    },
    "solicitante": {
      "nome": "Solicitante do Sinistro"
    },
    "cobertura": "cobertura/morte",
    "natureza": "morte-acidental",
    "data-ocorrencia": "2026-03-01T10:00:00.000-00:00",
    "relato-do-ocorrido": "Relato detalhado do ocorrido informado pelo solicitante.",
    "saldo-devedor": 10000,
    "detalhes-pagamento": {
      "beneficiario": {
        "tipo": "outro",
        "nome": "Beneficiario do Sinistro",
        "cpf-ou-cnpj": "15267296600"
      },
      "dados-pagamento": {
        "metodo-pagamento": "pix",
        "pix": {
          "conta-bancaria": {
            "banco": "18236120",
            "agencia": "0001",
            "conta": "1234567890"
          }
        }
      }
    }
  }'

detalhes-pagamento — métodos de pagamento

O campo dados-pagamento.metodo-pagamento aceita:

PIX (pix) — informe exatamente um dos objetos abaixo em pix:

Por chave PIX:

{
  "metodo-pagamento": "pix",
  "pix": {
    "chave": "[email protected]"
  }
}

Por dados bancários (ISPB do banco + agência + conta):

{
  "metodo-pagamento": "pix",
  "pix": {
    "conta-bancaria": {
      "banco": "18236120",
      "agencia": "0001",
      "conta": "1234567890",
      "agencia-digito-verificador": "0",
      "conta-digito-verificador": "1"
    }
  }
}

Campo (`conta-bancaria`)	Obrigatório	Descrição
`banco`	Sim	ISPB do banco (8 dígitos)
`agencia`	Sim	Número da agência (somente dígitos)
`conta`	Sim	Número da conta (somente dígitos)
`agencia-digito-verificador`	Não	Dígito verificador da agência
`conta-digito-verificador`	Não	Dígito verificador da conta

TED (ted) — banco usa código COMPE (3 dígitos):

{
  "metodo-pagamento": "ted",
  "ted": {
    "banco": "001",
    "agencia": "1234",
    "conta": "123456",
    "agencia-digito-verificador": "0",
    "conta-digito-verificador": "1"
  }
}

Boleto (boleto):

{"metodo-pagamento": "boleto", "boleto": {"codigo-de-barras": "..."}}

PIX BR Code (pix-brcode):

{"metodo-pagamento": "pix-brcode", "pix-brcode": {"brcode": "..."}}

O campo beneficiario.tipo aceita: segurado, credor, outro.

Resposta de sucesso (200)

{
  "numero-sinistro": "S123456789",
  "status": "pendente-de-documentacao",
  "valor": 100,
  "valor-restante": 100,
  "pagamentos": [],
  "cobertura": "cobertura/morte",
  "data-aviso": "2026-03-02T10:00:00Z",
  "data-ocorrencia": "2026-03-01T10:00:00Z",
  "solicitante": {"nome": "Solicitante do Sinistro"},
  "pessoa-para-contato": {
    "nome": "Pessoa para Contato",
    "email": "[email protected]",
    "telefone": {"codigo-area": "11", "numero-telefone": "987654321"}
  },
  "natureza": "morte-acidental",
  "relato-do-ocorrido": "Relato detalhado do ocorrido informado pelo solicitante.",
  "saldo-devedor": 10000,
  "documentacao": {
    "documentos-recebidos": [],
    "documentos-pendentes": [
      {"tipo": "cnh", "titulo": "CNH", "data-solicitacao": "2026-03-02T10:00:00Z"}
    ]
  }
}

Guarde numero-sinistro para os demais endpoints.

Erros

Erros de negócio retornam 422 com corpo no formato RFC 9457 Problem Details:

`problem-id`	Descrição
`claim-already-opened-for-coverage`	Já existe sinistro em aberto para a cobertura informada
`insurance-lmg-exhausted`	Limite máximo de garantia (LMG) da apólice esgotado
`coverage-lmi-exhausted`	Limite máximo de indenização (LMI) da cobertura esgotado

Exemplo — sinistro já aberto para a cobertura:

{
  "type": "https://180seg.github.io/sagas-docs/v1/problems/claim-already-opened-for-coverage",
  "title": "Já existe um sinistro em aberto para esta cobertura",
  "status": 422,
  "detail": "Não é possível abrir o sinistro. Já existe um sinistro em aberto para a cobertura informada.",
  "problem-id": "claim-already-opened-for-coverage",
  "instance": "https://180seg.github.io/sagas-docs/v1/problems/claim-already-opened-for-coverage/550e8400-e29b-41d4-a716-446655440000",
  "numero-sinistro": "S987654321"
}

Exemplo — LMG esgotado:

{
  "type": "https://180seg.github.io/sagas-docs/v1/problems/insurance-lmg-exhausted",
  "title": "O limiite máximo de garantia da apólice já foi atingido",
  "status": 422,
  "detail": "Não é possível abrir o sinistro. O limite máximo de garantia (LMG) da apólice já foi atingido.",
  "problem-id": "insurance-lmg-exhausted",
  "instance": "https://180seg.github.io/sagas-docs/v1/problems/insurance-lmg-exhausted/550e8400-e29b-41d4-a716-446655440001"
}

Exemplo — LMI esgotado:

{
  "type": "https://180seg.github.io/sagas-docs/v1/problems/coverage-lmi-exhausted",
  "title": "O limite máximo de indenização da cobertura já foi atingido",
  "status": 422,
  "detail": "Não é possível abrir o sinistro. O limite máximo de indenização (LMI) da cobertura já foi atingido.",
  "problem-id": "coverage-lmi-exhausted",
  "instance": "https://180seg.github.io/sagas-docs/v1/problems/coverage-lmi-exhausted/550e8400-e29b-41d4-a716-446655440002"
}