v1

latestOpenAPI 3.0.3Licença Sankhya2026-07-24161242654.8 KB

Fiscal

Calcular Impostos em Vendas

Este endpoint calcula os impostos incidentes sobre uma operação de venda. Com base nos dados fornecidos, como empresa, cliente, produtos e despesas acessórias, a API retorna os valores calculados, incluindo base de cálculo, alíquotas e valores de impostos.

É importante ressaltar que toda a parametrização tributária deve ser previamente configurada no SankhyaOm, pois o endpoint não realiza essa configuração, apenas aplica as regras já definidas no SankhyaOm.

Serviço está disponível no SankhyaOm a partir da versão 4.31.

post/v1/fiscal/impostos/calculo

Request body

notaModelointeger required

Este atributo é utilizado para preparar a inclusão do movimento no SankhyaOm, permitindo que o serviço obtenha informações essenciais, como empresa, tipo de operação, natureza, entre outros. Para saber mais como configurar um Modelo de Nota, clique aqui

codigoClienteinteger required

Para realizar o cálculo de impostos, informe neste atributo o "código do cliente" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Parceiro" (CODPARC). Para saber mais, clique aqui

codigoEmpresainteger

Este atributo é opcional e caso não seja enviado, a API irá assumir a empresa configurada na Nota Modelo. Para mudar a empresa contida na Nota Modelo, informe neste atributo o "código da empresa" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Empresa" (CODEMP). Para saber mais, clique aqui

codigoTipoOperacaointeger

Este atributo é opcional e caso não seja enviado, a API irá assumir o Tipo de Operação configurada na Nota Modelo. Para utilizar um Tipo de Operação diferente do que está configurado na Nota Modelo, informe neste atributo o "código do tipo de operação" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "TipoOperacao" (CODTIPOPER). Para saber mais, clique aqui

finalidadeOperacaointeger

Informe neste atributo a "finalidade da operação" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "FinalidadeOperacao" (NUFOP). Para saber mais, clique aqui

Example request

{
  "notaModelo": 123,
  "codigoCliente": 54321,
  "codigoEmpresa": 45,
  "codigoTipoOperacao": 45,
  "finalidadeOperacao": 2,
  "despesasAcessorias": {
    "frete": 100,
    "seguro": 50,
    "outras": 30
  },
  "produtos": [
    {
      "codigoProduto": 1,
      "unidade": "UN",
      "quantidade": 10,
      "valorUnitario": 50
    }
  ]
}

Response

Impostos calculados com sucesso.

Example response

{
  "produtos": [
    {
      "codigoProduto": 1,
      "origemProduto": 1,
      "unidade": "UN",
      "quantidade": 10,
      "valorUnitario": 50,
      "valorTotal": 500,
      "despesasAcessorias": 50,
      "impostos": [
        {
          "tipo": "st",
          "cst": "00",
          "modalidadeBaseCalculo": 1,
          "valorOperacao": 150,
          "aliquota": 18,
          "valorBase": 145,
          "valorImposto": 26.1,
          "valorDesoneracao": 3.31,
          "motivoDesoneracao": 4,
          "indicadorRepasseDesoneracao": 1
        }
      ]
    }
  ]
}