Chamada

Aqui veremos todos pontos da chamada, como definições, estruturas e exemplos para serem utilizados como base.

Definições da Chamada

Na chamada deve sempre ser indicado um produto, os dados do destinatário/comprador e aos menos 2 fornecedores diferentes (remetente) para que a solução tenha parâmetros para apontar qual fornecedor tem o melhor custo para aquisição.

Diferenciais:  1. Cálculo “onDemand” e 2. Consulta por valor de compra ou valor de custo

 

1. Cálculo onDemand:

O produto pode ser um existente na base do cliente ou ainda um produto novo ou desconhecido, onde nessa condição, a ferramenta fará uma consulta online com os produtos existentes na base de produtos da Systax.

Assim como o produto, os dados dos fornecedores podem ser de cenários já previamente cadastrados na base de cenários do cliente ou uma nova operação, e nessa condição, a ferramenta simulará um calculo online com cenários da base da Systax.

A modalidade de cálculo online tanto no caso de produto como de cenário, é conhecido como “onDemand”, e essa informação será indicada no genérico do retorno ‘tiporegra=ondemand".

 

2. Consulta por valor de compra ou valor de custo:

A ferramenta tem possibilidade de consultar cada fornecedor de forma diferente, onde pode-se indicar para um fornecedor o preço de custo, ou seja sem os tributos, e a ferramenta embute os tributos para calcular o “custo de aquisição” ou informa-se o valor da compra, com os tributos e demais despesas, e a ferramenta apenas indica o valor do custo (sem tributos), nesse caso, mantem o calculo do “custo de aquisição” pelo valor indicado no “vProdUni”, que corresponde ao valor de compra.

Em ambos os casos o Comparativo de Compras indica a melhor opção de compra, fazendo as devidas distinções entre as opções indicadas na chamada.

A chamada e o retorno de cada uma dessas opções são feitas em tags específicas.

Na chamada na tag "precoOuCusto” indica-se a modalidade de cálculo que se deseja para o fornecedor, onde:

                Se indicado nessa tag “C” a ferramenta vai considerar que o valor indicado na tag “vProdUni” é o custo sem os tributos, e portanto vai embutir os tributos e formar um novo “vProdUni”, calculando o custo de aquisição partindo desse valor, e indicará esse valor na tag do retorno “precoTributos”.

                Se indicado na tag “P” a ferramenta entende que o valor da tag “vProdUni” é o valor de compra com tributos, e calculará o “custo de aquisição” a partir desse valor  e apenas indicará no retorno na tag “precoNet” o custo líquido, ou seja, valor sem os tributos.

                Se na chamada a tag não for indicado nenhum valor a ferramenta calculará o “custo de aquisição” partindo do valor informado no “vProdUni”.

Veja o anexo 1 com exemplos de uma chamada com as indicações dessas tags.

Estrutura dos dados da chamada

TAG

PAI

DESCRIÇÃO

OBRIGATÓRIO

chamada

/

Ocorrência mínima: 1 | Ocorrência máxima: 1

Sim

cabecalho

chamada

Ocorrência mínima: 1 | Ocorrência máxima: 1

Sim

usuario

cabecalho

Usuário cadastrado no Cockpit

Sim

senha

cabecalho

Senha do usuário do Cockpit

Sim

sessionID

cabecalho

Código do sistema de origem + código hash

Sim

sisOrig

cabecalho

Código que identifica o sistema de origem

Sim

dtCalc

cabecalho

Data de cálculo a ser considerada na vigência da regra.

Sim

tpNF

cabecalho

Tipo da operação:
0 – Entrada

Sim

generico

cabecalho

Campo genérico para funções especiais para a chamada inteira, não deve ser informado se não for especialmente necessário.
Conforme tabela de informações genéricas do cabeçalho.

Não

chavebanco

cabecalho

Código do Cockpit considerado no cálculo

Permite utilizar um único Motor de Cálculo e vários bancos de dados. As chaves precisam ser previamente cadastradas e informadas no momento do cálculo.

Caso não seja informada, o motor irá procurar por um banco de dados padrão, que poderá ser configurado opcionalmente.

Não

Itens

chamada

Ocorrência mínima: 1 | Ocorrência máxima: 1

Sim

DadosProduto

DadosProduto

Ocorrência mínima: 1 | Ocorrência máxima: 999

Sim

cProd

DadosProduto

Código do produto previamente configurado.

Não

Orig

DadosProduto

Inteiro de 0 a 8 conforme tabela "Origem do produto" (abaixo).

Sim

cEAN

DadosProduto

Código de barras do produto

Não

NCM

DadosProduto

Classificação fiscal do produto

Não

EXTIPI

DadosProduto

Código EX da TIPI

Não

PerfilDestino

PerfilDestino

Ocorrência mínima: 1 | Ocorrência máxima: 1

Sim

finalidade

PerfilDestino

Código da finalidade do cenário.

Não

perfilDest

PerfilDestino

Obedecerá a tabela e códigos combinada a partir de parâmetros da contratação do serviço.

Sim

ufDest

PerfilDestino

Campo utilizado para informar o Estado de destino da mercadoria, ele é destinado para requisições do tributo A (ICMS e ICMS/ST).

Sim

CNAEDest

PerfilDestino

Código CNAE correspondente ao destinatário.

Não

munDest

PerfilDestino

Código do município de entrada da mercadoria, de acordo com a tabela IBGE (vide item 1 do anexo)

Não

ItensComparacao

perfilOrigem

Ocorrência mínima: 1 | Ocorrência máxima: 999

Sim

Id

perfilOrigem

Identificação única de cada item.

Sim

natOp

 perfilOrigem

Conforme tabela

Sim

ufOrig 

 perfilOrigem

Campo utilizado para informar o Estado de saída da mercadoria, ele é destinado para requisições do tributo A (ICMS e ICMS/ST).

Sim

perfilRem

 perfilOrigem

Obedecerá a tabela e códigos combinada a partir de parâmetros da contratação do serviço.

Sim

CNAERem

 perfilOrigem

Código CNAE correspondente ao remetente.

Não

munOrig

 perfilOrigem

Código do município de saída da mercadoria, de acordo com a tabela IBGE (vide item 1 do anexo)

Não

precoOuCusto

 perfilOrigem

Calcula o custo do produto, sem os tributos, ou calcula o valor de compra:

P - Calcula o valor de custo – desembute os tributos

C – Forma novo valor do vProdUni - embute os tributos

Não

qTrib

 perfilOrigem

Quantidade

Sim

vProdUni

 perfilOrigem

Valor unitário do produto.

Sim

vFrete

 perfilOrigem

Valor do frete

Não

pFrete

perfilOrigem

Percentual de frete. Pode ser indicado quando for feita a chamada com a solicitação de retorno do NetPrice, assim será considerado na formação do valor do valor de custo o percentual relativo ao frete do produto.

Não

vSeg

 perfilOrigem

Valor do seguro

Não

vOutro

 perfilOrigem

Outras despesas acessórias

Não

vDesc

 perfilOrigem

Valor do desconto incondicional

Não

outrasDesp

 perfilOrigem

Outras despesas, para operações de entrada quando aplicável. Ocorrência mínima: 1 | Ocorrência máxima: 1

Não

vII

outrasDesp

Valor Imposto de Importação

Não

bcII

outrasDesp

Base de cálculo do Imposto de Importação

Não

vIOF

outrasDesp

Valor Imposto sobre Operações Financeiras

Não

vEncCamb

outrasDesp

Valor dos encargos cambiais

Não

vDespAdu

outrasDesp

Valor despesas aduaneiras

Não

pCredSN

 perfilOrigem

Alíquota do Simples Nacional aplicável no cálculo do crédito pelo contribuinte destinatário.

Não

generico

 perfilOrigem

Campo genérico para funções especiais no âmbito do item, não deve ser informado se não for especialmente necessário.
Veja tabela de informações genéricas do item.

Não

Origem do produto

0 Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8
1 Estrangeira - Importação direta, exceto a indicada no código 6
2 Estrangeira - Adquirida no mercado interno, exceto a indicada no código 7
3 Nacional, mercadoria ou bem com Conteúdo de Importação superior a 40% e inferior ou igual a 70%
4 Nacional, cuja produção tenha sido feita em conformidade com os PPB de que tratam as legislações citadas nos Ajustes
5 Nacional, mercadoria ou bem com Conteúdo de Importação inferior ou igual a 40%
6 Estrangeira - Importação direta, sem similar nacional, constante em lista da CAMEX e gás natural
7 Estrangeira - Adquirida no mercado interno, sem similar nacional, constante em lista da CAMEX e gás natural
8 Nacional, mercadoria ou bem com Conteúdo de Importação superior a 70%

Exemplo de chamada

{
  "cabecalho": {
    "usuario": "superdemo@systax.com.br",
    "senha": "super123",
    "sessionID": "1",
    "sisOrig": "1",
    "dtCalc": "2021-03-24",
    "tpNF": "",
    "generico": "",
    "chaveBanco": "superdemo1"
  },
  "Itens": [
    {
      "DadosProduto": {
        "cProd": "",
        "Orig": "",
        "CEAN": "",
        "NCM": "21033021",
        "EXTIPI": ""
      },
      "PerfilDestino": [
        {
          "finalidade": "569",
          "perfilDest": "138",
          "ufDest": "SC",
          "CNAEDest": "",
          "munDest": ""
        },
        {
                "finalidade": "569",
          "perfilDest": "138",
          "ufDest": "SP",
          "CNAEDest": "",
          "munDest": ""
                }                
      ],
      "PerfilOrigem": [
        {
          "Id": "1",
          "natOp": "121",
          "UfOrig": "AC",
          "PerfilRem": "2",
          "CNAERem": "",
          "MunOrig": "",
          "qTrib": "1",
          "vProdUni": "10.00",
          "precoNet": "S",
          "vFrete": "",
          "pFrete": "",
          "vSeg": "",
          "vOutro": "",
          "vDesc": "",
          "outrasDesp": {
            "vII": "",
            "bcII": "",
            "vIOF": "",
            "vEncCamb": "",
            "vDespAdu": ""
          },
          "pCredSN": "",
          "generico": ""
        },
                { 
                    "Id": "2",
          "natOp": "120",
          "UfOrig": "TO",
          "PerfilRem": "1",
          "CNAERem": "",
          "MunOrig": "",
          "qTrib": "1",
          "vProdUni": "10.00",
          "precoNet": "",
          "TribIncluse": "",
          "vFrete": "",
          "pFrete": "",
          "vSeg": "",
          "vOutro": "",
          "vDesc": "",
          "outrasDesp": {
            "vII": "",
            "bcII": "",
            "vIOF": "",
            "vEncCamb": "",
            "vDespAdu": ""
          },
          "pCredSN": "",
          "generico": ""
                }
      ]
    }
  ]
}