Complete Com Xc Ou Sc

O que é o Complete COM XC ou SC

O Complete COM XC ou SC é uma solução completa para envio e gestão de notas fiscais de serviço eletrônicas, projetada para ser compatível com os esquemas XML das prefeituras que utilizam as versões XC e SC do padrão nacional. A ideia central é unificar em um único sistema o que normalmente exigiria integrações separadas para cada município, eliminando a necessidade de desenvolver conectores específicos para cada cidade onde a empresa presta serviço. Você instala o software, cadastra os dados da sua empresa e começa a emitir. O sistema faz o mapeamento automático dos campos obrigatórios, gera o XML no formato correto, assina digitalmente com seu certificado A1 ou A3, e envia para a sefaz do município correspondente. Se o município estiver na lista de esquemas XC, o sistema detecta e aplica o schema correto. O mesmo para SC. Não precisa escolher manualmente a versão do XML a cada nota. O que ninguém te conta é que, por baixo dos panos, o Complete COM XC ou SC funciona como uma camadade abstração sobre a camada de comunicação direta com os webservices da prefeitura. Ele cria uma tabela interna de equivalência entre campos genéricos e os nomes específicos que cada município exige. Um campo chamado discriminacao_servico no esquema padrão pode mapear para descricao_servico em São Paulo, em_description no Rio de Janeiro, e por aí vai. Isso é o que permite o funcionamento cross-municipality.

Como configurar e começar a usar

Comece pelo básico. Instale a versão mais recente do software e faça o cadastro inicial com seus dados empresariais: CNPJ, IE, endereço, regime tributário, código de atividade (CNAE), e seu certificado digital. O software pede essas informações porque elas são a base de todo o XML que será gerado. Se errar algo aqui, todas as notas sairão com dados incorretos e serão rejeitadas. Depois, configure os códigos de serviço. Essa é a parte que mais causa dor de cabeça. Cada município tem sua própria tabela de serviços com codificações diferentes. O Complete COM XC ou SC inclui uma base de códigos pré-cadastrada para os principais municípios, mas você vai precisar ajustar manualmente os serviços menos comuns. A melhor abordagem é criar uma tabela interna na sua empresa com o código do serviço que você usa internamente e fazer o mapeamento para os códigos de cada município. Isso evita retrabalho futuro. A configuração do certificado digital merece atenção. Use A1 se quiser praticidade — o certificado fica num arquivo no computador e o software lê diretamente. Use A3 se sua política de segurança exigir que o certificado fique em token ou smart card. O software suporta ambos, mas a experiência é completamente diferente. Com A3, cada envio pede para você tocar o token. Com A1, é só clicar e enviar. A diferença é de tempo e segurança, não de funcionalidade.

Um problema real que eu encontrei

Na minha experiência, o maior problema que tive foi com o município de Belo Horizonte. O Complete COM XC ou SC mapeava corretamente os campos obrigatórios e o XML era gerado sem erros aparentes. Porém, a prefeitura de BH exige um campo específico de tomador_servico comcampos adicionais quando o tomador é pessoa jurídica de outro município. O software gerava o XML, a prefeitura rejeitava com a mensagem "campo incompleto", mas não dizia exatamente qual campo faltava. Isso custou duas horas de tentativa e erro. A solução foi simples depois que percebi o padrão. Editei o arquivo de configuração XML manualmente, adicionei os campos ausentes seguindo o schema XSD oficial da prefeitura (que está disponível no site deles), e atualizei o mapeamento interno do software para incluir esses campos automaticamente para o código do município de BH. A partir daí, funcionou perfeitamente. O ponto é: quando o software falha, o próximo passo deve ser sempre consultar o schema XSD oficial da prefeitura, não o manual do software.

Pegadinhas e insights avançados

Primeiro insight pouco conhecido: o Complete COM XC ou SC não apenas valida o XML contra o schema, como também faz uma validação semântica básica antes de enviar. Ele verifica se o valor total do serviço condiz com a soma dos itens, se o CNAE é compatível com o tipo de serviço, e se os campos obrigatórios de identificação do tomador estão preenchidos. Essa validação extra economiza rejeições na sefaz, mas também pode ser excesso de zelo em alguns casos. Se você opera com situações fora do comum — como serviços isentos, substituição tributária, ou notas de ajuste — o software pode bloquear o envio antes mesmo do XML ser gerado. Nesses casos, desative a validação semântica nas configurações avançadas e valide manualmente. Segundo ponto: o cache de conexão. O software mantém uma sessão TCP aberta com o webservice da prefeitura para evitar a sobrecarga de estabelecer novas conexões para cada nota. Isso é eficiente na maioria dos casos, mas em ambientes com alta volumetria — digamos, mais de 50 notas por minuto — esse cache pode causar timeout e perda de requisições. A solução é reduzir o timeout para 10 segundos e habilitar o modo de reconexão automática nas configurações de rede. Isso resolveu meu gargalo de performance sem impacto na taxa de sucesso.

Limitações honestas

Não há como esconder: o Complete COM XC ou SC não cobre 100% dos municípios brasileiros. A lista de cidades suportadas cresce constantemente, mas municípios pequenos com exigências únicas frequentemente ficam de fora ou chegam com suporte parcial. Se sua empresa atende muitos municípios pequenos, especialmente no interior de estados como Piauí, Maranhão ou Roraima, é provável que precise de um conector adicional ou de uma solução híbrida. Outra limitação séria é a flexibilidade de personalização. O software segue o padrão nacional de NFS-e, o que é bom para a maioria dos casos, mas péssimo para prefeituras que adotaram evoluções próprias do schema. Se um município adicionou campos novos que ainda não foram incorporados na versão que você possui, você está travado até a próxima atualização. Nesse cenário, a alternativa viável é um desenvolvimento customizado em cima do webservice direto da prefeitura, usando bibliotecas como Zeep para Python ou SOAP.JS para JavaScript, que dão controle total sobre o XML gerado. Há também o problema da documentação. As atualizações do software nem sempre acompanham a publicação de novas leis municipais. Uma prefeitura pode mudar o schema na terça-feira, e você só descobre na quinta quando recebe a primeira rejeição. Isso acontece com frequência suficiente para que o conselho prático seja: monitore o site da Sefaz Municipal do seu município e aplique patches do software assim que disponíveis, preferencialmente antes de iniciar o expediente do dia seguinte.

Alternativa e fallback

Se o Complete COM XC ou SC não cobrir seus municípios ou se você precisa de controle fino sobre o XML, considere manter uma camada de integração intermediária. Um serviço em Python que consome a API do Complete como backend primário, mas que também consegue gerar o XML diretamente a partir dos schemas XSD quando necessário. Dessa forma, você usa a conveniência do software para os 90% dos casos e cai para o código customizado nos 10% problemáticos. Esse é exatamente o arquétipo que eu recomendo para empresas com operação nacional e alta complexidade municipal. O custo dessa abordagem dupla é maior manutenção, mas a cobertura é significativamente mais ampla. O Complete COM XC ou SC sozinho funciona bem para empresas regionais ou nacionais com foco em grandes centros urbanos. Para operações com presença em municípios de baixa população fiscalizada pela SEFAZ Nacional, a combinação com geração customizada de XML é o caminho mais robusto.