Cadastro Básico do Emissor

Este endpoint permite cadastrar as informações básicas de um emissor.

Request

ENDPOINT

/issuer_management/issuer

MÉTODO

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"
  }
}

Request Body Params

Campo	Tipo	Descrição	Caracteres Máx.
name *	string	Nome completo da empresa.	255
document_number *	string	CNPJ da empresa (somente números).	14
trading_name	string	Nome fantasia da empresa.	1023
cnae_code	string	Código CNAE da empresa (7 dígitos).	7
company_type	string	Tipo da empresa.	Enumeradores company_type
foundation_date	string	Data de fundação da empresa (formato "YYYY-MM-DD").	-
address *	string	Objeto referenciando o endereço	Objeto address

Objeto Address

Campo	Tipo	Descrição	Caracteres Máx.
street *	string	Nome da rua do endereço da empresa.	500
neighborhood	string	Nome do bairro do endereço da empresa.	100
number *	string	Número do endereço.	10
postal_code *	string	CEP do endereço (somente números).	8
city *	string	Nome da cidade do endereço.	255
state *	string	Sigla do estado (2 caracteres).	2
complement	string	Complemento do endereço, se aplicável.	100

Enumeradores company_type

Enum	Description
ltda	Limitada
sa	Sociedade Anônima
cop	Cooperativa

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"
    }
  }

Response Body Params

Campo	Tipo	Descrição	Caracteres Máx.
issuer_key	string	Chave única do emissor (UUID).	36
name	string	Nome completo do emissor.	255
document_number	string	CNPJ do emissor.	14
status	string	Status do emissor.	-
person_type	string	Tipo de pessoa	Enumeradores person_type
trading_name	string	Nome fantasia do emissor.	1023
cnae_code	string	Código CNAE do emissor.	7
company_type	string	Tipo da empresa	Enumeradores company_type
foundation_date	string	Data de fundação do emissor.	-
address	string	Objeto referenciando o endereço	Objeto address
registration_datetime	string	Data e hora de registro do emissor.	-
expiration_date	string	Data de expiração do emissor.	-

Enumeradores person_type

Enum	Description
legal	Pessoa Jurídica
natural	Pessoa Física

Aviso

Ao cadastrar um emissor é reservada uma conta interna que será aberta somente se uma operação for concretizada.

Objeto payment_bank_account

Campo	Tipo	Descrição	Caracteres Máx.
account_digit *	string	Dígito da conta bancária.	-
account_branch *	string	Agência bancária.	-
account_number *	string	Número da conta bancária.	-