Agregado

{
  "type": "object",
  "required": [
    "tipo",
    "documento",
    "cadastro",
    "conta",
    "certificado_digital"
  ],
  "properties": {
    "tipo": {
      "type": "string",
      "enum": [
        "motorista",
        "transportadora"
      ],
      "description": "A natureza do agregado — motorista da sua empresa ou transportadora que você contrata/convidou."
    },
    "documento": {
      "type": "string",
      "description": "CPF ou CNPJ, somente dígitos."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Como está cadastrado na FleetPay. `null` para quem foi convidado e ainda não concluiu o cadastro — nesse momento a FleetPay ainda não sabe o nome, e preferimos dizer isso a devolver um rótulo genérico."
    },
    "cadastro": {
      "type": "string",
      "enum": [
        "convidado",
        "cadastrado"
      ],
      "description": "`convidado` — o convite existe e o cadastro não; não há conta a mostrar ainda. `cadastrado` — existe cadastro na FleetPay, e `conta` reflete o estado real dele."
    },
    "conta": {
      "$ref": "#/components/schemas/ContaDoAgregado"
    },
    "certificado_digital": {
      "$ref": "#/components/schemas/CertificadoDoAgregado"
    }
  }
}