Resumo:
1. O XML Conecta permite habilitar empresas para captura de NFe, NFCe, NFSe e CTe.
2. É necessário login, módulo contratado, município válido e certificado A1 correspondente ao CNPJ.
3. NFe de saída e NFCe exigem XML de nota de partida, uma por série.
4. Pendências podem ser resolvidas na listagem, e a captura ocorre diariamente ou mediante execução manual.
🎯 Pré-requisitos
- Possuir conta de relacionamento no Connectcont (link para uma nova aba);
- Efetuar o login no Contmatic nuvem (link para uma nova aba).
- Ter o módulo XML Conecta contratado.
1. Antes de começar
Reúna o que será pedido durante a habilitação:
Item |
Observação |
| Certificado A1 da empresa | Um por empresa. O certificado precisa ser do mesmo CNPJ da empresa |
| Senha do certificado | — |
| Notas de partida | O arquivo XML de uma nota emitida nos últimos 40 dias. Obrigatórias para NFe de saída e NFCe, uma por série |
A empresa precisa ter um município válido cadastrado no G5. Sem isso, a habilitação é bloqueada.
2. Habilitar a empresa
Primeiramente, se certifique que você atende aos Pré-requisitos citados anteriormente. Caso sim, prossiga com a leitura abaixo:
No menu lateral do Web Contmatic, acesse XML Conecta e abra a aba Habilitar Empresas. Clique em Habilitar nova empresa para abrir o assistente.
O assistente tem quatro etapas:
Etapa |
O que você faz |
| 1 · Empresa e Tipos | Selecione a base, busque a empresa e marque os tipos de nota a capturar |
| 2 · Certificado A1 | Envie o arquivo .pfx e informe a senha. O sistema valida a senha e o titular |
| 3 · Nota de Partida | Informe as notas de partida — aparecem apenas os tipos marcados na etapa 1 |
| 4 · Revisão | Confira o resumo, os alertas e as dependências de cada tipo, e conclua |
A etapa 2 é obrigatória para avançar: sem certificado válido, o assistente não segue.
2.1.
Etapa 1: Empresa e tipos
Primeiro selecione a base e busque a empresa. Depois marque os tipos de nota, que aparecem com a direção e a cobertura de cada um:
Tipo |
O que é capturado |
| NFe | Entrada e Saída · todo o Brasil |
| NFCe | Apenas Saída · BA, GO, MG, PB, RJ, SC, SP |
| NFSe | Tomada e Prestada |
| CTe / CTeOS | Apenas Entrada |
Marque apenas os tipos que a empresa realmente emite ou recebe. Você pode alterar os tipos depois, pelo modal Configurar Tipos de Notas.
2.2.
Etapa 2: Certificado A1
Envie o arquivo .pfx e informe a senha. O XML Conecta valida a senha e confere se o titular do certificado é a própria empresa.
Certificado de CNPJ diferente é recusado.
2.3.
Etapa 3: Nota de partida
A nota de partida é o ponto de partida da numeração: ela diz ao XML Conecta a partir de qual nota começar a buscar.
Você não digita nada — envia o arquivo XML de uma nota que a empresa já emitiu. O sistema lê do próprio arquivo o tipo, a série, o número e a data.
O assistente mostra apenas os tipos marcados na etapa 1. Se nenhum deles exigir nota de partida, a etapa informa isso e você segue direto.
2.3.1. Só para as notas que a empresa emite
Precisa de nota de partida |
Não precisa |
| NFe de saída | NFe de entrada |
| NFCe (que só existe como saída) | NFSe, tomada e prestada |
| — | CTe / CTeOS |
A nota de partida vale apenas para as notas que a sua empresa emite.
O motivo é simples: ela marca um ponto na numeração da própria empresa. Notas de entrada são emitidas por terceiros, cada um com a sua própria numeração — não há sequência sua para marcar.
Por isso a NFe gera duas situações independentes na mesma empresa: a entrada começa a capturar de imediato, e só a saída fica aguardando a nota de partida.
2.3.2. Como enviar
-
Passo 1: Arraste os arquivos
.xmlpara a área indicada, ou clique em Escolher arquivo. - Passo 2: Confira o que foi aceito — o assistente mostra o tipo e a série lidos de cada arquivo.
- Passo 3: Repita para cada série que a empresa utiliza.
Você pode enviar até 10 arquivos por vez, e arrastar mais depois.
A área continua disponível após o primeiro envio.
2.3.3. O que o sistema aceita
| Regra | Detalhe |
| Formato | Arquivo .xml da nota |
| Tipo | Somente NFe e NFCe |
| Prazo | Emitida nos últimos 40 dias |
| Empresa | O XML precisa ser da própria empresa |
| Quantidade | Uma por série |
O prazo de 40 dias conta a partir da data de emissão da nota. Uma nota emitida há 41 dias é recusada.
XML de CTe ou de NFSe não serve como nota de partida — esses tipos não exigem nenhuma.
A recusa é por arquivo, não pelo conjunto. Se você enviar 5 arquivos e 2 tiverem problema, os 3 válidos entram — e cada recusa informa o nome do arquivo e o motivo.
2.3.4 Uma por série
Se a empresa emite em mais de uma série, é preciso uma nota de partida para cada.
Enquanto faltar a de qualquer série, a coluna Nota de partida, na listagem, continua como Pendente — e as séries sem nota não são capturadas.
2.4.
Etapa 4: Revisão e conclusão
A última etapa mostra o Resumo da habilitação — a empresa, o certificado e as notas de partida enviadas — e, abaixo, as dependências por tipo de nota.
Coluna |
O que informa |
| Tipo | O documento, com a NFe separada em Entrada e Saída |
| Serviço de captura | A direção capturada e, quando houver, as séries a baixar |
| Certificado A1 | Se a empresa já tem certificado vinculado |
| Nota de partida | Quantas séries foram enviadas, ou Não necessária |
| Status | Se aquele tipo está Pronto para captura |
🎯 A NFe aparece em duas linhas, e é aqui que isso fica visível: a Entrada marca Não necessária na nota de partida e já fica pronta, enquanto a Saída mostra as séries enviadas. São duas dependências diferentes no mesmo tipo.
CTe / CTeOS e NFSe também aparecem como Não necessária — nenhum dos dois exige nota de partida.
Confira o resumo e clique em Habilitar empresa.
2.5
Deixar para depois
As etapas 2 (Certificado A1) e 3 (Nota de partida) podem ser adiadas. A empresa é habilitada do mesmo jeito — mas a captura não começa inteira.
🎯 As duas pendências têm efeitos bem diferentes, e essa é a parte que mais importa:
O que você adiou |
O que para |
O que continua |
| Certificado A1 | Tudo. Nenhum tipo é capturado. | Nada |
| Nota de partida | Apenas NFe de saída e NFCe | NFe de entrada, NFSe e CTe / CTeOS capturam normalmente |
O certificado é a credencial de todas as buscas. Sem ele, a empresa fica com a situação Pendente A1 e nenhum tipo é capturado — nem os que não dependem de nota de partida.
Já a nota de partida é o ponto de partida da numeração. Sem ela, só os dois tipos que dependem de numeração ficam aguardando.
Se você tem o certificado em mãos mas ainda não tem a nota de partida, vale concluir a habilitação assim mesmo: a captura de entradas, serviços e CTe começa de imediato, e você envia a nota de partida depois.
2.6.
Onde a pendência aparece
Na última etapa, o resumo mostra a situação de cada tipo:
Situação |
O que significa |
| Pronto para captura | O tipo começa a capturar na próxima execução |
| Aguardando nota de partida | Falta enviar a nota de partida daquele tipo |
| Bloqueado | Falta o certificado A1 — vale para todos os tipos |
Compare com o resumo da seção 2.4. É a mesma tela, com as duas dependências adiadas: os alertas aparecem acima do resumo, e todos os tipos ficam Bloqueado — inclusive os que não dependem de nota de partida, porque o certificado é a credencial de todas as buscas.
Depois de concluída, a pendência continua visível na listagem de Habilitar Empresas, nas colunas Certificado A1 e Nota de partida.
3. A listagem de Habilitar empresas
Depois de habilitada, a empresa passa a constar na listagem da aba Habilitar empresas. É daqui que você acompanha o que falta em cada uma - e resolve, sem precisar refazer a habilitação.
🎯 A listagem é a tela do dia a dia. O assistente você usa uma vez por empresa; esta você abre sempre que quiser saber o que está pendente.
3.1.
O que cada coluna mostra
Coluna |
O que responde |
| Empresas | Razão social e CNPJ da empresa |
| Status A1 | Se a empresa tem certificado digital válido |
| Habilitada | Se a empresa está ativa para captura |
| Tipos habilitados | Quais tipos de nota foram marcados |
| Nota de partida | Enviada, pendente ou não necessária |
| Total notas | Quantas notas foram capturadas no mês vigente |
| Ações | Os atalhos para resolver cada pendência |
Cada coluna responde uma pergunta só. O estado do certificado vive apenas na coluna Status A1; o da nota de partida, apenas na coluna de mesmo nome. Se a empresa está sem certificado, é o Status A1 que avisa — a coluna Nota de partida continua mostrando o estado real da nota dela.
Os filtros da barra superior combinam. Filtrar Status A1 = Sem A1 junto com Nota de partida = Pendente mostra de uma vez as empresas às quais falta tudo.
3.2.
As ações de cada linha
Na coluna Ações, cada ícone resolve uma pendência. Passe o mouse sobre ele para ver o que faz.
| Ação | Para que serve |
| Gerenciar certificado A1 | Leva à aba Certificado A1, já filtrada naquela empresa |
| Nota de partida | Abre o modal para enviar, consultar e remover notas de partida |
| Configurar tipos de nNotas | Ativa e desativa tipos de nota da empresa |
| Excluir empresa | Remove a empresa — ver a seção 5 |
Ícone esmaecido significa que a ação não se aplica àquela empresa. O tooltip explica o motivo.
3.3.
Resolver a pendência de certificado
Clique em Gerenciar certificado A1 na linha da empresa. Você vai para a aba Certificado A1 já filtrada nela — sem precisar procurar na lista.
Lá, envie o arquivo .pfx e a senha, como na habilitação.
Para voltar a ver todas as empresas na aba Certificado A1, use o ícone de limpar filtros, na barra superior.
3.4.
Resolver a pendência de nota de partida
Clique em Nota de partida na linha da empresa. O modal mostra as notas já enviadas e permite enviar ou remover.
O modal exibe apenas os tipos habilitados daquela empresa. Se nenhum dos tipos marcados exigir nota de partida, ele informa isso — você não precisa fazer nada.
A nota de partida é uma por série. Enquanto faltar a de qualquer série, a coluna Nota de partida continua como Pendente.
O detalhe por série fica no modal: a coluna responde apenas falta alguma?.
3.5.
Alterar os tipos de nota
Clique em Configurar tipos de notas na linha da empresa. No modal você ativa e desativa tipos, e vê o histórico das alterações.
Ativar um tipo pode criar uma pendência nova. Se você ativar NFe ou NFCe numa empresa que não os tinha, a coluna Nota de partida passa a cobrar a nota daquele tipo.
4. Quando a captura começa
A captura passa a funcionar na próxima execução automática, que acontece uma vez por dia, de madrugada. Isso vale tanto para a habilitação inicial quanto para uma pendência que você acabou de resolver.
Acompanhe o resultado no Painel e na aba Monitoramento.
Não precisa esperar até a madrugada. Na aba Monitoramento, o botão Forçar execução agora antecipa a busca — útil logo depois de habilitar a primeira empresa, para conferir que está tudo certo.
A própria tela de revisão do assistente lembra disso, no rodapé.
5. Excluir uma empresa
A exclusão só fica disponível quando a empresa não tem nenhuma nota capturada.
Se a empresa já tem notas, o ícone de exclusão não aparece.
Perguntas frequentes
1. Posso usar o mesmo certificado para várias empresas?
Não. Cada empresa exige o seu próprio certificado A1, do mesmo CNPJ.
2. Não consigo habilitar a empresa. O que verificar?
Verifique se a empresa tem município válido cadastrado no G5. Sem município válido, a habilitação é bloqueada.
3. Marquei os tipos errados. Posso mudar?
Sim. Use o modal Configurar Tipos de Notas, na aba Habilitar Empresas.
4. Não vejo o botão para excluir a empresa.
A exclusão só aparece quando a empresa não tem nenhuma nota capturada.
5. Habilitei a empresa. Quando as notas aparecem?
A captura acontece uma vez por dia, de madrugada. As notas podem levar até 5 dias para aparecer após a emissão.
6. Preciso de nota de partida para todos os tipos?
Não. A nota de partida é obrigatória apenas para NFe de saída e NFCe, uma por série.
Ela vale só para as notas que a sua empresa emite — notas de entrada, NFSe e CTe não precisam.
6.1. Por que a nota de entrada não precisa de nota de partida?
Porque a nota de partida marca um ponto na numeração da sua empresa. Notas de entrada são emitidas por terceiros, cada um com a sua numeração — não há sequência sua para marcar.
Por isso, numa empresa com NFe marcada, a entrada começa a capturar de imediato e só a saída fica aguardando.
6.2. O que eu envio: o número da nota ou o arquivo?
O arquivo XML de uma nota que a empresa já emitiu. O sistema lê o tipo, a série, o número e a data do próprio arquivo — você não digita nada.
6.3. Minha nota foi recusada. Por quê?
Os motivos mais comuns:
o arquivo não é .xml;
a nota não é NFe nem NFCe;
a nota foi emitida há mais de 40 dias;
o XML é de outro CNPJ;
aquela série já tem nota de partida.
A mensagem informa o nome do arquivo e o motivo específico.
6.4. Minha empresa emite em várias séries. Preciso de uma para cada?
Sim, uma por série. Enquanto faltar a de qualquer série, a coluna Nota de partida fica como Pendente — e as séries sem nota não são capturadas.
7. Posso habilitar a empresa sem o certificado e enviar depois?
Pode. A empresa fica com a situação Pendente A1.
⚠️ Mas atenção: sem certificado, nenhum tipo é capturado — nem os que não dependem de nota de partida. O certificado é a credencial de todas as buscas.
8. E se eu deixar só a nota de partida para depois?
Aí a captura começa parcialmente. NFe de saída e NFCe ficam aguardando; NFe de entrada, NFSe e CTe / CTeOS capturam normalmente.
9. Habilitei com pendência. Como resolvo depois?
Pela listagem de Habilitar Empresas, na coluna Ações da linha da empresa:
Gerenciar Certificado A1 — leva à aba Certificado A1 já filtrada naquela empresa;
Nota de Partida — abre o modal para enviar a nota.
Em ambos os casos, a captura começa na execução automática seguinte.
10. Como vejo rapidamente quais empresas estão pendentes?
Use os filtros da listagem. Status A1 mostra quem está sem certificado; Nota de partida mostra quem está sem a nota. Os dois combinam.
11. Preciso refazer a habilitação para corrigir uma pendência?
Não. Tudo se resolve pelos ícones da coluna Ações, na própria listagem. O assistente é usado uma vez por empresa.
12. A empresa está sem certificado e a coluna Nota de partida diz "Pendente". Qual eu resolvo primeiro?
O certificado. Sem ele, nenhum tipo é capturado — a nota de partida só passa a fazer diferença depois que o certificado estiver vinculado.
As duas colunas mostram o estado real de cada dependência, de forma independente.
13. Concluí a habilitação e nenhuma nota apareceu. Por quê?
A causa mais comum é certificado pendente. Confira a coluna Certificado A1 na listagem: se estiver como Pendente A1, a captura está bloqueada para todos os tipos daquela empresa.
Relativo a