MDSAPI Portal/IZII MDS — Orquestrador de Benefícios (REST)
post

Receber callback assíncrono de operadora

/v1/webhooks/operadoras/{operadora}

Recebe callbacks assíncronos das operadoras (ex. SulAmérica) após o processamento de movimentações. Endpoint **público**. **Comportamento real (verificado):** o receptor apenas **confirma o recebimento** (ACK, `{"received": true}`) e registra o evento. Ele **não propaga** o status ao sistema cliente. Para obter o desfecho da movimentação, consulte `GET /v1/movimentacoes/{protocolo}` (polling).

Path Parameters

operadorastringrequired

Identificador da operadora de origem.

Request Body

application/jsonrequired

object

Payload assíncrono enviado pela operadora após processar movimentação.

codMovBenefinteger
codFamiliarBenefstring
matriculastring
nmeCompletostring
codigoRdpstring
empresastring
segurostring
movimentacaostring
statusstring
criticasarray

items

object

Crítica/erro de validação devolvido pela operadora.

codigostring
campostring
mensagemstring
Ver schema bruto / exemplo JSON
{
  "codMovBenef": 1,
  "matricula": "12345678",
  "nmeCompleto": "João dos Santos e Silva",
  "movimentacao": "I",
  "status": "Aprovado",
  "criticas": []
}

Responses

200

Callback recebido.

object
receivedboolean
Ver schema bruto / exemplo JSON
{
  "type": "object",
  "properties": {
    "received": {
      "type": "boolean"
    }
  }
}