4.3.1.1 - Facilitador de Lançamentos Winthor (Rotinas 749 e 1007)

4.3.1.1 - Facilitador de Lançamentos Winthor (Rotinas 749 e 1007)

Facilitador de Lançamentos Winthor — Rotinas 749 e 1007

Caminho no SAAM: 4 Integrações > 4.3 ERPs > 4.3.1 Winthor > 4.3.1.1 Facilitador de Lançamentos

Sobre este manual: Guia completo do Facilitador de Lançamentos Winthor — rotina 4.3.1.1 do SAAM. O sistema automatiza o processo de lançamento de contas a pagar no ERP Winthor, importando automaticamente os dados dos XMLs fiscais e eliminando a necessidade de acesso direto ao ERP para digitação manual.


1. Visão Geral

1.1 O que é o Facilitador de Lançamentos

O Facilitador de Lançamentos é uma interface web integrada ao SAAM que conecta o processo de contas a pagar ao ERP Winthor. Ele importa os dados fiscais dos XMLs já disponíveis no SAAM e permite que o operador complemente apenas as informações financeiras e de negócio — parcelas, retenções e centro de custo — antes de enviar tudo automaticamente ao Winthor.

1.2 Problema que o sistema resolve

Antes desta solução, o operador precisava:

  • Acessar o Winthor manualmente e redigitar dados de cada nota fiscal nas rotinas 749 e 1007

  • Transitar entre dois sistemas (SAAM e Winthor) para cada documento

  • Trabalhar sem rastreabilidade centralizada das operações

1.3 Como o processo funciona

  1. Pesquisa: o operador localiza as notas pendentes usando filtros avançados

  2. Lançamento: os dados do XML são carregados automaticamente; o operador preenche parcelas, retenções e centro de custo

  3. Gravação: o SAAM registra os dados nas tabelas nativas do Winthor — sem que o operador precise abrir o ERP

1.4 Tabelas do Winthor atualizadas pelo sistema

Tabela

O que armazena

Tabela

O que armazena

PCLANC

Lançamentos contábeis

PCNFENT

Notas fiscais de entrada

PCNFBASE

Base de dados de notas fiscais

PCNFENTPISCOFINS

PIS/COFINS das notas fiscais

PCRATEIOCENTROCUSTO

Rateio por centro de custo


2. Acesso ao Sistema

2.1 Como acessar

No menu principal do SAAM, siga o caminho:

4 Integrações → 4.3 ERPs → 4.3.1 Winthor → 4.3.1.1 Facilitador de Lançamentos

A rotina abre em uma janela web independente, separada da tela principal do SAAM.

2.2 Controle de permissões por bloco

O acesso a cada aba da tela de lançamento é controlado individualmente. Um usuário pode ter permissão para preencher apenas determinados blocos:

Bloco

Código

O que cobre

Bloco

Código

O que cobre

Dados de Pagamento

749-DP

Parcelas, forma de pagamento, conta de débito e tipo de lançamento (Provisório/Confirmado)

Centro de Custo

749-CC

Rateio percentual do valor entre centros de custo

Retenções Tributárias

749-RT

IRRF, INSS, PIS, COFINS, CSRF e SEST/SENAT

Dados Fiscais

1007

Dados da nota fiscal importados do XML (número, CFOP, itens, valores)

Se uma aba não aparecer na tela de lançamento, o usuário não possui permissão para aquele bloco. Entre em contato com o administrador do sistema.


3. Configurações

Antes de começar a operar, o administrador do sistema deve configurar o Facilitador. As configurações ficam acessíveis pelo ícone de engrenagem ou menu de configurações dentro da rotina 4.3.1.1, e estão organizadas em quatro abas.

3.1 Aba — Permissões

Concentra as configurações de comportamento geral do sistema, divididas em dois grupos:

Tipos de Pagamento

Lista todas as formas de pagamento disponíveis no Winthor. O administrador pode ativar ou desativar quais formas aparecem para seleção na tela de lançamento.

  • Use o botão "Atualizar do ERP" para sincronizar a lista com os dados atuais do Winthor

  • Apenas as formas marcadas como ativas ficam disponíveis para o operador

Configuração de Campos

Parâmetros que controlam o comportamento automático do sistema:

Configuração

O que faz

Configuração

O que faz

Preencher com último lançamento

Ao abrir uma nova nota, o sistema sugere automaticamente os dados do último lançamento realizado para aquele fornecedor (forma de pagamento, conta de débito, retenções, centro de custo etc.)

Dividir retenções em parcelas

Quando ativado, distribui os valores de retenção proporcionalmente entre as parcelas do título

Atualizar % REINF no fornecedor

Após o lançamento, atualiza automaticamente os percentuais REINF no cadastro do fornecedor no Winthor

Tempo de inatividade (minutos)

Define quantos minutos de inatividade encerram a sessão de edição de um lançamento em aberto

Enviar para o Winthor automaticamente

Quando ativado, o lançamento é enviado ao Winthor assim que confirmado, sem necessidade de clicar em "Enviar ao Winthor" separadamente

Permitir edição de 'Espécie' no XML

Permite que o operador altere o tipo de documento (espécie) importado do XML antes do envio ao Winthor

3.2 Aba — Workflows (Alçadas de Aprovação)

Define quantos e quais níveis de aprovação cada bloco precisa percorrer antes de ser gravado no Winthor. Cada bloco tem sua própria fila de alçadas, configurável de forma independente.

Blocos configuráveis:

  • 749-DP — Dados de Pagamento

  • 749-CC — Centro de Custo

  • 749-RT — Retenções

  • 1007 — Dados Fiscais

Configurações por nível:

Campo

Descrição

Campo

Descrição

Identificador

Nome descritivo do nível (ex.: "Conferência", "Pré-Aprovação", "Aprovação Final")

Status

Label de status exibido nos documentos que estão nesse nível

Tipo de lançamento

Apenas para 749-DP: define se o nível trabalha com lançamentos Provisórios ou Confirmados

Colaboradores responsáveis

Usuários que podem aprovar ou recusar documentos neste nível (podem ser vários)

Regras importantes:

  • Cada bloco suporta no máximo 4 níveis de aprovação

  • O Nível 01 é obrigatório e não pode ser excluído

  • Não é possível excluir um nível que possua documentos pendentes de aprovação

  • Um documento percorre os níveis de forma sequencial — só avança para o próximo após aprovação no nível atual

Os status de cada nível de workflow (campo "Status" na configuração) são os mesmos que aparecem nos badges de bloco (DP, CC, RT, 1007). Nomes como "Conferência", "Pré-Aprovação" e "Aprovação Final" são exemplos — o administrador pode personalizar livremente.

3.3 Aba — Integrações

Concentra as configurações de integração do Facilitador com o Winthor conectados ao SAAM.

3.4 Aba — Mapeamento de Espécie

Esta aba é visível apenas para usuários com perfil de administrador. Usuários com perfil comum não têm acesso.

Permite mapear os tipos de documento (espécies) presentes nos XMLs para os tipos correspondentes no Winthor. Útil quando a nomenclatura do XML não coincide diretamente com os tipos cadastrados no ERP.


4. Painel de Pesquisa de Documentos

Ao acessar a rotina 4.3.1.1, a primeira tela exibida é o Painel de Pesquisa. É aqui que o operador localiza as notas fiscais que precisam ser lançadas.

4.1 Filtros disponíveis e regras de pesquisa

Atenção — campos obrigatórios: a pesquisa só é executada quando todos os campos obrigatórios estão preenchidos. O botão "Pesquisar" aciona a validação e exibe um aviso caso alguma regra não seja atendida.

Filtro

Obrigatório?

Descrição e regras

Filtro

Obrigatório?

Descrição e regras

Filial

OBRIGATÓRIO

Selecione a filial ou empresa. A pesquisa é bloqueada enquanto nenhuma filial estiver selecionada.

Tipo de Documento

OBRIGATÓRIO

Selecione o tipo de documento a pesquisar (NF-e, NFS-e, CT-e etc.). A pesquisa é bloqueada sem este campo.

Nº Documento

OBRIGATÓRIO CONDICIONAL

Obrigatório apenas quando o Período de Datas não estiver preenchido. Informe o número da nota fiscal para buscar um documento específico diretamente.

Período de Datas (Data Inicial + Data Final)

OBRIGATÓRIO CONDICIONAL

Obrigatório apenas quando o Nº Documento não estiver preenchido. Quando utilizado, aplica duas regras adicionais:
• O intervalo entre Data Inicial e Data Final não pode ser maior que 10 dias
• A Data Inicial não pode ser posterior à Data Final

Fornecedor

OPCIONAL

Filtra por razão social ou CNPJ/CPF do fornecedor.

Local de Pesquisa

OPCIONAL

Define onde buscar os documentos. A escolha aqui impacta quais filtros de status ficam disponíveis — veja detalhes abaixo.

Status Conferência

OPCIONAL

Filtra pela situação geral do documento. Disponível apenas quando o Local de Pesquisa não for "Repositório" (11.3.2).

Status 749-DP / 749-CC / 749-RT / 1007

OPCIONAL

Filtra pela situação individual de cada bloco.

Observação

OPCIONAL

Filtra documentos por texto de observação vinculado.

Regra de obrigatoriedade condicional — Nº Documento ou Período

O sistema exige que pelo menos um destes dois filtros esteja preenchido antes de pesquisar:

  • Nº Documento — para localizar uma nota específica pelo número

  • Período de Datas (Data Inicial + Data Final) — para listar documentos dentro de um intervalo

Ambos podem ser usados ao mesmo tempo para refinar ainda mais a busca. O sistema exibe o aviso "Preencha o Nº Documento ou o Período de Datas" caso nenhum dos dois esteja informado.

Regras de validação do Período de Datas

Quando o Período de Datas for utilizado, duas regras adicionais são verificadas automaticamente pelo sistema:

  • Intervalo máximo de 10 dias — a diferença entre Data Inicial e Data Final não pode ultrapassar 10 dias. Para consultar períodos maiores, realize pesquisas separadas por intervalos de até 10 dias.

  • Ordem das datas — a Data Inicial não pode ser posterior à Data Final.

Impacto do filtro "Local de Pesquisa" nos demais filtros

O campo Local de Pesquisa determina de onde os documentos serão buscados, e isso afeta diretamente quais filtros de status ficam habilitados.

  • Rotina 11.3.2 - SAAM (P/novos lançamentos): Exibe novos documentos ainda não processados e não lançados na rotina.

  • Documentos processados na Rotina: Exibe documentos que já foram realizados lançamentos/edições através da rotina.


4.2 Colunas da grade de documentos

Os resultados são exibidos em uma grade com duas visualizações disponíveis: compacta (padrão) e detalhada.

Modo compacto — colunas principais:

Coluna

O que mostra

Coluna

O que mostra

Status Conferência

Situação geral do documento com badge colorido e ícone + campo de observação logo abaixo

Lançamentos

Badges individuais de cada bloco: DP, CC, RT, 1007, cada um com sua cor de status

Documento

Tipo, número e filial do documento

Fornecedor

Razão social, tipo de parceiro e CNPJ/CPF

Tipo Lançamento

Provisório ou Confirmado

Datas

Data de emissão, lançamento e pagamento

Valores

Valor bruto, retenções e valor líquido a pagar

Ações

Botões: Visualizar, Editar, Gerar PDF, Remover

Modo detalhado — colunas adicionais:

Coluna extra

O que mostra

Coluna extra

O que mostra

Tipo de Serviço

Classificação da operação: Mercadoria, Serviço, Frete etc.

Vencimentos

Primeiras datas de vencimento das parcelas (clique em "..." para ver todas)

Forma de Pagamento

Modalidade, data e se é parcelado

Origem

Badge indicando se o documento veio de XML (verde) ou foi inserido Manualmente (amarelo)

4.3 Status Conferência — indicadores visuais

A coluna Status Conferência mostra, com badge colorido, a situação geral do documento no fluxo de lançamento:

Status

O que significa

Status

O que significa

DISPONÍVEL PARA LANÇAMENTO

Nota disponível na fila, ainda não iniciada pelo operador

EM PROCESSAMENTO

Lançamento em andamento — algum bloco está em conferência ou aguardando aprovação

AVISO

Lançamento processado, mas com uma ou mais inconsistências que requerem atenção antes de prosseguir

PROBLEMA

Ocorreu um erro durante o processamento ou envio.

CONCLUÍDO

Lançamento finalizado e registrado com sucesso no Winthor

4.4 Campo Observação

Logo abaixo do badge de Status Conferência, aparece o campo Observação, que detalha a situação específica do documento. A cor do texto e da borda da observação muda conforme o seu conteúdo:

Observação

Cor

Significado

Observação

Cor

Significado

Inserida no Winthor

VERDE

Nota gravada com sucesso nas tabelas do Winthor

Pendente de aprovação / Integrado parcialmente

AZUL

Documento aguardando aprovação em alguma alçada ou integrado apenas em parte

Já presente no Winthor

ÂMBAR

Documento já existe no Winthor — verifique se é duplicidade antes de prosseguir

À integrar com o Winthor / Enviar para o Winthor

ROXO

Documento pronto e aguardando envio ao ERP

Cancelado no Winthor

VERMELHO

Documento cancelado no Winthor — nenhuma ação de lançamento possível

Lançado via Winthor (sem fluxo SAAM)

AZUL ESCURO

Documento lançado diretamente no Winthor, fora do fluxo do Facilitador

4.5 Badges de blocos — DP, CC, RT e 1007

Na coluna Lançamentos, cada bloco exibe seu próprio badge colorido de forma independente:

Cor do badge

Situação do bloco

Cor do badge

Situação do bloco

VERDE

Bloco aprovado / concluído

AZUL

Bloco em conferência, processamento ou já lançado aguardando próxima etapa

CINZA

Bloco pendente — ainda não foi preenchido ou não se aplica

4.6 Seleção de documentos em lote

A grade suporta seleção múltipla via checkbox. Após selecionar os documentos desejados, o botão de "Processamento em Lote" fica habilitado, podendo realizar ações, como processar, aprovar ou gravar no Winthor todos os selecionados de uma só vez.


5. Tela de Lançamento

5.1 Como acessar

Clique em qualquer documento na grade de pesquisa para abrir a Tela de Lançamento. Os dados fiscais do XML já aparecem carregados automaticamente.

A tela é organizada em abas conforme os blocos funcionais. As abas visíveis dependem das permissões de cada usuário.

5.2 Aba 1007 — Dados Fiscais

Exibe as informações da nota fiscal extraídas automaticamente do XML. Normalmente não requer edição — funciona como referência e conferência para o operador.

Informações disponíveis:

  • Número, série e chave de acesso da NF-e

  • CFOP da operação e datas de emissão e entrada

  • Dados do fornecedor: CNPJ, razão social e endereço

  • Itens da nota: descrição, quantidade, valor unitário, valor total, NCM e CFOP por item

  • Tributos: PIS, COFINS, ICMS

  • Valor total, desconto, frete e outras despesas acessórias

Qualquer divergência nos dados da aba 1007 deve ser investigada na origem do XML antes de prosseguir com o lançamento.

5.3 Aba 749-DP — Dados de Pagamento

Concentra as informações financeiras do título: como e quando o pagamento será realizado.

Campos principais:

Campo

Descrição

Campo

Descrição

Tipo de Lançamento

Provisório: reserva o valor sem comprometer o caixa definitivamente. Confirmado: lançamento definitivo, registrado como obrigação firme

Forma de Pagamento

Modalidade: boleto, transferência, PIX, cheque etc. (conforme tipos ativos nas Configurações)

Conta de Débito

Conta contábil que será debitada pelo valor do documento

Parcelas

Grade de parcelas com data de vencimento e valor de cada prestação

Gerador automático de parcelas:

Informe o número de parcelas, a data do primeiro vencimento e o intervalo em dias. O sistema distribui os valores automaticamente, ajustando centavos na última parcela para que a soma seja exata.

Se a configuração "Preencher com último lançamento" estiver ativa, forma de pagamento e conta de débito são sugeridos automaticamente com base no histórico do fornecedor.

5.4 Aba 749-CC — Centro de Custo

Permite distribuir o valor do documento entre diferentes centros de custo.

Como funciona:

  • Adicione uma ou mais linhas informando Centro de Custo + Percentual ou Valor

  • A soma dos percentuais deve ser exatamente 100% — o sistema valida e bloqueia a confirmação caso contrário

  • Múltiplas linhas por título são suportadas, permitindo rateio entre quantos centros forem necessários

Atenção: o lançamento não pode ser confirmado enquanto o rateio não totalizar 100%. Verifique o total exibido na parte inferior da grade antes de avançar.

5.5 Aba 749-RT — Retenções Tributárias

Configure as retenções que incidem sobre o documento conforme a natureza da operação.

Retenções disponíveis:

Retenção

Descrição

Retenção

Descrição

IRRF

Imposto de Renda Retido na Fonte — pagamentos de serviços conforme tabela da Receita Federal

INSS

Contribuição Previdenciária — prestadores sujeitos à retenção

PIS

Retenção na fonte de PIS

COFINS

Retenção na fonte de COFINS

CSRF

PIS + COFINS + CSLL agregados — pagamentos a pessoas jurídicas acima do limite legal

SEST/SENAT

Específico para contratação de serviços de transporte autônomo

Como configurar uma retenção:

  1. Confirme ou ajuste a alíquota aplicável

  2. O sistema calcula o valor da retenção automaticamente

  3. O valor líquido a pagar é atualizado

5.6 Botões de ação

Botão

Botão