Estrutura dos dados da chamada
Abaixo dados para a 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 cadatrado no Cockpit |
Sim |
senha |
cabecalho |
Senha do usuário do Cockpit |
Sim |
sessionID |
cabecalho |
Código de qualquer formato gerado pelo cliente e utilizado para obter controle das transações. Recomendamos que seja um código único por requisição. |
Sim |
sisOrig |
cabecalho |
Código numérico que identifica o sistema de origem de chamada. Controle do cliente e utilizado quando há vários sistemas requisitando o motor de cálculo. Se for utilizar somente 1 solução pra chamar o motor, por exemplo, pode mandar 1 no parâmetro. |
Sim |
dtCalc |
cabecalho |
Data de cálculo a ser considerada na vigência da regra. |
Sim |
ufOrig |
cabecalho |
Campo utilizado para informar o Estado de saída da mercadoria. |
Sim |
ufDest |
cabecalho |
Campo utilizado para informar o Estado de destino da mercadoria. |
Sim |
tpNF |
cabecalho |
Tipo da operação: |
Sim |
CNAERem |
cabecalho |
Código CNAE correspondente ao remetente. |
Não |
CNAEDest |
cabecalho |
Código CNAE correspondente ao destinatário. |
Não |
munOrig |
cabecalho |
Código do município de saída da mercadoria, de acordo com a tabela IBGE (vide item 1 do anexo) |
Não |
munDest |
cabecalho |
Código do município de entrada da mercadoria, de acordo com a tabela IBGE (vide item 1 do anexo) |
Não |
impAtiv |
cabecalho |
Ativação do cálculo de impostos e adição ao preço de custo: 2 - calculará preço líquido, o Net_price (custo sem impostos) 3 - Formação da base de cálculo de Pis e Cofins abatendo o ICMS 4 – Sem impostos, ativa o cálculo para embutir os tributos (ICMS, PIS Crédito, COFINS Crédito). obs. observar as notas abaixo. |
Não |
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. |
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 |
Item |
item |
Ocorrência mínima: 1 | Ocorrência máxima: 990 |
Sim |
Id |
item |
Identificação única de cada item. |
Sim |
natOp |
item |
Conforme tabela |
Sim |
finalidade |
item |
Código da finalidade do cenário. |
Não |
perfilRem |
item |
Obedecerá a tabela e códigos combinada a partir de parâmetros da contratação do serviço. |
Sim |
perfilDest |
item |
Obedecerá a tabela e códigos combinada a partir de parâmetros da contratação do serviço. |
Sim |
cProd |
item |
Código do produto previamente configurado. |
Sim |
Orig |
item |
Inteiro de 0 a 8 conforme tabela. |
Sim |
cEAN |
item |
Código de barras do produto |
Não |
NCM |
item |
Classificação fiscal do produto |
Não |
EXTIPI |
item |
Código EX da TIPI |
Não |
vProdUni |
item |
Valor unitário do produto. |
Sim |
qTrib |
item |
Quantidade |
Sim |
vFrete |
item |
Valor do frete |
Não |
vSeg |
item |
Valor do seguro |
Não |
vOutro |
item |
Outras despesas acessórias |
Não |
vDesc |
item |
Valor do desconto incondicional |
Não |
outrasDesp |
item |
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 |
item |
Alíquota do Simples Nacional aplicável no cálculo do crédito pelo contribuinte destinatário. |
Não |
infCustoAquis |
item |
Ativação do cálculo do custo de aquisição: |
Não |
generico |
item |
Campo genérico para funções especiais no âmbito do item, não deve ser informado se não for especialmente necessário. |
Não |
modalidade | item |
Informar a modalidade de inclusão da margem de lucro: 1 = inclui a margem de lucro sobre o valor net, ou seja nas chamadas com impAtiv=0 ao formar o valor NVProdUni a margem será acrescinda antes de embutir os tributos |
Não |
margem | item | percentual de margem de lucro a ser utilizado no cálculo. | Não |
Informações adicionaisdos campos:
* impAtiv=
0 |
o impAtiv = "0" cria o NvProdUni que retorna no cabeçalho. O NvProdUni é o vProdUni com os tributos da operação embutidos. Os cálculos da operação serão feitos com o NvProdUni |
1 ou vazio | o impAtiv = "1 "ou "vazio" fará o cálculo dos tributos considerando o vProdUni. |
2 |
o impAtiv = "2" calcula o net_price, que retornará na tag genérica do retorno, o calculo consiste em desembutir os tributos. Importante ressaltar que os tributos que serão considerados no cálculo são os tributos que constam na operação chamada. O impAtiv=2 conta com duas formas de cálculo, a considerar marcações no genérico do cabeçalho, por exemplo: - pFrete=00.0000, nessa marcação poderá informar qual o percentual de frete deve ser abatido para calcular o net_price; - e a marcação NPrice=1 consideramos que o valor informado é o total da nota fiscal, ou seja, temos que abater os tributos que são destacados, por exemplo: IPI. |
3 |
o impAtiv= "3" calcula a base de cálculo de Pis e Cofins abatendo o valor do ICMS. Para isso é necessário que o retorno tenha no bloco do ICMS o CST 00 ou 20. Para esse cálculo atender aos CSTs 41, 40, 60 ou 500, contamos com algumas marcações no genérico do item, conforme abaixo: vBCSTRet=0.000000|pST=0.000000|vICMSSTRet=0.000000|vICMSSubstituto=00.0000| vICMSRet=0.000000|vFCPSTRet=0.000000|vBCFCPSTRet=0.000000| pFCPSTRet=0.000000 Os valores informados nessas marcações serão abatdidos da base de cálculo de Pis e Cofins. No retorno com CST 60, essas marcações também serão usadas para preencher o bloxo do ICMSRetido, obrigatório em algumas ufs nas operações do substituído. |
4 |
o impAtiv = "4" cria o NvProdUni que retorna no cabeçalho e é utilizado como novo valor para cálculo da operação. O NvProdUni é o vProdUni com os tributos da operação embutidos, que nesse caso embutirá ICMS, PIS credito e Cofins Credito, e caso a operação não tenha crédito embutirá os valores de Pis e Cofins do débito. |