Atualizar configurações

POST /v1/settings

Atualiza as configurações.

Request

Header Parameters

Idempotency-Key string

Chave única de idempotência para evitar duplicação de requisições.

Example: 5f92f01728e009f403d8502e

application/json

Body

stepsobject

Configurações de fluxos em modo passo a passo do empréstimos.

property name*

SettingsSteps

Configurações do modo passo a passo

title string

Título identificador do passo.

type string

Tipo identificador do passo.

Possible values: [signature, disburse, document_verification, pass, valid_employment, custom_request, create_documents, attachments_to_request, unico]

methodData

object

Objeto que contém dados específicos para o tipo de etapa. Por exemplo, se a etapa for do tipo signature, este objeto conterá os dados necessários para a assinatura do documento.

anyOf

Configuração do responsável pela assinatura.

type string

Tipo responsável pela assinatura.

Possible values: [operator, customer]

role string

Papel assumido.

Possible values: [approver, financial, administrator, backoffice]

Example: approver

Tipo de documento para verificação.

purpose string

Propósito

Possible values: [account_requirement, org_icon, org_logo, identity_document, additional_verification, selfie, ccb, signature, ccb_signed, insurance, identity_document_front, identity_document_back, pay_stub, proof_of_address, insurance_signature, insurance_signed]

Configuração para validação de employment.

createdBy string

Definição de quem deveria ter criado o employment.

Possible values: [customer, operator]

Configuração para realizar a request customizável.

url stringrequired

Url a ser chamada.

Example: https://api.example.com

headers object

Valor do header Authorization

Configuração para criar documentos.

documents

object[]

Documentos criados após a criação do empréstimo, exemplos: ccb, seguro, etc…

Array [

purpose string

Possible values: [ccb, signature, insurance]

engine

object

type string

Template engine usado para gerar documentos.

Possible values: [google]

options

object

template string

Template utilizado no engine para gerar o documento.

]

Configuração de integração com a unico.io.

minScore number

Score mínimo aceito na validação de identidade. Esta propriedade somente será utilizada se o resultado da validação da biometria UNICO não for conclusiva. Para maiores informações, consulte o funcionamento do score.

Possible values: >= -100 and <= 100

Example: 70

Tipo de anexos para verificação.

purpose string[]

Possible values: [account_requirement, identity_document, additional_verification, selfie, identity_document_front, identity_document_back, pay_stub, proof_of_address]

needs string[]

Array de dependência (slugs) entre os passos necessarios para que esse seja executado.

hooks

object

Definição de hooks da esteira.

onFailure

object[]

Lista de ações que serão executadas se um passo da esteira falhar.

Array [

action string

Possible values: [void_loan, cancel_loan]

Example: ["void_loan"]

description string

Example: Ação de cancelamento de empréstimo.

]

onStart

object[]

Lista de ações que serão executadas ao iniciar um passo da esteira.

Array [

action string

Possible values: [mark_loan_as_pending]

Example: ["mark_loan_as_pending"]

description string

Example: Marcar o empréstimo como pendente.

]

disbursements
object

insurance
object

comboId stringrequired

Identificador do combo de produto.

productId stringrequired

Identificador do produto.

maxAmount doublerequired

Valor máximo de cobertura do seguro.

type string

Tipo de conta bancária.

Possible values: [base39, client_account]

account

object

anyOf

client_account

holderName stringrequired

O nome da pessoa ou empresa que possui a conta bancária.

holderDocument stringrequired

O documento da entidade que detém a conta. Pode ser CPF ou CNPJ.

bankCode stringrequired

Código COMPE da Instituição Financeira.

branch stringrequired

A agência da conta bancária.

number stringrequired

O número da conta bancária. Deve ser uma conta corrente ou conta poupança.

digit stringrequired

property name*

SettingsDisbursements

Configurações de desembolso.

type stringrequired

Possible values: [qitech, bv, custom, mock, banco_paulista]

credentials

object

anyOf

QITech
BV
Custom
Banco Paulista

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example:

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example:

-----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

url stringrequired

URL do fundo.

Example: https://api.example.com

headers object

Valor do header Authorization

promoter string

Promotora

Example: 9999

storeChain string

Rede de Lojas

Example: 9999

store string

Loja

Example: 9999

product string

Produto

Example: 9999

plan string

Plano

Example: 9999

user string

Nome de usuário

Example: New User

supportedPaymentMethods string[]

Possible values: [invoice, boleto, paymentMethod.pix, paymentMethod.bankAccount]

disbursementDay string

Possible values: [sameDay, nextWorkDay]

flagsobject

Configurações de flags.

showCancelButtonBeforeDisbursement boolean

Mostrar o botão de cancelar antes do desembolso.

Example: true

automaticChargeback boolean

Reembolsar automaticamente valores pagos a mais pelos clientes

Example: true

notifications
object

Configurações de serviços provedores de notificações.

email
object

Configurações do provedor de notificações via e-mail.

provider string

Provedor utilizado para envio de email.

Possible values: [default, test_only, smtp]

config

object

Objeto para definir a configuração para utilização do provedor de email.

email string

E-mail utilizado para o envio.

host string

Nome do host ou endereço IP ao qual se conectar.

port number

Porta de conexão SMTP.

username string

Nome de usuário do servidor SMTP.

password string

Senha de usuário do servidor SMTP.

sms
object

Configurações do provedor de notificações via SMS.

provider string

Provedor utilizado para envio de SMS.

Possible values: [test_only, infobip]

config

object

Objeto para definir a configuração para utilização do provedor de SMS.

token string

Token para conexão com a infobip.

basePath uri

Url base do provedor.

whatsapp
object

Configurações do provedor de notificações via WhatsApp.

provider string

Provedor utilizado para envio de mensagens via WhatsApp.

Possible values: [test_only, default, twilio]

config

object

Objeto para definir a configuração para utilização do provedor de mensagens via WhatsApp.

account string

Conta da twilio.

token string

Token para conexão com a twilio.

sender string

Número de telefone base para envio da mensagem.

validations
object

Configurações de validadores.

pix
object

Configuração do provedor de PIX.

type string

Tipo das credenciais do provedor de PIX.

Possible values: [qitech, custom, mock]

credentials

object

Definição de credênciais do provedor de serviço PIX.

anyOf

QITech
Custom
Mock

Credênciais de QITech.

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example:

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example:

-----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

Credênciais customizadas do provedor PIX.

url stringrequired

URL do serviço provedor de PIX.

Example: https://api.example.com

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

Credênciais de mock(objeto que imita comportamento) do provedor PIX.

url string

URL do serviço provedor de PIX.

Example: https://api.base39.io/v1/mocks

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

loansobject

Configurações de empréstimos

concurrency
object[]

Configurações referentes às limitações na criação de loans simultâneos.

Array [

quantityAllowed number

Número de empréstimos permitidos.

status string[]

Status a ser considerado na limitação da criação dos empréstimos.

Possible values: [open, disbursed, disbursing, repaid, void, canceled, expired, pending, draft]

]

conditions
object[]

Termos e Condições do empréstimo.

Array [

title string

Texto identificador da condição de empréstimos.

content string

Conteúdo da condição.

]

refin
object

Configurações referentes à refinanciamento de empréstimos.

minDays number

Número mínimo de dias necessário para que uma proposta possa ser refinanciada, contado a partir da criação da proposta.

expireInDays number

Número de dias para expiração de um empréstimo, contando a partir da data de criação.

invoicesobject

Configurações de faturas

payOff
object

Configurações de quitação.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor de juros representado em base decimal e ao mês. O valor máximo permitido é 1% (0.01). Os Juros são definidos ao mês, mas calculo para o pagamento após o vencimento converte para juros ao dia e aplica a quantidade de dias em atraso.

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias. Absoluto representa uma composição de um determinado dia somado ao valor definido em amount. O resultado dessa soma será considerado a data para fechamento da fatura. Exemplo: dia 5 + amount (3) 08/mês/ano.

Possible values: [absolute]

Example: absolute

amount number

Dia exato ou a quantidade de dias.

Possible values: >= 1 and <= 28

Example: 1

updateInvoiceItemOnInsert boolean

Define se no ato de criar o item de fatura será calculado automaticamente descontos/multa para a fatura em contexto. Os valores base usados nesse cálculos são originados de payOff, customerRecurring ou companyRecurring.

Example: true

customerRecurring
object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias usado no fechamento da fatura. Absoluto representa uma composição de um determinado dia somado ao valor definido em amount. O resultado dessa operação será considerado a data para fechamento da fatura. Exemplo: dia 5 + amount (3) 08/mês/ano.

Possible values: [absolute]

Example: absolute

amount number

Quantidade de dias para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

Example: false

companyRecurring
object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias usado no fechamento da fatura. Representa o dia do mês (1 até 28) para fechamento da fatura.

Possible values: [static]

Example: static

amount number

Dia do mês para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

cutoffDay number

Define o dia limite para a edição de uma fatura, antes que ela seja fechada.

Example: 25

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

Example: false

autoMoneyRelocation boolean

Se verdadeiro, o sistema irá fazer o remanejo automático de dinheiro entre as parcelas que possuem valor pago excedente.

localesobject

Estes são textos personalizáveis da aplicação, que aceitam campos chave-valor. É importante notar que nesta página de documentação, você pode criar até três níveis de objetos aninhados. No entanto, ao realizar chamadas fora desta página de documentação, o suporte é estendido para além de três níveis.

property name*
object

recaptcha
object

Configurações do recaptcha. Estas configurações não são utilizadas em rotinas de Core, cabendo ao Core apenas responsabilidade de persistência e disponilidade de dados.

siteKey string

Segredo para utilizar o recaptcha

employments
object

Configurações de vínculos empregatícios

expireInDays integer

Quantidade de dias para expirar o vínculo empregatício.

Example: 30

domainsobject

Configurações de domínios customizados

company string

URL do Portal Empresa.

customer string

URL do Portal Cliente.

backoffice string

URL do Backoffice.

queuesobject[]

Configurações de fila

Array [

name string

Nome da fila

Example: Fila de propostas

query string

Uma string de busca que permite criar filtros personalizados. Filtros permitidos customer, company, id, status, attachment, external_id e created_at. Para os campos que são string ou um conjunto de string separadas por vírgula o único comparador válido é :. Para campos do tipo data ou números são permitidos os comparadores =, >, <, >= e <=. É possível utilizar o operador AND para concatenar mais de uma query e o operador OR. Veja mais em Pesquisa

Example:

status:open OR status:pending AND customer.id:`${customer.id}` AND created_at<`${date}` AND company.document:`${company.document}`

]

installments
object

Configurações de parcelas.

dueDate
object

Configuração de data de vencimento.

type string

Tipo de data de vencimento. absolute representa o dia exato do mês, static representa o dia + amount.

Possible values: [absolute, static]

amount integer

Quantidade de dias para vencimento.

Example: 10

graceDate
object

Configuração de data de carência.

type string

Tipo de data de carência.

Possible values: [days, months]

amount integer

Quantidade para carência.

Example: 10

skipInstallments integer

Quantidade de parcelas que serão desconsideradas até a cobrança.

Example: 1

Responses

Retorna o objeto Settings se a atualização for bem-sucedida; caso contrário, retorna um erro.

application/json

Schema
Example (from schema)

Schema

steps

object

Configurações de fluxos em modo passo a passo do empréstimos.

property name*

SettingsSteps

Configurações do modo passo a passo

title string

Título identificador do passo.

type string

Tipo identificador do passo.

Possible values: [signature, disburse, document_verification, pass, valid_employment, custom_request, create_documents, attachments_to_request, unico]

methodData

object

Objeto que contém dados específicos para o tipo de etapa. Por exemplo, se a etapa for do tipo signature, este objeto conterá os dados necessários para a assinatura do documento.

anyOf

Configuração do responsável pela assinatura.

type string

Tipo responsável pela assinatura.

Possible values: [operator, customer]

role string

Papel assumido.

Possible values: [approver, financial, administrator, backoffice]

Example: approver

Tipo de documento para verificação.

purpose string

Propósito

Configuração para validação de employment.

createdBy string

Definição de quem deveria ter criado o employment.

Possible values: [customer, operator]

Configuração para realizar a request customizável.

url stringrequired

Url a ser chamada.

Example: https://api.example.com

headers object

Valor do header Authorization

Configuração para criar documentos.

documents

object[]

Documentos criados após a criação do empréstimo, exemplos: ccb, seguro, etc…

Array [

purpose string

Possible values: [ccb, signature, insurance]

engine

object

type string

Template engine usado para gerar documentos.

Possible values: [google]

options

object

template string

Template utilizado no engine para gerar o documento.

]

Configuração de integração com a unico.io.

minScore number

Possible values: >= -100 and <= 100

Example: 70

Tipo de anexos para verificação.

purpose string[]

Possible values: [account_requirement, identity_document, additional_verification, selfie, identity_document_front, identity_document_back, pay_stub, proof_of_address]

needs string[]

Array de dependência (slugs) entre os passos necessarios para que esse seja executado.

slug string

Identificador único do passo.

hooks

object

Definição de hooks da esteira.

onFailure

object[]

Lista de ações que serão executadas se um passo da esteira falhar.

Array [

action string

Possible values: [void_loan, cancel_loan]

Example: ["void_loan"]

description string

Example: Ação de cancelamento de empréstimo.

]

onStart

object[]

Lista de ações que serão executadas ao iniciar um passo da esteira.

Array [

action string

Possible values: [mark_loan_as_pending]

Example: ["mark_loan_as_pending"]

description string

Example: Marcar o empréstimo como pendente.

]

disbursements

object

insurance

object

comboId stringrequired

Identificador do combo de produto.

productId stringrequired

Identificador do produto.

maxAmount doublerequired

Valor máximo de cobertura do seguro.

type string

Tipo de conta bancária.

Possible values: [base39, client_account]

account

object

anyOf

client_account

holderName stringrequired

O nome da pessoa ou empresa que possui a conta bancária.

holderDocument stringrequired

O documento da entidade que detém a conta. Pode ser CPF ou CNPJ.

bankCode stringrequired

Código COMPE da Instituição Financeira.

branch stringrequired

A agência da conta bancária.

number stringrequired

O número da conta bancária. Deve ser uma conta corrente ou conta poupança.

digit stringrequired

property name*

SettingsDisbursements

Configurações de desembolso.

type stringrequired

Possible values: [qitech, bv, custom, mock, banco_paulista]

credentials

object

anyOf

QITech
BV
Custom
Banco Paulista

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example:

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example:

-----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

url stringrequired

URL do fundo.

Example: https://api.example.com

headers object

Valor do header Authorization

promoter string

Promotora

Example: 9999

storeChain string

Rede de Lojas

Example: 9999

store string

Loja

Example: 9999

product string

Produto

Example: 9999

plan string

Plano

Example: 9999

user string

Nome de usuário

Example: New User

supportedPaymentMethods string[]

Possible values: [invoice, boleto, paymentMethod.pix, paymentMethod.bankAccount]

disbursementDay string

Possible values: [sameDay, nextWorkDay]

flags

object

Configurações de flags.

showCancelButtonBeforeDisbursement boolean

Mostrar o botão de cancelar antes do desembolso.

Example: true

automaticChargeback boolean

Reembolsar automaticamente valores pagos a mais pelos clientes

Example: true

notifications

object

Configurações de serviços provedores de notificações.

email

object

Configurações do provedor de notificações via e-mail.

provider string

Provedor utilizado para envio de email.

Possible values: [default, test_only, smtp]

config

object

Objeto para definir a configuração para utilização do provedor de email.

email string

E-mail utilizado para o envio.

host string

Nome do host ou endereço IP ao qual se conectar.

port number

Porta de conexão SMTP.

username string

Nome de usuário do servidor SMTP.

password string

Senha de usuário do servidor SMTP.

sms

object

Configurações do provedor de notificações via SMS.

provider string

Provedor utilizado para envio de SMS.

Possible values: [test_only, infobip]

config

object

Objeto para definir a configuração para utilização do provedor de SMS.

token string

Token para conexão com a infobip.

basePath uri

Url base do provedor.

whatsapp

object

Configurações do provedor de notificações via WhatsApp.

provider string

Provedor utilizado para envio de mensagens via WhatsApp.

Possible values: [test_only, default, twilio]

config

object

Objeto para definir a configuração para utilização do provedor de mensagens via WhatsApp.

account string

Conta da twilio.

token string

Token para conexão com a twilio.

sender string

Número de telefone base para envio da mensagem.

validations

object

Configurações de validadores.

pix

object

Configuração do provedor de PIX.

type string

Tipo das credenciais do provedor de PIX.

Possible values: [qitech, custom, mock]

credentials

object

Definição de credênciais do provedor de serviço PIX.

anyOf

QITech
Custom
Mock

Credênciais de QITech.

url stringrequired

URL do parceiro de bancarização.

Example: https://api-auth.sandbox.qitech.app

apiKey stringrequired

Chave de acesso à api do parceiro de bancarização.

Example: abcdef12345

privateKey stringrequired

Chave privada do parceiro de bancarização.

Example:

publicKey stringrequired

Chave pública do parceiro de bancarização.

Example:

-----BEGIN PUBLIC KEY-----\nMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJBAK1v4KdR2rDDg4LU+9uI7ImVtQ4zcUC9\noQXSxo5c1iL+YC+dr4jmkSU1rAs8czUpBHZj/0nagBmBHgjP5W/Q9fkCAwEAAQ==\n-----END PUBLIC KEY-----

ccbPrefix stringrequired

Prefixo da CCB.

passphrase string

Frase secreta.

Credênciais customizadas do provedor PIX.

url stringrequired

URL do serviço provedor de PIX.

Example: https://api.example.com

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

Credênciais de mock(objeto que imita comportamento) do provedor PIX.

url string

URL do serviço provedor de PIX.

Example: https://api.base39.io/v1/mocks

headers object

Par de chave-valor usado como cabeçalho do serviço de validação.

Example: Authorization: Bearer value

loans

object

Configurações de empréstimos

concurrency

object[]

Configurações referentes às limitações na criação de loans simultâneos.

Array [

quantityAllowed number

Número de empréstimos permitidos.

status string[]

Status a ser considerado na limitação da criação dos empréstimos.

Possible values: [open, disbursed, disbursing, repaid, void, canceled, expired, pending, draft]

]

conditions

object[]

Termos e Condições do empréstimo.

Array [

title string

Texto identificador da condição de empréstimos.

content string

Conteúdo da condição.

]

refin

object

Configurações referentes à refinanciamento de empréstimos.

minDays number

Número mínimo de dias necessário para que uma proposta possa ser refinanciada, contado a partir da criação da proposta.

expireInDays number

Número de dias para expiração de um empréstimo, contando a partir da data de criação.

invoices

object

Configurações de faturas

payOff

object

Configurações de quitação.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Possible values: [absolute]

Example: absolute

amount number

Dia exato ou a quantidade de dias.

Possible values: >= 1 and <= 28

Example: 1

updateInvoiceItemOnInsert boolean

Example: true

customerRecurring

object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Possible values: [absolute]

Example: absolute

amount number

Quantidade de dias para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

Example: false

companyRecurring

object

Configuração de recorrência de fatura.

fine

object

Definição de incidência de multas. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Valor da multa representado em base decimal. A Multa é cobrada uma única vez independente do número de dias de vencimento. O valor máximo para multa é de 2% (0.02).

Example: 0.02

daysToStart integer

Quantidade de dias após o vencimento que a multa começará a incidir.

Example: 1

interest

object

Definição de incidência de juros. Campo reservado para instruções específicas do boleto. Não se aplica a cálculos.

amount number

Example: 0.01

daysToStart integer

Quantidade de dias após o vencimento que juro começará a incidir.

Example: 1

allowOverduePayment boolean

Permite pagamento da fatura após o vencimento.

Example: true

daysUntilDue

object

Definição de regras para o fechamento da fatura.

type string

Tipo de dias usado no fechamento da fatura. Representa o dia do mês (1 até 28) para fechamento da fatura.

Possible values: [static]

Example: static

amount number

Dia do mês para fechamento da fatura.

Possible values: >= 1 and <= 28

Example: 10

create

object

Definição de regras para geração de fatura.

cutoffDay number

Define o dia limite para a edição de uma fatura, antes que ela seja fechada.

Example: 25

autoCreate boolean

Define se a fatura deve ser criada automaticamente.

Example: true

updateInvoiceItemOnInsert boolean

Example: false

autoMoneyRelocation boolean

Se verdadeiro, o sistema irá fazer o remanejo automático de dinheiro entre as parcelas que possuem valor pago excedente.

locales

object

property name*

object

recaptcha

object

Configurações do recaptcha. Estas configurações não são utilizadas em rotinas de Core, cabendo ao Core apenas responsabilidade de persistência e disponilidade de dados.

siteKey string

Segredo para utilizar o recaptcha

employments

object

Configurações de vínculos empregatícios

expireInDays integer

Quantidade de dias para expirar o vínculo empregatício.

Example: 30

domains

object

Configurações de domínios customizados

company string

URL do Portal Empresa.

customer string

URL do Portal Cliente.

backoffice string

URL do Backoffice.

queues

object[]

Configurações de fila

Array [

name string

Nome da fila

Example: Fila de propostas

query string

Example:

status:open OR status:pending AND customer.id:`${customer.id}` AND created_at<`${date}` AND company.document:`${company.document}`

]

installments

object

Configurações de parcelas.

dueDate

object

Configuração de data de vencimento.

type string

Tipo de data de vencimento. absolute representa o dia exato do mês, static representa o dia + amount.

Possible values: [absolute, static]

amount integer

Quantidade de dias para vencimento.

Example: 10

graceDate

object

Configuração de data de carência.

type string

Tipo de data de carência.

Possible values: [days, months]

amount integer

Quantidade para carência.

Example: 10

skipInstallments integer

Quantidade de parcelas que serão desconsideradas até a cobrança.

Example: 1

{
  "steps": {},
  "disbursements": {
    "insurance": {
      "comboId": "string",
      "productId": "string",
      "maxAmount": 0,
      "type": "base39"
    }
  },
  "flags": {
    "showCancelButtonBeforeDisbursement": true,
    "automaticChargeback": true
  },
  "notifications": {
    "email": {
      "provider": "default",
      "config": {
        "email": "string",
        "host": "string",
        "port": 0,
        "username": "string",
        "password": "string"
      }
    },
    "sms": {
      "provider": "test_only",
      "config": {
        "token": "string",
        "basePath": "string"
      }
    },
    "whatsapp": {
      "provider": "test_only",
      "config": {
        "account": "string",
        "token": "string",
        "sender": "string"
      }
    }
  },
  "validations": {
    "pix": {
      "type": "qitech"
    }
  },
  "loans": {
    "concurrency": [
      {
        "quantityAllowed": 0,
        "status": [
          "open"
        ]
      }
    ],
    "conditions": [
      {
        "title": "string",
        "content": "string"
      }
    ],
    "refin": {
      "minDays": 0
    },
    "expireInDays": 0
  },
  "invoices": {
    "payOff": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "absolute",
        "amount": 1
      },
      "updateInvoiceItemOnInsert": true
    },
    "customerRecurring": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "absolute",
        "amount": 10
      },
      "create": {
        "autoCreate": true
      },
      "updateInvoiceItemOnInsert": false
    },
    "companyRecurring": {
      "fine": {
        "amount": 0.02,
        "daysToStart": 1
      },
      "interest": {
        "amount": 0.01,
        "daysToStart": 1
      },
      "allowOverduePayment": true,
      "daysUntilDue": {
        "type": "static",
        "amount": 10
      },
      "create": {
        "cutoffDay": 25,
        "autoCreate": true
      },
      "updateInvoiceItemOnInsert": false
    },
    "autoMoneyRelocation": true
  },
  "locales": {
    "Brazil": {
      "states": {
        "MG": {
          "name": "Minas Gerais",
          "slug": "MG"
        }
      }
    }
  },
  "recaptcha": {
    "siteKey": "string"
  },
  "employments": {
    "expireInDays": 30
  },
  "domains": {
    "company": "string",
    "customer": "string",
    "backoffice": "string"
  },
  "queues": [
    {
      "name": "Fila de propostas",
      "query": "status:open OR status:pending AND customer.id:`${customer.id}` AND created_at<`${date}` AND company.document:`${company.document}`"
    }
  ],
  "installments": {
    "dueDate": {
      "type": "absolute",
      "amount": 10
    },
    "graceDate": {
      "type": "days",
      "amount": 10
    },
    "skipInstallments": 1
  }
}

Atualizar configurações

/v1/settings

Request​

Header Parameters

Body

Responses​

Request

Responses