Regras de negócio

A API REST para cálculo de impostos foi criada para permitir que usuários obtenham informações sobre impostos de pedidos e notas. A API fornece um serviço para cálculo automático de impostos, a partir de dados informados pelo usuário. Esta documentação tem o objetivo de apresentar as funcionalidades e operações da API, bem como os parâmetros de entrada e saída necessários para cada operação.

Como usar a API
É necessário enviar uma requisição HTTPS para o endpoint mgecom/CentralVendaRapidaSP.simularValoresNota, contendo os dados do pedido ou nota fiscal. A API retornará informações sobre os impostos do pedido ou nota fiscal.
Endpoint: mgecom/CentralVendaRapidaSP.simularValoresNota

Impostos calculados:

• ICMS: ICMS_TGFDIN
• ST (Substituição Tributária): SUBST_TGFDIN
• IPI: IPI_TGFDIN
• IRPJ: IRPJ_TGFDIN
• CPP: CPP_TGFDIN
• ISS: ISS_TGFDIN
• INSS: INSS_TGFDIN
• PIS: PIS_TGFDIN
• COFINS: COFINS_TGFDIN
• IRF: IRF_TGFDIN
• CSSL: CSSL_TGFDIN
• Outros: Outros_TGFDIN

Dependências

- Serviço disponível a partir da versão 4.19 do SankhyOm.
- Os impostos retornados dependem das configurações da base (EIP) consultada. Nem todas as bases trabalham com todos os impostos.

Detalhes Técnicos

Os parâmetros obrigatórios para a consulta:
Cabeçalho: - nuNotaModelo: Nota modelo usada para preencher campos opcionais não passados na requisição. - codTipOper: Tipo de operação usada na nota para calculos. - codParc: Parceiro escolhido na negociação para o cálculo de imposto. - codEmp: Empresa escolhida na negociação para cálculo. - codVend: Vendedor escolhido na negociação. - codTipVend: Tipo Negociação da nota/pedido. Item: - codProd: Produto a ser usado para calculo de impostos. Apenas 1. - vlrUnit: Valor unitário para uso da venda do produto - qtdNeg: Quantidade de itens negociados. - vlrTot: Valor total dos produtos na venda. Para realizarmos a busca através do Json, utilizamos o serviço "mgecom/CentralVendaRapidaSP.simularValoresNota".

Exemplo de uso:

URL de chamada: https://api.sankhya.com.br/gateway/v1/mgecom/service.sbr?serviceName=CentralVendaRapidaSP.simularValoresNota&outputType=json

Corpo de requisição

{
  "serviceName": "CentralVendaRapidaSP.simularValoresNota",
  "requestBody": {
    "cabecalho": {
      "nuNotaModelo": 656,
      "codTipOper": 8,
      "codParc": 5,
      "codEmp": 2,
      "codVend": 2,
      "codTipVend": 11
      },
    "item": {
      "codProd": 20,
      "qtdNeg": 50,
      "vlrUnit": 27.87,
      "vlrTot": 1393.5
      }
  }
}

Retorno em json:

{
  "serviceName": "CentralVendaRapidaSP.simularValoresNota",
  "status": "1",
  "pendingPrinting": "false"
  "transactionId": "D48054F8CE82BEC85448B335C770F2A4"
  "responseBody":{
      "cabecalho": {
        "nuNotaModelo": -9999999990,
        "codTipOper": 8,
        "codParc": 5,
        "codEmp": 2,
        "codVend": 2,
        "codTipVend": 11
      },
      "itens": [
        {
          "codProd": 20,
          "qtdNeg": 50,
          "vlrUnit": 27.87,
          "vlrTot": 1393.5,
          "impostos": [
              {
                "tipoImposto": "ICMS_TGFDIN",
                "aliq": 12.000,
                "base": 1393.50,
                "vlr": 167.22,
                "vlrFCP": 0,
                "vlrDifalRem": 0,
                "vlrDifalDest": 0
              }
              {
                "tipoImposto": "SUBST_TGFDIN"
                "aliq": 18.96,
                "base": 1657.71,
                "vlr": 174.95
              }
              {
                "tipoImposto": "IPI_TGFDIN"
                "aliq": 3,
                "base": 1393.50,
                "vlr": 41.80
              }
            ]
        }
       ]
   }
}