Documentação rotina 6.5 - Gestão tributária SAAM: Integração Winthor
Versão: 1.0
Data de Atualização: 02/02/2024
Vídeo explicativo
Orientações gerais
Tabelas
Resumo das Tabelas
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
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 |
---|---|---|---|---|---|
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 |
---|---|---|---|---|---|
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 |
---|---|---|---|---|---|
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) | 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 | destaque PIS/COFINS |
Autores
Jhonatan P. Nascimento
Carlos R. Silva