NFS-e
Emitir NFS-e
Acepta la solicitud de inmediato y declara al emisor de forma asíncrona.
/openapi/v2/empresas/{empresaId}/nfsetoken, timestamp y sign, vea Autenticación.La aceptación devuelve HTTP 200 sin cuerpo y la declaración al emisor es asíncrona; el resultado llega por webhook o por la consulta. Reenviar el mismo id reutiliza la tarea original y nunca emite un segundo documento.
La clave de acceso de 50 dígitos la genera el emisor, por lo que un documento que falló no tiene chaveAcesso y solo puede localizarse por identificacaoDps, el identificador de 45 caracteres que genera la plataforma. La plataforma enruta por el municipio de la empresa y el canal aparece como padraoMunicipal en la consulta; un municipio aún no admitido se rechaza en la aceptación (10018010).
Parámetros de ruta
empresaId* | string | Identificador de la empresa |
* Campo obligatorio
Cuerpo de la petición
id* | string | Identificador de la solicitud |
ambienteEmissao* | string | Ambiente |
dataCompetencia | string | Mes de competencia |
| object | Emisor |
*obligatorio cuando `emitente.tipo` no es `Prestador` | object | Prestador del servicio |
| object | Tomador |
| object | Intermediario |
* | object | Servicio |
| object | Sustitución |
observacoes | string | Observaciones |
* Campo obligatorio
Sin cuerpo de respuesta
- La empresa debe estar aprobada y con certificado utilizable (
10018004). - La empresa necesita su perfil de NFS-e (serie, encuadre en el Simples, régimen especial), procedente de la sección
emissaoNFSede Registrar empresa o mantenido por la operación; si falta,10018005. Código de servicio, CNAE, NBS, alícuota de ISS y los códigos de PIS/COFINS e IBS/CBS no tienen valor por defecto en la empresa: van en cada solicitud. ambienteEmissaodebe ser el ambiente actual de la empresa. Tras el registro la empresa queda enHomologacao; el paso a producción lo hace la operación.- La plataforma enruta por el municipio de la empresa. Una empresa de São Paulo (
padraoMunicipalPaulistana) necesita la inscripción municipal CCM; si falta en el perfil, la plataforma la consulta por CNPJ en la aceptación y solo rechaza10018005cuando no encuentra nada. En ese canal: soloemitente.tipoPrestador, sinsubstituicao, sin descuentos, sinpagamentosVinculados, sinNaoIncidencia, CNPJ solo numérico,codigoTributacaoMunicipalde 5 dígitos.ibsCbses opcional y decide el diseño municipal: conibsCbs+codigoNbsla nota sale en el diseño 2 (con IBS/CBS); sin él, en el diseño 1 (solo ISS). Tomador extranjero (NIF) solo en el diseño 2. - Tomador CNPJ: envíe los importes retenidos en
servico.retencoes, u omítalos y la plataforma calcula por la clasificación oficial de retención del servicio y porcliente.orgaoPublicoycliente.optanteSimplesNacional; si falta información,10018023lista de una vez todo lo que falta. Un prestador ME/EPP con servicio sujeto a retención de INSS informa el anexo del Simples de ese servicio enservico.retencoes.anexoSimples.
Lo que necesita una nota común. Sin iss, gravado y no retenido con la alícuota de los parámetros municipales; sin pisCofins, CST 01 con las alícuotas del régimen de la empresa; sin cargaTributaria, la empresa fuera del Simples declara la carga aproximada del IBPT o, si la tabla no cubre el servicio, los tributos calculados.
Tomador persona física
Tomador CPF: sin retención federal. La dirección del tomador puede omitirse.
{"id": "PED-20260918-001","ambienteEmissao": "Homologacao","cliente": { "tipoPessoa": "F", "nome": "MARIA DA SILVA", "cpfCnpj": "88533234775" },"servico": {"descricao": "Servico de consultoria em tecnologia da informacao","codigoTributacaoNacional": "010701","valores": { "valorServico": 1000.00 }}}
id* | string | Identificador de la solicitud |
ambienteEmissao* | string | Ambiente |
dataCompetencia | string | Mes de competencia |
* | object | Tomador |
* | object | Servicio |
* Campo obligatorio
Tomador persona jurídica
Tomador CNPJ: envíe los importes en retencoes, cero declara que no hay retención; u omítalos e informe cliente.orgaoPublico y cliente.optanteSimplesNacional para que la plataforma calcule. Si falta información, 10018023 lista lo que falta.
{"id": "PED-20260918-002","ambienteEmissao": "Homologacao","dataCompetencia": "2026-09-01","cliente": {"tipoPessoa": "J","nome": "TOMADOR TESTE LTDA","cpfCnpj": "66500544000120","endereco": { "cidade": 3550308, "cep": "01021200", "uf": "SP", "logradouro": "RUA DO TOMADOR", "numero": "200", "bairro": "CENTRO" }},"servico": {"descricao": "Servico de consultoria em tecnologia da informacao","codigoTributacaoNacional": "010701","valores": { "valorServico": 1000.00 },"iss": { "aliquota": 2 },"retencoes": { "inss": 0, "irrf": 15.00, "csll": 0 }}}
id* | string | Identificador de la solicitud |
ambienteEmissao* | string | Ambiente |
dataCompetencia | string | Mes de competencia |
* | object | Tomador |
* | object | Servicio |
* Campo obligatorio
Sin tomador
El estándar nacional permite omitir cliente; sin tomador no hay retención federal.
{"id": "PED-20260918-003","ambienteEmissao": "Homologacao","servico": {"descricao": "Servico de estacionamento","codigoTributacaoNacional": "110101","valores": { "valorServico": 25.00 }}}
id* | string | Identificador de la solicitud |
ambienteEmissao* | string | Ambiente |
* | object | Servicio |
* Campo obligatorio
cliente, intermediario, prestador y servico.ibsCbs.destinatario tienen la misma estructura. Quien lleva documento lleva nome; la dirección es toda o nada. Solo cliente lleva además optanteSimplesNacional y orgaoPublico, usados cuando la plataforma calcula la retención federal.
Tomador extranjero con NIF
tipoPessoa E con nif; la dirección extranjera usa pais, cep, nomeCidade y uf en texto.
"cliente": {"tipoPessoa": "E","nome": "GLOBAL CLIENT INC","nif": "98-7654321","endereco": { "pais": "US", "cep": "10001", "nomeCidade": "New York", "uf": "NY", "logradouro": "5th Avenue", "numero": "500", "bairro": "Manhattan" }}
* | object | Tomador |
* Campo obligatorio
Tomador extranjero sin NIF
Sin nif, informe motivoSemNif.
"cliente": { "tipoPessoa": "E", "nome": "JOHN DOE", "motivoSemNif": "Dispensado" }
* | object | Tomador |
* Campo obligatorio
Nota con intermediario
intermediario sigue las reglas de cliente; con iss.retencao RetidoIntermediario es quien recauda el ISS.
"intermediario": { "tipoPessoa": "J", "nome": "PLATAFORMA INTERMEDIADORA LTDA", "cpfCnpj": "40673061000134" },"servico": { "iss": { "retencao": "RetidoIntermediario" } }
* | object | Intermediario |
* | object | Servicio |
* Campo obligatorio
El lugar de la prestación es un municipio o un país, nunca ambos. Omitidos, vale el municipio de la empresa.
Servicio prestado en otro municipio
Informe el IBGE del municipio. Solo los servicios de la lista de excepciones de la LC 116 deben el ISS en el lugar de la prestación; los demás siguen el municipio de la empresa. Para declarar usted mismo el municipio del ISS, envíe iss.municipioIncidencia.
"servico": { "municipioPrestacao": { "codigoIbge": 4106902 } }
* | object | Servicio |
* Campo obligatorio
Exportación de servicio
iss.tributacao Exportacao con paisPrestacao (o tomador extranjero); comercioExterior lleva los códigos oficiales. PIS/COFINS suele ir con CST 08.
{"id": "PED-20260921-003","ambienteEmissao": "Homologacao","cliente": {"tipoPessoa": "E","nome": "GLOBAL CLIENT INC","nif": "98-7654321","endereco": { "pais": "US", "cep": "10001", "nomeCidade": "New York", "uf": "NY", "logradouro": "5th Avenue", "numero": "500", "bairro": "Manhattan" }},"servico": {"descricao": "Desenvolvimento de software sob encomenda","codigoTributacaoNacional": "010201","paisPrestacao": "US","paisResultado": "US","comercioExterior": {"modoPrestacao": "1","vinculoPartes": "0","moeda": "220","valorServicoMoeda": 2000.00,"mecanismoApoioPrestador": "01","mecanismoApoioTomador": "01","movimentacaoTemporariaBens": "1","compartilharMdic": true},"valores": { "valorServico": 10800.00 },"iss": { "tributacao": "Exportacao" },"pisCofins": { "situacaoTributaria": "08" }}}
id* | string | Identificador de la solicitud |
ambienteEmissao* | string | Ambiente |
| object | Tomador |
* | object | Servicio |
* Campo obligatorio
Base del ISS = valorServico − descontoIncondicionado − deducciones − beneficio municipal; tributo = base × alícuota. Cada caso muestra el bloque servico.iss y lo que lleva.
Gravado con alícuota informada
En el estándar nacional, el ISS de una empresa fuera del Simples lo calcula el emisor: la alícuota informada solo entra en la estimación local y el impuesto final viene del retorno de la autorización.
"iss": { "tributacao": "Tributavel", "aliquota": 2 }
* | object | Servicio |
* Campo obligatorio
ISS retenido por el tomador
El tomador recauda; el importe del ISS sale del importe neto. Una empresa del Simples retenida tiene el ISS calculado normalmente.
"iss": { "aliquota": 5, "retencao": "RetidoTomador" }
* | object | Servicio |
* Campo obligatorio
Inmunidad
Sin alícuota; tipoImunidade indica el fundamento.
"iss": { "tributacao": "Imunidade", "tipoImunidade": 2 }
* | object | Servicio |
* Campo obligatorio
No incidencia
Sin alícuota. El canal de São Paulo lo rechaza: use Imunidade o Tributavel.
"iss": { "tributacao": "NaoIncidencia" }
* | object | Servicio |
* Campo obligatorio
Exigibilidad suspendida
El ISS se calcula y se marca como suspendido; processo tiene 30 dígitos.
"iss": { "aliquota": 2, "exigibilidadeSuspensa": { "tipo": "Judicial", "processo": "000012345678901234567890123456" } }
* | object | Servicio |
* Campo obligatorio
Beneficio municipal
La reducción rebaja la base de cálculo, en porcentaje o en importe, y no el impuesto; numero tiene 14 dígitos.
"iss": { "aliquota": 5, "beneficioMunicipal": { "numero": "12345678901234", "percentualReducao": 50 } }
* | object | Servicio |
* Campo obligatorio
Empresa del Simples Nacional
No envíe aliquota (10018022): el ISS se paga por el DAS y no sale en la nota. Solo con ISS retenido se acepta la alícuota y se calcula el tributo.
"iss": { "retencao": "NaoRetido" }
* | object | Servicio |
* Campo obligatorio
PIS/COFINS sigue el régimen de la empresa: Lucro Real no acumulativo 1,65 y 7,6, salvo los servicios del art. 10 de la Lei 10.833, que quedan acumulativos; demás regímenes acumulativo 0,65 y 3. La exportación de servicio y la competencia desde enero de 2027 no tienen PIS/COFINS. Base = valorServico − descontoIncondicionado; la empresa del Simples no tiene importes. Retenciones solo con tomador CNPJ: informadas por usted o calculadas por la plataforma.
Sin retención de PIS, COFINS y CSLL
CST y, si quiere, las alícuotas; tipoRetencao 0 declara que nada se retiene. Con tomador CNPJ, la forma exige los ceros en retencoes, si no 10018001; el tomador persona física o extranjero envía solo la forma.
"pisCofins": { "situacaoTributaria": "01", "aliquotaPis": 0.65, "aliquotaCofins": 3, "tipoRetencao": 0 },"retencoes": { "inss": 0, "irrf": 0, "csll": 0 }
* | object | Servicio |
* Campo obligatorio
PIS, COFINS y CSLL retenidos
tipoRetencao 3; envíe pis, cofins y csll por separado, los tres por encima de cero, o solo csll con la suma de los tres, que la plataforma reparte en la proporción legal. Importes que no coinciden con la forma rechazan 10018001. irrf e inss van aparte.
"pisCofins": { "situacaoTributaria": "01", "tipoRetencao": 3 },"retencoes": { "csll": 46.50, "irrf": 15.00, "inss": 0 }
* | object | Servicio |
* Campo obligatorio
Retenciones informadas por usted
Cualquier importe presente, cero incluido, desactiva el cálculo de la plataforma para todo el grupo; cero declara que no hay retención. Un prestador del Simples Nacional o MEI con irrf, csll, pis o cofins por encima de cero rechaza 10018001.
"retencoes": { "inss": 110.00, "irrf": 15.00, "csll": 10.00, "pis": 6.50, "cofins": 30.00 }
* | object | Servicio |
* Campo obligatorio
Retención calculada por la plataforma
Sin importes en retencoes y sin pisCofins.tipoRetencao, la plataforma calcula por la clasificación del servicio y los datos del tomador; un tipoRetencao sin importes rechaza 10018001. categoriaFederal solo cuando el código de servicio no basta; modoContratacao, valorMateriais y contribuinteCprb solo en servicios con retención de INSS, más anexoSimples cuando el prestador es ME/EPP. Si falta información, 10018023 lista todo lo que falta.
"cliente": { "tipoPessoa": "J", "nome": "TOMADOR TESTE LTDA", "cpfCnpj": "66500544000120", "orgaoPublico": "Nenhum", "optanteSimplesNacional": false },"servico": {"retencoes": { "categoriaFederal": "LimpezaConservacao", "modoContratacao": "CessaoMaoDeObra", "valorMateriais": 200.00 }}
* | object | Tomador |
* | object | Servicio |
* Campo obligatorio
Deducciones y descontoIncondicionado reducen la base del ISS y juntos no pueden superar valorServico. Los descuentos se rechazan en el canal de São Paulo.
Descuentos
El incondicionado reduce la base; el condicionado solo reduce el importe neto.
"valores": { "valorServico": 1000.00, "descontoIncondicionado": 100.00, "descontoCondicionado": 50.00 }
* | object | Servicio |
* Campo obligatorio
Deducción en importe
Materiales o subcontratación descontados de la base del ISS.
"valores": { "valorServico": 1000.00, "deducoes": { "valor": 200.00 } }
* | object | Servicio |
* Campo obligatorio
Deducción en porcentaje
Convertida sobre valorServico; no se combina con valor ni con documentos.
"valores": { "valorServico": 1000.00, "deducoes": { "percentual": 20 } }
* | object | Servicio |
* Campo obligatorio
Documentos de deducción: clave electrónica
Cada documento tiene una única identificación; la deducción pasa a ser la suma de valorDeducao.
"valores": {"valorServico": 100000.00,"deducoes": {"documentos": [{ "chaveNfe": "35260840673061000134550010000001231000001235", "tipo": "2", "dataEmissao": "2026-08-15", "valorDedutivel": 30000.00, "valorDeducao": 30000.00,"fornecedor": { "tipoPessoa": "J", "nome": "FORNECEDOR DE MATERIAIS LTDA", "cpfCnpj": "40673061000134" } }]}}
* | object | Servicio |
* Campo obligatorio
Documentos de deducción: NFS-e municipal antigua
Nota emitida antes del estándar nacional, identificada por municipio, número y código de verificación.
"documentos": [{ "nfseMunicipal": { "codigoMunicipio": 3550308, "numero": "123456", "codigoVerificacao": "AB12CD34" }, "tipo": "5", "dataEmissao": "2026-08-15", "valorDedutivel": 5000.00, "valorDeducao": 5000.00 }]
* | object | Servicio |
* Campo obligatorio
Documentos de deducción: nota no electrónica
Nota fiscal de papel o de otro modelo, con número, modelo y serie.
"documentos": [{ "notaFiscal": { "numero": "1234567", "modelo": "1", "serie": "A1" }, "tipo": "2", "dataEmissao": "2026-08-15", "valorDedutivel": 800.00, "valorDeducao": 800.00 }]
* | object | Servicio |
* Campo obligatorio
Documentos de deducción: solo el número
numeroDocumentoFiscal para documento fiscal sin clave, numeroDocumento para documento no fiscal; uno de los dos.
"documentos": [{ "numeroDocumento": "RECIBO-0099", "tipo": "99", "descricaoOutras": "Reembolso de despesas de viagem", "dataEmissao": "2026-08-15", "valorDedutivel": 300.00, "valorDeducao": 300.00 }]
* | object | Servicio |
* Campo obligatorio
Cuánto tributo hay en el precio, mostrado al consumidor. Una forma por nota. La empresa fuera del Simples que omite el grupo declara los porcentajes de la tabla de carga aproximada del IBPT, después de que la operación importa la tabla y cuando esta cubre el servicio; si no, los tributos calculados en importe. Para ella el emisor no acepta naoInformada ni percentualSimples.
En importe
Los tres importes van juntos, no negativos.
"cargaTributaria": { "valorFederal": 9415.00, "valorEstadual": 0, "valorMunicipal": 3500.00 }
* | object | Servicio |
* Campo obligatorio
En porcentaje
Porcentajes de 0 a 999,99; el ausente cuenta como 0.
"cargaTributaria": { "percentualFederal": 9.42, "percentualEstadual": 0, "percentualMunicipal": 3.5 }
* | object | Servicio |
* Campo obligatorio
Porcentaje del Simples
Solo empresa del Simples Nacional; 0 a 99,99.
"cargaTributaria": { "percentualSimples": 6 }
* | object | Servicio |
* Campo obligatorio
No informada
Solo empresa del Simples Nacional.
"cargaTributaria": { "naoInformada": true }
* | object | Servicio |
* Campo obligatorio
obra identifica la obra de un servicio de construcción por una única forma; eventoAtividade identifica el evento por código municipal o dirección.
Obra por el registro CNO o CEI
codigoObra solo; inscricaoImobiliaria y el documento de responsabilidad técnica son opcionales.
"obra": { "codigoObra": "12.345.67890/12", "inscricaoImobiliaria": "IPTU-000123" },"documentoResponsabilidadeTecnica": "ART-1234567890"
* | object | Servicio |
* Campo obligatorio
Obra por el CIB
codigoCib de 8 caracteres.
"obra": { "codigoCib": "AB123456" }
* | object | Servicio |
* Campo obligatorio
Obra por la dirección
Dirección sin cidade; nacional con cep de 8 dígitos.
"obra": { "endereco": { "cep": "01310100", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA" } }
* | object | Servicio |
* Campo obligatorio
Evento por el código municipal
identificacao hasta 30; dataFim no anterior a dataInicio.
"eventoAtividade": { "descricao": "Festival de musica 2026", "dataInicio": "2026-10-10", "dataFim": "2026-10-12", "identificacao": "EVT-2026-0101" }
* | object | Servicio |
* Campo obligatorio
Evento por la dirección
Misma dirección simple que la obra.
"eventoAtividade": { "descricao": "Festival de musica 2026", "dataInicio": "2026-10-10", "dataFim": "2026-10-12", "endereco": { "cep": "01310100", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA" } }
* | object | Servicio |
* Campo obligatorio
Campos libres que van a la nota sin afectar el cálculo.
Pedido, ítems y observaciones
itensPedido exige numeroPedido. observacoes y servico.informacoesComplementares ocupan el mismo campo de la nota; observacoes prevalece.
"servico": { "numeroPedido": "PO-2026-0042", "itensPedido": ["ITEM-001", "ITEM-002"], "documentoReferencia": "CONTRATO-2026-0042" },"observacoes": "Contrato 2026/0042 - medicao 2"
* | object | Servicio |
observacoes | string | Observaciones |
* Campo obligatorio
El grupo solo clasifica; los importes de IBS/CBS los calcula el emisor. Siempre con servico.codigoNbs. Antes de la vigencia oficial para el ambiente y el mes de competencia, enviar el grupo rechaza 10018001; en el canal de São Paulo el grupo es obligatorio.
Grupo mínimo
CST, clasificación e indicador de la operación, más el NBS en el servicio.
"servico": {"codigoNbs": "115011000","ibsCbs": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301" }}
* | object | Servicio |
* Campo obligatorio
Beneficiario distinto del tomador
destinatario solo cuando difiere de cliente; necesita documento y nome.
"ibsCbs": {"situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301","destinatario": { "tipoPessoa": "J", "nome": "FILIAL DO ANUNCIANTE LTDA", "cpfCnpj": "66500544000201", "email": "fiscal@anunciante.com.br" }}
* | object | Servicio |
* Campo obligatorio
Servicio sobre inmueble por el CIB
indicadorOperacao 02xxxx sin obra exige imovel; aquí identificado por codigoCib.
"ibsCbs": {"situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "020101","imovel": { "codigoCib": "AB123456", "inscricaoImobiliaria": "IPTU-000123" }}
* | object | Servicio |
* Campo obligatorio
Servicio sobre inmueble por la dirección
Dirección simple, sin cidade; nacional con cep de 8 dígitos.
"ibsCbs": {"situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "020101","imovel": { "endereco": { "cep": "01310100", "logradouro": "AVENIDA PAULISTA", "numero": "1000", "bairro": "BELA VISTA" } }}
* | object | Servicio |
* Campo obligatorio
Operación con ente gubernamental
tipoOperacao indica el momento del pago; tipoEnteGovernamental indica la esfera.
"ibsCbs": {"situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301","tipoOperacao": "1", "tipoEnteGovernamental": "4"}
* | object | Servicio |
* Campo obligatorio
Alícuota reducida con tributación regular
Clasificación de reducción en el grupo; tributacaoRegular dice cómo sería sin el beneficio, los dos campos juntos.
"ibsCbs": {"situacaoTributaria": "200", "classificacaoTributaria": "200052", "indicadorOperacao": "100301","tributacaoRegular": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" }}
* | object | Servicio |
* Campo obligatorio
Diferimiento
CST 510 o 515; los tres porcentajes van juntos.
"ibsCbs": {"situacaoTributaria": "510", "classificacaoTributaria": "510001", "indicadorOperacao": "100301","diferimento": { "percentualUf": 100, "percentualMunicipio": 100, "percentualCbs": 100 }}
* | object | Servicio |
* Campo obligatorio
Reembolso con clave electrónica
chaveDfe con tipoChaveDfe; el importe queda fuera de la base de ISS, IBS y CBS.
"reembolsos": [{ "chaveDfe": "35260840673061000134550010000001231000001235", "tipoChaveDfe": "2","fornecedor": { "tipoPessoa": "J", "nome": "VEICULO DE MIDIA LTDA", "cpfCnpj": "40673061000134" },"dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "04", "valor": 3000.00 }]
* | object | Servicio |
* Campo obligatorio
Reembolso con documento fiscal sin clave
documentoFiscal con municipio emisor, número y descripción.
"reembolsos": [{ "documentoFiscal": { "codigoMunicipio": 3550308, "numero": "778899", "descricao": "Nota de servico municipal" },"dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "02", "valor": 1500.00 }]
* | object | Servicio |
* Campo obligatorio
Reembolso con documento no fiscal
documentoOutro con número y descripción; tipo 99 exige descricaoTipo.
"reembolsos": [{ "documentoOutro": { "numero": "RECIBO-0099", "descricao": "Recibo de despesas" },"dataEmissao": "2026-08-20", "dataCompetencia": "2026-08-01", "tipo": "99", "descricaoTipo": "Reembolso de despesas pagas por conta do cliente", "valor": 250.00 }]
* | object | Servicio |
* Campo obligatorio
Pagos vinculados
Vincula la nota con los pagos que la liquidan. Validado y devuelto en la consulta, aún no transmitido; rechazado en el canal de São Paulo.
"pagamentosVinculados": [{ "sequencia": 1, "idTransacao": "E1234567820260918120000abcdef01", "meioPagamento": 17, "cnpjRecebedor": "40673061000134", "cnpjBasePsp": "18236120" }]
* | object | Servicio |
* Campo obligatorio
Notas referenciadas, consumo personal y crédito presunto
Campos opcionales independientes: claves de NFS-e referenciadas, usoConsumoPessoal y el código de crédito presunto.
"ibsCbs": {"situacaoTributaria": "000", "classificacaoTributaria": "000001", "indicadorOperacao": "100301","notasReferenciadas": ["35503082406730610001340000000000000000000000000077"],"usoConsumoPessoal": false,"creditoPresumido": "01"}
* | object | Servicio |
* Campo obligatorio
Cuando esta empresa no es la prestadora, declara el papel en emitente y envía al prestador en prestador; ella misma ocupa el lugar de tomador o intermediario. Con tomador CNPJ, envíe los importes en servico.retencoes, cero cuando no haya retención: la plataforma no conoce el régimen del prestador y sin ellos rechaza 10018023. No admitido en el canal de São Paulo.
Emite el tomador
emitente.tipo Tomador: esta empresa es el tomador, cliente no puede enviarse. motivo 4 lleva chaveAcessoRejeitada.
"emitente": { "tipo": "Tomador", "motivo": "2" },"prestador": {"tipoPessoa": "J", "nome": "PRESTADOR TERCEIRO LTDA", "cpfCnpj": "40673061000134", "inscricaoMunicipal": "12345678","endereco": { "cidade": 3550308, "cep": "01001000", "uf": "SP", "logradouro": "RUA DO PRESTADOR", "numero": "10", "bairro": "CENTRO" }},"servico": { "retencoes": { "inss": 0, "irrf": 0, "csll": 0 } }
* | object | Emisor |
* | object | Prestador del servicio |
* | object | Servicio |
* Campo obligatorio
Emite el intermediario
emitente.tipo Intermediario: esta empresa es el intermediario, intermediario no puede enviarse; cliente sigue siendo el tomador.
"emitente": { "tipo": "Intermediario", "motivo": "3" },"prestador": { "tipoPessoa": "J", "nome": "PRESTADOR TERCEIRO LTDA", "cpfCnpj": "40673061000134" },"cliente": { "tipoPessoa": "J", "nome": "TOMADOR TESTE LTDA", "cpfCnpj": "66500544000120" },"servico": { "retencoes": { "inss": 0, "irrf": 0, "csll": 0 } }
* | object | Emisor |
* | object | Prestador del servicio |
| object | Tomador |
*obligatorio con tomador CNPJ | object | Servicio |
* Campo obligatorio
La nueva nota sustituye a una ya autorizada; el resto de la solicitud es una emisión normal. No admitido en el canal de São Paulo: cancele y emita de nuevo.
Sustituir por error en la nota original
chaveAcessoSubstituida de 50 dígitos y codigoMotivo; motivo opcional de 15 a 255. Una nota ya sustituida rechaza 10018041.
"substituicao": {"chaveAcessoSubstituida": "35503082406730610001340000000000000000000000000077","codigoMotivo": "05","motivo": "Nota rejeitada pelo tomador responsavel pelo recolhimento"}
* | object | Sustitución |
* Campo obligatorio
Todo campo de texto queda en el rango Latin-1, sin espacios al inicio ni al final. Los caracteres chinos, los emoji, la puntuación de ancho completo y las rayas se rechazan: lo que la aceptación detecta devuelve 400, lo que solo aparece en la validación previa lleva la tarea a Falha con 10018063 y línea, columna y clave del error en el detalle. En ningún caso se consume numeración.
- Base del ISS =
valorServico−descontoIncondicionado− deducciones − beneficio municipal; tributo = base × alícuota. Deducciones y descuento por encima del importe del servicio se rechazan. - Alícuota del ISS: en el estándar nacional, la empresa fuera del Simples tiene el ISS calculado por el emisor con los parámetros municipales; la plataforma solo estima con
iss.aliquotao el parámetro municipal y, tras la autorización, graba el impuesto y el importe neto del retorno. Cuando la plataforma debe fijar la alícuota, rigeiss.aliquota, si no el parámetro municipal; sin ambos,10018020. - Simples Nacional sin ISS retenido: sin alícuota ni tributo en la nota (ISS por el DAS); con ISS retenido, cálculo normal.
iss.aliquotainformada rechaza10018022. - Beneficio municipal reduce la base del ISS, en porcentaje o en importe, y no el impuesto; una base negativa se rechaza.
- PIS/COFINS por el régimen de la empresa: Lucro Real no acumulativo 1,65 y 7,6, salvo los servicios del art. 10 de la Lei 10.833, acumulativos; demás regímenes acumulativo 0,65 y 3; exportación de servicio y competencia desde enero de 2027 sin importes. Base =
valorServico−descontoIncondicionado; el Simples no tiene importes. - Retenciones federales solo con tomador CNPJ: los valores informados prevalecen; si no, la plataforma calcula por la clasificación oficial de retención del servicio y los datos del tomador; si falta información,
10018023con la lista de lo que falta. - Importe neto =
valorServico− descuentos − ISS retenido − INSS, IRRF, CSLL, PIS y COFINS retenidos. - Documentos de deducción: la deducción es la suma de
valorDeducao. - Carga tributaria: declarada en la forma enviada; la empresa fuera del Simples sin el grupo declara los porcentajes del IBPT o, si la tabla no cubre el servicio, los tributos calculados en importe.
- IBS/CBS: la plataforma no calcula los importes; solo se envía la clasificación y el emisor graba los importes en la NFS-e devuelta.
- Validación previa: la declaración se valida contra el esquema oficial antes del envío; fuera de conformidad, la tarea pasa a
Falha(10018063o10018064) sin consumir numeración.
ambienteEmissaoAmbiente de emisión
| Valores | Significado |
|---|---|
| Homologacao | Ambiente de prueba; la nota no tiene validez |
| Producao | Ambiente oficial |
emitente.tipoPapel del emisor
Omitido vale Prestador. Canal de São Paulo: solo Prestador.
| Valores | Significado |
|---|---|
| Prestador | Esta empresa presta el servicio y emite |
| Tomador | Esta empresa es la tomadora y emite por el prestador; exige prestador y motivo, no envía cliente |
| Intermediario | Esta empresa es la intermediaria y emite por el prestador; exige prestador y motivo, no envía intermediario |
emitente.motivoMotivo de la emisión por el tomador o intermediario
| Valores | Significado |
|---|---|
| 1 | Importación de servicio |
| 2 | La legislación municipal obliga al tomador o al intermediario a emitir |
| 3 | El prestador se negó a emitir |
| 4 | La nota emitida por el prestador fue rechazada; informe chaveAcessoRejeitada |
substituicao.codigoMotivoMotivo de la sustitución
| Valores | Significado |
|---|---|
| 01 | Desencuadre de la nota del Simples Nacional |
| 02 | Encuadre de la nota en el Simples Nacional |
| 03 | Inclusión retroactiva de inmunidad o exención |
| 04 | Exclusión retroactiva de inmunidad o exención |
| 05 | Rechazo por el tomador o intermediario responsable del recaudo |
| 99 | Otros |
cliente.tipoPessoaTipo de persona
Vale para cliente, intermediario, prestador, servico.ibsCbs.destinatario y los fornecedor de los documentos. Omitido: 11 dígitos en cpfCnpj es F, 14 es J, solo nif es E.
| Valores | Significado |
|---|---|
| F | Persona física; documento CPF |
| J | Persona jurídica; documento CNPJ |
| E | Extranjera; nif o motivoSemNif |
cliente.motivoSemNifMotivo de la ausencia del NIF
Solo para parte extranjera sin nif; vale para todas las partes.
| Valores | Significado |
|---|---|
| NaoInformado | NIF no informado |
| Dispensado | Dispensado del NIF |
| NaoExigido | El país de origen no exige NIF |
cliente.orgaoPublicoEsfera pública del tomador
Solo cliente, para la retención federal calculada por la plataforma. Empresa pública y sociedad de economía mixta cuentan como Nenhum; las dependientes del presupuesto federal envían los importes retenidos.
| Valores | Significado |
|---|---|
| Nenhum | Persona jurídica privada |
| Federal | Órgano, autarquía o fundación pública federal; retiene impuesto a la renta, PIS, COFINS y CSLL |
| Estadual | Órgano, autarquía o fundación pública estatal o del Distrito Federal; retiene solo el impuesto a la renta |
| Municipal | Órgano, autarquía o fundación pública municipal; retiene solo el impuesto a la renta |
cliente.endereco.ufEstado de la dirección nacional
Solo cuando pais es BR; el extranjero envía el nombre del estado, provincia o región en texto libre. Vale para todas las direcciones.
| Valores | Significado |
|---|---|
| AC | Acre |
| AL | Alagoas |
| AP | Amapá |
| AM | Amazonas |
| BA | Bahia |
| CE | Ceará |
| DF | Distrito Federal |
| ES | Espírito Santo |
| GO | Goiás |
| MA | Maranhão |
| MT | Mato Grosso |
| MS | Mato Grosso do Sul |
| MG | Minas Gerais |
| PA | Pará |
| PB | Paraíba |
| PR | Paraná |
| PE | Pernambuco |
| PI | Piauí |
| RJ | Rio de Janeiro |
| RN | Rio Grande do Norte |
| RS | Rio Grande do Sul |
| RO | Rondônia |
| RR | Roraima |
| SC | Santa Catarina |
| SP | São Paulo |
| SE | Sergipe |
| TO | Tocantins |
servico.valores.deducoes.documentos[].tipoTipo de deducción
| Valores | Significado |
|---|---|
| 1 | Alimentación y bebidas o frigobar |
| 2 | Materiales |
| 3 | Producción externa |
| 4 | Reembolso de gastos |
| 5 | Traspaso consorciado |
| 6 | Traspaso de plan de salud |
| 7 | Servicios |
| 8 | Subcontratación de mano de obra |
| 9 | Profesional asociado |
| 99 | Otras deducciones; exige descricaoOutras |
servico.iss.tributacaoTributación del ISS
Omitido vale Tributavel.
| Valores | Significado |
|---|---|
| Tributavel | Gravado normalmente; acepta aliquota |
| Imunidade | Inmune; puede informar tipoImunidade |
| Exportacao | Exportación de servicio, ISS no debido; exige paisPrestacao o tomador extranjero |
| NaoIncidencia | No incidencia; rechazado en el canal de São Paulo |
servico.iss.retencaoRetención del ISS
Omitido vale NaoRetido.
| Valores | Significado |
|---|---|
| NaoRetido | El prestador lo recauda |
| RetidoTomador | El tomador retiene y recauda |
| RetidoIntermediario | El intermediario retiene y recauda |
servico.iss.tipoImunidadeTipo de inmunidad del ISS
Solo con tributacao Imunidade.
| Valores | Significado |
|---|---|
| 0 | Inmunidad sin tipo informado |
| 1 | Patrimonio, renta o servicios entre entes públicos |
| 2 | Templos de cualquier culto |
| 3 | Partidos políticos, sindicatos e instituciones de educación y asistencia social sin fines de lucro |
| 4 | Libros, periódicos, publicaciones y el papel para su impresión |
| 5 | Fonogramas y videofonogramas musicales producidos en Brasil |
servico.iss.exigibilidadeSuspensa.tipoVía de la exigibilidad suspendida
| Valores | Significado |
|---|---|
| Judicial | Suspendida por decisión judicial |
| Administrativa | Suspendida por proceso administrativo |
servico.pisCofins.situacaoTributariaCST del PIS/COFINS
Omitido vale 01.
| Valores | Significado |
|---|---|
| 00 | Ninguno |
| 01 | Operación gravada con alícuota básica |
| 02 | Operación gravada con alícuota diferenciada |
| 03 | Operación gravada con alícuota por unidad de medida |
| 04 | Operación gravada monofásica, reventa a alícuota cero |
| 05 | Operación gravada por sustitución tributaria |
| 06 | Operación gravada a alícuota cero |
| 07 | Operación exenta de la contribución |
| 08 | Operación sin incidencia de la contribución |
| 09 | Operación con suspensión de la contribución |
| 49 | Otras operaciones de salida |
| 50 | Con derecho a crédito, vinculada exclusivamente a ingreso gravado en el mercado interno |
| 51 | Con derecho a crédito, vinculada exclusivamente a ingreso no gravado en el mercado interno |
| 52 | Con derecho a crédito, vinculada exclusivamente a ingreso de exportación |
| 53 | Con derecho a crédito, vinculada a ingresos gravados y no gravados en el mercado interno |
| 54 | Con derecho a crédito, vinculada a ingresos gravados en el mercado interno y de exportación |
| 55 | Con derecho a crédito, vinculada a ingresos no gravados en el mercado interno y de exportación |
| 56 | Con derecho a crédito, vinculada a ingresos gravados y no gravados en el mercado interno y de exportación |
| 60 | Crédito presunto, adquisición vinculada exclusivamente a ingreso gravado en el mercado interno |
| 61 | Crédito presunto, adquisición vinculada exclusivamente a ingreso no gravado en el mercado interno |
| 62 | Crédito presunto, adquisición vinculada exclusivamente a ingreso de exportación |
| 63 | Crédito presunto, adquisición vinculada a ingresos gravados y no gravados en el mercado interno |
| 64 | Crédito presunto, adquisición vinculada a ingresos gravados en el mercado interno y de exportación |
| 65 | Crédito presunto, adquisición vinculada a ingresos no gravados en el mercado interno y de exportación |
| 66 | Crédito presunto, adquisición vinculada a ingresos gravados y no gravados en el mercado interno y de exportación |
| 67 | Crédito presunto, otras operaciones |
| 70 | Adquisición sin derecho a crédito |
| 71 | Adquisición con exención |
| 72 | Adquisición con suspensión |
| 73 | Adquisición a alícuota cero |
| 74 | Adquisición sin incidencia de la contribución |
| 75 | Adquisición por sustitución tributaria |
| 98 | Otras operaciones de entrada |
| 99 | Otras operaciones |
servico.pisCofins.retencaoRetención heredada del PIS/COFINS
Se ignora cuando se envía tipoRetencao.
| Valores | Significado |
|---|---|
| Retido | PIS y COFINS retenidos; equivale a tipoRetencao 1 |
| NaoRetido | PIS y COFINS no retenidos; equivale a tipoRetencao 2 |
servico.pisCofins.tipoRetencaoForma de retención de PIS, COFINS y CSLL
1 y 2 son valores de transición que la tabla oficial retirará; prefiera 0 y 3 a 9.
| Valores | Significado |
|---|---|
| 0 | PIS, COFINS y CSLL no retenidos |
| 1 | PIS y COFINS retenidos |
| 2 | PIS y COFINS no retenidos |
| 3 | PIS, COFINS y CSLL retenidos |
| 4 | PIS y COFINS retenidos, CSLL no retenida |
| 5 | PIS retenido, COFINS y CSLL no retenidas |
| 6 | COFINS retenida, PIS y CSLL no retenidos |
| 7 | PIS no retenido, COFINS y CSLL retenidas |
| 8 | PIS y COFINS no retenidos, CSLL retenida |
| 9 | COFINS no retenida, PIS y CSLL retenidos |
servico.retencoes.categoriaFederalClasificación de retención federal
Solo cuando la plataforma determina la retención. MonitoramentoEletronico y TransporteValoresReb exigen los importes retenidos en retencoes.
| Valores | Significado |
|---|---|
| ServicoProfissional | Servicio profesional de la lista del impuesto a la renta, como abogacía, ingeniería y consultoría |
| Treinamento | Enseñanza y capacitación |
| OrganizacaoEventos | Organización de ferias, congresos y eventos |
| LimpezaConservacao | Limpieza y conservación |
| Manutencao | Mantenimiento continuo; retiene PIS, COFINS y CSLL, sin impuesto a la renta |
| SegurancaVigilancia | Seguridad y vigilancia |
| LocacaoMaoDeObra | Suministro de mano de obra |
| AssessoriaCredito | Asesoría crediticia y gestión de cuentas por cobrar y por pagar |
| ComissaoCorretagem | Comisión, corretaje y representación comercial; solo impuesto a la renta |
| ComissaoAutoRetencao | Comisión cuyo impuesto a la renta recauda el propio prestador; el tomador no retiene |
| AgenciaPropaganda | Agencia de publicidad; la propia agencia recauda el impuesto a la renta |
| CooperativaTrabalho | Cooperativa de trabajo; retiene PIS y COFINS, sin CSLL |
| AssociacaoProfissionais | Asociación de profesionales |
| ServicoHospitalar | Servicio hospitalario |
| ConstrucaoCivil | Construcción civil |
| TransporteCargas | Transporte de cargas; sin retención de INSS |
| TransportePassageiros | Transporte de pasajeros |
| Hospedagem | Hospedaje |
| MonitoramentoEletronico | Monitoreo electrónico; sin INSS y sin cálculo automático: envíe los importes retenidos |
| LicenciamentoSoftware | Licenciamiento de software |
| LocacaoBens | Alquiler de bienes |
| FornecimentoBens | Suministro de bienes |
| ServicoRural | Servicio rural |
| ServicoIndustrial | Servicio de industrialización |
| ApoioAdministrativo | Apoyo administrativo y operativo |
| TransporteValoresReb | Transporte internacional de valores o astillero del REB; sin cálculo automático: envíe los importes retenidos |
| SemRetencaoFederal | Fuera de cualquier lista de retención federal |
servico.retencoes.modoContratacaoForma de contratación
Solo afecta la retención del INSS.
| Valores | Significado |
|---|---|
| CessaoMaoDeObra | Cesión de mano de obra: personal a disposición del tomador, en sus instalaciones o donde indique |
| Empreitada | Contrato de obra parcial o subcontrato ejecutado en las instalaciones del tomador |
| EmpreitadaTotal | Contrato de obra integral; sin retención de INSS |
| Resultado | Entrega por resultado, ni cesión de mano de obra ni contrato de obra; sin retención de INSS |
servico.retencoes.anexoSimplesAnexo del Simples Nacional
Solo prestador ME/EPP; vale para el ingreso de este servicio. Solo el anexo IV sufre retención de INSS por el tomador.
| Valores | Significado |
|---|---|
| 1 | Anexo I, comercio |
| 2 | Anexo II, industria |
| 3 | Anexo III, servicios |
| 4 | Anexo IV, servicios como construcción, vigilancia, limpieza y abogacía |
| 5 | Anexo V, servicios tributados por el factor R |
servico.comercioExterior.modoPrestacaoModo de prestación
| Valores | Significado |
|---|---|
| 0 | Desconocido, no informado en la nota de origen |
| 1 | Transfronterizo |
| 2 | Consumo en Brasil |
| 3 | Presencia comercial en el exterior |
| 4 | Movimiento temporal de personas físicas |
servico.comercioExterior.vinculoPartesVínculo entre las partes
| Valores | Significado |
|---|---|
| 0 | Sin vínculo |
| 1 | Controlada |
| 2 | Controladora |
| 3 | Coligada |
| 4 | Matriz |
| 5 | Filial o sucursal |
| 6 | Otro vínculo |
| 9 | Desconocido, no informado en la nota de origen |
servico.comercioExterior.mecanismoApoioPrestadorMecanismo de apoyo al comercio exterior del prestador
| Valores | Significado |
|---|---|
| 00 | Desconocido, no informado en la nota de origen |
| 01 | Ninguno |
| 02 | ACC, anticipo sobre contrato de cambio, reducción a cero del IR y del IOF |
| 03 | ACE, anticipo sobre cambiales entregadas, reducción a cero del IR y del IOF |
| 04 | BNDES-Exim posembarque, servicios |
| 05 | BNDES-Exim preembarque, servicios |
| 06 | FGE, Fondo de Garantía a la Exportación |
| 07 | PROEX ecualización |
| 08 | PROEX financiamiento |
servico.comercioExterior.mecanismoApoioTomadorMecanismo de apoyo al comercio exterior del tomador
| Valores | Significado |
|---|---|
| 00 | Desconocido, no informado en la nota de origen |
| 01 | Ninguno |
| 02 | Administración pública y representación internacional |
| 03 | Alquileres y arrendamiento mercantil de máquinas, equipos, embarcaciones y aeronaves |
| 04 | Arrendamiento mercantil de aeronave para empresa de transporte aéreo público |
| 05 | Comisión a agentes externos en la exportación |
| 06 | Gastos de almacenamiento, movimiento y transporte de carga en el exterior |
| 07 | Eventos FIFA, subsidiaria |
| 08 | Eventos FIFA |
| 09 | Fletes, arrendamientos de embarcaciones o aeronaves y otros |
| 10 | Material aeronáutico |
| 11 | Promoción de bienes en el exterior |
| 12 | Promoción de destinos turísticos brasileños |
| 13 | Promoción de Brasil en el exterior |
| 14 | Promoción de servicios en el exterior |
| 15 | RECINE |
| 16 | RECOPA |
| 17 | Registro y mantenimiento de marcas, patentes y cultivares |
| 18 | REICOMP |
| 19 | REIDI |
| 20 | REPENEC |
| 21 | REPES |
| 22 | RETAERO |
| 23 | RETID |
| 24 | Royalties, asistencia técnica, científica y asimilados |
| 25 | Servicios de evaluación de la conformidad vinculados a los acuerdos de la OMC |
| 26 | ZPE |
servico.comercioExterior.movimentacaoTemporariaBensMovimiento temporal de bienes
| Valores | Significado |
|---|---|
| 0 | Desconocido, no informado en la nota de origen |
| 1 | No vinculada |
| 2 | Vinculada a declaración de importación |
| 3 | Vinculada a declaración de exportación |
servico.ibsCbs.situacaoTributariaCST del IBS/CBS
Misma tabla para servico.ibsCbs.tributacaoRegular.situacaoTributaria.
| Valores | Significado |
|---|---|
| 000 | Tributación íntegra |
| 010 | Tributación con alícuotas uniformes |
| 011 | Tributación con alícuotas uniformes reducidas |
| 200 | Alícuota reducida |
| 220 | Alícuota fija |
| 221 | Alícuota fija proporcional |
| 222 | Reducción de base de cálculo |
| 400 | Exención |
| 410 | Inmunidad y no incidencia |
| 510 | Diferimiento |
| 515 | Diferimiento con reducción de alícuota |
| 550 | Suspensión |
| 620 | Tributación monofásica |
| 800 | Transferencia de crédito |
| 810 | Ajuste de IBS en la Zona Franca de Manaus |
| 811 | Ajustes |
| 820 | Tributación en documento específico |
| 830 | Exclusión de la base de cálculo |
servico.ibsCbs.classificacaoTributariaClasificación tributaria del IBS/CBS
Los 3 primeros dígitos son el CST. Misma tabla para servico.ibsCbs.tributacaoRegular.classificacaoTributaria.
| Valores | Significado |
|---|---|
| 000001 | Situaciones gravadas íntegramente por IBS y CBS |
| 000002 | Explotación de vía |
| 000003 | Régimen automotriz, proyectos incentivados (art. 311) |
| 000004 | Régimen automotriz, proyectos incentivados (art. 312) |
| 000005 | Etanol anhidro destinado a mezcla con gasolina A pero vendido con otro destino |
| 010001 | Operaciones del FGTS no realizadas por la Caixa Econômica Federal |
| 010002 | Operaciones del servicio financiero |
| 011001 | Planes de asistencia funeraria |
| 011002 | Planes de asistencia a la salud |
| 011003 | Intermediación de planes de asistencia a la salud |
| 011004 | Concursos y pronósticos |
| 011005 | Planes de asistencia a la salud de animales domésticos |
| 200001 | Transporte de bienes hacia las zonas de procesamiento de exportación y de bienes exportados desde ellas |
| 200002 | Suministro o importación para productor rural no contribuyente o TAC |
| 200003 | Venta de productos destinados a la alimentación humana (Anexo I) |
| 200004 | Suministro de dispositivos médicos (Anexo XII) |
| 200005 | Dispositivos médicos para órganos públicos y entidades de salud inmunes (Anexo IV) |
| 200006 | Emergencia de salud pública reconocida por el poder público |
| 200007 | Dispositivos de accesibilidad para personas con discapacidad (Anexo XIII) |
| 200008 | Dispositivos de accesibilidad adquiridos por órganos públicos (Anexo V) |
| 200009 | Suministro de medicamentos registrados en Anvisa |
| 200010 | Medicamentos registrados en Anvisa adquiridos por órganos públicos |
| 200011 | Nutrición enteral y parenteral adquirida por órganos públicos (Anexo VI) |
| 200012 | Emergencia de salud pública reconocida por el poder público |
| 200013 | Suministro de tampones y absorbentes higiénicos |
| 200014 | Hortalizas, frutas y huevos (Anexo XV) |
| 200015 | Automóviles de pasajeros nacionales adquiridos por conductores profesionales o personas con discapacidad |
| 200016 | Servicios de investigación y desarrollo por Institución Científica, Tecnológica y de Innovación (ICT) |
| 200017 | Operaciones relacionadas con el FGTS |
| 200018 | Operaciones de reaseguro y retrocesión |
| 200019 | Importador contribuyente de servicios financieros |
| 200020 | Operación de cooperativas bajo el régimen específico de IBS y CBS |
| 200021 | Transporte público colectivo de pasajeros ferroviario e hidroviario |
| 200022 | Bienes industrializados enviados desde fuera de la ZFM a contribuyente establecido en la ZFM |
| 200023 | Bienes intermedios entre industrias incentivadas en la ZFM |
| 200024 | Bienes enviados desde fuera de las Áreas de Libre Comercio a contribuyente establecido en ellas |
| 200025 | Servicios de educación relacionados con el programa Prouni |
| 200026 | Alquiler de inmuebles ubicados en zonas rehabilitadas |
| 200027 | Operaciones de alquiler, cesión onerosa y arrendamiento de bienes inmuebles |
| 200028 | Servicios de educación (Anexo II) |
| 200029 | Servicios de salud humana (Anexo III) |
| 200030 | Venta de dispositivos médicos (Anexo IV) |
| 200031 | Dispositivos de accesibilidad para personas con discapacidad (Anexo V) |
| 200032 | Medicamentos registrados en Anvisa o de farmacias de manipulación, salvo los sujetos a alícuota cero |
| 200033 | Nutrición enteral y parenteral (Anexo VI) |
| 200034 | Alimentos para consumo humano (Anexo VII) |
| 200035 | Productos de higiene personal y limpieza (Anexo VIII) |
| 200036 | Productos agropecuarios, acuícolas, pesqueros, forestales y extractivos vegetales in natura |
| 200037 | Servicios ambientales de conservación o recuperación de la vegetación nativa |
| 200038 | Insumos agropecuarios y acuícolas (Anexo IX) |
| 200039 | Producciones nacionales artísticas, culturales, de eventos, periodísticas y audiovisuales (Anexo X) |
| 200040 | Servicios de comunicación institucional a la administración pública |
| 200041 | Servicio de educación deportiva (art. 141, I) |
| 200042 | Servicio de gestión y explotación del deporte (art. 141, II) |
| 200043 | Bienes y servicios de soberanía para la administración pública (Anexo XI) |
| 200044 | Servicios de seguridad de la información y ciberseguridad de sociedad con socio brasileño (Anexo XI) |
| 200045 | Proyectos de rehabilitación urbana de zonas históricas y áreas críticas de recuperación urbanística |
| 200046 | Operaciones con bienes inmuebles |
| 200047 | Bares y restaurantes |
| 200048 | Hotelería, parques de diversiones y parques temáticos |
| 200049 | Transporte colectivo de pasajeros por carretera, ferroviario e hidroviario |
| 200050 | Transporte aéreo regional colectivo de pasajeros o de carga |
| 200051 | Agencias de turismo |
| 200052 | Servicios de profesiones intelectuales |
| 200053 | Medicamentos registrados en Anvisa clasificados como sueros o vacunas |
| 200054 | Bienes suministrados por cooperativa agropecuaria a asociado fuera del régimen regular |
| 220001 | Incorporación inmobiliaria sometida al régimen especial de tributación |
| 220002 | Incorporación inmobiliaria sometida al régimen especial de tributación |
| 220003 | Enajenación de inmueble derivada de parcelación del suelo |
| 221001 | Alquiler, cesión onerosa o arrendamiento de inmueble con alícuota sobre el ingreso bruto |
| 221002 | Incorporación inmobiliaria sometida al régimen especial de tributación |
| 221003 | Incorporación inmobiliaria sometida al régimen especial de tributación |
| 221004 | Enajenación de inmueble derivada de parcelación del suelo |
| 222001 | Transporte internacional de pasajeros cuando los tramos de ida y vuelta se venden juntos |
| 400001 | Transporte público colectivo de pasajeros por carretera y metro |
| 400002 | Transporte público colectivo de pasajeros por carretera y metro con medición por kilómetro recorrido |
| 410001 | Bonificaciones constantes en el documento que no dependen de evento posterior |
| 410002 | Transferencias entre establecimientos del mismo contribuyente |
| 410003 | Donaciones sin contraprestación en beneficio del donante |
| 410004 | Exportaciones de bienes y servicios |
| 410005 | Suministros de la Unión, los estados, el Distrito Federal y los municipios |
| 410006 | Suministros de entidades religiosas y templos |
| 410007 | Suministros de partidos políticos, sindicatos e instituciones de educación y asistencia social |
| 410008 | Libros, periódicos, publicaciones y el papel para su impresión |
| 410009 | Fonogramas y videofonogramas musicales producidos en Brasil |
| 410010 | Servicio de radiodifusión sonora y de sonidos e imágenes de recepción libre y gratuita |
| 410011 | Oro definido por ley como activo financiero o instrumento cambiario |
| 410012 | Suministro de condominio fuera del régimen regular |
| 410013 | Exportaciones de combustibles |
| 410014 | Suministro de productor rural no contribuyente |
| 410015 | Suministro por transportista autónomo no contribuyente |
| 410016 | Suministro o adquisición de residuos sólidos |
| 410017 | Adquisición de bien mueble con crédito presunto bajo condición de reventa |
| 410018 | Operaciones de fondos garantizadores y ejecutores de políticas públicas |
| 410019 | Exclusión de la propina de la base de cálculo en el suministro de alimentación |
| 410020 | Exclusión del valor de intermediación de la base de cálculo en el suministro de alimentación |
| 410021 | Contribución del art. 149-A de la Constitución Federal |
| 410022 | Consolidación de la propiedad del bien por el acreedor |
| 410023 | Enajenación de bienes muebles o inmuebles dados en garantía por un garante no contribuyente |
| 410024 | Consolidación de la propiedad del bien por el grupo de consorcio |
| 410025 | Enajenación de bien dado en garantía por un garante no contribuyente |
| 410026 | Donación con anulación de crédito |
| 410027 | Exportación de servicio o de bien inmaterial |
| 410028 | Operaciones con inmuebles realizadas por personas físicas no contribuyentes |
| 410029 | Operaciones amparadas solo por el ICMS |
| 410030 | Anulación de crédito por perecimiento, deterioro, robo, hurto o extravío |
| 410031 | Suministro anterior al inicio de vigencia de CBS e IBS |
| 410032 | Tributos de la operación que no integran la base de cálculo del IBS y de la CBS |
| 410033 | Operaciones de fondos de inversión inmobiliaria (FII) y de las cadenas productivas del agronegocio (Fiagro) |
| 410034 | Operaciones de fondos de inversión |
| 410035 | Suministro realizado por nanoemprendedor |
| 410036 | Descuentos incondicionales |
| 410037 | Importación de bienes materiales sin incidencia de IBS y CBS |
| 410999 | Operaciones no onerosas sin tributación no especificadas antes |
| 510001 | Operaciones con energía eléctrica sujetas a diferimiento: importación, generación, comercialización, distribución y transmisión |
| 515001 | Operaciones con insumos agropecuarios y acuícolas sujetas a diferimiento (Anexo IX) |
| 550001 | Exportaciones de bienes materiales |
| 550002 | Régimen de tránsito |
| 550003 | Regímenes de depósito (art. 85) |
| 550004 | Regímenes de depósito (art. 87) |
| 550005 | Regímenes de depósito (art. 87, párrafo único) |
| 550006 | Regímenes de permanencia temporal |
| 550007 | Regímenes de perfeccionamiento |
| 550008 | Importación de bienes bajo Repetro-Temporario |
| 550009 | GNL-Temporario |
| 550010 | Repetro-Permanente |
| 550011 | Repetro-Industrialización |
| 550012 | Repetro-Nacional |
| 550013 | Repetro-Depósito |
| 550014 | Zona de Procesamiento de Exportación |
| 550015 | Régimen tributario de incentivo a la modernización y ampliación portuaria |
| 550016 | Régimen especial de incentivos para el desarrollo de la infraestructura |
| 550017 | Régimen tributario de incentivo a la actividad naval |
| 550018 | Desgravación de la adquisición de bienes de capital |
| 550019 | Importación de bienes por industria incentivada para uso en la ZFM |
| 550020 | Áreas de libre comercio |
| 550021 | Industrialización destinada a exportaciones |
| 550022 | Régimen especial de incentivos para la producción de hidrógeno de baja emisión (Rehidro) |
| 550023 | Hidrocarburos líquidos no combustibles derivados de petróleo o gas natural, incluida la nafta |
| 550024 | Régimen tributario de incentivo a la actividad naval, Renaval (art. 107, II) |
| 550025 | Régimen tributario de incentivo a la actividad naval, Renaval (art. 107, III) |
| 620001 | Tributación monofásica sobre combustibles |
| 620002 | Tributación monofásica con responsabilidad de retención sobre combustibles |
| 620003 | Tributación monofásica con retención de tributos por terceros |
| 620004 | Tributación monofásica sobre mezcla de etanol con gasolina A superior al porcentaje obligatorio |
| 620005 | Tributación monofásica sobre mezcla de etanol con gasolina A inferior al porcentaje obligatorio |
| 620006 | Tributación monofásica sobre combustibles cobrada anteriormente |
| 620007 | Perecimiento, deterioro, robo, hurto o extravío en el régimen monofásico |
| 800001 | Fusión, escisión o incorporación |
| 800002 | Transferencia de crédito del asociado, incluidas las cooperativas singulares |
| 810001 | Crédito presunto sobre suministros desde la ZFM |
| 811001 | Anulación de crédito por salidas inmunes o exentas |
| 811002 | Débitos de facturas no procesadas en la liquidación |
| 811003 | Salida del Simples Nacional |
| 820001 | Documento con información de servicios de planes de asistencia a la salud del art. 234 de la LC 214/2025 |
| 820002 | Documento con información de servicios de planes de asistencia funeraria |
| 820003 | Documento con información de servicios de planes de asistencia a la salud de animales domésticos |
| 820004 | Documento con información de servicios de concursos de pronósticos |
| 820005 | Documento con información de enajenación de bienes inmuebles |
| 820006 | Documento con información de servicios de explotación de vía |
| 820007 | Documento con información de servicios financieros |
| 820008 | Documento con información de servicio continuado ya tributado en factura anterior |
| 820009 | Cobro relativo a suministros declarados en otro documento |
| 830001 | Documento con exclusión de la base de CBS e IBS de la energía eléctrica suministrada por la distribuidora a la unidad consumidora |
servico.ibsCbs.indicadorOperacaoIndicador de la operación
Los 2 primeros dígitos son el grupo de la operación. Los servicios en general usan 100301; 02xxxx exige imovel cuando no hay obra.
| Valores | Significado |
|---|---|
| 020101 | Operaciones con bienes inmuebles |
| 020201 | Operaciones con bienes inmuebles |
| 020301 | Operaciones con bienes inmuebles |
| 030101 | Servicios prestados sobre personas |
| 030102 | Servicios prestados sobre personas |
| 030103 | Servicios prestados sobre personas |
| 030104 | Servicios prestados sobre personas |
| 040101 | Eventos y ferias |
| 050101 | Operaciones con bienes muebles |
| 050102 | Operaciones con bienes muebles |
| 050103 | Operaciones con bienes muebles |
| 050104 | Operaciones con bienes muebles |
| 050201 | Operaciones con bienes muebles |
| 060101 | Transporte de pasajeros |
| 070101 | Transporte de carga |
| 070102 | Transporte de carga |
| 080101 | Operaciones con carreteras |
| 100101 | Demás suministros, incluidos los servicios en general |
| 100102 | Demás suministros, incluidos los servicios en general |
| 100201 | Demás suministros, incluidos los servicios en general |
| 100301 | Demás suministros, incluidos los servicios en general |
| 100302 | Demás suministros, incluidos los servicios en general |
| 100401 | Demás suministros, incluidos los servicios en general |
| 100501 | Demás suministros, incluidos los servicios en general |
| 100502 | Demás suministros, incluidos los servicios en general |
| 100601 | Demás suministros, incluidos los servicios en general |
servico.ibsCbs.finalidadeFinalidad de la NFS-e
Omitido vale 0.
| Valores | Significado |
|---|---|
| 0 | NFS-e regular |
servico.ibsCbs.tipoOperacaoTipo de operación
| Valores | Significado |
|---|---|
| 1 | Suministro con pago posterior |
| 2 | Pago recibido por suministro ya realizado |
| 3 | Suministro con pago ya realizado |
| 4 | Pago recibido por suministro posterior |
| 5 | Suministro y pago simultáneos |
servico.ibsCbs.tipoEnteGovernamentalTipo de ente gubernamental
| Valores | Significado |
|---|---|
| 1 | Unión |
| 2 | Estado |
| 3 | Distrito Federal |
| 4 | Municipio |
servico.ibsCbs.reembolsos[].tipoChaveDfeTipo del documento de la clave
| Valores | Significado |
|---|---|
| 1 | NFS-e |
| 2 | NF-e |
| 3 | CT-e |
| 9 | Otro; exige descricaoTipoChave |
servico.ibsCbs.reembolsos[].tipoNaturaleza del reembolso
| Valores | Significado |
|---|---|
| 01 | Traspaso de remuneración por intermediación de inmuebles a los demás corredores |
| 02 | Traspaso de importes a proveedor por suministro intermediado por agencia de turismo |
| 03 | Reembolso recibido por agencia de publicidad por servicios de producción externa pagados por cuenta de tercero |
| 04 | Reembolso recibido por agencia de publicidad por servicios de medios pagados por cuenta de tercero |
| 99 | Otros reembolsos por importes pagados por cuenta de tercero; exige descricaoTipo |
servico.ibsCbs.pagamentosVinculados[].meioPagamentoMedio de pago
| Valores | Significado |
|---|---|
| 15 | Boleto bancario |
| 17 | PIX por código QR dinámico |
| 18 | Transferencia electrónica TED |
| 20 | PIX por clave o código QR estático |
| 23 | PIX automático |
| 24 | Transferencia TEF |
| Código | HTTP | |
|---|---|---|
| 10018001 | 400 | Validación de parámetros rechazada en la aceptación; el mensaje indica el campo y el motivo. Incluye las reglas de ibsCbs: grupo antes de la vigencia, código fuera de la tabla oficial, codigoNbs ausente, grupos incompletos y las restricciones del canal de São Paulo. Incluye también el prestador del Simples Nacional o MEI que envía irrf, csll, pis o cofins por encima de cero, y un pisCofins.tipoRetencao enviado con tomador CNPJ sin importes en servico.retencoes, o que no coincide con ellos. |
| 10018004 | 400 | Empresa no habilitada para emitir: desactivada o certificado inutilizable. Verifique el estado de la empresa y el certificado. |
| 10018005 | 400 | La empresa no tiene perfil de NFS-e; el mensaje indica lo que falta. Cree el perfil enviando la sección emissaoNFSe en Registrar empresa. |
| 10018010 | 400 | El estándar de NFS-e del municipio aún no es compatible. Ese municipio no puede emitir; contacte con la plataforma. |
| 10018012 | 400 | Código de servicio ausente o fuera de la lista de la LC 116. Verifique servico.codigoTributacaoNacional. |
| 10018013 | 400 | Documento del tomador inválido. Verifique CPF, CNPJ o NIF. |
| 10018014 | 400 | Exportación de servicio sin país de destino. Envíe servico.paisPrestacao o un tomador extranjero. |
| 10018015 | 400 | El documento a sustituir no puede sustituirse. Verifique su estado. |
| 10018020 | 400 | No se pudo resolver la alícuota del ISS. Envíe servico.iss.aliquota o el servico.codigoTributacaoMunicipal correcto. |
| 10018022 | 400 | Una empresa del Simples Nacional no puede enviar alícuota de ISS. Elimine servico.iss.aliquota. |
| 10018023 | 400 | La retención federal no puede determinarse con los datos enviados; el mensaje lista de una vez las rutas de los campos que faltan: servico.retencoes.categoriaFederal, cliente.orgaoPublico, cliente.optanteSimplesNacional, servico.retencoes.modoContratacao, servico.retencoes.anexoSimples o servico.retencoes.inss/irrf/csll/pis/cofins. Informe lo que falta o envíe los importes retenidos en servico.retencoes; el último elemento solo se resuelve con los importes, pues aparece cuando la clasificación del servicio exige análisis manual o cuando esta empresa emite como tomadora o intermediaria. |
| 10018065 | 400 | Los datos de referencia fiscal de la NFS-e que necesita esta nota aún no se han importado; el rechazo siempre llega en la aceptación. Solo ocurre cuando un elemento que la solicitud no trajo debe consultarlo la plataforma; el mensaje lista cada elemento con una flecha hacia el campo de la solicitud que lo sustituye: retencao-federal -> servico.retencoes.inss/irrf/csll/pis/cofins, pis-cofins -> servico.pisCofins.aliquotaPis/aliquotaCofins, iss-local-incidencia -> servico.iss.municipioIncidencia.codigoIbge. Envíe esos campos en la solicitud o confirme con la plataforma que los datos están importados. El elemento iss-local-incidencia aparece con el lugar de la prestación en otro municipio, y basta con enviar servico.iss.municipioIncidencia. |
| 10018030 | 400 | La misma solicitud está en proceso. Reintente en breve. |
| 10018031 | 400 | Ese id ya fue emitido, o el mismo id llegó con contenido distinto. Use otro id o corrija el contenido. |
| 10018041 | 400 | El documento ya fue sustituido; no cabe otra operación sobre él. |
| 10018063 | 400 | La declaración no cumple el esquema oficial; el detalle trae línea, columna y clave del error. Causas habituales: texto fuera de Latin-1, dirección incompleta, código fuera de la tabla oficial. |
