Faturamento
⭐ Destaque
v2.0
12.1.x
Importação NFS-e Nacional (ABRASF)
Importa NFS-e no padrão nacional, gera Pedido de Vendas e NF de saída automaticamente. Compatível com múltiplos municípios.
⚙️ Como funciona
1
Aponte o diretório dos XMLs
Ao executar o fonte, uma tela de parâmetros permite informar o caminho da pasta onde estão os arquivos XML das NFS-e. O sistema lê automaticamente todos os
.xml do diretório.
2
O sistema analisa e valida cada XML
Cada arquivo é parseado, o CNPJ/CPF do tomador é localizado na SA1, o CNPJ do emitente é validado contra o CNPJ da empresa no SM0, e duplicidades são detectadas automaticamente.
3
Selecione as notas para importar
Os XMLs válidos aparecem em um browse com cliente, número e série. Você marca individualmente ou seleciona todos de uma vez e confirma a importação.
4
Preencha os dados do Pedido de Vendas
Para cada nota, uma tela solicita produto, natureza de operação, condição de pagamento, centro de custo, vendedor e outros dados do PV. Os campos já vêm pré-preenchidos com os valores configurados nos parâmetros SX6.
5
PV e NF de saída gerados automaticamente
O fonte executa o MATA410 para criar o Pedido de Vendas, libera o item, gera a Nota Fiscal de saída via MaPvlNfs com o número exato da NFS-e, e move o XML para a pasta
Importados\. Tudo em sequência, sem intervenção manual.
📦 O que está incluído
Arquivo .prw completo
Código-fonte ADVPL comentado, organizado e sem hardcode. Pronto para compilar e usar.
Documentação em PDF
Guia de instalação, lista de campos customizados, parâmetros SX6 e perguntas frequentes.
Suporte por e-mail — 30 dias
Dúvidas de instalação e configuração respondidas diretamente por quem desenvolveu o fonte.
Acesso imediato via Hotmart
Após a confirmação do pagamento, o acesso ao download é liberado automaticamente pela plataforma.
🔧 Especificações técnicas
Linguagem
ADVPL
Versão mínima Protheus
12.1.33
Padrão NFS-e
ABRASFDPS / infNFSeNacional
Multi-empresa
✓ Sim
Protheus Cloud (SaaS)
✓ Sim
Hardcode
✓ Zero — tudo via SX6
Rotinas utilizadas
MATA410MaPvlNfsMaLibDoFatMaLiberOk
Compatibilidade municipal
Qualquer município que exporte XML no padrão ABRASF
🗂️ Campos customizados necessários
Os campos abaixo precisam ser criados via ATUSX antes de compilar o fonte. Todos estão documentados no PDF que acompanha a compra.
C5_XNUMDOC
SC5 · C
Número da NFS-e — vincula o PV à nota fiscal de serviço
C5_XCODVER
SC5 · C
Código de verificação / ID da NFS-e (tag <Id> do XML)
C5_XCADFOR
SC5 · C
Indicador para cadastrar o tomador como fornecedor (S/N)
C5_XNUMMT
SC5 · C
Número da MT para controle interno
C5_XOBRA
SC5 · C
Código da obra vinculada ao pedido de vendas
C5_XPVCHEI
SC5 · C
Indicador de PV cheio (S/N)
C5_INCISS
SC5 · C
Incluir ISS no documento (S/N)
C5_RECISS
SC5 · C
Tipo de retenção ISS — 1=Sem retenção / 2=Com retenção
CV_FORMAPG
SCV · C
Forma de pagamento vinculada ao pedido
A1_XFORMPG
SA1 · C
Forma de pagamento padrão do cliente — pré-preenche a tela de importação
⚙️ Parâmetros SX6
Todos os valores que antes eram hardcode no fonte agora são parâmetros SX6. Crie-os via CFGX017 ou diretamente no SX6.
MV_XNFSSERIE
C(3)
Série padrão para NFS-e importada
Ex: "K"
MV_XNFSPROD
C(15)
Código de produto padrão
Ex: "SERVICO"
MV_XNFSTES
C(3)
TES padrão para itens do PV
Ex: "593"
MV_XNFSCC
C(9)
Centro de custo padrão
Ex: "001"
MV_XNFSSED
C(10)
Natureza de operação padrão
Ex: "3007"
MV_XNFSVEND
C(6)
Código do vendedor padrão
Ex: "000001"
MV_XNFSCOND
C(3)
Condição de pagamento padrão
Ex: "030"
MV_XNFSDANFE
C(300)
CCs que exigem vínculo de DANFE
Ex: "301,126"
❓ Perguntas frequentes
O fonte funciona com NFS-e de qualquer prefeitura?
▼
Sim. O fonte foi desenvolvido seguindo o padrão nacional ABRASF, que é o layout exigido pelo Governo Federal para a NFS-e Nacional. Qualquer município que utilize esse padrão e permita exportar o XML é compatível de imediato, sem necessidade de ajuste.
Municípios que utilizam layouts próprios (anteriores à NFS-e Nacional) também podem ser atendidos — basta mapear as tags do XML daquela prefeitura e ajustar os nós de leitura no fonte. Esse processo é simples e está documentado no PDF que acompanha a compra.
Municípios que utilizam layouts próprios (anteriores à NFS-e Nacional) também podem ser atendidos — basta mapear as tags do XML daquela prefeitura e ajustar os nós de leitura no fonte. Esse processo é simples e está documentado no PDF que acompanha a compra.
Funciona em ambiente multi-empresa?
▼
Sim. O fonte utiliza as funções padrão
FWxFilial() e xFilial() do Protheus para todas as operações de banco de dados, garantindo isolamento correto entre empresas e filiais.
Funciona no Protheus Cloud (SaaS / Hosted)?
▼
Sim. O fonte não utiliza DLL, componentes externos ou caminhos fixos de servidor. Os diretórios são configuráveis pelo usuário na tela de parâmetros, compatível com os caminhos de rede do ambiente Cloud da TOTVS.
Preciso de alguma licença extra da TOTVS?
▼
Não. O fonte utiliza apenas rotinas nativas do módulo de Faturamento (MATA410, MaPvlNfs) que já fazem parte da sua licença existente. Não há necessidade de contratar nenhum módulo ou funcionalidade adicional.
O que acontece se a NFS-e já foi importada anteriormente?
▼
O fonte verifica automaticamente se já existe uma NF de saída com o mesmo número e série na SF2 antes de processar. Em caso positivo, exibe um aviso e pula o arquivo, evitando duplicidade.
Como é feita a entrega após a compra?
▼
A entrega é feita via Hotmart automaticamente após a confirmação do pagamento. Você recebe um e-mail com o link para download do arquivo
.prw e do PDF de documentação. O acesso fica disponível na sua conta Hotmart para downloads futuros.
Tem política de reembolso?
▼
Não. Por se tratar de um produto digital com entrega imediata de código-fonte, não há política de reembolso após a liberação do download. Em caso de dúvidas antes da compra, entre em contato pelo contato@bopro.com.br.