Abrir Sinistro

Abre um sinistro contra uma apólice. Todo pagamento de um sinistro de perda de renda é um novo sinistro — não existe um endpoint separado para "abrir" versus "atualizar" um caso em andamento; a primeira parcela e a quinta parcela usam exatamente esta mesma chamada, mudando apenas pmtReferenceDate.

Requisição

Endpoint

Metodo: POST
Endpoint: /v2/claims
Content-Type: application/json ou multipart/form-data (para anexar arquivos diretamente, veja Enviando arquivos)

Parâmetros (Body)

Parâmetro	Tipo	Obrigatório	Descrição
policyId	`string (uuid)`	✅	Identificador da apólice
coverageType	`Tipo de Cobertura`	✅	Código da cobertura sendo acionada (ex: `MQC`, `PR`)
eventDate	`string (date)`	✅	Data do evento coberto (óbito, invalidez ou desligamento, a depender da cobertura)
jobStartDate	`string (date)`	❌	Data de admissão no emprego vigente na data do evento — recomendado para sinistros do tipo PR
pmtReferenceDate	`string (date)`	❌	Data de referência da parcela sendo pleiteada — recomendado para sinistros do tipo PR
proofs	`ProofInput[]`	✅	Provas anexadas ao sinistro

Envio incremental

O sinistro é aceito com as informações disponíveis no momento — não é necessário enviar tudo de uma vez, nem em uma ordem específica. Campos e documentos podem ser complementados depois, seja em novos sinistros (parcelas subsequentes), via Enviar Provas Adicionais ou via Retificar Informações.

Tipo `ProofInput`

Parâmetro	Tipo	Obrigatório	Descrição
proofTypeName	`string`	✅	Tipo da prova enviada. Valores aceitos: `DEBT_EVOLUTION_STATEMENT`, `EMPLOYMENT_TERMINATION_PROOF`, `DEATH_CERTIFICATE`, `DISABILITY_CERTIFICATE`, `OTHER`
url	`string`	❌*	URL pública do arquivo. Exatamente um entre `url`/`inlinePayload`
inlinePayload	`object`	❌*	Payload estruturado (ex: retorno de integração), quando aplicável

Provas de escopo de apólice

ANTIFRAUD_DOCS, DEBT_CESSION_TERM e EMPLOYMENT_ADMISSION_PROOF não podem ser enviados aqui — a API responde 422 (POLICY_DOCUMENT_WRONG_ENDPOINT). Esses documentos são enviados uma única vez por apólice via Enviar Documento Comprobatório.

Documentos necessários por cobertura

Cobertura	Documentos necessários (por sinistro)
MQC	`DEATH_CERTIFICATE`, `DEBT_EVOLUTION_STATEMENT`
IPTA	`DISABILITY_CERTIFICATE`, `DEBT_EVOLUTION_STATEMENT`
PR	`EMPLOYMENT_TERMINATION_PROOF`, `DEBT_EVOLUTION_STATEMENT`
CAP	Não aplicável — cobertura de sorteio, sem processo de sinistro

ANTIFRAUD_DOCS é necessário para todas as coberturas, mas enviado uma única vez por apólice via Enviar Documento Comprobatório, não junto ao sinistro.

DEBT_CESSION_TERM (quando aplicável) e EMPLOYMENT_ADMISSION_PROOF (quando aplicável) seguem o mesmo caminho — documentos de escopo de apólice, enviados uma única vez, não junto ao sinistro.

Exemplo de requisição

{
  "policyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "coverageType": "PR",
  "eventDate": "2026-06-01",
  "jobStartDate": "2023-01-15",
  "pmtReferenceDate": "2026-06-01",
  "proofs": [
    {
      "proofTypeName": "EMPLOYMENT_TERMINATION_PROOF",
      "url": "https://docs.example.com/rescisao.pdf"
    }
  ]
}

Enviando arquivos (multipart/form-data)

Para anexar um arquivo diretamente (em vez de uma URL ou payload), envie como multipart/form-data com os mesmos campos e as provas indexadas (Proofs[0].ProofTypeName, Proofs[0].File, ...):

Exemplo de requisição (multipart)

POST /v2/claims
Content-Type: multipart/form-data; boundary=...

policyId=3fa85f64-5717-4562-b3fc-2c963f66afa6
coverageType=PR
eventDate=2026-06-01
jobStartDate=2023-01-15
pmtReferenceDate=2026-06-01
Proofs[0].ProofTypeName=EMPLOYMENT_TERMINATION_PROOF
Proofs[0].File=@rescisao.pdf;type=application/pdf

Resposta

Campos da resposta (201)

Veja Sinistro para a descrição completa dos campos.

Exemplo (201)

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa4",
  "policyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "coverage": "Perda de Renda",
  "coverageType": "PR",
  "eventDate": "2026-06-01",
  "jobStartDate": "2023-01-15",
  "pmtReferenceDate": "2026-06-01",
  "createdAt": "2026-06-02T14:03:11.000Z",
  "updatedAt": "2026-06-02T14:03:11.000Z",
  "proofs": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa1",
      "proofType": "EMPLOYMENT_TERMINATION_PROOF",
      "originalUrl": "https://docs.example.com/rescisao.pdf",
      "contentType": "application/pdf",
      "createdAt": "2026-06-02T14:03:11.000Z"
    }
  ]
}

Erros

Código	HTTP	Descrição
`NOT_FOUND`	404	Apólice não encontrada.
`COVERAGE_NOT_ON_POLICY`	422	O produto da apólice não possui uma cobertura do tipo informado.
`POLICY_DOCUMENT_WRONG_ENDPOINT`	422	Uma prova de escopo de apólice foi enviada aqui em vez do endpoint correto.
`INVALID_PROOF_TYPE`	422	Tipo de prova inexistente.
`INVALID_PROOF_SOURCE`	422	Cada prova deve ter exatamente uma origem: `url`, `file` ou `inlinePayload`.
`TOO_MANY_PROOFS`	422	Máximo de 10 provas por requisição.
`DOCUMENT_DOWNLOAD_FAILED`	422	Falha ao baixar o arquivo a partir da `url` informada.

Requisição​

Endpoint​

Parâmetros (Body)​

Tipo ProofInput​

Documentos necessários por cobertura​

Enviando arquivos (multipart/form-data)​

Resposta​

Campos da resposta (201)​

Erros​