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 ou mais notas 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
O endpoint aceita dois formatos de envio:
- Envio Individual – uma nota por requisição, ideal para fluxo contínuo.
- Envio em Lote – múltiplas notas por requisição, ideal para integrações periódicas ou alto volume.
Em ambos os casos, 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 informações sobre aceitação e estrutura do lote/nota.
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.
base64ZipBase64 contendo o arquivo em zip.
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.
base64ZipBase64 contendo o arquivo em zip.
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.