Emissão de notas fiscais dos modelos 06, 21 e 22, destinadas a prestadores de serviços cujas atividades se enquadram nos segmentos de energia elétrica, comunicação ou telecomunicação.
Modelos suportados
- Modelo 06 – Nota Fiscal/Conta de Energia Elétrica. Utilizada por distribuidoras de energia para registrar consumo, tarifas, tributos e informações relacionadas ao fornecimento.
- Modelo 21 – Nota Fiscal de Serviço de Comunicação. Utilizada por provedores de internet, rádio, TV, serviços multimídia, transmissão de anúncios, entre outros.
- Modelo 22 – Nota Fiscal de Serviço de Telecomunicação. Utilizada por empresas de telefonia fixa ou móvel, VoIP, serviços de voz, dados e outros meios de transmissão de sinal.
Fluxo de emissão
- Transmissão individual ou em lote das notas - ficam armazenadas internamente.
- Geração do arquivo magnético consolidado do período.
- Validação externa do arquivo no validador oficial da SEFAZ, que realiza a transmissão final ao ambiente fiscal da UF.
Formas de envio
- Individual – uma nota por requisição, ideal para fluxo contínuo.
- Lote – múltiplas notas por requisição, ideal para integrações periódicas.
Nota: A transmissão oficial à SEFAZ não é feita pela API - ela apenas gera o arquivo magnético, que deve ser processado pelo validador oficial. O validador pode ser obtido em: https://portal.fazenda.sp.gov.br/servicos/nf-comunicacao-energia/Paginas/Downloads.aspx
Transmitir NFCom
Transmite uma nota dos modelos 06, 21 ou 22 para armazenamento interno, preparando-as para a posterior geração do arquivo magnético exigido por cada UF.
Como funciona na API
Cada requisição recebe uma nota. Para várias notas, faça uma chamada por nota, ou gere o arquivo direto da lista de notas em Gerar Arquivo Magnético (tipoGeracao: 2).
A cada nota recebida, o sistema:
- Valida os campos obrigatórios para cada modelo.
- Verifica regras específicas de energia, comunicação e telecomunicação.
- Armazena os dados para composição futura do arquivo magnético.
- Retorna a aceitação da nota (
status,erroseavisos).
Nota: A transmissão aqui é apenas interna - a consolidação no arquivo magnético oficial é feita separadamente pelo endpoint Gerar Arquivo Magnético, e a transmissão definitiva à SEFAZ ocorre fora da API (validador externo), conforme descrito na visão geral da seção.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Transmitir NFCom › Request Body
modeloDocumentoModelo do Documento
Valores Possíveis:
6: Energia elétrica
21: Comunicação
22: Telecomunicação
tipoAmbienteTipo de ambiente (Somente no envio individual)
Valores Possíveis:
1: Produção
2: Homologação
identificadorInternoCódigo de controle interno único da venda. Evita duplicidades, caso configurado.
serieSérie da nota fiscal. Quando não informado é controlado pelo Painel
numeroNúmero da nota fiscal. Quando não informado é controlado pelo Painel
situacaoSituação do documento (Padrão 4)
Valores Possíveis:
1: documento fiscal cancelado dentro do mesmo período de apuração
2: documento fiscal emitido em substituição a um documento fiscal cancelado dentro do mesmo período de apuração
3: documento fiscal complementar
4: demais casos
valorTotalFaturaValor total da fatura comercial
dataEmissaoData de emissão do documento
Campos específicos para Documentos de Comunicação (modelo 21/22)
Campos específicos para Documentos de Energia Elétrica (modelo 6)
Dados do destinatário do documento fiscal.
Lista de produtos/itens da nota fiscal
Transmitir NFCom › Responses
Successful operation
statusStatus do Lançamento. Indica sucesso (true) ou falha (false) da operação.
base64ZipArquivo magnético compactado (.zip) em Base64. Preenchido somente em Gerar Arquivo Magnético.
Lista de erros contendo informações detalhadas em caso de falha.
avisosLista de avisos ou mensagens de alerta que não impedem o processamento, mas merecem atenção.
Gerar Arquivo Magnético
Este método permite gerar e obter o arquivo magnético de transmissão referente às notas fiscais dos modelos 06, 21 e 22. O arquivo retornado deve ser utilizado no validador externo fornecido pela Secretaria da Fazenda, que é responsável pela validação e transmissão final para o ambiente fiscal da UF.
Como funciona
A API consolida todas as notas previamente transmitidas (individualmente ou em lote), organiza os registros conforme o layout oficial e gera um arquivo compactado (.zip) contendo todos os dados necessários para transmissão.
O arquivo retornado pelo endpoint está codificado em Base64, permitindo seu download e envio ao validador de forma segura.
Validação externa
A transmissão definitiva das informações não é feita pela API. O arquivo .zip deve ser importado no validador oficial da SEFAZ, responsável por:
- Validar estrutura e conteúdo do arquivo magnético;
- Emitir mensagens de erro, aviso ou aceite;
- Realizar a transmissão ao ambiente fiscal da UF.
O validador pode ser obtido no portal da Secretaria da Fazenda:
https://portal.fazenda.sp.gov.br/servicos/nf-comunicacao-energia/Paginas/Downloads.aspx
O que é retornado?
- Um arquivo .zip em Base64, contendo os registros montados conforme o layout oficial.
Nota: Este endpoint não realiza a transmissão para a SEFAZ; ele apenas gera o arquivo magnético que deve ser processado pelo validador externo.
Headers
TokenToken de identificação da empresa. Obrigatório em todas as operações fiscais (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e, Consultas, Escriturações, Energia e Comunicação) e nos métodos da seção Empresas que atuam sobre uma empresa específica (Buscar, Editar, Alterar Certificado, Verificar Certificado, Gerar Link de Ativação, Deletar, Consultar Numeração, Atualizar Numeração). Não é exigido em Adicionar nem em Buscar Todas.
Gerar Arquivo Magnético › Request Body
tipoGeracaoTipo de geração de arquivo
tipoAmbienteTipo de ambiente
mesMês de emissão das notas
anoAno de emissão das notas
Notas Fiscais de Energia, Comunicação e Telecomunicações
Gerar Arquivo Magnético › Responses
Successful operation
statusStatus do Lançamento. Indica sucesso (true) ou falha (false) da operação.
base64ZipArquivo magnético compactado (.zip) em Base64. Preenchido somente em Gerar Arquivo Magnético.
Lista de erros contendo informações detalhadas em caso de falha.
avisosLista de avisos ou mensagens de alerta que não impedem o processamento, mas merecem atenção.