post http://{{auth_server_host}}/banking//originator/business
Esse endpoint permite o cadastro de uma nova empresa, um participante do processo de contratação do crédito para o Originador.
Uma Empresa é a representação de uma companhia na Plataforma, e assim como uma Pessoa, uma Empresa pode assumir diferentes funções dentro de solicitações e os dados necessários para cada uma dessas funções podem variar de acordo com o as configurações do Produto.
Parâmetros do Body
taxpayer_id
(string, obrigatório): O nº do CNPJ da empresa a ser cadastrada.
legal_name
(string, obrigatório): A razão social da empresa a ser cadastrada.
name
(string, obrigatório): O nome fantasia da empresa a ser cadastrada.
email_address
(string, obrigatório): Campo de e-mail para contato com a Empresa. Deve ser um e-mail válido no formato "email@dominio".
foundation_date
(string, obrigatório): Data de abertura/registro da Empresa na Receita Federal".
phone
(string, obrigatório): Objeto contendo o número do telefone para contato com a empresa.area_code
(string, obrigatório): Campo do código da área (DDD).
country_code
(string, obrigatório): Código Internacional para identificação do país (DDI).
number
(string, obrigatório): Número do telefone, somente os números.
formatted_number
(string): Número do telefone formatado.
incorporation_type
(string, obrigatório): Regime legal da Empresa cadastrado na Receita Federal. Valores aceitos: EIRELI, LTDA, MEI, SA, SS.
tax_regime
(string, obrigatório): Regime tributário da Empresa. Valores aceitos: PRESUMED_PROFIT, REAL_PROFIT, SIMPLE.
industry_classification
(string, obrigatório): Classificação para a área de atuação da Empresa (CNAE).
address
(string, obrigatório): Objeto contendo os dados do endereço da Empresa.street_name
(string, obrigatório): Nome do logradouro do endereço.
street_number
(integer, obrigatório): Númeração do endereço. Se conter letras enviar no campo "extra_info".
extra_info
(string): Campo para dados adicionais, complemento, do Endereço.
district
(string, obrigatório): Bairro do endereço.
city
(string, obrigatório): Cidade do endereço.
postal_code
(string): Código de CEP para o endereço.
state_code
(string, obrigatório): Sigla para identificação do estado/uf. Exemplo: SP.
country_code
(string, obrigatório): Código do país. Exemplo: BR.
pix
(object): Objeto contendo os dados de uma chave PIX.key
(string): Chave PIX.
key_type
(string): Tipo da chave PIX. Valores aceitos: ALEATORY_KEY, EMAIL, PHONE_NUMBER, TAXPAYER_ID
external_bank_account
(object): Objeto contendo os dados bancários.bank_code
(string): Código do banco.
bank_account
(string): Número da conta
bank_account_digit
(string): Dígito do número da conta.
bank_branch
(string): Número da agência.
bank_account_type
(string): Tipo da conta bancária. Valores aceitos: CACC, TRAN, SLRY, SVGS.
ispb_code
(string): Código da Instituição recebedora no Sistema de Pagamentos Instantâneo.
billing_address
(string, obrigatório): Objeto contendo os dados do endereço da Empresa para cobrança.street_name
(string, obrigatório): Nome do logradouro do endereço.
street_number
(integer, obrigatório): Númeração do endereço. Se conter letras enviar no campo "extra_info".
extra_info
(string): Campo para dados adicionais, complemento, do Endereço.
district
(string, obrigatório): Bairro do endereço.
city
(string, obrigatório): Cidade do endereço.
postal_code
(string): Código de CEP para o endereço.
state_code
(string, obrigatório): Sigla para identificação do estado/uf. Exemplo: SP.
country_code
(string, obrigatório): Código do país. Exemplo: BR.
share_capital
(float): Capital social da eEmpresa.
monthly_revenue
(float): Faturamento mensal estimado para a Empresa.
employer
(boolean): Campo booleano que indica se essa empresa deve suportar ou não o cadastro de colaboradores vinculados a ela.
custom_variables
(objeto): Objeto contendo valores de variáveis personalizadas, no formato de "chave e valor".
Resposta
Se a requisição for processada com sucesso será retornado um status 201.