跳到主要内容

登记发行人代表

此端点允许登记与已登记发行人关联的代表。

Request​

ENDPOINT
/issuer_management/issuer/ISSUER-KEY/issuer_representative
MÉTODO
POST

Path Params​

字段类型描述字符数
ISSUER-KEYstring发行人的唯一键（UUID v4）。36

Request Body​

Request Body
{
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "birthdate": "1990-01-01",
  "nationality": "BRA",
  "mother_name": "Maria da Silva",
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "related_party_type": "attorney",
  "annual_revenues": 150000
}

Request Body Params​

字段类型描述最大字符数
name *string发行人代表的全名。255
document_number *string证件号码（CPF，格式"XXX.XXX.XXX-XX"）。11
birthdatestring代表的出生日期，ISO 8601 格式（YYYY-MM-DD）。-
document_identification_numberstring身份证件号码。255
marital_statusstring代表的婚姻状况。marital_status 枚举
property_systemstring财产制度。property_system 枚举
nationality *string受益人所在国家。3，依据 ISO 3166-1 alpha-3
mother_namestring代表母亲的全名。1023
father_namestring代表父亲的全名。1023
occupationstring代表的职业或工作。255
is_pepboolean指示代表是否为政治敏感人物（PEP）。-
address *string地址引用对象。address 对象
annual_revenuesnumber出让人年收入申报。-
related_party_type *枚举关联方的关系类型。参见 关联方类型枚举

Address 对象​

字段类型描述最大字符数
street *string公司地址街道名称。500
neighborhoodstring公司地址区域名称。100
number *string地址门牌号。10
postal_code *string邮政编码（格式"XXXXX-XXX"）。8
city *string地址城市名称。255
state *string州缩写（2个字符）。2
complementstring地址补充信息（如适用）。100

marital_status 枚举​

枚举值描述
single未婚
married已婚
widower丧偶
separated分居
stable_union同居关系
divorced离婚

property_system 枚举​

枚举值描述
total_communion_of_goods完全财产共同制
partial_communion_of_goods部分财产共同制
total_separation_of_goods完全财产分离制
final_participation_of_acquisitions婚后所得共同制
compulsory_separation_of_goods强制财产分离制
枚举值描述
president总裁
partner合伙人
administrator管理员
director董事
manager经理
attorney代理人

Response​

STATUS
201
Response Body
{
  "issuer_representative_key": "123e4567-e89b-12d3-a456-426614174000",
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "document_identification_number": "987654321",
  "marital_status": "single",
  "property_system": "partial_communion_of_goods",
  "birthdate": "1990-01-01",
  "nationality": "BRA",
  "mother_name": "Maria da Silva",
  "father_name": "José da Silva",
  "occupation": "Advogado",
  "is_pep": false,
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "related_party_type": "attorney",
  "annual_revenues": 150000,
  "issuer_representative_document_list": []
}

Response Body Params​

字段类型描述最大字符数
issuer_representative_keystring发行人代表的唯一标识符（UUID v4）。36
namestring发行人代表的全名。255
document_numberstring代表的证件号码（格式"XXX.XXX.XXX-XX"）。11
document_identification_numberstring身份证件号码。255
marital_statusstring代表的婚姻状况。marital_status 枚举
property_systemstring财产制度。property_system 枚举
birthdatestring代表的出生日期。-
nationality *string受益人所在国家。3，依据 ISO 3166-1 alpha-3
mother_namestring代表母亲的全名。1023
father_namestring代表父亲的全名。1023
occupationstring代表的职业或工作。255
is_pepboolean指示代表是否为政治敏感人物（PEP）。-
address *string地址引用对象。address 对象
issuer_representative_document_listarray与代表关联的文件列表。-
annual_revenuesnumber出让人年收入申报。-
related_party_type *枚举关联方的关系类型。参见 关联方类型枚举