Histórico da Página

...

Informações

title	Informação

Todos os tributo enviado tributos que terão os seus valores atribuídos pela classe precisam estar previamente cadastrados no Configurador de Tributos (FISA170), e em seu cadastro conter os Operandos de integração seguindo as Regras do Operando de Integração

...

Bloco de código

language	js
theme	Midnight
title	Exemplo método new

usingUsing Namespace totvs.protheus.backoffice.fiscal.taxoperandintegrator   
 
Function Exemplo()
    Local oIntegrador as Json
     oIntegrador oIntegrador   := TaxOperandIntegrator():New()
Return

...

Para o funcionamento correto da classe, é necessário que o JSON contenha a estrutura pré-determinada:.

Aviso

title	Atenção

A classe TaxOperandIntegrator tem por objetivo preencher as referencias internas do configurador de tributos, sendo assim, mesmo que a propriedade tenha o conteúdo zero ou vazio precisa ser informado, pois se tratando de uma integração para recepção dos tributos e seus respectivos valores não é possível presumir o valor.

Novos tributos

Os novos tributos (tributos da reforma), obrigatoriamente precisam conter a seguinte estrutura:

Estrutura JSON novos tributos

A Estrutura é composta por:

Número do Item (nItem);
ID do Tributo (para mais informações sobre ID do Tributo consulte aqui);
Propriedades do Tributo (valores ou dados que serão atualizados nas referencias das tabelas F2D e CJ3).

Informações

title	Informação

A classe segue os mesmo princípios do motor de calculo, MATXFIS, sendo assim, os tributos são atualizados por item. Ou seja, cada item terá um tributo ou n tributos.

Novos tributos

Os novos tributos (tributos da reforma), precisam conter a seguinte estrutura:

Estrutura JSON novos tributos

Bloco de código

language	js
theme	Midnight
title	Exemplo estrutura Json Novos Tributos

    numero_item
		|_id_tributo
			|_base_valor
		 	|_base_quantidade
        	|_base_um

Bloco de código

language	js
theme	Midnight
title	Exemplo estrutura Json Novos Tributos

    numero_item
		|_id_tributo
			|_base_valor
		 	|_base_quantidade
        	|_base_um
        	|_aliquota
        	|_valor
        	|_esc_CST
        	|_esc_CCT
        	|_esc_vl_tributado
        	|_esc_vl_isento
        	|_esc_vl_outros
        	|_esc_vl_diferido
        	|_esc_pc_diferido
        	|_esc_pc_reducao_base
        	|_esc_base_original
        	|_esc_pc_reducao_aliq
        	|_esc_aliquota_original

Composição JSON

Bloco de código

language	js
theme	Midnight
title	Exemplo JSON

 {
    "1": {
      "000062": {
        "base_valor": 0,
        "base_quantidade": 10000,
        "base_um": "UM",
        "aliquota": 10,
        "valor": 500,
        "esc_CST": "000",
        "CCT": "003",
        "vl_tributado": 6.55,
        "vl_isento": 0.00,
        "vl_outros": 0.00,
        "vl_diferido": 0.00,
        "pc_diferido": 0,
        "pc_reducao_base": 0,        "esc_CCT": "003",
        "esc_vl_tributado": 6.55,
        "esc_vl_isento": 0.00,
        "esc_vl_outros": 0.00,
        "esc_vl_diferido": 0.00,
        "esc_pc_diferido": 0,
        "esc_pc_reducao_base": 0,
        "esc_base_original": 0,
        "esc_pc_reducao_aliq": 0,
        "esc_aliquota_original": 0.00
      	}
   	}
}

Aviso

title	Atenção

Caso a estrutura não seja respeitada o método retornará um warning e o processamento será interrompido

Propriedades do Tributo (F2D)

Propriedade	Descrição	Type	Obrigatório?
base_valor	Valor da base do imposto	number	Sim
base_quantidade	Valor da base quando é operação com quantidade	number	Não*
base_um	Unidade de medida	character	Não*
aliquota	Alíquota do tributo	number	Sim
valor	Valor do imposto	number	Sim

Propriedades de escrituração (CJ3)

Propriedade	Descrição	Type	Obrigatório?
esc_CST	Classificação fiscal	character	Não
esc_CCT	CCT IBS/CBS	character	Não
esc_vl_tributado	Valor tributado	number	Sim
esc_vl_isento	Valor isento	number	Sim
esc_vl_outros	Valor outros	number	Sim
esc_vl_diferido	Valor diferido	number	Não
esc_pc_diferido	Percentual do diferimento	number	Não
esc_pc_reducao_base	Percentual da redução	number	Não
esc_base_original	Base original	number	Não
esc_pc_reducao_aliq	Percentual de redução de alíquota	number	Não
esc_aliquota_original	Alíquota original	number	Não

Base quantidade

* Em casos onde é necessário enviar o valor da base por quantidade é obrigatório o envio de todas as propriedades do tributo, sendo necessário também o preenchimento da propriedade base_um.

Tributos legados

Para o funcionamento correto, os tributos legados (tributos correntes atualmente, antes da reforma) precisam ter pelo menos a seguinte estrutura:

Estrutura JSON tributos legados

Bloco de código

language	js
theme	Midnight
title	Exemplo estrutura Json Tributos legados

    numero_item
		|_id_tributo
			|_base_valor
        	|_aliquota
        	|_valor

Composição JSON

Atenção

Bloco de código

language	js
theme	Midnight

{
    "1": {
      "000021": {
        "base_originalvalor": 010000,
        "pc_reducao_aliqaliquota": 010,
        "aliquota_originalvalor": 0.00500,
       	}
   	}
}

Aviso

title

Caso a estrutura não seja respeitada o método retornará um warning e o processamento será interrompido

Propriedades do Tributo (F2D)

character

Propriedade	Descrição	Type	Obrigatório?
base_valor	Valor da base do imposto	number	Sim
base_quantidade	Valor da base quando é operação com quantidade	number	Não*
base_um	Unidade de medida
(preenchimento obrigatório caso haja valor na propriedade base_quantidade)	character	Não*
aliquota	Alíquota do tributo	number	Sim
valor	Valor do imposto	number

Propriedades de escrituração (CJ3)

...

vl_diferido

...

pc_diferido

...

pc_reducao_base

...

base_original

...

pc_reducao_aliq

...

aliquota_original

...

Sim
mva	Índice de cálculo MVA	number	Não
aux_mva	Índice de cálculo auxiliar do MVA	number	Não
pauta	Pauta	number	Não
vl_majorado	Percentual de Majoração	number	Não
aux_majoracao	Indice auxiliar do percentual de majorção	number	Não
vl_majoracao	Valor Majoração	number	Não
pc_majorcao	Alíquota Majoração	number	Não
aliquota_tribut	Alíquota do Tributo por regra de NCM	number	Não
ded_dep	Dedução por dependentes	number	Não

Base quantidade

* Em casos onde é necessário enviar o valor da base por quantidade é obrigatório o envio de todas as propriedades do tributo, sendo necessário também o preenchimento da propriedade base_um, exemplo:

Tributos legados

Para o funcionamento correto, os tributos legados (tributos correntes atualmente, antes da reforma) precisam ter pelo menos a seguinte estrutura:

Estrutura JSON tributos legados

Bloco de código

language	js
theme	Midnight
title	Exemplo estrutura Json Tributos legadosEstrutura com base_valor, base_quantidade e base um

    numero_item
		|_id_tributo
			|_base_valor
		 	|_idbase_tributo
		quantidade
        	|_base_valorum
        	|_aliquota
        	|_valor

...

Composição JSON

Bloco de código

language	js
theme	Midnight

 {
    "1": {
      "000021"000021": {
        "base_valor": 0,
        "base_quantidade": {10000,
        "base_valorum": 10000"UM",
        "aliquota": 10,
        "valor": 500,
             
		}
    	 }
}

Propriedades

...

de escrituração (

...

CJ3)

Propriedade	Descrição	Type
base_valor	Valor da base do imposto	number
base_quantidade	Valor da base quando é operação com quantidade	number
base_um	Unidade de medida (preenchimento obrigatório caso haja valor na propriedade base_quantidade)	character
aliquota	Alíquota do tributo	number
valor	Valor do imposto	number

Base quantidade

Em casos onde é necessário enviar o valor da base por quantidade é obrigatório o envio de todas as propriedades do tributo, sendo necessário também o preenchimento da propriedade base_um, exemplo:

Bloco de código

language	js
theme	Midnight
title	Estrutura com base_valor, base_quantidade e base um

    numero_item
		|_id_tributo
			|_base_valor
		 	|_base_quantidade
        	|_base_um
        	|_aliquota
        	|_valor

...

	type	Obrigatório?
esc_tab_CST	Tabela CST	character	Não
esc_CST	CST	character	Não
esc_vl_tributado	Valor tributado	number	Sim
esc_vl_isento	Valor isento	number	Sim
esc_vl_outros	Valor outros	number	Sim
esc_vl_diferido	Valor diferido	number	Não
esc_pc_diferido	Percentual do diferimento	number	Não
esc_pc_reducao_base	Percentual da redução	number	Não
esc_base_original	Base original	number	Não
esc_pc_reducao_aliq	Percentual de redução de alíquota	number	Não
esc_aliquota_original	Alíquota original	number	Não

Escrituração

Em casos onde é necessário enviar a escrituração é obrigatório que todas as propriedades de escrituração estejam no JSON:

Estrutura JSON tributos legados completa

Bloco de código

language	js
theme	Midnight
title	Estrutura completa JSON Tributo legado

    numero_item
		|_id_tributo
			|_base_valor
		 	|_base_quantidade
        	|_base_um
        	|_aliquota
  {
    "1": {
      "000062": {
        "base_valor": 0,
        "base_quantidade": 10000,
        "base_um": "UM",
        "aliquota": 10,
        "valor": 500,            
		}
    }
}

Propriedades de escrituração (CJ3)

...

tab_CST

...

vl_diferido

...

pc_diferido

...

pc_reducao_base

...

base_original

...

pc_reducao_aliq

...

aliquota_original

...

Escrituração

Em casos onde é necessário enviar a escrituração é obrigatório que todas as propriedades de escrituração estejam no JSON:

Estrutura JSON tributos legados completa

Bloco de código

language	js
theme	Midnight
title	Estrutura completa JSON Tributo legado

    numero_item
		|_id_tributo
			|_base_valor
		 	|_base_quantidade	|_valor
 		 	|_mva
			|_aux_mva
			|_pauta
			|_vl_majorado
			|_aux_majoracao
			|_vl_majoracao
			|_pc_majorcao
			|_aliquota_tribut
			|_ded_dep 
            |_esc_tab_CST
        	|_esc_CST
        	|_esc_vl_tributado
        	|_esc_vl_isento
        	|_baseesc_vl_umoutros
        	|_esc_vl_aliquotadiferido
        	|_esc_pc_valordiferido
        	|_esc_pc_tabreducao_CSTbase
        	|_esc_CSTbase_original
        	|_esc_pc_vlreducao_tributadoaliq
        	|_esc_vl_isento
        	|_vl_outros
        	|_vl_diferido
        	|_pc_diferido
        	|_pc_reducao_base
        	|_base_original
        	|_pc_reducao_aliq
        	|_aliquota_original

Composição JSON

aliquota_original

Composição JSON

Bloco de código

language	js
theme	Midnight
title	Exemplo

 {
    "1": {
      "000021": {
        "base_valor": 0,
        "base_quantidade": 10000,
        "base_um": "UM",
        "aliquota": 10,

Bloco de código

language	js
theme	Midnight
title	Exemplo

 {
    "1": {
       "000062valor": {
        "base_valor500,
		"mva": 0,
		"aux_mva": 0,
		"pauta" : 0,
		"vl_majorado": 0,
        "base_quantidade		"aux_majoracao": 100000,
        "base_um		"vl_majoracao": "UM",
        "aliquota": 10,
        "valor": 5000,
		"pc_majorcao": 0,
		"aliquota_tribut": 0,
		"ded_dep": 0,
        "esc_tab_CST": "000001",
        "esc_CST": "001",
        "esc_vl_tributado": 6.55,
        "esc_vl_isento": 0.00,
        "esc_vl_outros": 0.00,
        "esc_vl_diferido": 0.00,
        "esc_pc_diferido": 0,
        "esc_pc_reducao_base": 0,
        "esc_base_original": 0,
        "esc_pc_reducao_aliq": 0,
        "aliquota_originalreducao_aliq": 0.00,
      	}
   	}
}

05. REGRAS OPERANDOS DE INTEGRAÇAO

Novos tributos

Para que a integração funcione é necessário que o Operandos de integração esteja configurado nas seguintes regras:

Regra de Base
Regra de Alíquota
Regra de Escrituração
Regra de Cálculo

Caso alguma dessas configurações não esteja de acordo será retornada uma mensagem de warning e o processamento será interrompido.

...

  "esc_aliquota_original": 0.00
      	}
   	}
}

05. REGRAS OPERANDOS DE INTEGRAÇAO

Para que a integração funcione é necessário que o Operando de integração esteja configurado nas seguintes regras:

Regra de Base
Regra de Alíquota
Regra de Cálculo

No caso da Regra de Escrituração ela só será necessária, caso no JSON, seja informada alguma propriedade de escrituração. Caso o contrário a classe respeitará a regra de escrituração amarrada ao tributo, se houver.

...

Árvore de páginas

Versões comparadas

Versão antiga 22

Nova versão Atual

Chave

Novos tributos

Estrutura JSON novos tributos

Novos tributos

Estrutura JSON novos tributos

Composição JSON

Propriedades do Tributo (F2D)

Propriedades de escrituração (CJ3)

Base quantidade

Tributos legados

Estrutura JSON tributos legados

Composição JSON

Propriedades do Tributo (F2D)

Propriedades de escrituração (CJ3)

Base quantidade

Tributos legados

Estrutura JSON tributos legados

Composição JSON

Propriedades

de escrituração (

CJ3)

Base quantidade

Escrituração

Estrutura JSON tributos legados completa

Propriedades de escrituração (CJ3)

Escrituração

Estrutura JSON tributos legados completa

Composição JSON

Composição JSON

05. REGRAS OPERANDOS DE INTEGRAÇAO

Novos tributos

05. REGRAS OPERANDOS DE INTEGRAÇAO