Emitir NF-e

Parámetros de ruta

empresaId*

string

Identificador de la empresa emisora

* Campo obligatorio

Cuerpo de la petición

`id*`	string	Identificador de la solicitud
`ambienteEmissao*`	string	Ambiente
`finalidade`	string	Finalidad
`*` obligatorio en devolución, complementaria y ajuste	object	Factura original
`naturezaOperacao`	string	Naturaleza de la operación
`consumidorFinal`	bool	Consumidor final
`informacoesAdicionais`	string	Información adicional
`informacoesAdicionaisFisco`	string	Información al fisco
`*`	object	Pedido
`*`	object	Comprador
`*`	array	Ítems
	object	Transporte
	object	Cobro
`*` obligatorio en facturas de exportación	object	Exportación

* Campo obligatorio

200

Solicitud aceptada; sin cuerpo. La factura permanece en AguardandoAutorizacao hasta que la SEFAZ responda.

Sin cuerpo de respuesta

Tienda del Simples Nacional (CRT 1) vendiendo por internet a persona física. Solo hacen falta los cinco bloques del ejemplo; la tabla siguiente lista solo los campos a enviar, todo lo que no aparece queda fuera.

json

{
  "id": "NFe-000014553",
  "ambienteEmissao": "Homologacao",
  "pedido": {
    "presencaConsumidor": "OperacaoPelaInternet",
    "pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 56.94 } ] }
  },
  "cliente": {
    "tipoPessoa": "F", "nome": "Cliente Demo", "email": "cliente.demo@mail.com", "cpfCnpj": "88533234775",
    "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" }
  },
  "itens": [
    {
      "cfop": "6102", "codigo": "000068", "descricao": "Pendrive 16GB", "ncm": "85235190",
      "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 28.47,
      "impostos": {
        "icms": { "situacaoTributaria": "102" },
        "pis": { "situacaoTributaria": "49" },
        "cofins": { "situacaoTributaria": "49" }
      }
    }
  ]
}

`id*`	string	Identificador de la solicitud
`ambienteEmissao*`	string	Ambiente
`*`	object	Datos del pedido
`*`	object	Comprador
`*`	array	Ítems

* Campo obligatorio

Todo lo que va más allá de la factura simple es opcional; si se omite, la factura sale igual que en el escenario 2. Grupos disponibles:

naturezaOperacao, consumidorFinal, informacoesAdicionais, informacoesAdicionaisFisco: encabezado y observaciones.
pedido.intermediadorTransacao: marketplace que intermedió la venta (solo con presencia internet / fuera del establecimiento / otros).
pedido.pagamento.tipo (PagamentoAVista · PagamentoAPrazo), troco, formas[].descricao, credenciadoraCartao integrada (cnpj + bandeira + codigoAutorizacao).
cliente.indicadorContribuinteICMS, inscricaoMunicipal; para exportación cliente.idEstrangeiro, endereco.uf=EX, endereco.codigoPais, endereco.pais y exportacao.
transporte: frete.modalidade (sección Transporte), transportadora, veiculo, reboques, volumes, retencaoIcms, enderecoEntrega.
cobranca: fatura y parcelas (la suma de las cuotas = valor líquido).
itens[].valorFrete, valorSeguro, valorOutrasDespesas, producaoEmEscala, informacoesAdicionais, pedido.

Las secciones siguientes muestran cada grupo con ejemplo y los campos a completar; las violaciones devuelven 10004031 con la ruta del campo.

json

{
  "id": "NFe-000014554",
  "ambienteEmissao": "Producao",
  "naturezaOperacao": "Venda de mercadoria",
  "consumidorFinal": false,
  "informacoesAdicionais": "Pedido loja 77 - entrega em 5 dias uteis",
  "informacoesAdicionaisFisco": "ICMS recolhido conforme regime normal",
  "pedido": {
    "presencaConsumidor": "OperacaoPelaInternet",
    "intermediadorTransacao": { "cnpj": "12345678000195", "identificadorCadastro": "seller-778899" },
    "pagamento": {
      "tipo": "PagamentoAPrazo",
      "troco": 0,
      "formas": [
        { "tipo": "BoletoBancario", "valor": 60.00 },
        { "tipo": "CartaoDeCredito", "valor": 44.50, "credenciadoraCartao": { "tipoIntegracaoPagamento": "IntegradoAoSistemaDeGestao", "cnpj": "01027058000191", "bandeira": "Mastercard", "codigoAutorizacao": "123456" } }
      ]
    }
  },
  "cliente": {
    "tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123456789012",
    "indicadorContribuinteICMS": "ContribuinteICMS", "inscricaoMunicipal": "123456",
    "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }
  },
  "transporte": {
    "frete": { "modalidade": "PorContaDoEmitente" },
    "transportadora": { "cpfCnpj": "12345678000195", "nome": "Transportadora Demo LTDA", "inscricaoEstadual": "123456789", "enderecoCompleto": "Rua A, 10", "cidade": "Sao Paulo", "uf": "SP" },
    "veiculo": { "placa": "ABC1D23", "uf": "SP", "rntc": "000123456" },
    "volumes": [ { "quantidade": 2, "especie": "CAIXA", "marca": "MARCA X", "numeracao": "001-002", "pesoLiquido": 1.250, "pesoBruto": 1.500 } ],
    "enderecoEntrega": { "cpfCnpj": "11222333000181", "nome": "Deposito Demo", "uf": "SP", "cidade": "3550308", "logradouro": "Rua B", "numero": "20", "bairro": "Centro", "cep": "01001000", "telefone": "11999990000" }
  },
  "cobranca": {
    "fatura": { "numero": "FAT-2026-001", "valorOriginal": 104.50, "desconto": 0, "valorLiquido": 104.50 },
    "parcelas": [ { "numero": "001", "vencimento": "2026-10-30", "valor": 52.25 }, { "numero": "002", "vencimento": "2026-11-30", "valor": 52.25 } ]
  },
  "itens": [
    {
      "cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "origem": 0,
      "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 50.00, "valorDesconto": 0,
      "valorFrete": 3.00, "valorSeguro": 1.00, "valorOutrasDespesas": 0.50,
      "informacoesAdicionais": "Lote 2026-09",
      "pedido": { "numero": "PO-778899", "numeroItem": 3 },
      "impostos": {
        "icms": { "situacaoTributaria": "20", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001" },
        "pis": { "situacaoTributaria": "01", "aliquota": 1.65 },
        "cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }
      }
    }
  ]
}

Omitido vale Normal, la venta común de los escenarios 1 a 3. Los otros tres valores referencian una factura ya autorizada en esta plataforma por esta empresa: Devolucao devuelve mercancía, Complementar completa valor, cantidad o impuesto, Ajuste corrige sin circulación de mercancía. Cada uno se muestra abajo.

Complementar: completar una factura ya autorizada

Se usa cuando la factura original salió con precio, cantidad o impuesto de menos. Es una factura de salida normal que referencia la original en la cabecera; las líneas llevan solo la diferencia (el precio o la cantidad que faltó) con los impuestos calculados sobre ella, y el pago cubre ese importe. No envíe notaReferenciada en las líneas (10004022). Sin notaReferenciada.chaveAcesso se rechaza (10004028).

json

{
  "id": "NFe-000014561-C",
  "ambienteEmissao": "Producao",
  "finalidade": "Complementar",
  "notaReferenciada": { "chaveAcesso": "35241104893402000113550020000002621202427463" },
  "pedido": {
    "presencaConsumidor": "OperacaoPelaInternet",
    "pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 20.00 } ] }
  },
  "cliente": {
    "tipoPessoa": "F", "nome": "Cliente Demo", "cpfCnpj": "88533234775",
    "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }
  },
  "itens": [
    {
      "cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo - complemento de preco", "ncm": "85235190",
      "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 10.00,
      "impostos": {
        "icms": { "situacaoTributaria": "00", "aliquota": 18 },
        "pis": { "situacaoTributaria": "01", "aliquota": 1.65 },
        "cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }
      }
    }
  ]
}

`finalidade*`	string	Finalidad
`*`	object	Factura original
`naturezaOperacao`	string	Naturaleza de la operación
`pedido*`	object	Pedido
`cliente*`	object	Comprador
`*`	array	Ítems

* Campo obligatorio

Ajuste: corregir una factura ya autorizada

Factura sin circulación de mercancía, usada para corregir impuesto o inventario de una factura ya autorizada. Referencia la original en la cabecera, no tiene pago (la presencia sale NaoSeAplica y el pago SemPagamento, como en la devolución) y no vale para exportación. La línea describe lo que se ajusta; explique el motivo en informacoesAdicionais. Confirme con su contador el CFOP y los impuestos de cada caso.

json

{
  "id": "NFe-000014561-A",
  "ambienteEmissao": "Producao",
  "finalidade": "Ajuste",
  "notaReferenciada": { "chaveAcesso": "35241104893402000113550020000002621202427463" },
  "informacoesAdicionais": "Ajuste de ICMS referente a NF-e 262 serie 2",
  "pedido": {
    "presencaConsumidor": "NaoSeAplica",
    "pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] }
  },
  "cliente": {
    "tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123456789012",
    "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" }
  },
  "itens": [
    {
      "cfop": "5949", "codigo": "AJUSTE-ICMS", "descricao": "Ajuste de imposto", "ncm": "85235190",
      "quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 100.00,
      "impostos": {
        "icms": { "situacaoTributaria": "00", "aliquota": 18 },
        "pis": { "situacaoTributaria": "08" },
        "cofins": { "situacaoTributaria": "08" }
      }
    }
  ]
}

`finalidade*`	string	Finalidad
`*`	object	Factura original
`naturezaOperacao`	string	Naturaleza de la operación
`informacoesAdicionais`	string	Información adicional
`*`	object	Pedido
`cliente*`	object	Comprador
`*`	array	Ítems

* Campo obligatorio

Devolucao: devolver una factura ya autorizada

La factura de devolución es de entrada: referencia la factura original, usa CFOP y PIS/COFINS de entrada, no tiene pago y la presencia queda NaoSeAplica sola. Los parámetros de ICMS repiten los de la línea original.

json

{
  "id": "DEV-000014553",
  "ambienteEmissao": "Producao",
  "finalidade": "Devolucao",
  "notaReferenciada": { "chaveAcesso": "35241204893402000113650010000117691017244265" },
  "pedido": { "presencaConsumidor": "OperacaoPelaInternet", "pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] } },
  "cliente": { "tipoPessoa": "F", "nome": "Demo Client", "cpfCnpj": "88533234775", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" } },
  "itens": [
    {
      "cfop": "2202", "codigo": "000068", "descricao": "Pendrive Kingston 16GB", "ncm": "85235190",
      "quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 28.47,
      "notaReferenciada": { "numeroItem": 1 },
      "impostos": {
        "icms": { "situacaoTributaria": "102" },
        "pis": { "situacaoTributaria": "70", "aliquota": 0 },
        "cofins": { "situacaoTributaria": "70", "aliquota": 0 }
      }
    }
  ]
}

`finalidade*`	string	Finalidad
`*`	object	Factura original
`*`	object	Pedido
`*`	array	Ítems

* Campo obligatorio

tipoPessoa, cpfCnpj, inscricaoEstadual e indicadorContribuinteICMS deben combinar. La combinación decide si el comprador es contribuyente de ICMS, y eso decide qué códigos de ICMS pueden usarse (10004047). El comprador en el exterior está en la sección de exportación.

Persona física consumidora

El caso del e-commerce. Sin inscripción estatal y sin indicador: la plataforma lo trata como no contribuyente; solo códigos para no contribuyente.

json

"cliente": { "tipoPessoa": "F", "nome": "Cliente Demo", "cpfCnpj": "88533234775", "email": "cliente@mail.com", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Rua Presidente Wilson", "numero": "911", "bairro": "Uberaba", "cep": "81570440" } }

`tipoPessoa*`	string	Tipo de persona
`nome*`	string	Nombre o razón social
`cpfCnpj*`	string	CPF de 11 dígitos
`email`	string	Correo
`inscricaoMunicipal`	string	Inscripción municipal
`*`	object	Dirección del comprador

* Campo obligatorio

Empresa contribuyente de ICMS

Venta B2B. La inscripción estatal sola ya caracteriza al contribuyente; el indicador es opcional. Puede usar códigos de sustitución tributaria y el crédito del Simples.

json

"cliente": { "tipoPessoa": "J", "nome": "Revenda Demo LTDA", "cpfCnpj": "11222333000181", "inscricaoEstadual": "123.456.789.012", "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" } }

`tipoPessoa*`	string	Tipo de persona
`nome*`	string	Nombre o razón social
`cpfCnpj*`	string	CNPJ de 14 dígitos
`inscricaoEstadual*`	string	Inscripción estatal
`indicadorContribuinteICMS`	string	Indicador de contribuyente
`email`	string	Correo
`inscricaoMunicipal`	string	Inscripción municipal
`*`	object	Dirección del comprador

* Campo obligatorio

Empresa sin inscripción estatal

Empresa de servicios, condominio, organismo público. El indicador es obligatorio: sin él el CNPJ sin inscripción se rechaza (10004034). Tratada como no contribuyente.

json

"cliente": { "tipoPessoa": "J", "nome": "Servicos Demo LTDA", "cpfCnpj": "11222333000181", "indicadorContribuinteICMS": "NaoContribuinte", "endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Av. Paulista", "numero": "1000", "bairro": "Bela Vista", "cep": "01310100" } }

`tipoPessoa*`	string	Tipo de persona
`nome*`	string	Nombre o razón social
`cpfCnpj*`	string	CNPJ de 14 dígitos
`indicadorContribuinteICMS*`	string	Indicador de contribuyente
`email`	string	Correo
`inscricaoMunicipal`	string	Inscripción municipal
`*`	object	Dirección del comprador

* Campo obligatorio

Persona física con inscripción estatal (productor rural)

Caso raro. El indicador ContribuinteICMS es obligatorio: sin él, un CPF con inscripción se rechaza (10004031).

json

"cliente": { "tipoPessoa": "F", "nome": "Produtor Demo", "cpfCnpj": "88533234775", "inscricaoEstadual": "123.456.789.012", "indicadorContribuinteICMS": "ContribuinteICMS", "endereco": { "uf": "PR", "cidade": "4106902", "logradouro": "Estrada Rural", "numero": "S/N", "bairro": "Zona Rural", "cep": "81570440" } }

`tipoPessoa*`	string	Tipo de persona
`nome*`	string	Nombre o razón social
`cpfCnpj*`	string	CPF de 11 dígitos
`inscricaoEstadual*`	string	Inscripción estatal
`indicadorContribuinteICMS*`	string	Indicador de contribuyente
`email`	string	Correo
`inscricaoMunicipal`	string	Inscripción municipal
`*`	object	Dirección del comprador

* Campo obligatorio

cfop, codigo, descricao, ncm, quantidade, unidadeMedida, valorUnitario e impostos están en los escenarios 1 y 2. El total de la línea es quantidade × valorUnitario − valorDesconto + valorFrete + valorSeguro + valorOutrasDespesas; la suma de las líneas debe coincidir con el pago.

Línea con descuento, flete prorrateado, código de barras y pedido de compra

json

{
  "cfop": "5102", "codigo": "SKU-100", "descricao": "Produto demo", "ncm": "85235190", "ean": "7891149102105", "origem": 0,
  "quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 50.00,
  "valorDesconto": 5.00, "valorFrete": 3.00, "valorSeguro": 1.00, "valorOutrasDespesas": 0.50,
  "informacoesAdicionais": "Lote 2026-09",
  "pedido": { "numero": "PO-778899", "numeroItem": 3 },
  "impostos": { "icms": { "situacaoTributaria": "00", "aliquota": 18 }, "pis": { "situacaoTributaria": "01" }, "cofins": { "situacaoTributaria": "01" } }
}

`cfop*`	string	CFOP
`ean`	string	GTIN válido
`cest`	string	Solo producto con sustitución tributaria
`origem`	int	Origen del producto
`valorDesconto`	number	Descuento de la línea
`valorFrete`	number	Flete prorrateado en esta línea
`valorSeguro`	number	Seguro prorrateado en esta línea
`valorOutrasDespesas`	number	Otros gastos prorrateados en esta línea
`producaoEmEscala`	bool	Producción en escala
`informacoesAdicionais`	string	Observación de la línea
	object	Pedido de compra

* Campo obligatorio

Línea de combustible: diésel B vendido por la distribuidora

Toda línea de combustible líquido lleva el grupo combustivel; sin él la SEFAZ rechaza el CST monofásico. La plataforma verifica el código ANP contra la tabla oficial del Portal NF-e: la unidad de la línea debe ser la de la tabla (L o KG), el porcentaje de mezcla y los orígenes son obligatorios o prohibidos según el producto, y el importe por unidad del ICMS se completa desde la tabla cuando se omite. La venta de combustible a revendedor o distribuidora (CFOP 5.651 a 5.655, 6.651 a 6.656 y afines) exige transporte.transportadora con CNPJ o CPF; sin él la SEFAZ rechaza con 362 y la plataforma rechaza antes del envío. Sin circulación física, informe el CNPJ del propio emisor.

json

{
  "codigo": "DIESEL-B-S10",
  "descricao": "OLEO DIESEL B S10 COMUM",
  "ncm": "27101921",
  "cfop": "5656",
  "unidadeMedida": "L",
  "quantidade": 1000,
  "valorUnitario": 5.5,
  "combustivel": {
    "codigoANP": "820101034",
    "ufConsumo": "SP",
    "percentualBiocombustivel": 14,
    "origens": [{ "importado": false, "ufOrigem": "35", "percentual": 100 }]
  },
  "impostos": {
    "icms": { "situacaoTributaria": "61", "monofasico": { "valorIcmsRetidoAnteriormente": 1119.55 } },
    "pis": { "situacaoTributaria": "04" },
    "cofins": { "situacaoTributaria": "04" }
  }
}

`unidadeMedida*`	string	Unidad
`*`	object	Grupo de combustible

* Campo obligatorio

Las empresas del régimen normal (CRT 2 y 3) usan CST de 2 dígitos en itens[].impostos.icms.situacaoTributaria; un CSOSN de 3 dígitos se rechaza con 10004046. Cada caso siguiente muestra el bloque icms de la línea y los campos que lleva; lo que no aparece no debe enviarse (10004044). Porcentajes en número: 18 = 18 %.

CST 00: tributación integral

El caso más común de venta. Solo la alícuota; en la venta a otro estado a persona física el DIFAL se calcula solo.

json

"icms": { "situacaoTributaria": "00", "aliquota": 18 }

`situacaoTributaria*`	string	Código
`aliquota`	number	Alícuota de ICMS en %
`aliquotaFcp`	number	Alícuota del FCP
	object	DIFAL

* Campo obligatorio

CST 10: gravada con sustitución tributaria

El vendedor paga su propio ICMS y además retiene el de las ventas siguientes. Solo para comprador contribuyente (10004047).

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "10", "aliquota": 18, "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }

`situacaoTributaria*`	string	Código
`aliquota*`	number	Alícuota de ICMS en %
`*`	object	Grupo de ST
`cest*`	string	Código CEST de 7 dígitos del producto
`aliquotaFcp`	number	Alícuota del FCP
	object	Reparto

* Campo obligatorio

CST 20: reducción de base de cálculo

El impuesto incide sobre una base menor que el precio. Exige el código del beneficio fiscal del estado.

json

"icms": { "situacaoTributaria": "20", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001" }

`situacaoTributaria*`	string	Código
`aliquota*`	number	Alícuota de ICMS en %
`percentualReducaoBase*`	number	Reducción de la base
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`aliquotaFcp`	number	Alícuota del FCP
	object	DIFAL

* Campo obligatorio

CST 30: exenta con sustitución tributaria

El propio vendedor no paga ICMS, pero retiene el de las ventas siguientes. Solo para comprador contribuyente.

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "30", "codigoBeneficioFiscal": "SP800001", "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }

`situacaoTributaria*`	string	Código
`*`	object	Grupo de ST
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`cest*`	string	Código CEST de 7 dígitos del producto

* Campo obligatorio

CST 40 / 41 / 50: exenta, no gravada, suspendida

No hay ICMS en la línea. Solo el código de beneficio; no genera DIFAL. 41 es el código usual de exportación.

json

"icms": { "situacaoTributaria": "40", "codigoBeneficioFiscal": "SP800001" }

`situacaoTributaria*`	string	Código
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`substituicaoTributariaDestino`	object	ST del destino

* Campo obligatorio

CST 51: diferimiento

Parte del impuesto se aplaza a una etapa siguiente de la cadena.

json

"icms": { "situacaoTributaria": "51", "aliquota": 18, "percentualDiferimento": 100, "codigoBeneficioFiscal": "SP800001" }

`situacaoTributaria*`	string	Código
`aliquota*`	number	Alícuota de ICMS en %
`percentualDiferimento*`	number	Diferimiento
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`percentualReducaoBase`	number	Reducción de la base
`aliquotaFcp`	number	Alícuota del FCP
`percentualDiferimentoFcp`	number	Parte del FCP diferida

* Campo obligatorio

CST 60: ICMS ya retenido anteriormente

Producto con sustitución tributaria vendido al consumidor: el impuesto ya se pagó antes en la cadena. Sin alícuota.

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "60", "retencaoAnterior": { "baseCalculo": 45, "aliquota": 18 } } }

`situacaoTributaria*`	string	Código
`cest*`	string	Código CEST de 7 dígitos del producto
	object	Retención anterior
	object	ST del destino
	object	Tributación efectiva

* Campo obligatorio

CST 70: reducción de base con sustitución tributaria

Combina el CST 20 con la retención del CST 10. Solo para comprador contribuyente.

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "70", "aliquota": 18, "percentualReducaoBase": 33.33, "codigoBeneficioFiscal": "SP800001", "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }

`situacaoTributaria*`	string	Código
`aliquota*`	number	Alícuota de ICMS en %
`percentualReducaoBase*`	number	Reducción de la base
`*`	object	Grupo de ST
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`cest*`	string	Código CEST de 7 dígitos del producto
`aliquotaFcp`	number	Alícuota del FCP

* Campo obligatorio

CST 90: otras

Código combinado: cada grupo enviado se calcula, ninguno es obligatorio además del beneficio.

json

"icms": { "situacaoTributaria": "90", "codigoBeneficioFiscal": "SP800001", "aliquota": 18 }

`situacaoTributaria*`	string	Código
`codigoBeneficioFiscal*`	string	Código del beneficio fiscal del estado
`aliquota`	number	Alícuota de ICMS en %
`percentualReducaoBase`	number	Reducción de la base
`aliquotaFcp`	number	Alícuota del FCP
	object	Grupo de ST
	object	Reparto

* Campo obligatorio

CST 02 / 15 / 53 / 61: combustibles, tributación por unidad

El impuesto es un importe fijo por litro o kilo, no un porcentaje. 02 cobro propio, 15 propio y retención, 53 diferida, 61 ya cobrada antes. La línea debe llevar el grupo combustivel (sección Línea de producto). Los importes por unidad pueden omitirse: la plataforma los completa desde la tabla oficial del Portal NF-e y rechaza valores distintos. En 15 con diésel la retención sale con el 33,33 % del importe, como lo calcula la SEFAZ. Los combustibles derivados del petróleo no generan DIFAL; las empresas del Simples también usan estos CST.

json

"icms": { "situacaoTributaria": "15", "monofasico": { "quantidadeBaseCalculo": 7300, "quantidadeBaseCalculoRetencao": 2700 } }

`situacaoTributaria*`	string	Código
`*`	object	Grupo monofásico
`percentualDiferimento`	number	Diferimiento

* Campo obligatorio

Las empresas del Simples Nacional (CRT 1 y 4) usan CSOSN de 3 dígitos en situacaoTributaria; un CST de 2 dígitos se rechaza con 10004046. Ningún CSOSN lleva aliquota, difal, percentualDiferimento ni monofasico. Excepción: las líneas de combustible usan los CST 02, 15, 53 y 61 incluso en el Simples.

CSOSN 102 / 103 / 300 / 400: sin crédito

La venta común del Simples: solo el código.

json

"icms": { "situacaoTributaria": "102" }

situacaoTributaria*

string

Código

* Campo obligatorio

CSOSN 101: con permiso de crédito

Venta a empresa contribuyente que aprovechará el crédito. Solo para comprador contribuyente (10004047).

json

"icms": { "situacaoTributaria": "101", "percentualCreditoSimples": 1.25 }

`situacaoTributaria*`	string	Código
`percentualCreditoSimples*`	number	Crédito del Simples

* Campo obligatorio

CSOSN 201 / 202 / 203: con sustitución tributaria

El vendedor retiene el ICMS de las ventas siguientes. Solo para comprador contribuyente; 201 también da crédito.

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "201", "percentualCreditoSimples": 1.25, "substituicaoTributaria": { "mva": 40, "aliquota": 18 } } }

`situacaoTributaria*`	string	Código
`percentualCreditoSimples`	number	Solo en `201`
`*`	object	Grupo de ST
`cest*`	string	Código CEST de 7 dígitos del producto

* Campo obligatorio

CSOSN 500: ICMS ya retenido anteriormente

Producto con sustitución vendido al consumidor por el Simples.

json

"cest": "0300100",
"impostos": { "icms": { "situacaoTributaria": "500" } }

`situacaoTributaria*`	string	Código
`cest*`	string	Código CEST de 7 dígitos del producto
	object	Retención anterior

* Campo obligatorio

CSOSN 900: otros

Código combinado: cada grupo enviado se calcula, ninguno es obligatorio.

json

"icms": { "situacaoTributaria": "900" }

`situacaoTributaria*`	string	Código
`percentualCreditoSimples`	number	Crédito del Simples
`percentualReducaoBase`	number	Reducción de la base
	object	Grupo de ST

* Campo obligatorio

pis y cofins son dos bloques separados con los mismos campos; los códigos casi siempre coinciden. 01–49 son de salida (venta); 50–98 son de entrada y solo valen en facturas de devolución; 99 vale en ambos sentidos. Alícuotas en %: 1,65 = 1,65 %.

CST 01 / 02: gravable por alícuota

Régimen normal no acumulativo. 01 usa las alícuotas básicas 1,65 y 7,6; 02 usa alícuota diferenciada.

json

"pis": { "situacaoTributaria": "01", "aliquota": 1.65 },
"cofins": { "situacaoTributaria": "01", "aliquota": 7.6 }

`situacaoTributaria*`	string	Código
`aliquota`	number	Alícuota en %

* Campo obligatorio

CST 03: gravable por unidad

El tributo es un importe fijo por unidad vendida, no un porcentaje.

json

"pis": { "situacaoTributaria": "03", "quantidadeBaseCalculo": 100, "valorUnitarioTributo": 0.1 },
"cofins": { "situacaoTributaria": "03", "quantidadeBaseCalculo": 100, "valorUnitarioTributo": 0.46 }

`situacaoTributaria*`	string	Código
`valorUnitarioTributo*`	number	Tributo por unidad
`quantidadeBaseCalculo`	number	Cantidad gravada

* Campo obligatorio

CST 04 a 09: sin tributo en la venta

Solo el código. 05 admite el grupo de retención cuando el vendedor recauda por el comprador.

json

"pis": { "situacaoTributaria": "07" },
"cofins": { "situacaoTributaria": "07" }

`situacaoTributaria*`	string	Código
`substituicaoTributaria`	object	Grupo de ST

* Campo obligatorio

CST 49 / 99: otras operaciones

Lo usual del vendedor del Simples. Solo el código; la alícuota queda 0.

json

"pis": { "situacaoTributaria": "49" },
"cofins": { "situacaoTributaria": "49" }

situacaoTributaria*

string

Código

* Campo obligatorio

CST 50 a 75 y 98: entrada, solo en facturas de devolución

En la devolución la factura es de entrada, así que PIS/COFINS usan código de entrada y la alícuota es obligatoria (0 cuando no hay tributo). 70 con alícuota 0 es lo usual al devolver una venta del Simples.

json

"pis": { "situacaoTributaria": "70", "aliquota": 0 },
"cofins": { "situacaoTributaria": "70", "aliquota": 0 }

`situacaoTributaria*`	string	Código
`aliquota*`	number	Alícuota en %

* Campo obligatorio

IBS y CBS son los dos impuestos de la reforma tributaria de 2026: el IBS sustituye a ICMS e ISS, la CBS sustituye a PIS y COFINS. En 2026 solo se informan, con alícuotas de prueba. Las empresas del régimen normal (CRT 3) llevan el grupo en toda factura; las del Simples solo desde 2027 (lo enviado se ignora). En la venta común no envíe nada: la plataforma graba 000 con clasificación 000001. Los casos siguientes son las excepciones; enviado en una línea, el grupo debe ir en todas.

IBS/CBS 200: alícuota reducida

El porcentaje de reducción viene del código de clasificación.

json

"ibsCbs": { "situacaoTributaria": "200", "classificacaoTributaria": "200003" }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación

* Campo obligatorio

IBS/CBS 410: inmunidad o no incidencia

No sale ningún importe de impuesto en la factura.

json

"ibsCbs": { "situacaoTributaria": "410", "classificacaoTributaria": "410001" }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación

* Campo obligatorio

IBS/CBS 510 / 515: diferimiento

515 combina diferimiento con alícuota reducida.

json

"ibsCbs": { "situacaoTributaria": "510", "classificacaoTributaria": "510001", "percentualDiferimento": 100 }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación
`percentualDiferimento*`	number	Diferimiento

* Campo obligatorio

IBS/CBS 550: suspensión

Declare en tributacaoRegular cómo se tributaría sin la suspensión.

json

"ibsCbs": { "situacaoTributaria": "550", "classificacaoTributaria": "550001", "tributacaoRegular": { "situacaoTributaria": "000", "classificacaoTributaria": "000001" } }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación
`*`	object	Tributación regular

* Campo obligatorio

IBS/CBS 620: combustibles por unidad

json

"ibsCbs": { "situacaoTributaria": "620", "classificacaoTributaria": "620001", "monofasico": { "quantidadeBaseCalculo": 100, "aliquotaAdRemIbs": 0.2, "aliquotaAdRemCbs": 0.1 } }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación
`monofasico*`	object	Grupo monofásico

* Campo obligatorio

IBS/CBS 800 / 810 / 811: crédito transferido, crédito de la Zona Franca, ajustes

json

"ibsCbs": { "situacaoTributaria": "800", "classificacaoTributaria": "800001", "transferenciaCredito": { "valorIbs": 10.00, "valorCbs": 4.00 } }

`situacaoTributaria*`	string	Código
`classificacaoTributaria*`	string	Clasificación
`transferenciaCredito`	object	Solo en `800`
`zonaFrancaManaus`	object	Solo en `810`
`ajuste`	object	Solo en `811`

* Campo obligatorio

Crédito presunto (creditoPresumido), opcional en cualquier situación

Solo cuando el código de clasificación admite crédito presunto.

json

"ibsCbs": { "situacaoTributaria": "000", "classificacaoTributaria": "000001", "creditoPresumido": { "codigo": "01", "percentualIbs": 2, "percentualCbs": 1, "suspensivo": false, "deduzir": true } }

object

Crédito presunto

* Campo obligatorio

Cada forma lleva tipo y valor. La suma de los importes menos troco debe ser igual al total de la factura. Los casos siguientes cubren los 22 tipos.

Efectivo, cheque, boleto, depósito, transferencia, vales, crédito de tienda, saldo en tienda, fidelidad

Solo tipo e importe. Ninguno de estos acepta el grupo de la terminal de tarjeta.

json

"pagamento": { "formas": [ { "tipo": "BoletoBancario", "valor": 56.94 } ] }

*

array

Formas de pago

* Campo obligatorio

Tarjeta de crédito, tarjeta de débito, Pix: terminal no integrada

El caso normal del e-commerce: la terminal o el Pix no se comunica con el sistema de emisión. El grupo credenciadoraCartao puede incluso omitirse; la plataforma declara terminal no integrada.

json

"pagamento": { "formas": [ { "tipo": "CartaoDeCredito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "NaoIntegradoAoSistemaDeGestao", "bandeira": "Mastercard" } } ] }

*

array

Formas de pago

* Campo obligatorio

Tarjeta o Pix con terminal integrada al sistema de emisión

Tienda física con TEF integrado. Los tres datos de la transacción son obligatorios (10004031 si falta).

json

"pagamento": { "formas": [ { "tipo": "CartaoDeDebito", "valor": 56.94, "credenciadoraCartao": { "tipoIntegracaoPagamento": "IntegradoAoSistemaDeGestao", "cnpj": "01027058000191", "bandeira": "Visa", "codigoAutorizacao": "123456" } } ] }

*

array

Formas de pago

* Campo obligatorio

Otros

Cualquier medio fuera de la tabla; la descripción es obligatoria.

json

"pagamento": { "formas": [ { "tipo": "Outros", "valor": 56.94, "descricao": "Vale-troca" } ] }

*

array

Formas de pago

* Campo obligatorio

Varias formas y vuelto

La suma de las formas menos el vuelto debe ser exactamente el total de la factura; cualquier diferencia se rechaza.

json

"pagamento": { "troco": 3.06, "formas": [ { "tipo": "Dinheiro", "valor": 40.00 }, { "tipo": "PagamentoInstantaneoPix", "valor": 20.00 } ] }

`formas*`	array	Formas de pago
`troco`	number	Vuelto

* Campo obligatorio

Venta a plazo (PagamentoAPrazo)

Normalmente con boleto. Para registrar las cuotas use también el grupo cobranca.

json

"pagamento": { "tipo": "PagamentoAPrazo", "formas": [ { "tipo": "BoletoBancario", "valor": 100.00 } ] }

`tipo*`	string	Plazo del pago
`formas*`	array	Formas de pago

* Campo obligatorio

Pago posterior (PagamentoPosterior)

No se cobró nada o solo una parte al emitir. La forma PagamentoPosterior va con valor 0; con ella la suma de las formas puede quedar por debajo del total de la factura, sin vuelto.

json

"pagamento": { "formas": [ { "tipo": "Dinheiro", "valor": 20.00 }, { "tipo": "PagamentoPosterior", "valor": 0 } ] }

*

array

Formas de pago

* Campo obligatorio

Sin pago (SemPagamento), solo en devolución

Única forma de la lista, valor 0. En una venta normal el fisco lo rechaza.

json

"pagamento": { "formas": [ { "tipo": "SemPagamento", "valor": 0 } ] }

*

array

Formas de pago

* Campo obligatorio

Sin el grupo transporte la factura sale como SemFrete, sin flete declarado: el caso de quien no quiere informar logística. Con SemFrete no envíe transportadora, veiculo ni retencaoIcms (10004031).

Flete con transportista contratada

PorContaDoEmitente, PorContaDoDestinatario o PorContaDeTerceiros. Todos los subgrupos son opcionales; informe lo que sepa.

json

"transporte": {
  "frete": { "modalidade": "PorContaDoEmitente" },
  "transportadora": { "cpfCnpj": "12345678000195", "nome": "Transportadora Demo LTDA", "inscricaoEstadual": "123456789", "enderecoCompleto": "Rua A, 10", "cidade": "Curitiba", "uf": "PR" },
  "volumes": [ { "quantidade": 2, "especie": "CAIXA", "numeracao": "001-002", "pesoLiquido": 1.250, "pesoBruto": 1.500 } ]
}

`*`	object	Flete
	object	Transportista
	array	Bultos

* Campo obligatorio

Transporte propio, con vehículo

TransporteProprioPorContaDoRemetente o TransporteProprioPorContaDoDestinatario. Remolques solo junto con el vehículo, hasta 5.

json

"transporte": {
  "frete": { "modalidade": "TransporteProprioPorContaDoRemetente" },
  "veiculo": { "placa": "ABC1D23", "uf": "PR", "rntc": "000123456" },
  "reboques": [ { "placa": "XYZ9Z99", "uf": "PR" } ],
  "volumes": [ { "quantidade": 10, "especie": "PALLET" } ]
}

`*`	object	Flete
	object	Vehículo
	array	Remolques
	array	Bultos

* Campo obligatorio

ICMS retenido sobre el flete

Cuando el vendedor retiene el ICMS del servicio de transporte. Los seis campos son obligatorios y valor debe ser baseCalculo × aliquota. No combina con SemFrete.

json

"transporte": {
  "frete": { "modalidade": "PorContaDoEmitente" },
  "retencaoIcms": { "valorServico": 100.00, "baseCalculo": 100.00, "aliquota": 12, "valor": 12.00, "cfop": "5352", "codigoMunicipio": "4106902" }
}

*

object

ICMS retenido del flete

* Campo obligatorio

Dirección de entrega distinta del comprador

Puede ir con cualquier modalidad, incluso SemFrete. cidade es el código IBGE, como en la dirección del comprador.

json

"transporte": {
  "enderecoEntrega": { "cpfCnpj": "11222333000181", "nome": "Deposito Demo", "uf": "PR", "cidade": "4106902", "logradouro": "Rua B", "numero": "20", "bairro": "Centro", "cep": "80010000", "telefone": "41999990000" }
}

*

object

Dirección de entrega

* Campo obligatorio

`ambienteEmissao`Ambiente de emisión

Valores	Significado
Homologacao	Ambiente de prueba de la SEFAZ; la factura no tiene validez
Producao	Ambiente oficial

`finalidade`Finalidad de la factura

Omitido vale Normal.

Valores	Significado
Normal	Venta común
Complementar	Factura complementaria: completa valor, cantidad o impuesto de una factura ya autorizada
Ajuste	Factura de ajuste: corrige una factura ya autorizada sin circulación de mercancía
Devolucao	Devolución de una factura ya autorizada

`cliente.tipoPessoa`Tipo de comprador

Valores	Significado
F	Persona física (CPF)
J	Persona jurídica (CNPJ)

`cliente.indicadorContribuinteICMS`Situación del comprador ante el ICMS

Omitido: CNPJ con inscripción estatal es contribuyente, los demás no.

Valores	Significado
ContribuinteICMS	Contribuyente; exige `inscricaoEstadual`
ContribuinteIsento	Exento de inscripción estatal
NaoContribuinte	No contribuyente

`cliente.endereco.uf`Estado del comprador

También vale para transporte.transportadora.uf, transporte.veiculo.uf, transporte.enderecoEntrega.uf y exportacao.ufEmbarque (sin EX).

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
EX	Exterior (factura de exportación)

`pedido.presencaConsumidor`Presencia del comprador

Valores	Significado
NaoSeAplica	No aplica; solo en devolución
OperacaoPresencial	Venta presencial en la tienda
OperacaoPelaInternet	Venta por internet
OperacaoPorTelefone	Venta por teléfono
EntregaEmDomicilio	Venta cerrada en la entrega a domicilio
OperacaoPresencialForaDoEstabelecimento	Venta presencial fuera de la tienda: ferias, vendedor externo
Outros	Otros

`pedido.pagamento.tipo`Plazo del pago

Omitido vale PagamentoAVista.

Valores	Significado
PagamentoAVista	Al contado
PagamentoAPrazo	A plazo; registre las cuotas en `cobranca`

`pedido.pagamento.formas[].tipo`Forma de pago

Valores	Significado
Dinheiro	Efectivo
Cheque	Cheque
CartaoDeCredito	Tarjeta de crédito
CartaoDeDebito	Tarjeta de débito
CreditoLoja	Crédito de tienda
ValeAlimentacao	Vale de alimentación
ValeRefeicao	Vale de comida
ValePresente	Vale de regalo
ValeCombustivel	Vale de combustible
BoletoBancario	Boleto bancario
DepositoBancario	Depósito bancario
PagamentoInstantaneoPix	Pix
TransferenciaBancaria	Transferencia bancaria
ProgramaDeFidelidade	Programa de fidelidad o cashback
PagamentoInstantaneoPixEstatico	Pix estático: QR estático, clave Pix o datos de la cuenta
CreditoEmLoja	Saldo en tienda de un pago anterior o devolución
PagamentoEletronicoNaoInformado	Pago electrónico no informado; solo con falla de hardware
PagamentoInstantaneoPixAutomatico	Pix automático, cobro recurrente
TransferenciaTefBookTransfer	Transferencia TEF entre cuentas del mismo banco
SemPagamento	Sin pago; solo en devolución, solo y con valor 0
PagamentoPosterior	Pago posterior; valor 0, la suma puede quedar por debajo del total
Outros	Otros; exige `descricao`

`pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamento`Integración de la terminal de tarjeta

Omitido vale NaoIntegradoAoSistemaDeGestao.

Valores	Significado
NaoIntegradoAoSistemaDeGestao	Terminal no integrada; solo `bandeira`
IntegradoAoSistemaDeGestao	Terminal integrada; exige `cnpj`, `bandeira` y `codigoAutorizacao`

`pedido.pagamento.formas[].credenciadoraCartao.bandeira`Marca de la tarjeta

Sin distinguir mayúsculas; la plataforma lo convierte al código oficial.

Valores	Significado
Visa	Visa
Mastercard	Mastercard
AmericanExpress	AmericanExpress
Sorocred	Sorocred
DinersClub	DinersClub
Elo	Elo
Hipercard	Hipercard
Aura	Aura
Cabal	Cabal
Alelo	Alelo
BanesCard	BanesCard
CalCard	CalCard
Credz	Credz
Discover	Discover
GoodCard	GoodCard
GreenCard	GreenCard
Hiper	Hiper
JcB	JcB
Mais	Mais
MaxVan	MaxVan
Policard	Policard
RedeCompras	RedeCompras
Sodexo	Sodexo
ValeCard	ValeCard
Verocheque	Verocheque
VR	VR
Ticket	Ticket
Outros	Otra marca

`transporte.frete.modalidade`Modalidad del flete

Omitido vale SemFrete.

Valores	Significado
SemFrete	Sin flete; no envíe transportista, vehículo ni retención
PorContaDoEmitente	Flete por cuenta del vendedor
PorContaDoDestinatario	Flete por cuenta del comprador
PorContaDeTerceiros	Flete por cuenta de terceros
TransporteProprioPorContaDoRemetente	Transporte propio del vendedor
TransporteProprioPorContaDoDestinatario	Transporte propio del comprador

`itens[].origem`Origen del producto

Omitido vale 0. 1 / 2 / 3 / 8 usan la alícuota interestatal del 4 %.

Valores	Significado
0	Nacional
1	Importado directamente
2	Importado, comprado en el mercado interno
3	Nacional con más del 40 % de contenido importado
4	Nacional por proceso productivo básico
5	Nacional con hasta 40 % de contenido importado
6	Importado directamente, sin similar nacional
7	Importado del mercado interno, sin similar nacional
8	Nacional con más del 70 % de contenido importado

`itens[].impostos.icms.situacaoTributaria`CST del ICMS (régimen normal, CRT 2 / 3)

Valores	Significado
00	Gravada íntegramente
02	Monofásica propia (combustibles)
10	Gravada con cobro de ST
15	Monofásica propia y con retención (combustibles)
20	Con reducción de base de cálculo
30	Exenta o no gravada, con cobro de ST
40	Exenta
41	No gravada
50	Suspensión
51	Diferimiento
53	Monofásica con diferimiento (combustibles)
60	ICMS cobrado anteriormente por ST
61	Monofásica cobrada anteriormente (combustibles)
70	Con reducción de base y cobro de ST
90	Otras

`itens[].impostos.icms.situacaoTributaria`CSOSN del ICMS (Simples Nacional, CRT 1 / 4)

Valores	Significado
101	Gravada con permiso de crédito
102	Gravada sin permiso de crédito
103	Exención por franja de ingresos
201	Gravada con permiso de crédito y cobro de ST
202	Gravada sin permiso de crédito y con cobro de ST
203	Exención por franja de ingresos, con cobro de ST
300	Inmune
400	No gravada
500	ICMS cobrado anteriormente por ST
900	Otros

`itens[].impostos.pis.situacaoTributaria`CST del PIS

Valores	Significado
01	Gravado a la alícuota básica
02	Gravado a alícuota diferenciada
03	Gravado por cantidad
04	Monofásico, reventa a alícuota cero
05	Sustitución tributaria
06	Alícuota cero
07	Exenta
08	Sin incidencia (exportación)
09	Suspensión
49	Otras operaciones de salida
50–56	Entrada con derecho a crédito, por tipo de ingreso (solo devolución)
60–66	Entrada con crédito presunto, por tipo de ingreso (solo devolución)
67	Crédito presunto, otras operaciones (solo devolución)
70	Entrada sin derecho a crédito
71	Entrada con exención
72	Entrada con suspensión
73	Entrada a alícuota cero
74	Entrada sin incidencia
75	Entrada por sustitución tributaria
98	Otras operaciones de entrada
99	Otras operaciones

`itens[].impostos.cofins.situacaoTributaria`CST de la COFINS

Misma tabla que el PIS.

Valores	Significado
01	Gravado a la alícuota básica
02	Gravado a alícuota diferenciada
03	Gravado por cantidad
04	Monofásico, reventa a alícuota cero
05	Sustitución tributaria
06	Alícuota cero
07	Exenta
08	Sin incidencia (exportación)
09	Suspensión
49	Otras operaciones de salida
50–56	Entrada con derecho a crédito, por tipo de ingreso (solo devolución)
60–66	Entrada con crédito presunto, por tipo de ingreso (solo devolución)
67	Crédito presunto, otras operaciones (solo devolución)
70	Entrada sin derecho a crédito
71	Entrada con exención
72	Entrada con suspensión
73	Entrada a alícuota cero
74	Entrada sin incidencia
75	Entrada por sustitución tributaria
98	Otras operaciones de entrada
99	Otras operaciones

`itens[].impostos.ipi.situacaoTributaria`CST del IPI

Valores	Significado
00	Entrada con recuperación de crédito
01	Entrada gravada a alícuota cero
02	Entrada exenta
03	Entrada no gravada
04	Entrada inmune
05	Entrada con suspensión
49	Otras entradas
50	Salida gravada
51	Salida gravada a alícuota cero
52	Salida exenta
53	Salida no gravada
54	Salida inmune
55	Salida con suspensión
99	Otras salidas

`itens[].impostos.ibsCbs.situacaoTributaria`CST del IBS/CBS

Omitido vale 000.

Valores	Significado
000	Tributación íntegra
200	Alícuota reducida
410	Inmunidad o no incidencia
510	Diferimiento
515	Diferimiento con alícuota reducida
550	Suspensión
620	Tributación monofásica (combustibles)
800	Transferencia de crédito
810	Crédito presunto de la Zona Franca de Manaus
811	Ajuste de períodos anteriores

`itens[].impostos.ibsCbs.classificacaoTributaria`Clasificación tributaria del IBS/CBS

Omitido vale 000001. Los 3 primeros dígitos son el CST y deben coincidir con situacaoTributaria; solo se listan los códigos válidos para NF-e en los CST que la plataforma emite (tabla oficial de 2026-08-23).

Valores	Significado
000001	Situaciones gravadas íntegramente por IBS y CBS
000003	Régimen automotriz, proyectos incentivados (art. 311); admite `creditoPresumido`
000004	Régimen automotriz, proyectos incentivados (art. 312); admite `creditoPresumido`
000005	Etanol anhidro destinado a mezcla con gasolina A pero vendido con otro destino
200002	Suministro o importación para productor rural no contribuyente o TAC; reducción del 100 %
200003	Venta de productos destinados a la alimentación humana (Anexo I); reducción del 100 %
200004	Suministro de dispositivos médicos (Anexo XII); reducción del 100 %
200005	Dispositivos médicos para órganos públicos y entidades de salud inmunes (Anexo XII); reducción del 100 %
200006	Emergencia de salud pública reconocida por el poder público; reducción del 100 %
200007	Dispositivos de accesibilidad para personas con discapacidad (Anexo XIII); reducción del 100 %
200008	Dispositivos de accesibilidad adquiridos por órganos públicos; reducción del 100 %
200009	Suministro de medicamentos registrados en Anvisa; reducción del 100 %
200010	Medicamentos registrados en Anvisa adquiridos por órganos públicos; reducción del 100 %
200011	Nutrición enteral y parenteral adquirida por órganos públicos; reducción del 100 %
200012	Emergencia de salud pública reconocida por el poder público; reducción del 100 %
200013	Suministro de tampones y absorbentes higiénicos; reducción del 100 %
200014	Hortalizas, frutas y huevos (Anexo XV); reducción del 100 %
200015	Automóviles de pasajeros nacionales adquiridos por conductores profesionales o personas con discapacidad; reducción del 100 %
200020	Operación de cooperativas bajo el régimen específico de IBS y CBS; reducción del 100 %
200022	Bienes industrializados enviados desde fuera de la ZFM a contribuyente establecido en la ZFM; reducción del 100 %, exige `tributacaoRegular`
200023	Bienes intermedios entre industrias incentivadas; reducción del 100 %
200024	Bienes enviados desde fuera de las Áreas de Libre Comercio a contribuyente establecido en ellas; reducción del 100 %, exige `tributacaoRegular`
200030	Venta de dispositivos médicos (Anexo IV); reducción del 60 %
200031	Dispositivos de accesibilidad para personas con discapacidad (Anexo V); reducción del 60 %
200032	Medicamentos registrados en Anvisa o de farmacias de manipulación, salvo los del Anexo XIV; reducción del 60 %
200033	Nutrición enteral y parenteral (Anexo VI); reducción del 60 %
200034	Alimentos para consumo humano (Anexo VII); reducción del 60 %
200035	Productos de higiene personal y limpieza (Anexo VIII); reducción del 60 %
200036	Productos agropecuarios, acuícolas, pesqueros, forestales y extractivos vegetales in natura; reducción del 60 %
200038	Insumos agropecuarios y acuícolas (Anexo IX); reducción del 60 %
200039	Producciones nacionales artísticas, culturales, de eventos, periodísticas y audiovisuales; reducción del 60 %
200043	Bienes y servicios de soberanía y seguridad para la administración pública (Anexo XI); reducción del 60 %
200047	Bares y restaurantes; reducción del 40 %
200053	Medicamentos registrados en Anvisa clasificados como sueros o vacunas; reducción del 100 %
200054	Bienes suministrados por cooperativa agropecuaria a asociado fuera del régimen regular; reducción del 100 %
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
410012	Suministro de condominio fuera del régimen regular
410013	Exportaciones de combustibles
410014	Suministro de productor rural no contribuyente; admite `creditoPresumido`
410016	Suministro o adquisición de residuos sólidos; admite `creditoPresumido`
410017	Adquisición de bien mueble con crédito presunto bajo condición de reventa
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
410026	Donación con anulación de crédito
410027	Exportación de servicio o de bien inmaterial
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
410035	Suministro realizado por nanoemprendedor
410999	Operaciones no onerosas sin previsión de 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); reducción del 60 %
550001	Exportaciones de bienes materiales; exige `tributacaoRegular`
550002	Régimen de tránsito; exige `tributacaoRegular`
550003	Regímenes de depósito (art. 85); exige `tributacaoRegular`
550004	Regímenes de depósito (art. 87); exige `tributacaoRegular`
550005	Regímenes de depósito (art. 87, párrafo único); exige `tributacaoRegular`
550006	Regímenes de permanencia temporal; exige `tributacaoRegular`
550007	Regímenes de perfeccionamiento; exige `tributacaoRegular`
550008	Importación de bienes bajo Repetro-Temporario; exige `tributacaoRegular`
550009	GNL-Temporario; exige `tributacaoRegular`
550010	Repetro-Permanente; exige `tributacaoRegular`
550011	Repetro-Industrialización; exige `tributacaoRegular`
550012	Repetro-Nacional; exige `tributacaoRegular`
550013	Repetro-Depósito; exige `tributacaoRegular`
550014	Zona de Procesamiento de Exportación; exige `tributacaoRegular`
550015	Régimen tributario de incentivo a la modernización y ampliación portuaria; exige `tributacaoRegular`
550016	Régimen especial de incentivos para el desarrollo de la infraestructura; exige `tributacaoRegular`
550017	Régimen tributario de incentivo a la actividad naval; exige `tributacaoRegular`
550018	Desgravación de la adquisición de bienes de capital; exige `tributacaoRegular`
550019	Importación de bienes por industria incentivada para uso en la ZFM; exige `tributacaoRegular`
550020	Áreas de libre comercio; exige `tributacaoRegular`
550021	Industrialización destinada a exportaciones; exige `tributacaoRegular`
550022	Régimen especial de incentivos para la producción de hidrógeno de baja emisión (Rehidro); exige `tributacaoRegular`
550023	Hidrocarburos líquidos no combustibles derivados de petróleo o gas natural, incluida la nafta; exige `tributacaoRegular`
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

`itens[].impostos.ibsCbs.zonaFrancaManaus.tipo`Tipo de crédito presunto de la ZFM

Valores	Significado
0	Sin crédito presunto
1	Bienes de consumo final
2	Bienes de capital
3	Bienes intermedios
4	Bienes de informática y otros definidos por ley

Código	HTTP
10003004	400	El código IBGE del municipio del cliente no existe. Verifique la UF y el código IBGE.
10003000	404	`empresaId` no existe o no pertenece a esta aplicación.
10004004	400	Empresa no habilitada para emitir (aún no aprobada o certificado no listo). Espere la aprobación / vincule el certificado.
10004030	400	`ambienteEmissao` no corresponde al entorno actual de la empresa. Envíe en el entorno de la empresa o pida a operaciones que lo cambie.
10004031	400	Valor no admitido: `presencaConsumidor` fuera de la tabla, tipo de pago o marca desconocidos, `tipoPessoa` incoherente con el documento, inscripción estatal incoherente con `indicadorContribuinteICMS`, tarjeta integrada sin sus tres datos, transportista con `SemFrete`, o campo obligatorio ausente en factura nacional / de exportación. El `mensagem` indica la ruta del campo.
10004032	400	El mismo `id` se reenvió con campos clave modificados mientras el intento anterior sigue en proceso o ya fue autorizado. Use un nuevo `id`.
10004002	400	Demasiadas tareas de emisión pendientes para el CNPJ. Reintente más tarde.
10005000	400	Rechazado por el motor tributario (régimen / código incompatible, código de ST para comprador no contribuyente, alícuota fuera de rango...). Vea las secciones de ICMS, CSOSN y PIS/COFINS por código.
10005011	400	Tabla ANP de combustibles aún no cargada en la plataforma; las líneas de combustible no se aceptan hasta la carga. Contacte al soporte.
10005012	400	Línea de combustible fuera de las reglas de la NF-e; el mensaje trae la regla y el motivo (código ANP fuera de la tabla con CST monofásico, unidad distinta de la tabla, porcentaje de mezcla u orígenes obligatorios o prohibidos, suma de orígenes distinta de 100, totalizador fuera del CFOP 5.656 / 5.667, venta a revendedor sin `transporte.transportadora`).
10005013	400	Importe por unidad del ICMS monofásico distinto de la tabla oficial del Portal NF-e para el código ANP y la fecha. Omita el campo o envíe el valor de la tabla; reducción solo con `percentualReducaoAdRem` y `motivoReducaoAdRem`.
10004020	400	Falta `codigoBeneficioFiscal` en CST 20/30/40/41/50/51/70/90.
10004021	400	Factura de devolución: línea sin `notaReferenciada.numeroItem` o factura sin `notaReferenciada.chaveAcesso`.
10004022	400	Referencia de línea en una factura que no es de devolución.
10004023	400	Factura original no encontrada o no perteneciente a esta empresa.
10004024	400	Factura original no autorizada.
10004025	400	Ítem no encontrado en la factura original.
10004026	400	Cantidad superior a la línea original (sumada entre las líneas que referencian el mismo ítem).
10004028	400	Factura complementaria o de ajuste sin `notaReferenciada.chaveAcesso`. Informe la factura original.
10004029	400	Factura normal con `notaReferenciada.chaveAcesso` sin referencias en las líneas. La referencia de cabecera es solo para `Complementar` / `Ajuste`; la devolución referencia por línea.
10004034	400	Comprador CNPJ sin `cliente.inscricaoEstadual` ni `indicadorContribuinteICMS`. Contribuyente: envíe la inscripción estatal; empresa sin inscripción: envíe `NaoContribuinte` o `ContribuinteIsento`.
10004043	400	Falta un campo del contrato (reducción de base / MVA y alícuota de ST / diferimiento / importe de tributo por unidad / código de IPI / `percentualCreditoSimples` ausente en la solicitud y en el perfil / `cest` en un ítem de ST); el mensaje nombra la ruta del campo. Complete el campo según la sección del código tributario usado.
10004044	400	Campo no aplicable al código tributario (`substituicaoTributaria` en un código que no es de ST, `percentualCreditoSimples` en un código sin crédito, `monofasico` fuera de CST 02/15/53/61). Elimine el grupo.
10004045	400	La `cliente.inscricaoEstadual` del comprador CNPJ no cumple la regla de dígito verificador del estado del comprador. Verifique la IE y el estado.
10004046	400	Código tributario incompatible con el régimen de la empresa (CRT 1/4 exige CSOSN de 3 dígitos, CRT 2/3 CST de 2 dígitos).
10004047	400	Comprador no contribuyente con un código exclusivo de contribuyente (10/30/70, 101/201/202/203) o con `percentualCreditoSimples`. Use 102 / 500 o 900 sin crédito.
10001001	400	Falló la validación de campos (una entrada por campo). Corrija según `mensagem`.

`presencaConsumidor*`	string	Presencia
	object	Intermediario

Parámetros

Parámetros de ruta

Cuerpo de la petición

Respuestas

Escenario 1 Simples Nacional (CSOSN 102)

Escenario 2 régimen normal (CST 00)

Escenario 3 factura completa

Finalidad de la factura (finalidade)3 bloques

Complementar: completar una factura ya autorizada

Ajuste: corregir una factura ya autorizada

Devolucao: devolver una factura ya autorizada

Presencia del comprador (pedido.presencaConsumidor)1 bloques

Presencia y marketplace intermediario

Comprador (cliente)4 bloques

Persona física consumidora

Empresa contribuyente de ICMS

Empresa sin inscripción estatal

Persona física con inscripción estatal (productor rural)

Línea de producto (itens[])2 bloques

Línea con descuento, flete prorrateado, código de barras y pedido de compra

Línea de combustible: diésel B vendido por la distribuidora

ICMS en el régimen normal (CRT 2 / 3)10 bloques

CST 00: tributación integral

CST 10: gravada con sustitución tributaria

CST 20: reducción de base de cálculo

CST 30: exenta con sustitución tributaria

CST 40 / 41 / 50: exenta, no gravada, suspendida

CST 51: diferimiento

CST 60: ICMS ya retenido anteriormente

CST 70: reducción de base con sustitución tributaria

CST 90: otras

CST 02 / 15 / 53 / 61: combustibles, tributación por unidad

ICMS en el Simples Nacional (CRT 1 / 4)5 bloques

CSOSN 102 / 103 / 300 / 400: sin crédito

CSOSN 101: con permiso de crédito

CSOSN 201 / 202 / 203: con sustitución tributaria

CSOSN 500: ICMS ya retenido anteriormente

CSOSN 900: otros

PIS y COFINS5 bloques

CST 01 / 02: gravable por alícuota

CST 03: gravable por unidad

CST 04 a 09: sin tributo en la venta

CST 49 / 99: otras operaciones

CST 50 a 75 y 98: entrada, solo en facturas de devolución

IPI3 bloques

IPI gravado: CST 50 / 99

IPI sin tributo: CST 51 a 55

IPI en factura de devolución: CST 00 a 49

IBS/CBS (reforma tributaria de 2026)7 bloques

IBS/CBS 200: alícuota reducida

IBS/CBS 410: inmunidad o no incidencia

IBS/CBS 510 / 515: diferimiento

IBS/CBS 550: suspensión

IBS/CBS 620: combustibles por unidad

IBS/CBS 800 / 810 / 811: crédito transferido, crédito de la Zona Franca, ajustes

Crédito presunto (creditoPresumido), opcional en cualquier situación

Pago (pedido.pagamento)8 bloques

Efectivo, cheque, boleto, depósito, transferencia, vales, crédito de tienda, saldo en tienda, fidelidad

Tarjeta de crédito, tarjeta de débito, Pix: terminal no integrada

Tarjeta o Pix con terminal integrada al sistema de emisión

Otros

Varias formas y vuelto

Venta a plazo (PagamentoAPrazo)

Pago posterior (PagamentoPosterior)

Sin pago (SemPagamento), solo en devolución

Marcas de tarjeta (credenciadoraCartao.bandeira)

Transporte (transporte)4 bloques

Flete con transportista contratada

Transporte propio, con vehículo

ICMS retenido sobre el flete

Dirección de entrega distinta del comprador

Cobro (cobranca)1 bloques

Factura en dos cuotas

Factura de exportación1 bloques

Venta al exterior

Enumeraciones20 tablas

ambienteEmissaoAmbiente de emisión

finalidadeFinalidad de la factura

cliente.tipoPessoaTipo de comprador

`ambienteEmissao`Ambiente de emisión

`finalidade`Finalidad de la factura

`cliente.tipoPessoa`Tipo de comprador

`cliente.indicadorContribuinteICMS`Situación del comprador ante el ICMS

`cliente.endereco.uf`Estado del comprador

`pedido.presencaConsumidor`Presencia del comprador

`pedido.pagamento.tipo`Plazo del pago

`pedido.pagamento.formas[].tipo`Forma de pago

`pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamento`Integración de la terminal de tarjeta

`pedido.pagamento.formas[].credenciadoraCartao.bandeira`Marca de la tarjeta

`transporte.frete.modalidade`Modalidad del flete

`itens[].origem`Origen del producto

`itens[].impostos.icms.situacaoTributaria`CST del ICMS (régimen normal, CRT 2 / 3)

`itens[].impostos.icms.situacaoTributaria`CSOSN del ICMS (Simples Nacional, CRT 1 / 4)

`itens[].impostos.pis.situacaoTributaria`CST del PIS

`itens[].impostos.cofins.situacaoTributaria`CST de la COFINS

`itens[].impostos.ipi.situacaoTributaria`CST del IPI

`itens[].impostos.ibsCbs.situacaoTributaria`CST del IBS/CBS

`itens[].impostos.ibsCbs.classificacaoTributaria`Clasificación tributaria del IBS/CBS

`itens[].impostos.ibsCbs.zonaFrancaManaus.tipo`Tipo de crédito presunto de la ZFM