查询发行人

此端点允许通过唯一键查询系统中已登记发行人的完整详情。

---

Request

ENDPOINT

/issuer_management/issuer/ISSUER-KEY

MÉTODO

GET

Path Params

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

Response

RESPONSE STATUS

200

状态为 in_filling 的 Response Body

{
    "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "name": "Fabrica Exemplo S.A.",
    "document_number": "96.146.194/0001-07",
    "status": "in_filling",
    "backoffice_analysis_status": "in_analysis",
    "person_type": "legal",
    "trading_name": "Fabrica Comércio",
    "cnae_code": "62.02-3-00",
    "company_type": "sa",
    "foundation_date": "2000-01-01",
    "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
    },
    "registration_datetime": "2025-01-23T13:47:57.354528",
    "expiration_date": "2026-01-23",
    "signer_group_list": [],
    "bank_account_list": [],
    "issuer_representative_list": [],
    "issuer_contact_information_list": [],
    "issuer_document_list": [],
    "issuer_analysis_list": [],
    "payment_bank_account": {
        "account_number": "19500",
        "account_digit": "7",
        "account_branch": "0001"
    },
    "annual_revenues": 150000,
    "is_in_national_financial_system": false
}

RESPONSE STATUS

200

状态为 reproved 的 Response Body

{
    "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "name": "Fabrica Exemplo S.A.",
    "document_number": "96.146.194/0001-07",
    "status": "reproved",
    "backoffice_analysis_status": "reproved",
    "person_type": "legal",
    "trading_name": "Fabrica Comércio",
    "cnae_code": "62.02-3-00",
    "company_type": "sa",
    "foundation_date": "2000-01-01",
    "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
    },
    "registration_datetime": "2025-01-23T13:47:57.354528",
    "expiration_date": "2026-01-23",
    "bank_account_list": [],
    "signer_group_list": [],
    "issuer_representative_list": [],
    "issuer_contact_information_list": [],
    "issuer_document_list": [],
    "issuer_analysis_list": [],
    "last_analysis": {
        "analysis_key": "a274106e-5dbe-4a87-8999-6e41020f09b9",
        "analysis_number": 3,
        "status": "reproved",
        "analysis_datetime": "2025-10-24 02:52:15.886432",
        "analysis_related_parties": [],
        "documents": [],
        "annotations": [],
        "last_updated": "2025-10-24 02:52:20.169204",
        "analysis_origin_type": "nce_integration",
        "reproval_reason": "missing_related_parties",
        "reproval_details": "parte relacionada João Representante consta no contrato social mas não está cadastrado"
    },
    "annual_revenues": 150000,
    "is_in_national_financial_system": false
}

RESPONSE STATUS

200

状态为 approved 的 Response Body

{
    "issuer_key": "07b1ac01-5fc4-475f-930b-19595f24bc1e",
    "name": "Fabrica Exemplo S.A.",
    "document_number": "96.146.194/0001-07",
    "status": "approved",
    "backoffice_analysis_status": "approved",
    "person_type": "legal",
    "trading_name": "Fabrica Comércio",
    "cnae_code": "62.02-3-00",
    "company_type": "sa",
    "foundation_date": "2000-01-01",
    "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
    },
    "registration_datetime": "2025-01-23T13:47:57.354528",
    "expiration_date": "2026-01-23",
    "bank_account_list": [],
    "signer_group_list": [],
    "issuer_representative_list": [],
    "issuer_contact_information_list": [],
    "issuer_document_list": [],
    "issuer_analysis_list": [],
    "last_analysis": {
        "analysis_key": "a274106e-5dbe-4a87-8999-6e41020f09b9",
        "analysis_number": 3,
        "status": "approved",
        "analysis_datetime": "2025-10-24 02:52:15.886432",
        "analysis_related_parties": [],
        "documents": [],
        "annotations": [],
        "last_updated": "2025-10-24 02:52:20.169204",
        "analysis_origin_type": "nce_integration",
        "reproval_reason": null,
        "reproval_details": null
    },
    "annual_revenues": 150000,
    "is_in_national_financial_system": false
}

Response Body Params

字段	类型	描述	最大字符数
issuer_key	string	发行人的唯一标识符。	36
name	string	发行人全名。	255
document_number	string	发行人证件号码（CNPJ）。	14
status	string	发行人状态。	status 枚举
backoffice_analysis_status	string	后台分析状态。	-
person_type	string	人员类型（legal 或 natural）。	-
trading_name	string	发行人商业名称。	1023
cnae_code	string	发行人的 CNAE 代码。	10
company_type	string	公司类型：sa、ltda、cop、-。	50
foundation_date	string	发行人成立日期。	-
signer_group_list	array	与发行人关联的签名人组列表。	-
bank_account_list	array	与发行人关联的银行账户列表。	-
issuer_representative_list	array	发行人代表列表。	-
issuer_contact_information_list	array	与发行人关联的联系信息列表。	-
issuer_document_list	array	发行人已登记的文件列表。	-
address	string	地址引用对象。	address 对象
annual_revenues	number	出让人年收入申报。	-
is_in_national_financial_system	boolean	指示出让人是否为国家金融系统（SFN）成员。	-
last_analysis	object	分析对象。	分析定义。

Address 对象

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

status 枚举

枚举值	描述
in_filling	填写中
in_analysis	分析中
canceled	已取消
approved	已批准
reproved	未批准
expired	已过期

payment_bank_account 对象

字段	类型	描述	最大字符数
account_digit	string	银行账户校验位。	-
account_branch	string	银行支行。	-
account_number	string	银行账户号码。	-

分析定义

字段	类型	描述	字符数
analysis_key	string	分析标识符。	36
analysis_number	integer	分析序列号。	-
status	string	分析状态。	参见 分析状态枚举。
analysis_related_parties	array	分析中的关联方。	参见 分析关联方定义。
documents	array	分析文件。	参见 分析文件定义。
analysis_data	object	产生该分析的请求有效载荷。	-
analysis_datetime	string	分析创建日期时间对象。	-
reproval_reason	string	分析拒绝原因枚举。	参见 拒绝原因枚举。
reproval_details	string	分析拒绝详细信息的自由文本字段。	-

---

Analysis Status

枚举值	描述
pending_documents	文件待提交
sent_to_analysis	已发送分析
pending_internal_validation	文件验证中
in_manual_analysis	合规人工分析中
approved	已批准
reproved	未批准

---

文件定义

字段	类型	描述	字符数
document_key	string	文件标识符。	36
document_type	string	文件类型。
status	string	文件状态。
observation	string	提交的备注。	-

---

分析关联方定义

字段	类型	描述	字符数
analysis_related_party_key	string	关联方标识符。	36
document_number	string	关联方的证件号码。	14 至 18
name	string	关联方名称。	1 至 255
documents	array	关联方分析文件。

---

Analysis Reproval Reason

枚举值	描述
assignor_update	因后续注册更新而取消分析
insuficient_documents	未提交验证权限的最少文件
compliance_reproval	合规团队分析后拒绝关联关系
unidentified_related_parties	已提交关联方但无法证明关联关系
invalid_documents	文件无效/已过期
missing_related_parties	未提交必需关联方

---