Issuer Registration

This endpoint allows registering the basic information of an issuer.

Request

ENDPOINT

/issuer_management/issuer

METHOD

POST

Request Body

Request Body

{
  "name": "Empresa Exemplo S.A.",
  "document_number": "12.345.678/0001-95",
  "trading_name": "Exemplo 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"
  },
  "annual_revenues": 150000,
  "is_in_national_financial_system": false
}

Request Body Params

Field	Type	Description	Max Characters
name *	string	Full company name.	255
document_number *	string	Company CNPJ (format "XX.XXX.XXX/XXXX-XX").	14
trading_name*	string	Company trade name.	1023
cnae_code*	string	Company CNAE code (format "XX.XX-X-XX").	7
company_type*	string	Company type.	company_type Enumerators
foundation_date*	string	Company foundation date (format "YYYY-MM-DD").	-
address *	string	Object referencing the address	address object
annual_revenues	number	Issuer's annual revenue declaration.	-
is_in_national_financial_system	boolean	Indicator if the issuer is part of the National Financial System.	-

Address Object

Field	Type	Description	Max Characters
street *	string	Street name of the company address.	500
neighborhood *	string	Neighborhood name of the company address.	100
number *	string	Address number.	10
postal_code *	string	Address postal code (format "XXXXX-XXX").	8
city *	string	City name of the address.	255
state *	string	State abbreviation (2 characters).	2
complement	string	Address complement, if applicable.	100

company_type Enumerators

Enum	Description
ltda	Limited Company
sa	Sociedade Anônima
cop	Cooperative

Response

STATUS

201

Response Body

{
    "issuer_key": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Empresa Exemplo S.A.",
    "document_number": "12.345.678/0001-95",
    "status": "in_filling",
    "person_type": "legal",
    "trading_name": "Exemplo 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": "2023-01-01T12:00:00Z",
    "expiration_date": "2024-01-01T12:00:00Z",
    "payment_bank_account": {
        "account_number": "19500",
        "account_digit": "7",
        "account_branch": "0001"
    },
    "annual_revenues": 150000,
    "is_in_national_financial_system": false
  }

Response Body Params

Field	Type	Description	Max Characters
issuer_key	string	Unique issuer key (UUID).	36
name	string	Full issuer name.	255
document_number	string	Issuer CNPJ.	14
status	string	Issuer status.	-
person_type	string	Person type	person_type Enumerators
trading_name	string	Issuer trade name.	1023
cnae_code	string	Issuer CNAE code.	7
company_type	string	Company type	company_type Enumerators
foundation_date	string	Issuer foundation date.	-
address	string	Object referencing the address	address object
registration_datetime	string	Issuer registration date and time.	-
expiration_date	string	Issuer expiration date.	-
annual_revenues	number	Issuer's annual revenue declaration.	-
is_in_national_financial_system	boolean	Indicator if the issuer is part of the National Financial System.	-

person_type Enumerators

Enum	Description
legal	Legal Entity
natural	Natural Person

Warning

When registering an issuer, an internal account is reserved that will only be opened if an operation is completed.

payment_bank_account Object

Field	Type	Description	Max Characters
account_digit *	string	Bank account digit.	-
account_branch *	string	Bank branch.	-
account_number *	string	Bank account number.	-