ContaDoAgregado

{
  "type": "object",
  "required": [
    "situacao",
    "biometria",
    "habilitado_a_receber"
  ],
  "description": "A conta digital FleetPay do agregado. Se você só for ler um campo, leia `habilitado_a_receber` — os outros existem para explicar o \"por quê\".",
  "properties": {
    "situacao": {
      "type": "string",
      "enum": [
        "sem_conta",
        "criada",
        "em_analise",
        "aprovada",
        "reprovada",
        "encerrada"
      ],
      "description": "Em que ponto está a conta. `sem_conta` — o cadastro existe mas a abertura da conta não começou. `criada` / `em_analise` — a FleetPay está conduzindo. `aprovada` — a conta existe e funciona. `reprovada` / `encerrada` — desfechos finais. Trate como lista aberta: um valor novo não deve quebrar o seu cliente."
    },
    "biometria": {
      "type": "string",
      "enum": [
        "nao_iniciada",
        "em_analise",
        "aprovada",
        "reprovada"
      ],
      "description": "A verificação de identidade do titular. É o passo que mais segura conta parada, e é conduzido pela FleetPay com a pessoa — você não consegue destravá-lo pela API."
    },
    "habilitado_a_receber": {
      "type": "boolean",
      "description": "**O campo que decide.** `true` só quando a conta está aprovada E não está bloqueada. Uma conta aprovada porém bloqueada continua existindo e continua não recebendo — por isso não basta olhar `situacao`."
    },
    "pendencia": {
      "type": [
        "string",
        "null"
      ],
      "description": "O que falta, em uma frase que você pode mostrar ao seu operador. `null` quando não há nada pendente. É texto para leitura humana: não faça `if` em cima dele — use `situacao` e `biometria`."
    }
  }
}