# Manual - Fórmulas
Manual contendo as últimas atualizações efetuadas em 25/06/2026.
# Introdução
Essa API tem como objetivo retornar as fórmulas para cálculo dos tributos.
Para os tributos atuais, a API entrega as fórmulas de cálculo constantes das tabelas de bcComposicao, tipoAntecipacao, indicadorCredito, bcComposicaoFCPAntecipacao.
Para os tributos da Reforma Tributária, a API entrega as fórmulas de cálculo constantes das tabelas de bcComposicao e indicadorCredito.
# Acesso
**URL:** http://app.systax.com.br/api/formulas
**Swagger**: [http://app.systax.com.br/systax/swagger#/formulas/formulas](http://app.systax.com.br/systax/swagger#/formulas/formulas)
# Autenticação
A autenticação pode ser feita através de usuário e senha ou através do token.
Para mais informações sobre o token:
[https://documentacao.systax.com.br/books/manual-da-api-de-geracao-de-token](https://documentacao.systax.com.br/books/manual-da-api-de-geracao-de-token)
# Descrição dos campos da chamada e retorno
### **Chamada**
**TIPO DE CONSULTA**
A API permite consultar as fórmulas dos tributos atuais e também as fórmulas dos tributos da Reforma Tributária. Para diferenciar o tipo de consulta, a API utiliza o campo "RT".
Para consultar as fórmulas dos tributos da Reforma, é necessário enviar na chamada o campo "RT" preenchido com "true".
Caso não seja enviado este campo na chamado ou caso este seja enviado mas preenchido com algo diferente de "true", a API retornará as fórmulas dos tributos atuais.
**BLOCOS E CAMPOS DA CHAMADA**
**Bloco "formulaEspecifica":**
Este bloco é composto por quatro campos: `bcComposicao`, `indicadorCredito`, `tipoAntecipacao` e `bcComposicaoFCPAntecipacao`.
- Para os **tributos atuais**, os quatro campos são aplicáveis.
- Para a **Reforma Tributária**, apenas os campos `bcComposicao` e `indicadorCredito` devem ser utilizados.
Portanto, nas consultas de fórmulas relacionadas à Reforma Tributária, devem ser enviados apenas esses dois campos do bloco `formulaEspecifica`.
Todos os campos são numéricos e representam os IDs das respectivas tabelas. Esses IDs correspondem aos códigos retornados nas regras tributárias fornecidas pela Systax.
O preenchimento dos campos é opcional:
- Se um ou mais IDs forem informados, será retornada a fórmula correspondente aos IDs enviados.
- Se um campo não for informado, ele não será considerado no retorno.
**CAMPO TRIBUTO**
Este é um campo do tipo texto. Ele pode ser enviado vazio ou preenchido.
- Quando **não preenchido**, o sistema retornará todas as fórmulas disponíveis.
- Quando **preenchido**, o sistema retornará apenas as fórmulas aplicáveis aos tributos informados.
**Valores Aceitos:**
- **Tributos atuais:** `icms`, `icmsst`, `antecipacao`, `pis`, `cofins`, `ipi`
- **Tributos da Reforma Tributária:** `CBS`, `IBSUF`, `IBSMun`, `IS`
**Formato de preenchimento:**
O campo pode ser enviado com um ou mais tributos, separados por vírgula.
Exemplos:
1. "tributo": "icms"
2. "tributo": "icms, ipi".
---
### **Retorno**
**Descrição dos campos retornados:**
| **API**
| **Definições**
|
| "indicador"
| corresponde ao ID da fórmula na tabela especifica
|
| "descricao"
| descreve a definição da fórmula. Por exemplo, bcComposicao=1, descrição: valor da operação com IPI
|
| "formula"
| é a fórmula a ser utilizada para cálculo do ID correspondente
|
| "tributo"
| indica os tributos que podem ser calculados com essa fórmula
|
| "observacoes"
| indica particularidades aplicadas a fórmula
|
**Tipos de Fórmulas retornadas para cada Tributo:**
| **Campo Tributo**
| **Fórmula correspondente**
|
| ICMS
| bcComposicao + indicador\_credito
|
| ICMSST
| bcComposicao + indicador\_credito
|
| ANTECIPACAO
| tipoAntecipacao +bcComposicaoFCPAntecipacao + indicadorCredito
|
| PIS
| bcComposicao + indicadorCredito
|
| COFINS
| bcComposicao + indicadorCredito
|
| IPI
| bcComposicao + indicadorCredito
|
| CBS
| bcComposicao + indicador\_credito
|
| IBSUF
| bcComposicao + indicador\_credito
|
| IBSMun
| bcComposicao + indicador\_credito
|
| IS
| bcComposicao + indicador\_credito
|
Exemplo: Se for enviado "tributo": "icms" retornará tudo relativo a "bcComposicao" e "indicadorCredito" que se aplica para este tributo. Sendo assim, não deve retornar bcComposicao aplicável apenas para ipi, por exemplo.
# Exemplos de chamada e retorno
**Chamada para consultar Fórmulas dos Tributos Atuais**
{
"username": "",
"senha": "",
"idCliente": "",
"FormulaEspecifica": {
"bcComposicao": "1",
"indicadorCredito": "",
"tipoAntecipacao": "",
"bcComposicaoFCPAntecipacao": ""
},
"tributo": "icms"
}
**Chamada para consultar Fórmulas dos Tributos da Reforma**
{
"usuario": "",
"senha": "",
"idCliente": "",
"FormulaEspecifica": {
"bcComposicao": "",
"indicadorCredito": "",
"tipoAntecipacao": "",
"bcComposicaoFCPAntecipacao": ""
},
"tributo": ""
,
"variacao": {
"excluiICMS": "",
"excluiICMSFCP": "",
"RT": "true"
}
}
**Retorno**
{
"success": true,
"message": "1 registros localizados",
"record\_count": 1,
"formulas": {
"bcComposicao": \[
{
"indicador": "1",
"descricao": "Valor da operação com IPI incluso",
"formula": "vBC = (qTrib \* vUnTrib) + vFrete + vSeg - vDesc + vIPI + vOutro",
"tributo": "icms,pis",
"observacoes": ""
}