Documentação rotina 6.5 - Gestão tributária SAAM: Integração Winthor

Versão: 1.0
Data de Atualização: 02/02/2024

1 Vídeo explicativo
2 Orientações gerais
3 Tabelas
- 3.1 Resumo das Tabelas
- 3.2 Observações sobre as colunas
- 3.3 Tabela tab_figura_entrada
- 3.4 Tabela tab_figura_saida
- 3.5 Tabela tab_figura_participante_excecao
4 Regras de preenchimento tabela tab_figura_participante_excecao

Vídeo explicativo

https://youtu.be/Yc2iOCEQDeU?si=_C3FyNZfeR13Uhx0

Orientações gerais

Tabelas

Resumo das Tabelas

Tabela	Propósito	Grupos Principais	Campos Relevantes

Tabela	Propósito	Grupos Principais	Campos Relevantes
tab_figura_entrada	Armazenar dados de entrada, especialmente fiscais e tributários.	Identificação, Participante, Produto, Tributação	CNPJ/CPF, IE, códigos tributários, informações do participante e do produto, dados relacionados à tributação.
tab_figura_saida	Registrar dados de saída, especialmente no contexto tributário.	Identificação, Participante, Produto, Tributação, Gestão	CNPJ/CPF, IE, códigos tributários, informações do participante e do produto, dados tributários específicos, indicação de conferência e origem.
tab_figura_participante_excecao	Gerenciar exceções e configurações específicas para participantes.		CNPJ/CPF, IE, datas de início e fim, observações, dados tributários específicos, CFOP aplicado na exceção, indicadores de base de cálculo, percentuais, configurações de seleção inteligente, status de conferência e origem.

Observações sobre as colunas

Grupo:
- A tabela parece ser organizada em grupos, como "identificação", "participante", "produto", e "tributação". Cada grupo agrupa campos relacionados a uma determinada categoria de informações.
Campos:
- Cada grupo possui campos específicos, como "cnpj_cpf_0000", "ie_0000", "data_inicio", etc. Cada campo é associado a um tipo de dado (char, varchar, booleano) e tem um tamanho máximo definido.
Obrigatório:
- A coluna "obrigatório" indica se o preenchimento do campo é obrigatório ("Sim") ou não ("Não").
Tipo e Tamanho Máximo:
- Indicam o tipo de dado que o campo aceita (char, varchar, booleano) e o tamanho máximo permitido para esse campo.
Preenchimento
- Oferece uma descrição do propósito ou conteúdo esperado para cada campo.
Observações:
- Alguns campos têm observações associadas, como "campo aberto para anotações" ou "campo com anotações importantes sobre o ERP". Essas notas podem fornecer contextos adicionais para o uso dos campos.
Preenchimento
1. Quando um campo está vazio, significa que não será aplicado, ou seja, apenas 0 será alterado. O campo vazio não é considerado para efeitos de alteração.

Tabela tab_figura_entrada

grupo	campo	obrigatório	tipo	tamanho máximo	descrição

grupo	campo	obrigatório	tipo	tamanho máximo	descrição
identificação	cnpj_cpf_0000	Sim	char	14	cnpj ou cpf da empresa cadastrada na 12.8
identificação	ie_0000	Sim	varchar	40	ie da empresa cadastrada na 12.8
identificação	data_inicio	não	char	8	data de inicio válida
identificação	data_final	não	char	8	data de fim válida
identificação	codigo_tributacao_erp	não	varchar	100	código da tributação do ERP
identificação	observacao_erp	não	varchar	2000	campo aberto para anotações
identificação	observacao_geral	não	varchar	2000	campo com anotações importantes sobre o ERP
participante	participante_cnpj_cpf	não	char	14	cnpj ou cpf do participante
participante	participante_cod_part	Não	varchar	60	Código cadastrado no SPED do participante
participante	participante_ie	Não	varchar	30	Incrição estatudal do participante
participante	participante_razao	Não	varchar	100	Razão do participante
participante	participante_uf	Não	char	2	Estado do participante
participante	participante_tipo	Não	varchar	10	Categoria do participante OPÇÕES SÃO: 1 - Comércio varejista / 2 - Indústria / 3 - Outros / 4 - Comércio atacadista 5 / CONSUMIDOR
participante	participante_cod_item	Não	varchar	60	código do produto interno do participante
participante	participante_ncm	Não	varchar	8	NCM interno do participante
participante	participante_descr_item	Não	varchar	2000	Descrição original do produto
participante	participante_cest	Não	varchar	7	CEST interno do participante
participante	participante_aliq_icms_orig	Não	varchar	21	Aliquota do icms do item original do fornecedor XML
participante	participante_aliq_icms_fcp	Não	varchar	21	Aliquota do icms FCP do item original do fornecedor
participante	participante_cod_barras	Não	varchar	1000	Código de barras interno do participante
produto	produto_cod_item	Não	varchar	60	cod_item do sped
produto	produto_descricao_item	Não	varchar	2000	descrição do item no sped
produto	produto_ncm	Não	varchar	8	NCM item no sped
produto	produto_cest	Não	varchar	7	CEST do item no sped
produto	produto_cod_barras	Não	varchar	100	Código de barras do item no sped
tributação	cst_ipi	Não	char	2	Codigo da situação do IPI
tributação	percentual_ipi	Não	varchar	21	%IPI
tributação	aliquota_icms	Não	varchar	21	%ICMS
tributação	aliquota_icms_especifico	Não	varchar	21	Percentual de ICMS
tributação	percentual_reducao_base_icms	Não	varchar	21	%Redução base ICMS
tributação	aliq_icms_presumido	Não	varchar	21	%ICMS Presumido
tributação	aliquota_suframa	Não	varchar	21	%SUFRAMA
tributação	cst_icms_origem	não	char	1	Origem do cst
tributação	cst_icms	Não	char	3	Sit.Tribut.entrada com dois digitos
tributação	Indicador_base_calculo	Não	char	1	indicador base de calculo 1 - valor bruto / 2 - Valor líquido - Somente em base de calculo por IVA
tributação	percentual_iva	Não	varchar	21	%IVA
tributação	percentual_reducao_base_iva	Não	varchar	21	%Redução Base IVA
tributação	vlr_pauta_st	Não	varchar	21	Vlr. Pauta ST
tributação	aliquota_st	Não	varchar	21	Percentual de ICMS ST
tributação	aliquota_fcp_st	Não	varchar	21	Percentual de ICMS ST fundo de combate
tributação	aliquota_st_externa	Não	varchar	21	%Alíq.Externa
tributação	tipo_pis_cofins	Não	char	1	1 - percentual(padrão) / 2 - quantidade
tributação	cst_pis_cofins	Não	char	2	Cód. sit. tribut. PIS/COFINS
tributação	percentual_pis	Não	varchar	21	%PIS
tributação	percentual_cofins	Não	varchar	21	%COFINS
tributação	operacao	Não	char	1	1 - estadual/2 - interestadual/3 - Importação
tributação	cfop_compra	Não	varchar	100	cfop_compra
tributação	cfop_compra_st	Não	varchar	100	cfop_compra_st
tributação	cfop_bonificacao	Não	varchar	100	cfop_bonificacao
tributação	cfop_remessa	Não	varchar	100	cfop_remessa
tributação	cfop_entrega_futura	Não	varchar	100	cfop_entrega_futura
tributação	cfop_transferencia	Não	varchar	100	cfop_transferencia
tributação	cfop_transferencia_st	Não	varchar	100	cfop_transferencia_st
tributação	cfop_devolucao	Não	varchar	100	cfop_devolucao
tributação	cfop_devolucao_st	Não	varchar	100	cfop_devolucao_st
tributação	cfop_beneficiamento	Não	varchar	100	cfop_beneficiamento
tributação	cfop_comodato	Não	varchar	100	cfop_comodato
tributação	cfop_outras	Não	varchar	100	cfop_outras
tributação	determinar_cfop_do_5929_pelo_cst	Não	booleano	-	Quando o CFOP do XML do fornecedor for 5929-6929 a categorização será por cst
tributação	cfop_curinga	Não	varchar	1000	Combinações chave valor para tratamento de CFOPs sem grupo
tributação	uso_consumo	Não	booleano	-	Ao ativar o SAAM irá atribuir cfop 1556,1407,1653 automaticamente
tributação	ativo	Não	booleano	-	Ao ativar o SAAM irá atribuir cfop 1551,1406 automaticamente

Tabela tab_figura_saida

grupo	campo	obrigatório	tipo	tamanho	descrição

grupo	campo	obrigatório	tipo	tamanho	descrição
identificação	cnpj_cpf_0000	Sim	char	14	cnpj ou cpf da empresa cadastrada na 12.8
identificação	ie_0000	Sim	varchar	40	ie da empresa cadastrada na 12.8
identificação	codigo_tributacao_erp	não	varchar	100	código da tributação do ERP
identificação	observacao_erp	não	varchar	2000	campo aberto para anotações
identificação	observacao_geral	não	varchar	2000	campo com anotações importantes sobre o ERP
participante	participante_cnpj_cpf	não	char	14	cnpj ou cpf do participante
participante	participante_cod_part	Não	varchar	60	Código cadastrado no SPED do participante
participante	participante_ie	Não	varchar	30	Incrição estatudal do participante
participante	participante_razao	Não	varchar	100	Razão do participante
participante	participante_uf	Não	char	2	Estado do participante
participante	participante_tipo	Não	varchar	10	Categoria do participante OPÇÕES SÃO: 1 - Comércio varejista / 2 - Indústria / 3 - Outros / 4 - Comércio atacadista 5 / CONSUMIDOR
produto	produto_cod_item	Não	varchar	60	cod_item do sped
produto	produto_descricao_item	Não	varchar	2000	descrição do item no sped
produto	produto_ncm	Não	varchar	8	NCM item no sped
produto	produto_cest	Não	varchar	7	CEST do item no sped
produto	produto_cod_barras	Não	varchar	100	Código de barras do item no sped
tributação	cst_ipi	Não	char	2	Codigo da situação do IPI
tributação	percentual_ipi	Não	varchar	21	%IPI
tributação	aliquota_icms	Não	varchar	21	%ICMS
tributação	aliquota_icms_retido	Não	varchar	21	%ICMS retido anteriormente utilizada para redução do icms na base de base de calculo
tributação	percentual_reducao_base_icms	Não	varchar	21	%Redução base ICMS
tributação	cst_icms	Não	char	3	Sit.Tribut.ent
tributação	beneficiado_suframa	Não	booleano		Informação
tributação	Indicador_base_calculo	Não	char	1	indicador base de calculo 1 - valor bruto / 2 - Valor líquido - Somente em base de calculo por IVA
tributação	percentual_iva	Não	varchar	21	%IVA
tributação	percentual_reducao_base_iva	Não	varchar	21	%Redução Base IVA
tributação	vlr_pauta_st	Não	varchar	21	Vlr. Pauta ST
tributação	aliquota_st	Não	varchar	21	Percentual de ICMS ST
tributação	aliquota_fcp_st	Não	varchar	21	Percentual de ICMS ST fundo de combate
tributação	aliquota_st_externa	Não	varchar	21	%Alíq.Externa
tributação	tipo_pis_cofins	Não	char	1	1 - percentual(padrão) / 2 - quantidade
tributação	cst_pis_cofins	Não	char	2	Cód. sit. tribut. PIS/COFINS
tributação	percentual_pis	Não	varchar	21	%PIS
tributação	percentual_cofins	Não	varchar	21	%COFINS
tributação	cfop_estadual	Não	varchar	100	cfop_compra
tributação	cfop_interestadual	Não	varchar	100	cfop_compra_st
tributação	cfop_exportacao	Não	varchar	100	cfop_bonificacao

Tabela tab_figura_participante_excecao

campo	campos para integração	obrigatório	tipo	tamanho	descrição

campo	campos para integração	obrigatório	tipo	tamanho	descrição
cnpj_cpf_0000	sim	sim	char	14	cnpj ou cpf da empresa cadastrada na 12.8
ie_0000	sim	sim	varchar	40	ie da empresa cadastrada na 12.8
data_inicio	não	Não	date		data de inicio válida
data_final	não	Não	date		data de fim válida
Observação	sim	não	varchar	200	descrição do grupo de participantes
cpf_cnpj_participante	sim	sim	char	14	cpf e cnpj do participante
ie_participante	sim	não	varchar	40	Inscrição estadual do participante
participante_razao	sim	Não	varchar	100	Razão do participante
cod_participante	sim	Não	varchar	60	Código cadastrado no SPED do participante
cst_ipi	sim	Não	char	2	Codigo da situação do IPI
percentual_ipi	sim	Não	varchar	21	%IPI
aliquota_icms	sim	Não	varchar	21	%ICMS
aliquota_icms_retido	sim	Não	varchar	21	%ICMS retido anteriormente utilizada para redução do icms na base de base de calculo
percentual_reducao_base_icms	sim	Não	varchar	21	%Redução base ICMS
cst_icms	sim	Não	char	3	Sit.Tribut.ent
cfop	sim	Não	char	4	CFOP aplicado na excecao
Indicador_base_calculo	sim	Não	char	1	indicador base de calculo 1 - valor bruto / 2 - Valor líquido - Somente em base de calculo por IVA
percentual_iva	sim	Não	varchar	21	%IVA
percentual_reducao_base_iva	sim	Não	varchar	21	%Redução Base IVA
vlr_pauta_st	sim	Não	varchar	21	Vlr. Pauta ST
aliquota_st	sim	Não	varchar	21	Percentual de ICMS ST
aliquota_fcp_st	sim	Não	varchar	21	Percentual de ICMS ST fundo de combate
aliquota_st_externa	sim	Não	varchar	21	%Alíq.Externa
tipo_pis_cofins	sim	Não	char	1	1 - percentual(padrão) / 2 - quantidade
cst_pis_cofins	sim	Não	char	2	Cód. sit. tribut. PIS/COFINS
percentual_pis	sim	Não	varchar	21	%PIS
percentual_cofins	sim	Não	varchar	21	%COFINS
selecao_inteligente_cnpj_cpf	sim	Não	char	1	1 - todos os CNPJs / 2 - Todos os CPF
selecao_inteligente_cnpj_ie	sim	Não	char	1	1 - Com IE preenchida / 2 - Sem ie Prenchida
selecao_inteligente_modelo	sim	Não	char	2	lista de modelos válidos - 65-55-etc

Regras de preenchimento tabela tab_figura_participante_excecao

Deve existir apenas uma linha com o participante, desta forma, as exceções devem ser unificadas para apresentar em apenas uma linha

CÓDIGO	UF DA REGRA	NOME A EXCEÇÃO	ORIENTAÇÃO DE COLETA DE DADOS PARA A EXCEÇÃO WINTHOR	ORIENTAÇÃO DE PREENCHIMENTO EXCEÇÃO	REGRAS DE APLICAÇÃO DA EXCEÇÃO SAAM	ORIENTAÇÃO FIGURA PADRAO DE SAIDA
1	AM	Isenção para Clientes SUFRAMA	buscar todos os participantes que contém inscrição suframa preenchido no cadastro de cliente winthor	aliquota_icms=0 , aliquota_icms_retido=0, percentual_reducao_base_icms=0, cst_icms=40 = cfop=5110	produto é beneficiado(tab_figura_saida.beneficiado_suframa) tab_figura_saida.aliquota_icms	destaque de icms normal
2	BR	PIS/COFINS Bebidas Frias	Buscar destinatário = v (Varejista) critério PIS/COFINS	tipo_pis_cofins=1; percentual_pis=1,86; percentual_cofins=8,54	tab_figura_saida.percentual_pis = 2,32 tab_figura_saida.percentual_cofins = 10,68 tab_figura_saida.cst_pis_cofins = 02	destaque PIS/COFINS

Autores

Jhonatan P. Nascimento
Carlos R. Silva