Pular para o conteúdo principal
Novo: painel de lotes

O app tem um novo jeito de enviar e acompanhar lotes, num painel ao lado da lista de notas. Esta página descreve o envio anterior. Por enquanto, ele continua disponível, mas vai ser desligado no futuro, em data ainda a definir. Para ativar o painel e ver como ele funciona, consulte Painel de lotes.

Interface em atualização

O painel da NFE.io está recebendo uma nova interface e esta documentação está sendo atualizada junto. Alguns nomes de menus e telas podem estar diferentes do que você vê. Em caso de divergência, fale com o suporte.

Como emitir Nota Fiscal Eletrônica de Serviço em Lote

Aqui você entenderá melhor como emitir nota fiscal eletrônica de serviço (NFS-e) em Lote na nossa plataforma, explicado passo-a-passo.

📚 Novo na emissão de NFS-e? Recomendamos ler os conceitos sobre Nota Fiscal de Serviço antes de continuar.

Ao final desse tutorial, você será capaz de:​

  • Emitir notas fiscais de serviço eletrônica (NFS-e) em lote

Requisitos​

  1. Criar uma conta
  2. Criar uma empresa
  3. Ter Certificado Digital - Fazer upload na plataforma

A emissão é limitada a 50 linhas por planilha. Com a funcionalidade Emissão de NFS-e em Lote habilitada na assinatura, o limite passa a 1.000 linhas. Para habilitar, fale com o suporte pelo chat ou por [email protected].
Não há custo para essa solicitação.

1. Como emitir​

1.1 No menu lateral, clique em Empresas

1.2 No fim da linha da sua empresa, clique no botão de Ações (⋮) e, no grupo NFS-e, escolha Emitir NFS-e em lote.

1.3 Nesse passo a passo você encontrará as instruções necessárias para emitir suas notas fiscais utilizando o excel e como preencher os campos da planilha.

Passo a passo para emitir notas fiscais em lote

2. Passo a passo para montar sua planilha​

2.1 Você pode pular caso já saiba como emitir em lote, ou pode clicar em sim e dar continuidade.

2.2 Nessa etapa você deve escolher um dos modelos de planilha que disponibilizamos para realizar as emissões em lote. No modelo básico, os impostos são calculados automaticamente pelo nosso sistema e contém apenas os campos excênciais para a emissão das notas. No modelo avançado, você pode informar os dados de impostos retidos, alíquota de ISS entre outros campos. Os impostos serão calculados de acordo com as alíquotas que você informou.

💡 Dica: Se você não sabe qual código de serviço utilizar, consulte nosso guia Qual código de serviço devo utilizar?

2.3 Aqui você poderá baixar e aprender como preencher o modelo de planilha selecionado anteriormente.

2.4 Nessa etapa você já deve estar com a sua planilha corretamente preenchida. Para importá-la, arraste o arquivo para a área Arraste e solte a planilha aqui (ou clique nela para selecionar o arquivo) e depois clique em Importar. Nós iremos validar todas as informações nela contidas.

2.5 Aguarde um momento enquanto realizamos a validação dos dados. Se estiver tudo correto, você irá ver a seguinte mensagem "Planilha importada com sucesso!". Clique no botão IR PARA EMISSÃO para continuar com a emissão das suas notas.

3. Emitir em lote​

Nessa tela temos uma listagem com as notas fiscais de sua planilha. Aqui você poderá revisar as informações das notas, selecionar quais serão enviadas para emissão e acompanhar o status da sua emissão.

3.1 Para selecionar, clique na caixa de seleção na primeira coluna. Você poderá selecionar todas de uma vez clicando na primeira caixa de seleção ou poderá selecionar manualmente quais deseja.

3.2 Para emitir, clique no botão Emitir em lote e aguarde até que todas sejam emitidas.

Veja esse tutorial que montamos para você!

4. Planilha básica​

Veja abaixo algumas regras importantes para alguns campos específicos.

  • Codigo_Servico: código do serviço no município (cityServiceCode). Cada prefeitura possui sua própria tabela de códigos de serviço.
  • Codigo_Servico_Federal: código federal do serviço (federalServiceCode) conforme Lei Complementar 116 (máx. 5 caracteres). Saiba mais.
  • Descricao: descrição detalhada do serviço prestado (máx. 2000 caracteres).
  • NBS: código da Nomenclatura Brasileira de Serviços (máx. 9 dígitos). Campo obrigatório na API. Consulte a tabela de códigos NBS aqui.
  • CPF_CNPJ: pode ser preenchido no formato padrão ou somente números.
  • Email: caso queira enviar para mais de um email, basta separá-los com vírgula. (Ex: [email protected], [email protected]).
  • Valor: pode ser preenchido no padrão brasileiro ou americano. (Ex: 1.000,50 ou 1000.50).
  • Endereco_Pais: Sigla do País no padrão ISO 3166-1. (Ex: BRA, USA, ARG). Mais em Wikipedia - ISO 3166-1.
  • Endereco_Cep: pode ser preenchido no formato padrão ou somente números.
  • Data_competencia: a data de competência deve ser preenchida apenas para notas retroativas e deve seguir o seguinte formato: YYYY-MM-DD (ano-mês-dia).

⚠️ Importante: O nome de cada coluna na planilha deve ser exatamente igual ao descrito na coluna "Campo/Coluna" das tabelas abaixo. Qualquer diferença (espaços, acentos, maiúsculas/minúsculas diferentes) fará com que o sistema não reconheça o campo.

A coluna "Campo na API" é o caminho, no corpo da emissão (POST https://api.nfse.io/v2/companies/{company_id}/serviceinvoices), do campo que recebe o valor da coluna, para quem quiser comparar com a referência da API. O ponto separa os níveis do objeto (borrower.address.city.code é code dentro de city, dentro de address, dentro de borrower) e [] indica um item de lista. Nos grupos de documento de dedução e de reembolso, a planilha envia um único documento por nota; em Info_Adicional_Itens_Pedido, cada item separado vira um elemento da lista.

🎨 Convenção de cores dos cabeçalhos: na planilha, cabeçalhos em vermelho indicam campos obrigatórios em toda linha. Cabeçalhos em cinza indicam campos opcionais no nível da nota; alguns desses campos podem se tornar condicionalmente obrigatórios quando o grupo ao qual pertencem é utilizado (ex: Obra_Endereco_*, Deducao_Documento_*, Reembolso_Terceiros_Documento_*). Consulte as regras de cada grupo nas seções abaixo.

⚠️ Mantenha as células como Texto: os modelos oficiais já vêm com as colunas formatadas como Texto. Não sobrescreva esse formato ao colar dados (prefira Colar Especial → Valores) ou ao montar sua própria planilha. Caso contrário, o editor pode remover zeros à esquerda ou converter o valor (ex.: 05 vira 5), gerando erro na emissão.

Campos Obrigatórios (Planilha Básica)​

⚠️ Atenção: A obrigatoriedade das informações pode variar de prefeitura para prefeitura.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Codigo_ServicocityServiceCodeTexto livreCódigo do serviço no município. Cada prefeitura possui sua própria tabela de códigos.
DescricaodescriptionTexto livreDescrição detalhada do serviço prestado (máx. 2000 caracteres)
ValorservicesAmountNuméricoValor total do serviço. Ex: 1000.50 ou 1.000,50
NBSnbsCodeCódigo NBSCódigo da Nomenclatura Brasileira de Serviços (máx. 9 dígitos). Obrigatório em algumas cidades. Consulte a tabela de códigos NBS aqui.
CPF_CNPJborrower.federalTaxNumberCPF ou CNPJCPF ou CNPJ do tomador. Pode ser com ou sem formatação
Nomeborrower.nameTexto livreNome ou Razão Social do tomador
Endereco_Paisborrower.address.countryCódigo ISO 3166-1Sigla do país (ex: BRA, USA, ARG)
Endereco_Cepborrower.address.postalCodeCEPCEP do endereço. Com ou sem formatação
Endereco_Logradouroborrower.address.streetTexto livreNome da rua, avenida, etc.
Endereco_Numeroborrower.address.numberTexto livreNúmero do endereço
Endereco_Bairroborrower.address.districtTexto livreBairro do endereço
Endereco_Cidade_Codigoborrower.address.city.codeCódigo IBGECódigo IBGE da cidade (7 dígitos)
Endereco_Cidade_Nomeborrower.address.city.nameTexto livreNome da cidade
Endereco_Estadoborrower.address.stateUFSigla do estado (ex: SP, RJ, MG)

Campos Opcionais (Planilha Básica)​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
NCMncmCodeCódigo NCMCódigo NCM (Nomenclatura Comum do Mercosul) (máx. 8 caracteres). Usado para identificação de produtos/mercadorias.
Emailborrower.emailEmail(s)Email do tomador. Para múltiplos, separar com vírgula
Endereco_Complementoborrower.address.additionalInformationTexto livreComplemento do endereço (sala, andar, etc.)
Data_CompetenciaaccrualOnYYYY-MM-DDData de competência para notas retroativas
Data_EmissaoissuedOnYYYY-MM-DDData de emissão: se não informada, assume-se a data atual.
Regime_Tributario_Tomadorborrower.taxRegimeIsento, MicroempreendedorIndividual, SimplesNacional, LucroPresumido, LucroRealRegime tributário do tomador do serviço
Tomador_Telefoneborrower.phoneNumberTexto livreTelefone do tomador do serviço
Tomador_Inscricao_Estadualborrower.stateTaxNumberTexto livreInscrição estadual do tomador do serviço

Campos IBS/CBS - Reforma Tributária (Planilha Básica)​

⚠️ Regra de Obrigatoriedade Condicional: Se qualquer um dos campos NBS, IBSCBS_Indicador_Operacao ou IBSCBS_Codigo_Classificacao for preenchido, todos os três devem ser preenchidos. Esses campos são utilizados para operações que seguem o novo modelo tributário brasileiro (Reforma Tributária).

Consulte a documentação completa:

Campo/ColunaCampo na APIPossíveis ValoresDescrição
NBSnbsCodeCódigo NBSCódigo da Nomenclatura Brasileira de Serviços (máx. 9 dígitos). Consulte a tabela de códigos NBS aqui.
IBSCBS_Indicador_OperacaoibsCbs.operationIndicatorCódigo indOp (ex: 020101, 030101, 100301)Indicador da operação que determina o local de incidência do IBS/CBS. Consulte a tabela de referência
IBSCBS_Codigo_ClassificacaoibsCbs.classCodeCódigo cClassTrib (ex: 000001, 200028, 200052)Código de Classificação Tributária que define o regime e alíquotas aplicáveis. Consulte a tabela de CST/cClassTrib

5. Planilha avançada​

A planilha avançada possui os mesmos campos da planilha básica e mais os campos adicionais listados abaixo.

⚠️ Importante: O nome de cada coluna na planilha deve ser exatamente igual ao descrito na coluna "Campo/Coluna" das tabelas abaixo. Qualquer diferença (espaços, acentos, maiúsculas/minúsculas diferentes) fará com que o sistema não reconheça o campo.

Campos Tributários Básicos​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
CNAEcnaeCodeCódigo CNAECódigo CNAE da atividade
Codigo_Servico_FederalfederalServiceCodeCódigo LC 116Código federal do serviço conforme Lei Complementar 116. Saiba mais sobre códigos de serviço
NBSnbsCodeCódigo NBSCódigo da Nomenclatura Brasileira de Serviços. Consulte a tabela de códigos NBS aqui.
NCMncmCodeCódigo NCMCódigo NCM (Nomenclatura Comum do Mercosul) (máx. 8 caracteres)
Inscricao_Municipalborrower.municipalTaxNumberTexto livreInscrição municipal do tomador
Informacoes_AdicionaisadditionalInformationTexto livreInformações complementares para a nota
CAEPF_Tomadorborrower.caepfNuméricoCadastro de Atividade Econômica da Pessoa Física do tomador (máx. 14 dígitos)
Tomador_Motivo_Sem_NIFborrower.noTaxIdReasonOtherNotInformedOriginal, Exempted, NotRequiredJustificativa para ausência de NIF do tomador
Pagamento_Parcelado_AntecipadoisEarlyInstallmentPaymenttrue, falseIndica se é pagamento parcelado antecipado
Tipo_TributacaotaxationTypeNone, WithinCity, OutsideCity, Export, Free, Immune, SuspendedCourtDecision, SuspendedAdministrativeProcedure, OutsideCityFree, OutsideCityImmune, OutsideCitySuspended, OutsideCitySuspendedAdministrativeProcedure, ObjectiveImune, ObjectiveOutsideCityImuneTipo de tributação do serviço
Aliquota_ISSissRateNumérico (%)Alíquota do ISS em percentual. Enviada à API como fração: 5 vira 0.05
Valor_ISSissTaxAmountNuméricoValor do ISS calculado
CST_PIS_COFINScstPisCofins00, 01, 02, 03, 04, 05, 06, 07, 08, 09Código de Situação Tributária do PIS/COFINS
Base_Calculo_PIS_COFINSpisCofinsBaseTaxNuméricoBase de cálculo para PIS e COFINS
Aliquota_PISpisRateNumérico (%)Alíquota do PIS. Enviada à API como fração: 5 vira 0.05
Valor_PISpisAmountNuméricoValor do PIS (sem retenção)
Aliquota_COFINScofinsRateNumérico (%)Alíquota do COFINS. Enviada à API como fração: 5 vira 0.05
Valor_COFINScofinsAmountNuméricoValor do COFINS (sem retenção)
Retencao_IRirAmountWithheldNuméricoValor da retenção de IR
Retencao_PISpisAmountWithheldNuméricoValor da retenção de PIS
Retencao_COFINScofinsAmountWithheldNuméricoValor da retenção de COFINS
Retencao_CSLLcsllAmountWithheldNuméricoValor da retenção de CSLL
Retencao_INSSinssAmountWithheldNuméricoValor da retenção de INSS
Retencao_ISSissAmountWithheldNuméricoValor da retenção de ISS
Aliquota_CSLLcsllRateNumérico (%)Alíquota do CSLL. Enviada à API como fração: 5 vira 0.05
Aliquota_INSSinssRateNumérico (%)Alíquota do INSS. Enviada à API como fração: 5 vira 0.05
Aliquota_IPIipiRateNumérico (%)Alíquota do IPI. Enviada à API como fração: 5 vira 0.05
Valor_IPIipiAmountNuméricoValor do IPI calculado
Retencao_OUTROSothersAmountWithheldNuméricoValor de outras retenções
Valor_DeducoesdeductionsAmountNuméricoValor das deduções legais
Valor_Desconto_IncondicionadodiscountUnconditionedAmountNuméricoValor do desconto incondicionado
Valor_Desconto_CondicionadodiscountConditionedAmountNuméricoValor do desconto condicionado
Valor_RecebidopaidAmountNuméricoValor efetivamente recebido
Tipo_Tomadorborrower.typePF, Pessoa Física, PJ, Pessoa Jurídica, NaturalPerson, LegalEntity, UndefinedTipo do tomador do serviço. Enviado à API como NaturalPerson, LegalEntity ou Undefined
Estado_Prestacao_Servicolocation.stateUFEstado onde o serviço foi prestado
Cidade_Prestacao_Servicolocation.city.nameTexto livreNome da cidade onde o serviço foi prestado
Codigo_Cidade_Prestacao_Servicolocation.city.codeCódigo IBGECódigo IBGE da cidade de prestação
ID_ExternoexternalIdTexto livreIdentificador externo para integração
RPS_SerierpsSerialNumberTexto livreSérie do RPS (máx. 5 caracteres). Se não informado, usa o valor do cadastro da empresa
RPS_NumerorpsNumberNuméricoNúmero do RPS. Se não informado, usa o próximo da sequência automática

Local de Prestação do Serviço​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Pais_Prestacao_Servicolocation.countryCódigo ISO 3166-1País de prestação do serviço (ex: BRA)
Cep_Prestacao_Servicolocation.postalCodeCEPCEP do local de prestação do serviço
Logradouro_Prestacao_Servicolocation.streetTexto livreLogradouro do local de prestação
Numero_Prestacao_Servicolocation.numberTexto livreNúmero do local de prestação
Bairro_Prestacao_Servicolocation.districtTexto livreBairro do local de prestação
Complemento_Prestacao_Servicolocation.AdditionalInformationTexto livreComplemento do endereço de prestação

Atividade/Evento​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Nome_Atividade_EventoactivityEvent.nameTexto livreNome da atividade ou evento
Data_Inicio_EventoactivityEvent.beginOnYYYY-MM-DDData de início do evento
Data_Fim_EventoactivityEvent.endOnYYYY-MM-DDData de término do evento
Codigo_Atividade_EventoactivityEvent.codeTexto livreCódigo identificador da atividade/evento

Endereço do Evento​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Evento_Endereco_PaisactivityEvent.address.countryCódigo ISO 3166-1País do evento (ex: BRA)
Evento_Endereco_CepactivityEvent.address.postalCodeCEPCEP do local do evento
Evento_Endereco_LogradouroactivityEvent.address.streetTexto livreLogradouro do evento
Evento_Endereco_NumeroactivityEvent.address.numberTexto livreNúmero do endereço do evento
Evento_Endereco_ComplementoactivityEvent.address.additionalInformationTexto livreComplemento do endereço do evento
Evento_Endereco_BairroactivityEvent.address.districtTexto livreBairro do evento
Evento_Endereco_Cidade_CodigoactivityEvent.address.city.codeCódigo IBGECódigo IBGE da cidade do evento
Evento_Endereco_Cidade_NomeactivityEvent.address.city.nameTexto livreNome da cidade do evento
Evento_Endereco_EstadoactivityEvent.address.stateUFEstado do evento (ex: SP)

Imóvel​

Campos para serviços relacionados a imóveis (ex: serviços de manutenção, limpeza, administração de imóveis).

Estas colunas também alimentam os dados de imóvel exigidos na apuração do IBS/CBS: não há colunas separadas de imóvel no grupo IBS/CBS.

Para locação de imóvel (município, dados da locação e ajustes da base de cálculo), veja Locação de imóvel.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Imovel_Inscricao_FiscalrealEstate.propertyFiscalRegistrationTexto livreInscrição imobiliária do imóvel (número de cadastro municipal)
Imovel_CIBrealEstate.cibCodeTexto livreCódigo de Identificação de Bens (imóvel)
Imovel_Endereco_PaisrealEstate.siteAddress.countryCódigo ISO 3166-1País do imóvel (ex: BRA)
Imovel_Endereco_CeprealEstate.siteAddress.postalCodeCEPCEP do imóvel
Imovel_Endereco_LogradourorealEstate.siteAddress.streetTexto livreLogradouro do imóvel
Imovel_Endereco_NumerorealEstate.siteAddress.numberTexto livreNúmero do endereço do imóvel
Imovel_Endereco_ComplementorealEstate.siteAddress.additionalInformationTexto livreComplemento do endereço do imóvel
Imovel_Endereco_BairrorealEstate.siteAddress.districtTexto livreBairro do imóvel
Imovel_Endereco_Cidade_CodigorealEstate.siteAddress.city.codeCódigo IBGECódigo IBGE da cidade do imóvel
Imovel_Endereco_Cidade_NomerealEstate.siteAddress.city.nameTexto livreNome da cidade do imóvel
Imovel_Endereco_EstadorealEstate.siteAddress.stateUFEstado do imóvel (ex: SP)

Obra/Construção Civil​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Obra_CNOconstruction.workId.valueTexto livreCadastro Nacional de Obras. Enviado com construction.workId.scheme = bra.cno. Quando Obra_CNO e Obra_CEI são preenchidos, vale o CNO
Obra_CEIconstruction.workId.valueTexto livreCadastro Específico do INSS. Enviado com construction.workId.scheme = bra.cei
Obra_CIBconstruction.cibCodeTexto livreCódigo de Identificação de Bens
Obra_Inscricao_Fiscalconstruction.propertyFiscalRegistrationTexto livreInscrição imobiliária fiscal da obra
Obra_Endereco_Paisconstruction.siteAddress.countryCódigo ISO 3166-1País da obra (ex: BRA)
Obra_Endereco_Cepconstruction.siteAddress.postalCodeCEPCEP da obra
Obra_Endereco_Logradouroconstruction.siteAddress.streetTexto livreLogradouro da obra
Obra_Endereco_Numeroconstruction.siteAddress.numberTexto livreNúmero do endereço da obra
Obra_Endereco_Complementoconstruction.siteAddress.additionalInformationTexto livreComplemento do endereço da obra
Obra_Endereco_Bairroconstruction.siteAddress.districtTexto livreBairro da obra
Obra_Endereco_Cidade_Codigoconstruction.siteAddress.city.codeCódigo IBGECódigo IBGE da cidade da obra
Obra_Endereco_Cidade_Nomeconstruction.siteAddress.city.nameTexto livreNome da cidade da obra
Obra_Endereco_Estadoconstruction.siteAddress.stateUFEstado da obra (ex: SP)

Comércio Exterior​

Consulte a [Tabela de Referência de Comércio Exterior](/docs/documentacao/reforma-tributaria/conceitos-funcionais/tabelas-de-referencia/tabela-referencia-comercio-exterior /) para todos os códigos, vínculos, modos de prestação, moedas e mecanismos de fomento utilizados nos campos abaixo.

Fatura e contrato de câmbio (leiaute 1.02): Comercio_Exterior_Numero_Fatura, Comercio_Exterior_Valor_Fatura e Comercio_Exterior_Numero_Contrato_Cambio só chegam ao XML no leiaute 1.02 da NFS-e nacional. Veja Grupos da NT 009. No leiaute 1.01, a API ignora estas colunas, e a nota é emitida sem elas.

Regras de preenchimento:

  • Célula vazia: o campo não vai para a API.
  • Quando Comercio_Exterior_Numero_Fatura, Comercio_Exterior_Valor_Fatura ou Comercio_Exterior_Numero_Contrato_Cambio é preenchida, Comercio_Exterior_Modo_Prestacao, Comercio_Exterior_Vinculo, Comercio_Exterior_Moeda e Comercio_Exterior_Valor_Servico_Moeda passam a ser obrigatórias. Cada coluna obrigatória vazia recebe um erro e bloqueia a linha.
  • Comercio_Exterior_Numero_Fatura e Comercio_Exterior_Numero_Contrato_Cambio aceitam até 20 caracteres.
  • Formate as células Comercio_Exterior_Numero_Fatura e Comercio_Exterior_Numero_Contrato_Cambio como Texto antes de digitar o número. O editor de planilha guarda só 15 dígitos de um número. Um número com mais de 15 dígitos digitado como número perde os dígitos finais e bloqueia a linha. Nesse caso, formate a célula como Texto e digite o número de novo.
  • Comercio_Exterior_Valor_Fatura aceita somente número maior ou igual a 0,01. Zero, valor negativo e texto bloqueiam a linha.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
Comercio_Exterior_Modo_PrestacaoforeignTrade.serviceModeUnknown, CrossBorder, ConsumptionInBrazil, TemporaryPersonnel, ConsumptionAbroadModo de prestação do serviço internacional. Veja a tabela de referência para todos os códigos. Obrigatório quando a fatura ou o contrato de câmbio é preenchido.
Comercio_Exterior_VinculoforeignTrade.relationShipNoLink, Controlled, Controller, Affiliate, HeadOffice, Branch, OtherLinkVínculo entre prestador e tomador. Veja a tabela de referência para todos os códigos. Obrigatório quando a fatura ou o contrato de câmbio é preenchido.
Comercio_Exterior_MoedaforeignTrade.currencyCódigo Siscomex/BACENMoeda da operação (ex: 220, 756, etc). Veja a tabela oficial de moedas do Banco Central do Brasil para todos os códigos. Obrigatório quando a fatura ou o contrato de câmbio é preenchido.
Comercio_Exterior_Valor_Servico_MoedaforeignTrade.serviceAmountInCurrencyNuméricoValor do serviço na moeda estrangeira. Obrigatório quando a fatura ou o contrato de câmbio é preenchido.
Comercio_Exterior_Fomento_PrestadorforeignTrade.supportMechanismProviderUnknown, None, Acc, Ace, BndesEximPostShipServices, BndesEximPreShipServices, Fge, ProexEqualization, ProexFinancingMecanismo de fomento do prestador. Veja a tabela de referência para todos os códigos.
Comercio_Exterior_Fomento_TomadorforeignTrade.supportMechanismReceiverUnknown, None, PublicAdminAndInternationalRep, LeasesMachineryShipsAircraft, AircraftLeaseAirTransportPublic, ExportAgentsCommission, StorageHandlingTransportAbroad, FifaEventsSubsidiary, FifaEvents, FreightsVesselAircraftRentalsOthers, AeronauticalMaterial, PromotionGoodsAbroad, PromotionBrazilianTourism, PromotionBrazilAbroad, PromotionServicesAbroad, Recine, Recopa, TrademarksPatentsCultivars, Reicomp, Reidi, Repenec, Repes, Retaero, Retid, RoyaltiesTechnicalAssistance, ConformityAssessmentWto, ZpeMecanismo de fomento do tomador. Veja a tabela de referência para todos os códigos.
Comercio_Exterior_Movimentacao_Temporaria_BensforeignTrade.temporaryGoodsUnknown, No, LinkedImportDeclaration, LinkedExportDeclarationMovimentação temporária de bens. Veja a tabela de referência para todos os códigos.
Comercio_Exterior_Declaracao_ImportacaoforeignTrade.importDeclarationTexto livreNúmero da declaração de importação
Comercio_Exterior_Registro_ExportacaoforeignTrade.exportRegistrationTexto livreNúmero do registro de exportação
Comercio_Exterior_Envio_MDICforeignTrade.mdicDeliverytrue, falseIndicador de envio ao MDIC
Comercio_Exterior_Numero_FaturaforeignTrade.invoiceNumberTexto livre (máx. 20)Número da fatura (nFatura). Formate a célula como Texto para manter os zeros à esquerda. Um número com mais de 15 dígitos digitado como número bloqueia a linha. Leiaute 1.02.
Comercio_Exterior_Valor_FaturaforeignTrade.invoiceAmountNumérico (mínimo 0,01)Valor da fatura (vFatura). Leiaute 1.02.
Comercio_Exterior_Numero_Contrato_CambioforeignTrade.exchangeContractNumberTexto livre (máx. 20)Número do contrato de câmbio (nContCambio). Formate a célula como Texto para manter os zeros à esquerda. Um número com mais de 15 dígitos digitado como número bloqueia a linha. Leiaute 1.02.

Intermediário​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Intermediario_Tipointermediary.typeUndefined, NaturalPerson, LegalEntityTipo do intermediário (Pessoa Física ou Jurídica)
Intermediario_Nomeintermediary.nameTexto livreNome ou Razão Social do intermediário
Intermediario_CPF_CNPJintermediary.federalTaxNumberCPF ou CNPJCPF ou CNPJ do intermediário
Intermediario_Inscricao_Municipalintermediary.municipalTaxNumberTexto livreInscrição municipal do intermediário
Intermediario_Inscricao_Estadualintermediary.stateTaxNumberTexto livreInscrição estadual do intermediário
Intermediario_Regime_Tributariointermediary.taxRegimeIsento, MicroempreendedorIndividual, SimplesNacional, LucroPresumido, LucroRealRegime tributário do intermediário
Intermediario_CAEPFintermediary.caepfNuméricoCadastro de Atividade Econômica da Pessoa Física do intermediário (máx. 14 dígitos)
Intermediario_Motivo_Sem_NIFintermediary.noTaxIdReasonOtherNotInformedOriginal, Exempted, NotRequiredJustificativa para ausência de NIF do intermediário
Intermediario_Telefoneintermediary.phoneNumberTexto livreTelefone do intermediário
Intermediario_Emailintermediary.emailEmailEmail do intermediário
Intermediario_Endereco_Paisintermediary.address.countryCódigo ISO 3166-1País do intermediário
Intermediario_Endereco_Cepintermediary.address.postalCodeCEPCEP do intermediário
Intermediario_Endereco_Logradourointermediary.address.streetTexto livreLogradouro do intermediário
Intermediario_Endereco_Numerointermediary.address.numberTexto livreNúmero do endereço do intermediário
Intermediario_Endereco_Complementointermediary.address.additionalInformationTexto livreComplemento do endereço do intermediário
Intermediario_Endereco_Bairrointermediary.address.districtTexto livreBairro do intermediário
Intermediario_Endereco_Cidade_Codigointermediary.address.city.codeCódigo IBGECódigo IBGE da cidade do intermediário
Intermediario_Endereco_Cidade_Nomeintermediary.address.city.nameTexto livreNome da cidade do intermediário
Intermediario_Endereco_Estadointermediary.address.stateUFEstado do intermediário

Destinatário (quando diferente do tomador)​

Regras de preenchimento:

  • O sistema envia o destinatário (recipient) só quando Destinatario_Nome ou Destinatario_CPF_CNPJ está preenchido. As demais colunas Destinatario_* sozinhas não são enviadas.
  • Com o destinatário enviado e IBSCBS_Indicador_Destino vazio, o sistema envia DifferentFromBuyer quando a nota já tem o grupo IBS/CBS, preenchido por outras colunas do grupo (inclusive as de reembolso a terceiros). Sem essas colunas, a nota sai sem o grupo IBS/CBS, como antes.
  • Com o destinatário enviado, IBSCBS_Indicador_Destino = SameAsBuyer bloqueia a linha, porque o destinatário seria descartado. Use DifferentFromBuyer ou deixe a coluna vazia.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
Destinatario_Nomerecipient.nameTexto livreNome ou Razão Social do destinatário
Destinatario_CPF_CNPJrecipient.federalTaxNumberCPF ou CNPJCPF ou CNPJ do destinatário
Destinatario_Emailrecipient.emailEmailEmail do destinatário
Destinatario_Tiporecipient.typePF, Pessoa Física, PJ, Pessoa Jurídica, NaturalPerson, LegalEntity, UndefinedTipo do destinatário (Pessoa Física ou Jurídica). Aceita os mesmos valores de Tipo_Tomador e é enviado à API como NaturalPerson, LegalEntity ou Undefined
Destinatario_Inscricao_Municipalrecipient.municipalTaxNumberTexto livreInscrição municipal do destinatário
Destinatario_Inscricao_Estadualrecipient.stateTaxNumberTexto livreInscrição estadual do destinatário
Destinatario_Regime_Tributariorecipient.taxRegimeIsento, MicroempreendedorIndividual, SimplesNacional, LucroPresumido, LucroRealRegime tributário do destinatário
Destinatario_CAEPFrecipient.caepfNuméricoCadastro de Atividade Econômica da Pessoa Física do destinatário (máx. 14 dígitos)
Destinatario_Motivo_Sem_NIFrecipient.noTaxIdReasonOtherNotInformedOriginal, Exempted, NotRequiredJustificativa para ausência de NIF do destinatário
Destinatario_Telefonerecipient.phoneNumberTexto livreTelefone do destinatário
Destinatario_Endereco_Paisrecipient.address.countryCódigo ISO 3166-1País do destinatário
Destinatario_Endereco_Ceprecipient.address.postalCodeCEPCEP do destinatário
Destinatario_Endereco_Logradourorecipient.address.streetTexto livreLogradouro do destinatário
Destinatario_Endereco_Numerorecipient.address.numberTexto livreNúmero do endereço do destinatário
Destinatario_Endereco_Complementorecipient.address.additionalInformationTexto livreComplemento do endereço do destinatário
Destinatario_Endereco_Bairrorecipient.address.districtTexto livreBairro do destinatário
Destinatario_Endereco_Cidade_Codigorecipient.address.city.codeCódigo IBGECódigo IBGE da cidade do destinatário
Destinatario_Endereco_Cidade_Nomerecipient.address.city.nameTexto livreNome da cidade do destinatário
Destinatario_Endereco_Estadorecipient.address.stateUFEstado do destinatário

Locação de Bens​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Locacao_Categorialease.categoryLease, Sublease, Leasehold, RightOfWay, UsePermissionCategoria da locação (Locação, Sublocação, Arrendamento, Direito de Passagem, Permissão de Uso)
Locacao_Objetolease.objectTypeRailway, Road, Poles, Cables, Pipelines, ConduitsObjeto da locação (Ferrovia, Rodovia, Postes, Cabos, Dutos, Condutos)
Locacao_Extensaolease.totalLengthNuméricoExtensão em metros

Benefício Municipal​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Beneficio_IDbenefit.idTexto livreIdentificador do benefício fiscal municipal
Beneficio_Valorbenefit.amountNuméricoValor do benefício

Suspensão de Exigibilidade​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Suspensao_Motivosuspension.reasonJudicial, AdministrativeMotivo da suspensão da exigibilidade (Decisão Judicial ou Procedimento Administrativo)
Suspensao_Numero_Processosuspension.processNumberTexto livreNúmero do processo judicial ou administrativo

Tipo de Imunidade​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Tipo_ImunidadeimmunityTypeUnspecified, PublicEntitiesMutual, Temples, PartiesUnionsEducationSocialNonprofit, BooksPressPaper, BrazilianMusicPhonogramsTipo de imunidade tributária (CF88, Art 150, VI)

Tipo de Retenção​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Tipo_RetencaoretentionTypeNotWithheld, WithheldByBuyer, WithheldByIntermediaryTipo de retenção do ISSQN (Não Retido, Retido pelo Tomador, Retido pelo Intermediário)

Tributos Aproximados (Lei 12.741/2012)​

Os campos de tributos aproximados atendem à Lei 12.741/2012 ("Lei De Olho no Imposto"). Você pode usar a estrutura simplificada (totais consolidados) ou a estrutura detalhada (por esfera governamental).

Estrutura Simplificada​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Tributos_Aproximados_FonteapproximateTax.sourceTexto livreFonte da informação (ex: IBPT)
Tributos_Aproximados_VersaoapproximateTax.versionTexto livreVersão da tabela (ex: 24.1.A)
Tributos_Aproximados_Percentual_TotalapproximateTax.totalRateNumérico (%)Percentual total da carga tributária
Tributos_Aproximados_Valor_TotalapproximateTax.totalAmountNuméricoValor total aproximado dos tributos

Estrutura Detalhada​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Tributos_Aproximados_Federal_PercentualapproximateTotals.federal.rateNumérico (%)Percentual de tributos federais
Tributos_Aproximados_Federal_ValorapproximateTotals.federal.amountNuméricoValor de tributos federais
Tributos_Aproximados_Estadual_PercentualapproximateTotals.state.rateNumérico (%)Percentual de tributos estaduais
Tributos_Aproximados_Estadual_ValorapproximateTotals.state.amountNuméricoValor de tributos estaduais
Tributos_Aproximados_Municipal_PercentualapproximateTotals.municipal.rateNumérico (%)Percentual de tributos municipais
Tributos_Aproximados_Municipal_ValorapproximateTotals.municipal.amountNuméricoValor de tributos municipais
Tributos_Aproximados_Detalhado_Percentual_TotalapproximateTotals.rateNumérico (%)Percentual total agregado dos tributos aproximados detalhados
Tributos_Aproximados_Detalhado_Valor_TotalapproximateTotals.amountNuméricoValor total agregado dos tributos aproximados detalhados

Substituição de NFS-e​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Substituicao_Chave_NFSereferenceSubstitution.idTexto livreChave da NFS-e a ser substituída (44 dígitos)
Substituicao_MotivoreferenceSubstitution.reasonSnOut, SnIn, ImmunityAddRetro, ImmunityRemoveRetro, RejectionBuyerOrIntermediary, OtherMotivo da substituição
Substituicao_Motivo_TextoreferenceSubstitution.reasonTextTexto livre (15 a 255 caracteres)Descrição do motivo da substituição (xMotivo). Recomendada quando o motivo é Other. Preencha somente com Substituicao_Chave_NFSe

Informações Adicionais Estruturadas​

Além do campo Informacoes_Adicionais (texto livre), você pode estruturar informações específicas:

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Info_Adicional_ART_RRTadditionalInformationGroup.responsibilityDocumentIdentifierTexto livreDocumento de responsabilidade técnica (ART/RRT)
Info_Adicional_Documento_ReferenciaadditionalInformationGroup.referencedDocumentTexto livreDocumento referenciado
Info_Adicional_PedidoadditionalInformationGroup.orderTexto livreNúmero do pedido/ordem de compra
Info_Adicional_Itens_PedidoadditionalInformationGroup.items[].itemTexto livreItens do pedido separados por vírgula ou ponto e vírgula (ex: Item A, Item B ou Item A; Item B; Item C)
Info_Adicional_Outras_InformacoesadditionalInformationGroup.otherInformationTexto livreOutras informações complementares

Documento de Dedução (grupo deduction.documents)​

Use este grupo para detalhar um documento fiscal que justifique uma dedução/redução da base de cálculo do ISSQN, alinhado ao padrão da NFS-e Nacional. É a forma mais completa e recomendada quando você possui os dados do documento que embasa a dedução, e o sistema de emissão prioriza estes campos em relação ao Valor_Deducoes.

⚠️ Um documento por nota: como a planilha prevê apenas uma nota por linha, é permitido preencher apenas um documento de dedução por NFS-e. Para enviar múltiplos documentos por nota, utilize a API REST.

Regras de preenchimento:

  • Pelo menos um dos campos identificadores (Deducao_Documento_Chave_NFSe_Nacional, Deducao_Documento_Chave_NFe, o bloco Deducao_Documento_NFSe_Municipal_*, Deducao_Documento_Numero_Documento_Fiscal ou Deducao_Documento_Numero_Documento_Nao_Fiscal) é obrigatório quando o grupo é utilizado. Se mais de um identificador for enviado, o backend aplica a precedência nessa ordem.
  • Quando qualquer campo do grupo é preenchido, os campos Deducao_Documento_Tipo, Deducao_Documento_Data_Emissao, Deducao_Documento_Valor_Dedutivel e Deducao_Documento_Valor_Utilizado passam a ser obrigatórios.
  • Quando Deducao_Documento_Tipo = Other, o campo Deducao_Documento_Outra_Descricao passa a ser obrigatório.
  • Quando qualquer um dos campos do bloco Deducao_Documento_NFSe_Municipal_* é preenchido, os três (Codigo_Cidade, Numero, Codigo_Verificacao) devem ser preenchidos.
  • Deducao_Documento_Valor_Utilizado deve ser menor ou igual a Deducao_Documento_Valor_Dedutivel.

Identificadores do documento (ao menos um é obrigatório)​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Deducao_Documento_Chave_NFSe_Nacionaldeduction.documents[].nfseKey50 dígitosChave de acesso da NFS-e nacional (chNFSe).
Deducao_Documento_Chave_NFededuction.documents[].nfeKey44 dígitosChave de acesso da NF-e de produto (chNFe).
Deducao_Documento_NFSe_Municipal_Codigo_Cidadededuction.documents[].municipalNfse.cityCodeCódigo IBGECódigo IBGE do município emissor (cMunNFSeMun).
Deducao_Documento_NFSe_Municipal_Numerodeduction.documents[].municipalNfse.numberTexto (máx. 15)Número da NFS-e municipal (nNFSeMun).
Deducao_Documento_NFSe_Municipal_Codigo_Verificacaodeduction.documents[].municipalNfse.verificationCodeTexto (máx. 9)Código de verificação da NFS-e municipal (cVerifNFSeMun).
Deducao_Documento_Numero_Documento_Fiscaldeduction.documents[].fiscalDocumentNumberTexto (máx. 255)Identificador de outro documento fiscal não eletrônico (nDocFisc).
Deducao_Documento_Numero_Documento_Nao_Fiscaldeduction.documents[].nonFiscalDocumentNumberTexto (máx. 255)Identificador de documento não fiscal, ex: nota de débito interna (nDoc).

Dados obrigatórios do documento​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Deducao_Documento_Tipodeduction.documents[].deductionTypeFoodAndBeverages, Materials, ConsortiumPassThrough, HealthPlanPassThrough, Services, Subcontracting, OtherTipo da dedução/redução (tpDedRed). Valores: Alimentação/bebidas, Materiais, Repasse consorciado, Repasse plano de saúde, Serviços, Subempreitada de mão de obra, Outras.
Deducao_Documento_Outra_Descricaodeduction.documents[].otherDeductionDescriptionTexto livre (máx. 150)Descrição livre da dedução (xDescOutDed). Obrigatório quando Deducao_Documento_Tipo = Other.
Deducao_Documento_Data_Emissaodeduction.documents[].issueDateYYYY-MM-DDData de emissão do documento de origem (dtEmiDoc).
Deducao_Documento_Valor_Dedutiveldeduction.documents[].deductibleTotalNuméricoValor total dedutível/redutível no documento de origem (vDedutivelRedutivel).
Deducao_Documento_Valor_Utilizadodeduction.documents[].usedAmountNuméricoValor efetivamente utilizado como dedução nesta NFS-e (vDeducaoReducao). Deve ser ≤ Deducao_Documento_Valor_Dedutivel.

Fornecedor do documento (opcional)​

Dados do emitente do documento que embasa a dedução (fornec). Baseado em partyDefinition.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Deducao_Documento_Fornecedor_Tipodeduction.documents[].supplier.typeUndefined, NaturalPerson, LegalEntityTipo do fornecedor (Pessoa Física ou Jurídica).
Deducao_Documento_Fornecedor_Nomededuction.documents[].supplier.nameTexto livre (máx. 115)Nome ou Razão Social do fornecedor.
Deducao_Documento_Fornecedor_CPF_CNPJdeduction.documents[].supplier.federalTaxNumberCPF ou CNPJCPF ou CNPJ do fornecedor. Pode ser com ou sem formatação.
Deducao_Documento_Fornecedor_CAEPFdeduction.documents[].supplier.caepfNuméricoCadastro de Atividade Econômica da Pessoa Física do fornecedor (máx. 14 dígitos).
Deducao_Documento_Fornecedor_Motivo_Sem_NIFdeduction.documents[].supplier.noTaxIdReasonOtherNotInformedOriginal, Exempted, NotRequiredJustificativa para ausência de NIF do fornecedor.
Deducao_Documento_Fornecedor_Telefonededuction.documents[].supplier.phoneNumberTexto livreTelefone do fornecedor.
Deducao_Documento_Fornecedor_Emaildeduction.documents[].supplier.emailEmailEmail do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Paisdeduction.documents[].supplier.address.countryCódigo ISO 3166-1País do fornecedor (ex: BRA).
Deducao_Documento_Fornecedor_Endereco_Cepdeduction.documents[].supplier.address.postalCodeCEPCEP do endereço do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Logradourodeduction.documents[].supplier.address.streetTexto livreLogradouro do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Numerodeduction.documents[].supplier.address.numberTexto livreNúmero do endereço do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Complementodeduction.documents[].supplier.address.additionalInformationTexto livreComplemento do endereço do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Bairrodeduction.documents[].supplier.address.districtTexto livreBairro do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Cidade_Codigodeduction.documents[].supplier.address.city.codeCódigo IBGECódigo IBGE da cidade do fornecedor (7 dígitos).
Deducao_Documento_Fornecedor_Endereco_Cidade_Nomededuction.documents[].supplier.address.city.nameTexto livreNome da cidade do fornecedor.
Deducao_Documento_Fornecedor_Endereco_Estadodeduction.documents[].supplier.address.stateUFSigla do estado do fornecedor (ex: SP).

Documento de Reembolso a Terceiros (grupo ibsCbs.thirdPartyReimbursements.documents)​

Use este grupo para detalhar um documento que justifique um valor de reembolso ou repasse a terceiros no contexto da Reforma Tributária (IBS/CBS). Exemplos típicos: corretagem imobiliária com repasse, agência de viagens repassando ao fornecedor, agência de publicidade reembolsando produção externa ou mídia.

⚠️ Um documento por nota: como a planilha prevê apenas uma nota por linha, é permitido preencher apenas um documento de reembolso a terceiros por NFS-e. Para enviar múltiplos documentos por nota, utilize a API REST.

Regras de preenchimento:

  • Preencha exatamente um destes caminhos de identificação quando o grupo é utilizado: Reembolso_Terceiros_Documento_Chave_NFSe_Nacional, Reembolso_Terceiros_Documento_Chave_NFe, Reembolso_Terceiros_Documento_Chave_CTe, o bloco Reembolso_Terceiros_Documento_Outro_DFe_Nacional_*, o bloco Reembolso_Terceiros_Documento_Outro_Doc_Fiscal_* ou o bloco Reembolso_Terceiros_Documento_Outro_Doc_Nao_Fiscal_*. Linha com mais de um caminho preenchido fica bloqueada para envio.
  • As três colunas de chave são enviadas em otherNationalDfe, o mesmo campo da API do bloco Outro_DFe_Nacional_*, com dfeType 1 (NFS-e), 2 (NF-e) ou 3 (CT-e) preenchido automaticamente.
  • Quando qualquer campo do grupo é preenchido, os campos Reembolso_Terceiros_Documento_Data_Emissao, Reembolso_Terceiros_Documento_Data_Competencia, Reembolso_Terceiros_Documento_Tipo e Reembolso_Terceiros_Documento_Valor passam a ser obrigatórios.
  • Quando o bloco Reembolso_Terceiros_Documento_Outro_DFe_Nacional_* é utilizado, o campo Outro_DFe_Nacional_Tipo_Texto passa a ser obrigatório (Outro_DFe_Nacional_Chave é opcional).
  • Quando o bloco Reembolso_Terceiros_Documento_Outro_Doc_Fiscal_* é utilizado, os campos Outro_Doc_Fiscal_Codigo_Cidade_Emissor e Outro_Doc_Fiscal_Numero são obrigatórios.
  • Quando o bloco Reembolso_Terceiros_Documento_Outro_Doc_Nao_Fiscal_* é utilizado, os dois campos (Numero e Descricao) são obrigatórios.
  • Reembolso_Terceiros_Documento_Tipo_Descricao é opcional. Preencha somente com Reembolso_Terceiros_Documento_Tipo = OtherReimbursement. Com outro tipo, a linha fica bloqueada para envio.

Identificador do documento (anyOf: escolha exatamente um caminho)​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Reembolso_Terceiros_Documento_Chave_NFSe_NacionalibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeKeyTexto (máx. 50)Chave de acesso da NFS-e Nacional. Enviada com dfeType = 1 e dfeTypeText = NFS-e, preenchidos automaticamente.
Reembolso_Terceiros_Documento_Chave_NFeibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeKey44 dígitosChave de acesso da NF-e. Enviada com dfeType = 2 e dfeTypeText = NF-e, preenchidos automaticamente.
Reembolso_Terceiros_Documento_Chave_CTeibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeKey44 dígitosChave de acesso do CT-e. Enviada com dfeType = 3 e dfeTypeText = CT-e, preenchidos automaticamente.
Reembolso_Terceiros_Documento_Outro_DFe_Nacional_ChaveibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeKeyTexto livreChave de outro DF-e nacional (chDFE). Obrigatório quando o bloco Outro_DFe_Nacional_* é utilizado.
Reembolso_Terceiros_Documento_Outro_DFe_Nacional_Tipo_TextoibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeTypeTextTexto livreDescrição textual do tipo de DF-e (xTpDFE), ex: NFS-e, NF-e, CT-e. Obrigatório quando o bloco Outro_DFe_Nacional_* é utilizado.
Reembolso_Terceiros_Documento_Outro_DFe_Nacional_TipoibsCbs.thirdPartyReimbursements.documents[].otherNationalDfe.dfeTypeTexto (1 caractere)Código numérico do tipo de DF-e (tipoChaveDFE). Validação fraca no backend, sem enum oficial.
Reembolso_Terceiros_Documento_Outro_Doc_Fiscal_Codigo_Cidade_EmissoribsCbs.thirdPartyReimbursements.documents[].otherFiscalDoc.issuerCityCodeCódigo IBGECódigo IBGE do município emissor do documento fiscal (cMunEmiDocFisc). Obrigatório quando o bloco Outro_Doc_Fiscal_* é utilizado.
Reembolso_Terceiros_Documento_Outro_Doc_Fiscal_NumeroibsCbs.thirdPartyReimbursements.documents[].otherFiscalDoc.fiscalDocNumberTexto livreNúmero do documento fiscal (nDocFisc). Obrigatório quando o bloco Outro_Doc_Fiscal_* é utilizado.
Reembolso_Terceiros_Documento_Outro_Doc_Fiscal_DescricaoibsCbs.thirdPartyReimbursements.documents[].otherFiscalDoc.fiscalDocDescriptionTexto livreDescrição complementar do documento fiscal (xDocFisc).
Reembolso_Terceiros_Documento_Outro_Doc_Nao_Fiscal_NumeroibsCbs.thirdPartyReimbursements.documents[].otherDoc.docNumberTexto livre (máx. 255)Número do documento não fiscal (nDoc). Obrigatório quando o bloco Outro_Doc_Nao_Fiscal_* é utilizado.
Reembolso_Terceiros_Documento_Outro_Doc_Nao_Fiscal_DescricaoibsCbs.thirdPartyReimbursements.documents[].otherDoc.docDescriptionTexto livre (máx. 255)Descrição do documento não fiscal (xDoc). Obrigatório quando o bloco Outro_Doc_Nao_Fiscal_* é utilizado.

Dados obrigatórios do documento​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Reembolso_Terceiros_Documento_Data_EmissaoibsCbs.thirdPartyReimbursements.documents[].issueDateYYYY-MM-DDData de emissão do documento que originou o reembolso/repasse (dtEmiDoc).
Reembolso_Terceiros_Documento_Data_CompetenciaibsCbs.thirdPartyReimbursements.documents[].accrualOnYYYY-MM-DDData de competência do reembolso/repasse (dtCompDoc).
Reembolso_Terceiros_Documento_TipoibsCbs.thirdPartyReimbursements.documents[].reimbursementTypeRealEstateBrokerPassThrough, TravelAgencySupplierPassThrough, AdAgencyExternalProductionReimbursement, AdAgencyMediaReimbursement, OtherReimbursementTipo do reembolso/repasse (tpReemb). Valores: Repasse de corretagem imobiliária, Repasse de fornecedor de agência de viagens, Reembolso de produção externa de agência de publicidade, Reembolso de mídia de agência de publicidade, Outro reembolso.
Reembolso_Terceiros_Documento_Tipo_DescricaoibsCbs.thirdPartyReimbursements.documents[].reimbursementTypeTextTexto livre (máx. 150)Descrição do tipo de reembolso. Opcional. Preencha somente com o tipo OtherReimbursement.
Reembolso_Terceiros_Documento_ValoribsCbs.thirdPartyReimbursements.documents[].amountNuméricoValor do reembolso/repasse a terceiros (vReemb).

Fornecedor do documento (opcional)​

Dados do fornecedor (terceiro) que recebeu o repasse/reembolso (fornec). Baseado em partyDefinition.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Reembolso_Terceiros_Documento_Fornecedor_TipoibsCbs.thirdPartyReimbursements.documents[].supplier.typeUndefined, NaturalPerson, LegalEntityTipo do fornecedor (Pessoa Física ou Jurídica).
Reembolso_Terceiros_Documento_Fornecedor_NomeibsCbs.thirdPartyReimbursements.documents[].supplier.nameTexto livre (máx. 115)Nome ou Razão Social do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_CPF_CNPJibsCbs.thirdPartyReimbursements.documents[].supplier.federalTaxNumberCPF ou CNPJCPF ou CNPJ do fornecedor. Pode ser com ou sem formatação.
Reembolso_Terceiros_Documento_Fornecedor_Motivo_Sem_NIFibsCbs.thirdPartyReimbursements.documents[].supplier.noTaxIdReasonOtherNotInformedOriginal, Exempted, NotRequiredJustificativa para ausência de NIF do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_PaisibsCbs.thirdPartyReimbursements.documents[].supplier.address.countryCódigo ISO 3166-1País do fornecedor (ex: BRA).
Reembolso_Terceiros_Documento_Fornecedor_Endereco_CepibsCbs.thirdPartyReimbursements.documents[].supplier.address.postalCodeCEPCEP do endereço do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_LogradouroibsCbs.thirdPartyReimbursements.documents[].supplier.address.streetTexto livreLogradouro do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_NumeroibsCbs.thirdPartyReimbursements.documents[].supplier.address.numberTexto livreNúmero do endereço do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_ComplementoibsCbs.thirdPartyReimbursements.documents[].supplier.address.additionalInformationTexto livreComplemento do endereço do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_BairroibsCbs.thirdPartyReimbursements.documents[].supplier.address.districtTexto livreBairro do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_Cidade_CodigoibsCbs.thirdPartyReimbursements.documents[].supplier.address.city.codeCódigo IBGECódigo IBGE da cidade do fornecedor (7 dígitos).
Reembolso_Terceiros_Documento_Fornecedor_Endereco_Cidade_NomeibsCbs.thirdPartyReimbursements.documents[].supplier.address.city.nameTexto livreNome da cidade do fornecedor.
Reembolso_Terceiros_Documento_Fornecedor_Endereco_EstadoibsCbs.thirdPartyReimbursements.documents[].supplier.address.stateUFSigla do estado do fornecedor (ex: SP).

Detalhes de Valores do Serviço​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
Valor_Inicial_CobradoserviceAmountDetails.initialChargedAmountNuméricoValor inicial cobrado pelo serviço (antes de tributos, multa e juros)
Valor_Final_CobradoserviceAmountDetails.finalChargedAmountNuméricoValor final cobrado pelo serviço (incluindo todos os tributos)
Valor_MultaserviceAmountDetails.fineAmountNuméricoValor de multa aplicada
Valor_JurosserviceAmountDetails.interestAmountNuméricoValor de juros aplicados

IBS/CBS (Reforma Tributária)​

Nota sobre a Reforma Tributária: Os campos de IBS/CBS são utilizados para operações que seguem o novo modelo tributário brasileiro (Reforma Tributária). Esses campos são opcionais e devem ser preenchidos apenas quando aplicável à operação.

⚠️ Regra de Obrigatoriedade Condicional: Se qualquer um dos campos IBSCBS_Indicador_Operacao ou IBSCBS_Codigo_Classificacao for preenchido, ambos se tornam obrigatórios.

Saiba mais sobre a Reforma Tributária:

Dados Gerais do IBS/CBS​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Indicador_OperacaoibsCbs.operationIndicatorCódigo indOp (ex: 020101, 030101, 100301)Condicionalmente obrigatório. Indicador da operação que determina o local de incidência do IBS/CBS, conforme Art. 11 da LC nº 214/2025. Consulte a tabela completa
IBSCBS_Codigo_ClassificacaoibsCbs.classCodeCódigo cClassTrib (ex: 000001, 200028)Condicionalmente obrigatório. Código de Classificação Tributária que define o regime e alíquotas aplicáveis (ex: tributação integral, alíquota reduzida). Consulte a tabela de CST/cClassTrib
IBSCBS_Codigo_SituacaoibsCbs.situationCodeCódigo CST (ex: 000, 200, 400)Código da Situação Tributária do IBS/CBS. O CST indica o tratamento tributário da operação (tributação integral, alíquota zero, imunidade, etc.). Consulte a tabela de CST
IBSCBS_FinalidadeibsCbs.purposeregularFinalidade da operação (atualmente apenas regular é aceito)
IBSCBS_Indicador_DestinoibsCbs.destinationIndicatorSameAsBuyer, DifferentFromBuyerIndicador de destino (mesmo que o tomador ou diferente do tomador)
IBSCBS_Tipo_OperacaoibsCbs.operationTypeTexto livreTipo de operação do IBS/CBS
IBSCBS_NFSe_ReferenciadasibsCbs.relatedDocs.items[]Chaves de NFS-eChaves das NFS-e referenciadas, separadas por vírgula, ponto e vírgula ou espaço. Cada chave vira um item da lista. Formate a célula como Texto: a chave tem 50 dígitos e o editor de planilha a converte em notação científica
IBSCBS_Uso_PessoalibsCbs.personalUsetrue, falseIndica se é para uso/consumo pessoal do adquirente
IBSCBS_Base_CalculoibsCbs.basisNuméricoBase de cálculo do IBS/CBS
IBSCBS_Valor_Reembolso_RepasseibsCbs.reimbursedResuppliedAmountNuméricoValor de reembolso ou repasse
IBSCBS_DoacaoibsCbs.isDonationtrue, falseIndicador de doação

IBS Estadual​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBS_Estadual_AliquotaibsCbs.ibs.state.rateNumérico (%)Alíquota do IBS estadual
IBS_Estadual_Reducao_AliquotaibsCbs.ibs.state.rateReductionNumérico (%)Percentual de redução da alíquota
IBS_Estadual_Aliquota_EfetivaibsCbs.ibs.state.effectiveRateNumérico (%)Alíquota efetiva após reduções
IBS_Estadual_ValoribsCbs.ibs.state.amountNuméricoValor calculado do IBS estadual
IBS_Estadual_Diferimento_PercentualibsCbs.ibs.state.deferment.rateNumérico (%)Percentual de diferimento
IBS_Estadual_Diferimento_ValoribsCbs.ibs.state.deferment.amountNuméricoValor diferido
IBS_Estadual_Valor_DevolvidoibsCbs.ibs.state.returnedAmountNuméricoValor devolvido (cashback)

IBS Municipal​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBS_Municipal_AliquotaibsCbs.ibs.municipal.rateNumérico (%)Alíquota do IBS municipal
IBS_Municipal_Reducao_AliquotaibsCbs.ibs.municipal.rateReductionNumérico (%)Percentual de redução da alíquota
IBS_Municipal_Aliquota_EfetivaibsCbs.ibs.municipal.effectiveRateNumérico (%)Alíquota efetiva após reduções
IBS_Municipal_ValoribsCbs.ibs.municipal.amountNuméricoValor calculado do IBS municipal
IBS_Municipal_Diferimento_PercentualibsCbs.ibs.municipal.deferment.rateNumérico (%)Percentual de diferimento
IBS_Municipal_Diferimento_ValoribsCbs.ibs.municipal.deferment.amountNuméricoValor diferido
IBS_Municipal_Valor_DevolvidoibsCbs.ibs.municipal.returnedAmountNuméricoValor devolvido (cashback)

IBS Total​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBS_TotalibsCbs.ibs.totalAmountNuméricoValor total do IBS (estadual + municipal)

CBS (Contribuição sobre Bens e Serviços)​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
CBS_AliquotaibsCbs.cbs.rateNumérico (%)Alíquota da CBS
CBS_Reducao_AliquotaibsCbs.cbs.rateReductionNumérico (%)Percentual de redução da alíquota
CBS_Aliquota_EfetivaibsCbs.cbs.effectiveRateNumérico (%)Alíquota efetiva após reduções
CBS_ValoribsCbs.cbs.amountNuméricoValor calculado da CBS
CBS_Diferimento_PercentualibsCbs.cbs.deferment.rateNumérico (%)Percentual de diferimento
CBS_Diferimento_ValoribsCbs.cbs.deferment.amountNuméricoValor diferido
CBS_Valor_DevolvidoibsCbs.cbs.returnedAmountNuméricoValor devolvido (cashback)

Transferência de Crédito (IBS/CBS)​

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Transferencia_Credito_IBSibsCbs.creditTransfer.ibsAmountNuméricoValor da transferência de crédito de IBS
IBSCBS_Transferencia_Credito_CBSibsCbs.creditTransfer.cbsAmountNuméricoValor da transferência de crédito de CBS

Tributação Regular (IBS/CBS)​

Campos para informar dados da tributação pelo regime regular, quando a operação possui tratamento diferenciado no grupo principal de IBS/CBS (ex: imunidade, isenção) mas também precisa informar os valores que seriam devidos na tributação regular.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Trib_Regular_Codigo_SituacaoibsCbs.regularTaxation.situationCodeCódigo CSTCódigo da Situação Tributária da tributação regular
IBSCBS_Trib_Regular_Codigo_ClassificacaoibsCbs.regularTaxation.classCodeCódigo cClassTribCódigo de Classificação Tributária da tributação regular
IBSCBS_Trib_Regular_IBS_TotalibsCbs.regularTaxation.ibs.totalAmountNuméricoValor total do IBS na tributação regular
IBSCBS_Trib_Regular_IBS_Estadual_Aliquota_EfetivaibsCbs.regularTaxation.ibs.state.effectiveRateNumérico (%)Alíquota efetiva do IBS estadual na tributação regular
IBSCBS_Trib_Regular_IBS_Estadual_ValoribsCbs.regularTaxation.ibs.state.amountNuméricoValor do IBS estadual na tributação regular
IBSCBS_Trib_Regular_IBS_Municipal_Aliquota_EfetivaibsCbs.regularTaxation.ibs.municipal.effectiveRateNumérico (%)Alíquota efetiva do IBS municipal na tributação regular
IBSCBS_Trib_Regular_IBS_Municipal_ValoribsCbs.regularTaxation.ibs.municipal.amountNuméricoValor do IBS municipal na tributação regular
IBSCBS_Trib_Regular_CBS_Aliquota_EfetivaibsCbs.regularTaxation.cbs.effectiveRateNumérico (%)Alíquota efetiva da CBS na tributação regular
IBSCBS_Trib_Regular_CBS_ValoribsCbs.regularTaxation.cbs.amountNuméricoValor da CBS na tributação regular

Crédito Presumido (IBS/CBS)​

Campos para informar dados de crédito presumido do IBS e CBS, quando aplicável à operação.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Credito_Presumido_IBS_CodigoibsCbs.presumedCredits.ibs.codeTexto livreCódigo do crédito presumido de IBS
IBSCBS_Credito_Presumido_IBS_AliquotaibsCbs.presumedCredits.ibs.rateNumérico (%)Alíquota do crédito presumido de IBS
IBSCBS_Credito_Presumido_IBS_ValoribsCbs.presumedCredits.ibs.amountNuméricoValor do crédito presumido de IBS
IBSCBS_Credito_Presumido_IBS_Valor_CondicionalibsCbs.presumedCredits.ibs.conditionalAmountNuméricoValor condicional do crédito presumido de IBS
IBSCBS_Credito_Presumido_CBS_CodigoibsCbs.presumedCredits.cbs.codeTexto livreCódigo do crédito presumido de CBS
IBSCBS_Credito_Presumido_CBS_AliquotaibsCbs.presumedCredits.cbs.rateNumérico (%)Alíquota do crédito presumido de CBS
IBSCBS_Credito_Presumido_CBS_ValoribsCbs.presumedCredits.cbs.amountNuméricoValor do crédito presumido de CBS
IBSCBS_Credito_Presumido_CBS_Valor_CondicionalibsCbs.presumedCredits.cbs.conditionalAmountNuméricoValor condicional do crédito presumido de CBS

Compra Governamental (IBS/CBS)​

Campos para operações de venda de serviços para órgãos governamentais, com tratamento tributário específico.

Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Compra_Gov_Tipo_EntidadeibsCbs.governmentPurchase.entityTypeVeja os valores aceitosTipo de entidade governamental compradora
IBSCBS_Compra_Gov_IBS_TotalibsCbs.governmentPurchase.ibs.totalAmountNuméricoValor total do IBS na compra governamental
IBSCBS_Compra_Gov_IBS_Estadual_AliquotaibsCbs.governmentPurchase.ibs.state.rateNumérico (%)Alíquota do IBS estadual na compra governamental
IBSCBS_Compra_Gov_IBS_Estadual_ValoribsCbs.governmentPurchase.ibs.state.amountNuméricoValor do IBS estadual na compra governamental
IBSCBS_Compra_Gov_IBS_Municipal_AliquotaibsCbs.governmentPurchase.ibs.municipal.rateNumérico (%)Alíquota do IBS municipal na compra governamental
IBSCBS_Compra_Gov_IBS_Municipal_ValoribsCbs.governmentPurchase.ibs.municipal.amountNuméricoValor do IBS municipal na compra governamental
IBSCBS_Compra_Gov_CBS_AliquotaibsCbs.governmentPurchase.cbs.rateNumérico (%)Alíquota da CBS na compra governamental
IBSCBS_Compra_Gov_CBS_ValoribsCbs.governmentPurchase.cbs.amountNuméricoValor da CBS na compra governamental

Valores aceitos em IBSCBS_Compra_Gov_Tipo_Entidade​

A planilha aceita mais de uma forma de escrever cada entidade, sem diferença entre maiúsculas e minúsculas. O valor enviado à API é sempre o da coluna "Na API".

Na planilhaNa APIEntidade compradora
federal, Union ou 1UnionUnião
state, estadual, State ou 2StateEstado
distrito_federal, df, FederalDistrict ou 3FederalDistrictDistrito Federal
municipal, municipio, Municipality ou 4MunicipalityMunicípio

Grupos da NT 009 (leiaute 1.02)​

Os grupos da NT 009 só valem no leiaute 1.02

Os grupos desta seção (locação de imóvel, bens móveis, condomínio e NFS-e de ajuste) só chegam ao XML da nota no leiaute 1.02 da NFS-e nacional, definido pela NT 009.

  • Hoje, o leiaute 1.02 vale para as notas de homologação.
  • Em produção, o leiaute 1.02 passa a valer na Sefin Nacional a partir de 01/12/2026.

No leiaute 1.01:

  • A API ignora os dados de locação de imóvel, de bens móveis e de condomínio. A nota é emitida sem eles.
  • A API ignora a fatura e o contrato de câmbio da seção Comércio Exterior. A nota é emitida sem eles.
  • A API recusa a NFS-e de ajuste antes do envio.

A planilha aceita, por nota, até 5 bens móveis, até 3 ajustes da base de cálculo do imóvel e, no condomínio, até 5 cobranças, até 2 detalhes por cobrança e até 3 descontos. Para enviar mais, use a API REST.

Locação de imóvel​

Use nas notas de locação, cessão onerosa ou arrendamento de bem imóvel (código de tributação nacional 99.03). Estas colunas completam a seção Imóvel.

Regras de preenchimento:

  • Quando qualquer coluna Imovel_Locacao_* é preenchida, Imovel_Locacao_Valor_Total_Operacao passa a ser obrigatória.
  • A planilha aceita até 3 ajustes da base de cálculo por nota. Troque {n} pelo número do ajuste, de 1 a 3. Exemplo: Imovel_Ajuste_BC_1_Tipo, Imovel_Ajuste_BC_2_Tipo.
  • Quando qualquer coluna do ajuste {n} é preenchida, Imovel_Ajuste_BC_{n}_Tipo e Imovel_Ajuste_BC_{n}_Valor passam a ser obrigatórias.
  • Quando Imovel_Ajuste_BC_{n}_Tipo = 99, Imovel_Ajuste_BC_{n}_Descricao passa a ser obrigatória.
  • Os dados da seção Imóvel (inscrição, CIB e endereço) chegam à nota nos leiautes 1.01 e 1.02, com ou sem ajuste da base de cálculo.
  • Os ajustes da base de cálculo (Imovel_Ajuste_BC_*) só chegam ao XML no leiaute 1.02. No leiaute 1.01, a API ignora os ajustes, e a nota é emitida sem eles.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
Imovel_Codigo_MunicipiorealEstate.municipalityCodeCódigo IBGE (7 dígitos)Código IBGE do município do imóvel (cMun). Formate a célula como Texto.
Imovel_Locacao_Percentual_CopropriedaderealEstate.leasing.coOwnershipPercentageNumérico (0 a 100)Percentual de copropriedade do locador (pCopropriedade). Use 100 quando há um único locador.
Imovel_Locacao_Valor_Total_OperacaorealEstate.leasing.totalOperationAmountNuméricoValor total da operação, sem proporcionalizar (vTotOper). Obrigatório quando qualquer coluna Imovel_Locacao_* é preenchida.
Imovel_Locacao_Desconto_Incondicionado_TotalrealEstate.leasing.unconditionalDiscountTotalNuméricoDesconto incondicionado total (vDescIncondTot).
Imovel_Locacao_Desconto_Condicionado_TotalrealEstate.leasing.conditionalDiscountTotalNuméricoDesconto condicionado total (vDescCondTot).
Imovel_Locacao_Data_Vencimento_OriginalrealEstate.leasing.originalDueDateYYYY-MM-DDData de vencimento original do aluguel (dVencOrig).
Imovel_Ajuste_BC_{n}_TiporealEstate.propertyUnits[0].baseCalculationAdjustments[].type1, 2, 3, 4 ou 99Tipo da parcela que não integra a base de cálculo do IBS/CBS na locação (tpAjusteBCLocImoveis). Valores: 1 Tributos inclusos, 2 Emolumento, 3 Condomínio, 4 Redutor social, 99 Outras.
Imovel_Ajuste_BC_{n}_DescricaorealEstate.propertyUnits[0].baseCalculationAdjustments[].typeDescriptionTexto livre (máx. 150)Descrição da parcela (xTpAjusteBCLocImoveis). Obrigatório quando o tipo é 99.
Imovel_Ajuste_BC_{n}_ValorrealEstate.propertyUnits[0].baseCalculationAdjustments[].amountNuméricoValor total da parcela, sem proporcionalizar (vAjusteBCLocImoveis).

Bens móveis locados​

Use nas notas de locação de bens móveis (código de tributação nacional 99.04.01). Cada bem vira um item de ibsCbs.movableAssets.

Regras de preenchimento:

  • A planilha aceita até 5 bens por nota. Troque {n} pelo número do bem, de 1 a 5. Exemplo: Bem_Movel_1_NCM, Bem_Movel_2_NCM.
  • Quando qualquer coluna do bem {n} é preenchida, as três colunas do bem passam a ser obrigatórias.
  • Bens vazios são pulados. Exemplo: com os bens 1 e 3 preenchidos, a nota leva dois itens em movableAssets.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
Bem_Movel_{n}_NCMibsCbs.movableAssets[].ncmCodeCódigo NCM (8 dígitos)Código NCM do bem, sem pontos (cNCMBemMovel). Formate a célula como Texto para manter os zeros à esquerda.
Bem_Movel_{n}_DescricaoibsCbs.movableAssets[].ncmDescriptionTexto livre (máx. 150)Descrição do NCM do bem (xNCMBemMovel).
Bem_Movel_{n}_QuantidadeibsCbs.movableAssets[].quantityInteiro de 1 a 999Quantidade do bem (qtdNCMBemMovel).

Condomínio​

Use nas notas de operações condominiais (código de tributação nacional 99.05.01). As colunas viram o grupo ibsCbs.condominium: o vencimento original, as cobranças com o detalhamento de cada uma e os descontos.

Regras de preenchimento:

  • A planilha aceita até 5 cobranças por nota, até 2 detalhes por cobrança e até 3 descontos por nota. Troque {n} pelo número da cobrança (1 a 5), {m} pelo número do detalhe (1 a 2) e {k} pelo número do desconto (1 a 3). Exemplo: Condominio_Cobranca_1_Tipo, Condominio_Cobranca_1_Detalhe_2_Tipo, Condominio_Desconto_3_Tipo.
  • Quando qualquer coluna Condominio_* é preenchida, Condominio_Vencimento_Original passa a ser obrigatória, e a nota precisa de pelo menos 1 cobrança. O vencimento original é um só por nota.
  • Uma cobrança, um detalhe ou um desconto está preenchido quando qualquer uma das suas três colunas tem valor. No item preenchido, as colunas Tipo e Descricao passam a ser obrigatórias, em todo tipo. A descrição aceita até 150 caracteres.
  • A coluna Valor é opcional em todo item. Quando preenchida, ela aceita somente número maior ou igual a 0.
  • As colunas Tipo aceitam somente o código numérico. Exemplo: 99, e não 99 - Outra.
  • O detalhe exige a cobrança dele. Um detalhe preenchido com a cobrança {n} vazia bloqueia a linha.
  • Itens vazios são pulados. Exemplo: com as cobranças 1 e 3 preenchidas, a nota leva dois itens em charges. O mesmo vale para os detalhes de cada cobrança e para os descontos.
  • Uma coluna acima do limite da planilha bloqueia a linha quando está preenchida. Exemplo: Condominio_Cobranca_6_Tipo, Condominio_Cobranca_1_Detalhe_3_Tipo ou Condominio_Desconto_4_Tipo. Vazia, a coluna é ignorada.
  • A API aceita até 20 cobranças, 20 detalhes por cobrança e 10 descontos. Para uma nota com mais itens do que a planilha aceita, emita pela API REST.
  • A soma dos valores das cobranças compõe o valor do serviço (Valor). A planilha não confere essa soma. Confira os valores antes de enviar.
  • O grupo de condomínio só chega ao XML no leiaute 1.02. No leiaute 1.01, a API ignora o grupo, e a nota é emitida sem ele.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
Condominio_Vencimento_OriginalibsCbs.condominium.originalDueDateYYYY-MM-DDData de vencimento original das cobranças (dVencOrig). Uma por nota. Obrigatório quando qualquer coluna Condominio_* é preenchida. Ex.: 2026-12-10.
Condominio_Cobranca_{n}_TipoibsCbs.condominium.charges[].type1, 2, 3, 4, 5 ou 99Tipo da cobrança (tpCobranca). Valores: 1 Ordinário, 2 Privativo, 3 FPP (fundo de promoção e propaganda), 4 Impostos e taxas, 5 Fundo de reserva, 99 Outra. Obrigatório na cobrança preenchida. Ex.: 1.
Condominio_Cobranca_{n}_DescricaoibsCbs.condominium.charges[].typeDescriptionTexto livre (máx. 150)Descrição da cobrança (xTpCobranca). Obrigatório na cobrança preenchida, em todo tipo. Ex.: Taxa ordinária.
Condominio_Cobranca_{n}_ValoribsCbs.condominium.charges[].amountNumérico (mínimo 0)Valor da cobrança (vCobranca). Opcional. Ex.: 850,00.
Condominio_Cobranca_{n}_Detalhe_{m}_TipoibsCbs.condominium.charges[].details[].typeInteiro de 1 a 36 ou 999Tipo do detalhe da cobrança (tpDetCobranca). Veja os tipos de detalhe. Obrigatório no detalhe preenchido. Ex.: 23.
Condominio_Cobranca_{n}_Detalhe_{m}_DescricaoibsCbs.condominium.charges[].details[].typeDescriptionTexto livre (máx. 150)Descrição do detalhe (xTpDetCobranca). Obrigatório no detalhe preenchido, em todo tipo. Ex.: Limpeza.
Condominio_Cobranca_{n}_Detalhe_{m}_ValoribsCbs.condominium.charges[].details[].amountNumérico (mínimo 0)Valor do detalhe, que compõe o valor da cobrança (vDetCobranca). Opcional. Ex.: 300,00.
Condominio_Desconto_{k}_TipoibsCbs.condominium.discounts[].type1 ou 2Tipo do desconto (tpDesconto). Valores: 1 Incondicionado, 2 Condicionado. Obrigatório no desconto preenchido. Ex.: 1.
Condominio_Desconto_{k}_DescricaoibsCbs.condominium.discounts[].descriptionTexto livre (máx. 150)Descrição do desconto (xTpDesconto). Obrigatório no desconto preenchido. Ex.: Desconto por pontualidade.
Condominio_Desconto_{k}_ValoribsCbs.condominium.discounts[].amountNumérico (mínimo 0)Valor do desconto (vDesconto). Opcional. Ex.: 35,00.
Tipos de detalhe da cobrança​

Os códigos de Condominio_Cobranca_{n}_Detalhe_{m}_Tipo seguem o Anexo VI da NT 009, na versão do schema 1.02 que a API usa. Esse schema ainda não é a versão oficial, e a lista pode mudar.

Ver os 37 tipos de detalhe
CódigoTipo de detalhe
1Cond. Comum CRD
2Cond. Comum M2
3Cond. Comum Fixo
4Cond. Comum Fração
5Cond. Comum Percentual
6Condomínio CMM
7Energia Elétrica
8Água
9Ar Condicionado
10Telefone
11Internet
12Controle de Pragas
13Exaustão
14Gás
15IPTU
16Taxa Área
17Manutenção
18Multa
19Seguro
20Taxa Bombeiro
21Taxa Administração
22Taxa Foro
23Limpeza
24Taxa de Lixo
25Tapume
26Instalação Alarme
27Segurança
28Fundo de Promoção e Propaganda
29Análise de Projeto
30Fundo de Reserva
31Laudos e Vistorias
32Detecção de Fumaça
33Reanálise de Projeto
34Taxa Extra
35Área Vaga
36Condomínio Irrecuperável
999Outro
Exemplo de preenchimento​

Nota fictícia de condomínio (código de tributação nacional 99.05.01) com a taxa ordinária, o fundo de reserva e um desconto por pontualidade:

ColunaValor
Valor935,00
Condominio_Vencimento_Original2026-12-10
Condominio_Cobranca_1_Tipo1
Condominio_Cobranca_1_DescricaoTaxa ordinária
Condominio_Cobranca_1_Valor850,00
Condominio_Cobranca_2_Tipo5
Condominio_Cobranca_2_DescricaoFundo de reserva
Condominio_Cobranca_2_Valor85,00
Condominio_Desconto_1_Tipo1
Condominio_Desconto_1_DescricaoDesconto por pontualidade
Condominio_Desconto_1_Valor35,00

As demais colunas Condominio_* ficam vazias. A nota leva 2 itens em charges e 1 item em discounts, sem details. A coluna Valor traz a soma das cobranças: 850,00 + 85,00 = 935,00.

NFS-e de ajuste (crédito e débito)​

Use para emitir uma NFS-e de ajuste de IBS/CBS, de crédito ou de débito. A situação atual e os cenários estão em NFS-e de ajuste de IBS/CBS.

Regras de preenchimento:

  • Com IBSCBS_Ajuste_Finalidade = Debit, IBSCBS_Ajuste_Tipo_Debito passa a ser obrigatório, e IBSCBS_Ajuste_Tipo_Credito deve ficar vazio.
  • Com IBSCBS_Ajuste_Finalidade = Credit, IBSCBS_Ajuste_Tipo_Credito passa a ser obrigatório, e IBSCBS_Ajuste_Tipo_Debito deve ficar vazio.
  • Um tipo sem a finalidade correspondente bloqueia a linha.
  • Preencha IBSCBS_Ajuste_IBS_Valor e IBSCBS_Ajuste_CBS_Valor somente com IBSCBS_Ajuste_Finalidade.
  • Para referenciar a NFS-e original, use a coluna IBSCBS_NFSe_Referenciadas.
  • A API aplica as demais regras de cada tipo, por exemplo, quais tipos exigem a NFS-e referenciada ou os valores de IBS e CBS.
  • As três colunas de finalidade e tipo aceitam o valor na API ou o código, sem diferença entre maiúsculas e minúsculas. Exemplo: Debit ou 2; FinesAndInterest ou 04.
Campo/ColunaCampo na APIPossíveis ValoresDescrição
IBSCBS_Ajuste_FinalidadeibsCbs.adjustmentPurposeCredit (1), Debit (2)Finalidade da NFS-e de ajuste (finNFSe): crédito ou débito. Vazia, a nota é regular.
IBSCBS_Ajuste_Tipo_DebitoibsCbs.debitAdjustmentTypeCooperativeCreditTransfer (01), CreditAnnulmentExemptOutflows (02), UnprocessedInvoiceDebits (03), FinesAndInterest (04), SuccessionCreditTransfer (05), AdvancePayment (06)Tipo da nota de débito (tpNFSeDebito). Valores: 01 Transferência de créditos para cooperativas, 02 Anulação de crédito por saídas imunes ou isentas, 03 Débitos de notas fiscais não processadas na apuração, 04 Multa e juros, 05 Transferência de crédito na sucessão, 06 Pagamento antecipado.
IBSCBS_Ajuste_Tipo_CreditoibsCbs.creditAdjustmentTypeFinesAndInterest (01), SuccessionCreditTransfer (05)Tipo da nota de crédito (tpNFSeCredito). Valores: 01 Multa e juros, 05 Transferência de crédito na sucessão.
IBSCBS_Ajuste_IBS_ValoribsCbs.adjustment.ibsAmountNuméricoValor do IBS a ajustar (grupo gIBSCBSAjuste).
IBSCBS_Ajuste_CBS_ValoribsCbs.adjustment.cbsAmountNuméricoValor da CBS a ajustar (grupo gIBSCBSAjuste).

⚠️ Atenção: Evite adicionar fórmulas, índices ou qualquer tipo de alteração no excel. Isso pode gerar problemas ao capturar os dados do excel.

Próximos passos​

Documentação relacionada​

Reforma Tributária (IBS/CBS)​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.