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
Pesquisa: o operador localiza as notas pendentes usando filtros avançados
Lançamento: os dados do XML são carregados automaticamente; o operador preenche parcelas, retenções e centro de custo
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 |
|---|---|
| Lançamentos contábeis |
| Notas fiscais de entrada |
| Base de dados de notas fiscais |
| PIS/COFINS das notas fiscais |
| 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 |
|---|---|---|
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|---|
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: |
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|---|
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 |
|---|---|
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 |
|---|---|
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 |
|---|---|
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:
Confirme ou ajuste a alíquota aplicável
O sistema calcula o valor da retenção automaticamente
O valor líquido a pagar é atualizado
5.6 Botões de ação
Botão |
|---|