Consulta de Assinantes

Consulta paginada dos conjuntos de assinantes (signer_group_sets) vinculados ao cedente e às suas partes relacionadas. Retorna tanto os conjuntos padrão (main), gerados pela análise da Administradora, quanto os conjuntos customizados (custom) definidos pelo cliente.

Informação

Cada conjunto está vinculado a um proprietário (owner), que pode ser o cedente (assignor_registry) ou uma parte relacionada de análise (analysis_related_party, de avalistas), e a um tipo de produto.

Para criar conjuntos customizados, consulte Definição de Assinantes.

---

Consulta Paginada de Conjuntos de Assinantes

Request

ENDPOINT

/assignor_registry/signer_group_sets

MÉTODO

GET

Query Parameters

Campo	Tipo	Descrição
limit	integer	Quantidade de itens por página (0 a 50). Padrão: 10.
page	integer	Página a ser consultada, iniciando em 0. Padrão: 0.
owner_key	string	Filtra pelo identificador do proprietário (cedente ou parte relacionada).
owner_type	string	Tipo do proprietário. Ver Owner Type.
owner_document_number	string	Documento do proprietário. Exige owner_type para ser utilizado.
product_type	string	Filtra por tipo de produto. Ver Product Type.
status	string	Filtra pelo status do conjunto. Ver Signer Group Set Status.

Dica

Para listar apenas os conjuntos que estão efetivamente sendo utilizados nas assinaturas, filtre por status=valid. Conjuntos em in_analysis ainda dependem da aprovação do cadastro e não são enviados para assinatura.

Response

STATUS

200

Response Body

{
  "data": [
    {
      "signer_group_set_key": "f2c1e4a8-91d2-4f10-8a3b-7e5c9b2d4a6e",
      "owner_key": "c4295375-4077-4092-a258-5bcdf8875907",
      "owner_type": "assignor_registry",
      "product_type": "assignment_contract",
      "signer_group_set_type": "custom",
      "status": "valid",
      "signer_groups": [
        {
          "minimum_required_signers": 2,
          "signers": [
            {
              "document_number": "883.512.866-80",
              "is_required_signer": true
            },
            {
              "document_number": "802.834.257-41",
              "is_required_signer": false
            }
          ],
          "expiration": null
        }
      ]
    }
  ],
  "limit": 10,
  "page": 0,
  "is_last_page": true
}

Campos de Paginação

Campo	Tipo	Descrição
data	array	Lista de conjuntos de assinantes da página atual. Ver Definição de Conjunto de Assinantes.
limit	integer	Quantidade de itens por página utilizada na consulta.
page	integer	Página retornada, iniciando em 0.
is_last_page	boolean	Indica se esta é a última página do resultado.

Erros Tratáveis

Código	HTTP	Causa	Como resolver
ASR000121	400	owner_document_number enviado sem owner_type.	Ao filtrar por owner_document_number, sempre informar também owner_type.
ASR000120	400	Valor de status inválido no filtro.	Usar um valor válido para o filtro status (ver enum Signer Group Set Status).

---

Definições

Definição de Conjunto de Assinantes (Signer Group Set)

Campo	Tipo	Descrição	Caracteres
signer_group_set_key	string	Identificador único do conjunto.	36
owner_key	string	Identificador do proprietário. Pode ser assignor_registry_key ou analysis_related_party_key.	36
owner_type	string	Tipo do proprietário.	Ver Owner Type.
product_type	string	Tipo de produto ao qual o conjunto está associado.	Ver Product Type.
signer_group_set_type	string	Tipo do conjunto (main ou custom).	Ver Signer Group Set Type.
status	string	Status do conjunto.	Ver Signer Group Set Status.
signer_groups	array	Lista de grupos de assinantes que compõem o conjunto.	Ver Definição de Grupo de Assinantes.

---

Definição de Grupo de Assinantes (Signer Group)

Campo	Tipo	Descrição	Caracteres
minimum_required_signers	number	Quantidade mínima de assinantes do grupo necessários para validar a assinatura.	Mínimo 1
signers	array	Lista de assinantes do grupo.	Ver Definição de Assinante.
expiration	string	Data de expiração do grupo no formato YYYY-MM-DD. Retorna null quando o grupo não expira.	10

---

Definição de Assinante (Signer)

Campo	Tipo	Descrição	Caracteres
document_number	string	CPF do assinante no formato XXX.XXX.XXX-XX.	14
is_required_signer	boolean	Indica se o assinante é obrigatório no grupo.	-

---

Enumeradores

Owner Type

Enumerador	Descrição
assignor_registry	Conjunto vinculado ao cedente.
analysis_related_party	Conjunto vinculado a uma parte relacionada da análise (avalistas).

---

Product Type

Enumerador	Descrição
assignment_contract	Contrato de cessão (utilizado por padrão).
commercial_paper	Nota Comercial (Cadastro único com a plataforma de escrituração).

---

Signer Group Set Type

Enumerador	Descrição
main	Conjunto padrão, gerado da análise da Administradora.
custom	Conjunto customizado, criado pelo cliente sobrepondo o conjunto main.

---

Signer Group Set Status

Enumerador	Descrição
in_analysis	Conjunto enviado e atrelado à análise em aberto. Não é utilizado nas assinaturas.
valid	Conjunto vigente e utilizado nas assinaturas.
inactive	Conjunto substituído por uma versão mais recente ou desativado.