Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.gyramais.com.br/llms.txt

Use this file to discover all available pages before exploring further.

Resumo: a GYRA+ permite que cada política defina três fórmulas dinâmicas que calculam o prazo, a taxa de juros e o valor final aprovado a partir dos dados do relatório. A sintaxe é idêntica ao Excel, com mais de 270 funções suportadas (matemáticas, lógicas, de data, texto, estatísticas) e permite referenciar qualquer variável da política.

​
O que é

Precificar, no contexto GYRA+, é decidir quanto, por quanto tempo e a que taxa o crédito pode ser concedido a um tomador após a política aprovar a operação. A decisão binária (aprovar, alertar, negar) é feita pelas regras; a precificação é feita pelas fórmulas. Cada política tem três fórmulas independentes:
FórmulaCampoO que calcula
PrazoperiodFormulaNúmero de meses do contrato
Taxa de jurosinterestFormulaTaxa mensal aplicada à operação
Valor finalamountFormulaValor efetivo aprovado (pode ser menor que o valor solicitado)
As três são opcionais. Política que não define fórmula entrega o valor solicitado na operação sem transformação.

​
Como habilitar na política

1

Abrir a política no toolbox

Em Política de Crédito, editar a política onde você quer configurar precificação.
2

Preencher uma, duas ou as três fórmulas

Cada campo aceita uma expressão no estilo Excel. Validação automática impede salvar uma fórmula mal formada.
A precificação sempre roda, independentemente do status final da política. Como todas as variáveis usadas pelas fórmulas já estão consolidadas após a coleta de dados, a fórmula é executada — não depende de APPROVED.
3

Rodar uma operação de teste

A fórmula é avaliada no momento da operação e o resultado aparece no payload de saída (amount, period, interest).

​
Sintaxe

​
Operadores básicos

OperadorUsoExemplo
+ - * /Aritmética1000 * 1.05
^Potência2^10
= <> < > <= >=Comparaçãoscore >= 600
&Concatenação de texto"PREFIXO-" & id

​
Como referenciar variáveis e fórmulas

Dentro do editor, dois caracteres especiais ativam o autocomplete:
PrefixoPara que serve
#Buscar uma variável disponível na política (valor solicitado, score, faturamento, campos do relatório, etc.)
=Usar uma fórmula (referenciar o resultado de outra fórmula calculada na mesma avaliação ou inserir uma função)
Ao digitar # ou = no editor, o toolbox abre uma lista buscável com as opções compatíveis. Ao escolher, a referência é inserida como um chip clicável. Exemplo, referenciando a variável valorSolicitado e aplicando 80%: 
#valorSolicitado * 0.8
Exemplo, reaproveitando o resultado de outra fórmula da mesma política: 
=amountFormula * #taxa
Internamente as referências são resolvidas para os valores reais antes do cálculo.

​
Fórmulas de exemplo

​
1. Valor aprovado limitado a 30% do faturamento

MIN(#solicitado, #faturamento * 0.3)
Aprova o que foi pedido, desde que não ultrapasse 30% do faturamento mensal informado.

​
2. Taxa de juros condicional ao score

IF(#score >= 800, 1.49,
IF(#score >= 650, 1.99,
IF(#score >= 500, 2.49, 2.99)))
Escalona a taxa mensal conforme a faixa do score.

​
3. Prazo máximo baseado em anos de abertura

IF(#anosAbertura >= 5, 36,
IF(#anosAbertura >= 2, 18, 12))
Empresa com 5+ anos: até 36 meses. Entre 2 e 5: até 18. Abaixo de 2: 12 meses.

​
4. Valor com haircut por protesto

#solicitado * IF(#protestos > 0, 0.5, 1)
Aplica 50% de haircut caso haja qualquer protesto ativo.

​
Catálogo de funções disponíveis

A GYRA+ usa o motor fast-formula-parser, compatível com a semântica do Excel. 271 funções suportadas, organizadas por família:

​
Matemáticas e trigonométricas

ABS, CEILING, EVEN, EXP, FACT, FACTDOUBLE, FLOOR, GCD, INT, LCM, LN, LOG, MOD, MROUND, ODD, PI, POWER, PRODUCT, QUOTIENT, RAND, RANDBETWEEN, ROUND, ROUNDDOWN, ROUNDUP, SIGN, SQRT, SQRTPI, SUM, SUMIF, SUMPRODUCT, SUMSQ, TRUNC, SIN, COS, TAN, ASIN, ACOS, ATAN, ATAN2, SINH, COSH, TANH, DEGREES, RADIANS.

​
Lógicas

AND, OR, NOT, XOR, IF, IFS, IFERROR, IFNA, TRUE, FALSE.

​
Estatísticas

AVERAGE, AVERAGEA, AVERAGEIF, AVEDEV, COUNT, COUNTIF, MAX, MIN, MEDIAN, MODE, STDEV, VAR, CORREL, FORECAST, FREQUENCY, GEOMEAN, HARMEAN, GROWTH, INTERCEPT, KURT, STANDARDIZE, DEVSQ.

​
Data e hora

DATE, DATEDIF, DATEVALUE, DAY, DAYS, EDATE, EOMONTH, HOUR, MINUTE, MONTH, NETWORKDAYS, NOW, SECOND, TIME, TIMEVALUE, TODAY, WEEKDAY, WEEKNUM, WORKDAY, YEAR, YEARFRAC, ISOWEEKNUM.

​
Texto

CHAR, CLEAN, CODE, CONCAT, CONCATENATE, EXACT, FIND, FIXED, LEFT, LOWER, MID, PROPER, REPLACE, REPT, RIGHT, SEARCH, T, TEXT, TRIM, UPPER, VALUE, UNICHAR, UNICODE, NUMBERVALUE, DOLLAR.

​
Informação e tipos

ISBLANK, ISERR, ISERROR, ISEVEN, ISLOGICAL, ISNA, ISNONTEXT, ISNUMBER, ISTEXT, N, NA, TYPE.

​
Engenharia e avançadas

BITAND, BITOR, BITXOR, BITLSHIFT, BITRSHIFT, DELTA, GESTEP, BASE, DECIMAL, COMPLEX, IMABS, IMAGINARY, IMREAL, IMSUM, IMPRODUCT, IMPOWER, IMSQRT, IMEXP, IMLN, funções de Bessel (BESSELI, BESSELJ, BESSELK, BESSELY), funções de erro (ERF, ERFC), GAMMA, GAMMALN, FISHER, FISHERINV, GAUSS, PHI, COMBIN, PERMUT, MULTINOMIAL.

​
Matrizes

MDETERM, MINVERSE, MMULT, MUNIT, TRANSPOSE.

​
Financeiras (compatíveis)

PMT, PV, FV, NPER, RATE, IRR, NPV, SLN, SYD, DB, DDB, PPMT, IPMT.
A lista acima cobre as funções mais usadas. O conjunto completo de 271 está disponível no dropdown do editor de fórmulas do toolbox, com busca por nome e descrição de cada função.

​
Onde o resultado aparece

No payload da operação, após a execução da política aprovada: 
{
  "operationId": "6612a7f30000000000000001",
  "status": "APPROVED",
  "pricing": {
    "amount": 80000.00,
    "period": 24,
    "interest": 1.99
  }
}
Também visível no toolbox na tela de detalhe da operação, aba Precificação.

​
Limitações e considerações

  • Fórmulas sempre rodam. Como dependem apenas das variáveis disponíveis após a coleta, a fórmula é executada independentemente do policyStatus final.
  • Sem efeitos colaterais. Fórmulas são puras: não fazem chamadas HTTP, não gravam em banco, não disparam eventos. Se precisar de efeito colateral, use webhook na operação.
  • Variável inexistente retorna erro. Se uma menção apontar para variável que não está mais na política, a validação falha ao salvar.
  • Precisão numérica. Seguimos precisão de ponto flutuante IEEE 754 do JavaScript. Para valores monetários, sempre arredondar ao final com ROUND(..., 2).
  • Sem loops ou recursão. Fórmulas são expressões, não scripts. Lógica sequencial complexa deve ser resolvida em camadas com IF aninhado ou múltiplas fórmulas.

​
Perguntas frequentes

Sim. Variáveis são referenciadas por id; podem aparecer em periodFormula, interestFormula e amountFormula simultaneamente.
A plataforma valida o tipo esperado para cada campo: period e amount devem ser números positivos, interest precisa ser numérico. Retorno inválido marca a operação como ERROR e dispara notificação.
O editor do toolbox tem um campo pré-visualizar onde você informa valores de teste para cada variável e vê o resultado da fórmula em tempo real.
Sim. Toda edição em periodFormula, interestFormula ou amountFormula é registrada em PolicyChange, com diff entre versões, autor e timestamp. Ver Operações para detalhes de versionamento.
Precificação funciona em qualquer nível de relatório. Os campos que a fórmula pode consultar variam com o nível: fórmulas que usam SCR, por exemplo, só funcionam em COMPLETO ou COMPLETO+.

​
Próximos passos

Criar política

Passo a passo no toolbox.

Operações

Como a operação consome o resultado da precificação.

Templates de política

Vários templates já vêm com fórmulas pré-configuradas.

Webhooks

Receber o resultado da precificação em tempo real.