NFC-e
Emitir NFC-e
Emite un cupón fiscal electrónico (modelo 65) para venta al consumidor final dentro del estado; asíncrono por defecto, o síncrono para imprimir en la caja.
/openapi/v2/empresas/{empresaId}/nfcetoken, timestamp y sign, vea Autenticación.La empresa debe estar aprobada, con certificado válido y con NFC-e habilitada por el bloque emissaoNFeConsumidor del registro. El cuerpo usa los mismos nombres de campo de la emisión de NF-e, con las restricciones y adiciones de la NFC-e. ambienteEmissao debe ser igual al ambiente actual de la empresa.
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 de emisión |
modoResposta | string | Modo de respuesta |
consumidorFinal | bool | Consumidor final |
informacoesAdicionais | string | Información adicional |
| array | Observaciones del contribuyente |
| array | Observaciones para el fisco |
| array | Autorizados a descargar el XML |
* | object | Pedido y pago |
*obligatorio en entrega, por encima del límite de identificación del estado, o cuando el consumidor pide CPF en la nota | object | Consumidor |
*obligatorio en venta con entrega | object | Transporte |
* | array | Ítems |
* Campo obligatorio
Autorizada, Negada o ContingenciaPendente (ejemplo abajo).AguardandoAutorizacao. El resultado final llega por webhook; consulte con el mismo id.| Modo | Uso | Respuesta |
|---|---|---|
Assincrono (por defecto) | Lotes, pedidos de delivery | HTTP 200 sin cuerpo; el resultado llega por webhook o por la consulta |
Sincrono | Caja que imprime el cupón en el momento | HTTP 200 con el mismo cuerpo de la consulta. Sin resultado en 10 segundos: HTTP 202 con AguardandoAutorizacao; el resultado final llega por webhook |
Con la SEFAZ caída y el estado permitiendo contingencia, el modo síncrono devuelve 200 con ContingenciaPendente: el cupón offline ya puede imprimirse y entregarse, y la plataforma lo transmite a la SEFAZ cuando vuelva.
El webhook se envía en los dos modos.
Idempotencia. id es la clave: el mismo id enviado de nuevo devuelve la misma nota, sin emitir otra. Tras un timeout de red, repita con el mismo id. Si el intento anterior terminó Negada, el mismo id con campos corregidos emite de nuevo. Sugerencia: terminal + secuencial local, como PDV01-000123.
Cada modo de principio a fin: qué enviar, qué devuelve la llamada y cómo llega el resultado final. En los dos modos el webhook solo se entrega si los eventos nfce.* están suscritos en Webhook.
Asíncrono 1/3: solicitud
Pedido de restaurante enviado por el sistema de gestión, sin esperar en la caja. modoResposta omitido vale Assincrono.
{"id": "LOJA01-PED-98765","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 42.50 } ] }},"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
Asíncrono 2/3: HTTP 200 sin cuerpo
La llamada termina en el momento con HTTP 200 y cuerpo vacío: solo significa que la solicitud fue aceptada, aún no que la nota fue autorizada. Los errores de validación devuelven 400 en el momento, como en el modo síncrono. Guarde el id enviado; identifica la nota en el webhook (nfeId) y en la consulta.
Asíncrono 3/3: webhook con el resultado
Normalmente en pocos segundos llega nfce.authorized, como abajo. Si la SEFAZ rechaza, llega nfce.rejected con nfeStatus = Negada y el motivo en nfeMotivoStatus; los enlaces y el protocolo vienen null. Sin webhook, consulte con el mismo id.
{"tipo": "NFC-e","empresaId": "1934811222334455","nfeId": "LOJA01-PED-98765","nfeStatus": "Autorizada","nfeMotivoStatus": null,"nfeLinkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001251123456784?token=MXw3fDEwMXwxNzU4...","nfeLinkXml": "https://api.v2.tffiscal.com/openapi/files/xml/9903?token=MXw3fDEwMXwxNzU4...","nfeNumero": "125","nfeSerie": "1","nfeChaveAcesso": "35261111222333000181650010000001251123456784","nfeDataEmissao": "2026-11-04T18:05:11Z","nfeDataAutorizacao": "2026-11-04T18:05:12Z","nfeNumeroProtocolo": "135261234567892","nfeQrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001251123456784|3|2"}
Asíncrono: webhook de rechazo
{"tipo": "NFC-e","empresaId": "1934811222334455","nfeId": "LOJA01-PED-98765","nfeStatus": "Negada","nfeMotivoStatus": "778 - Rejeicao: Informado NCM inexistente","nfeLinkDanfe": null,"nfeLinkXml": null,"nfeNumero": "125","nfeSerie": "1","nfeChaveAcesso": "35261111222333000181650010000001251123456784","nfeDataEmissao": "2026-11-04T18:05:11Z","nfeDataAutorizacao": null,"nfeNumeroProtocolo": null,"nfeQrCode": null}
Síncrono 1/3: solicitud
La caja envía "modoResposta": "Sincrono" y espera la respuesta para imprimir el cupón. El cuerpo completo es el ejemplo de solicitud al inicio de la página; ajuste el tiempo límite HTTP de su lado a por lo menos 15 segundos.
Síncrono 2/3: HTTP 200 autorizada
El caso común: la SEFAZ responde dentro de 10 segundos y la llamada devuelve HTTP 200 con Autorizada (ejemplo en la sección Respuestas). Imprima con linkDanfe, o arme el cupón con qrCode, urlConsulta y chaveAcesso. El webhook nfce.authorized también llega.
Síncrono 3/3: HTTP 202 esperando
La SEFAZ no respondió en 10 segundos. La nota ya tiene número y clave, pero aún no tiene protocolo ni enlace del cupón; no imprima todavía. El resultado final llega por nfce.authorized o nfce.rejected; también puede consultar con el mismo id. Reenviar con el mismo id no emite otra nota. Si la nota aún estaba en la cola, numero, serie y chaveAcesso también vienen null.
{"id": "PDV01-000123","tipo": "NFC-e","status": "AguardandoAutorizacao","motivoStatus": null,"ambienteEmissao": "Homologacao","dataCriacao": "2026-11-04T15:20:01Z","dataUltimaAlteracao": "2026-11-04T15:20:01Z","numero": "123","serie": "1","dataEmissao": "2026-11-04T15:20:01Z","chaveAcesso": "35261111222333000181650010000001231123456780","dataAutorizacao": null,"protocolo": null,"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001231123456780|3|2","urlConsulta": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta","linkDanfe": null,"linkDownloadXml": null,"emitidaEmContingencia": false,"alertas": [],"valorTotal": 60.30}
Síncrono: HTTP 200 en contingencia
La SEFAZ está caída y el estado permite contingencia: HTTP 200 con ContingenciaPendente y emitidaEmContingencia = true. Ya tiene linkDanfe; imprima y entregue el cupón, que sale con la marca de contingencia. La plataforma lo transmite a la SEFAZ cuando vuelva y envía nfce.authorized; si es rechazada en la transmisión, envía nfce.rejected.
{"id": "PDV01-000124","tipo": "NFC-e","status": "ContingenciaPendente","motivoStatus": null,"ambienteEmissao": "Homologacao","dataCriacao": "2026-11-04T15:31:40Z","dataUltimaAlteracao": "2026-11-04T15:31:42Z","numero": "124","serie": "1","dataEmissao": "2026-11-04T15:31:41Z","chaveAcesso": "35261111222333000181650010000001249123456782","dataAutorizacao": null,"protocolo": null,"qrCode": "https://www.homologacao.nfce.fazenda.sp.gov.br/qrcode?p=35261111222333000181650010000001249123456782|3|2|...","urlConsulta": "https://www.homologacao.nfce.fazenda.sp.gov.br/consulta","linkDanfe": "https://api.v2.tffiscal.com/openapi/files/danfce/35261111222333000181650010000001249123456782?token=MXw3fDEwMXwxNzU4...","linkDownloadXml": null,"emitidaEmContingencia": true,"alertas": [],"valorTotal": 60.30}
La plataforma verifica estas reglas antes de numerar; la infracción devuelve 10022004 y mensagem indica cuál.
| Regla | Detalle |
|---|---|
| Entrega en el estado | transporte.enderecoEntrega en el mismo estado del emisor |
| Solo consumidor final | consumidorFinal solo true; el comprador no puede tener inscripción estatal |
| Presencia | Solo OperacaoPresencial, EntregaEmDomicilio, OperacaoPresencialForaDoEstabelecimento |
| Entrega | Consumidor identificado con documento y dirección, y transportista |
| Valor máximo | La nota no puede superar R$ 200.000; algunos estados tienen un límite menor |
| Identificación | Por encima de R$ 10.000 el consumidor debe identificarse; varios estados tienen un límite menor |
| Pago | Suma menos vuelto igual al total; SemPagamento no se acepta |
| Solo nota normal | Sin devolución, complementaria, ajuste ni nota referenciada |
| Emisión en tiempo real | La SEFAZ rechaza una nota emitida más de 5 minutos antes de recibirla (código 704) |
Campos que la NFC-e no acepta. Si se envían, se rechazan todos juntos en un solo 10022004: finalidade distinta de Normal, naturezaOperacao, notaReferenciada, cobranca, exportacao, cliente.inscricaoEstadual, transporte.veiculo, transporte.reboques, transporte.retencaoIcms, transporte.enderecoRetirada (la NFC-e no tiene lugar de retiro desde la NT 2026.002), y en los ítems pedido, notaReferenciada, impostos.ipi, impostos.icms.substituicaoTributaria, impostos.icms.difal, impostos.icms.motivoDesoneracaoSt, impostos.icms.valorDesoneradoSt, impostos.icms.codigoBeneficioFiscalReducaoBase.
CFOP aceptados.
| CFOP | Uso | Códigos de ICMS |
|---|---|---|
| 5101, 5102 | Venta de producción propia / de mercadería adquirida | CST 00, 20, 40, 41, 90; CSOSN 102, 103, 300, 400, 900 |
| 5103, 5104 | Venta fuera del establecimiento productor | Igual que arriba |
| 5115 | Venta de mercadería en consignación | Igual que arriba |
| 5405 | Venta de mercadería con ICMS-ST ya retenido | CST 60; CSOSN 500 |
| 5910 | Obsequio, bonificación o muestra gratis | CST 00, 20, 40, 41, 60, 90; CSOSN 102, 103, 300, 400, 500, 900 |
Los códigos CST 00, 20, 40, 41, 90 y CSOSN 102, 103, 300, 400, 900 solo combinan con 5101 a 5104, 5115 y 5910 (salvo las excepciones estatales de abajo). Los códigos de ICMS-ST ya retenido, CST 60 y CSOSN 500, solo combinan con 5405, 5656, 5667 y 5910.
5656 y 5667 (combustible, CST 60 / 61 o CSOSN 500) exigen el grupo combustivel en la línea. 5933 es la línea de servicio junto con mercadería: lleva impostos.issqn en lugar de icms, la factura necesita al menos una línea de mercadería con ICMS, y el emisor necesita la inscripción municipal registrada en el perfil de la empresa. El valor de los servicios entra en el total de la factura.
Excepciones estatales: RS y ES aceptan 5949 con CST 90 / CSOSN 900; SP acepta 5949 con CST 40 / CSOSN 900, para registrar propinas; CE acepta 5403 y 5405 con CST 90 / CSOSN 900. MEI solo usa CSOSN 102 o 300 con CFOP 5102; la línea de servicio sigue la misma regla, así que el MEI no puede emitir línea de servicio.
Códigos de ICMS aceptados.
| Régimen | Códigos |
|---|---|
| Régimen normal (CST) | 00, 20, 40, 41, 60, 61; 90 según el estado |
| Simples Nacional (CSOSN) | 102, 103, 300, 400, 500; 900 según el estado |
| MEI | 102, 300 |
Reglas del lado de la SEFAZ. Algunos estados prohíben CSOSN 103 y 400; la plataforma no lo verifica en la aceptación, y la SEFAZ lo rechaza en la autorización, con la nota terminando en Negada.
pedido.presencaConsumidor | Qué cambia en el cuerpo |
|---|---|
OperacaoPresencial | Solo pedido e itens; cliente es opcional; sin transporte |
EntregaEmDomicilio | cliente con documento y dirección, transporte.transportadora; pedido.intermediadorTransacao si el pedido vino por app |
OperacaoPresencialForaDoEstabelecimento | Como la venta en la tienda, más pedido.municipioOcorrencia cuando la venta es en otra ciudad; sin transporte |
Algunos estados prohíben la entrega con NFC-e o la limitan a la misma ciudad; vea NFC-e.
En la tienda, consumidor no identificado
El caso más común en la caja. Sin cliente; el cupón sale como CONSUMIDOR NÃO IDENTIFICADO. Pagado en efectivo con vuelto: la suma de las formas menos el troco es igual al total.
{"id": "PDV01-000130","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "Dinheiro", "valor": 50.00 } ], "troco": 7.50 }},"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
En la tienda, CPF en la nota
El consumidor pide el CPF en el cupón: envíe cliente solo con tipoPessoa y cpfCnpj. Nombre y dirección son opcionales, salvo por encima del límite de identificación del estado.
{"id": "PDV01-000131","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencial","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 42.50 } ] }},"cliente": { "tipoPessoa": "F", "cpfCnpj": "52998224725" },"itens": [{"cfop": "5102", "codigo": "PF-FRANGO", "descricao": "PRATO FEITO FRANGO", "ncm": "21069090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 32.50,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }},{"cfop": "5405", "codigo": "7894900011517", "descricao": "REFRIGERANTE LATA 350ML", "ncm": "22021000", "cest": "0300700","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 5.00,"impostos": { "icms": { "situacaoTributaria": "500" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
Entrega propia
Pedido por teléfono o sitio propio, entregado por la tienda o un repartidor contratado. cliente con documento y dirección de entrega, y transporte.transportadora.
{"id": "APP-DELIVERY-98765","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "EntregaEmDomicilio","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 89.90 } ] }},"cliente": {"tipoPessoa": "F","nome": "Maria da Silva","cpfCnpj": "52998224725","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Rua Augusta", "numero": "1500", "bairro": "Consolacao", "cep": "01304001" }},"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "11222333000181", "nome": "Entregas Rapidas LTDA", "uf": "SP" }},"itens": [{"cfop": "5102", "codigo": "PIZ-GG-01", "descricao": "PIZZA GRANDE MUSSARELA", "ncm": "19059090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 89.90,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
Entrega por app de delivery
Igual que la entrega propia, más pedido.intermediadorTransacao con el CNPJ de la plataforma y el identificador de la tienda en la plataforma.
{"id": "APP-DELIVERY-98766","ambienteEmissao": "Homologacao","pedido": {"presencaConsumidor": "EntregaEmDomicilio","pagamento": { "formas": [ { "tipo": "PagamentoInstantaneoPix", "valor": 89.90 } ] },"intermediadorTransacao": { "cnpj": "33444555000181", "identificadorCadastro": "loja-centro-123" }},"cliente": {"tipoPessoa": "F","nome": "Maria da Silva","cpfCnpj": "52998224725","endereco": { "uf": "SP", "cidade": "3550308", "logradouro": "Rua Augusta", "numero": "1500", "bairro": "Consolacao", "cep": "01304001" }},"transporte": {"frete": { "modalidade": "PorContaDoEmitente" },"transportadora": { "cpfCnpj": "11222333000181", "nome": "Entregas Rapidas LTDA", "uf": "SP" }},"itens": [{"cfop": "5102", "codigo": "PIZ-GG-01", "descricao": "PIZZA GRANDE MUSSARELA", "ncm": "19059090","quantidade": 1, "unidadeMedida": "UN", "valorUnitario": 89.90,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
Fuera de la tienda: feria en otra ciudad
Venta presencial en feria, evento o puesto ambulante. La feria es en Campinas y el emisor es de São Paulo, por eso pedido.municipioOcorrencia = 3509502; si la venta es en la ciudad del emisor, omita el campo. La ciudad debe estar en el mismo estado del emisor.
{"id": "FEIRA-CAMPINAS-0007","ambienteEmissao": "Homologacao","modoResposta": "Sincrono","pedido": {"presencaConsumidor": "OperacaoPresencialForaDoEstabelecimento","municipioOcorrencia": "3509502","pagamento": { "formas": [ { "tipo": "CartaoDeDebito", "valor": 36.00 } ] }},"itens": [{"cfop": "5102", "codigo": "DOCE-LEITE-500", "descricao": "DOCE DE LEITE POTE 500G", "ncm": "19019020","quantidade": 2, "unidadeMedida": "UN", "valorUnitario": 18.00,"impostos": { "icms": { "situacaoTributaria": "102" }, "pis": { "situacaoTributaria": "49" }, "cofins": { "situacaoTributaria": "49" } }}]}
ambienteEmissaoAmbiente de emisión
| Valores | Significado |
|---|---|
| Homologacao | Ambiente de prueba de la SEFAZ; la factura no tiene validez |
| Producao | Ambiente oficial |
modoRespostaModo de respuesta
Omitido vale Assincrono.
| Valores | Significado |
|---|---|
| Assincrono | Acepta y devuelve HTTP 200 sin cuerpo; el resultado llega por webhook |
| Sincrono | Espera el resultado de la SEFAZ hasta 10 segundos; sin resultado devuelve HTTP 202 |
pedido.presencaConsumidorPresencia del consumidor
| Valores | Significado |
|---|---|
| OperacaoPresencial | Venta presencial en la tienda; no envíe transportista |
| EntregaEmDomicilio | Venta no presencial con entrega; exige cliente con documento y dirección, y transporte.transportadora; el lugar de entrega queda en el estado del emisor |
| OperacaoPresencialForaDoEstabelecimento | Venta presencial fuera de la tienda, como feria o puesto ambulante; no envíe transportista |
| OperacaoPelaInternet | Venta por internet; emita NF-e. La NFC-e no lo acepta |
| OperacaoPorTelefone | Venta por teléfono; emita NF-e. La NFC-e no lo acepta |
| NaoSeAplica | No aplica. La NFC-e no lo acepta |
| Outros | Otros. La NFC-e no lo acepta |
pedido.pagamento.formas[].tipoTipo de pago
Los mismos nombres de la NF-e, excepto SemPagamento, que la NFC-e no acepta. credenciadoraCartao solo se acepta en los tipos marcados abajo, y descricao solo en Outros; en otro tipo devuelven 10022004.
| Valores | Significado |
|---|---|
| Dinheiro | Efectivo; puede generar vuelto |
| Cheque | Cheque |
| CartaoDeCredito | Tarjeta de crédito; muchos estados exigen credenciadoraCartao |
| CartaoDeDebito | Tarjeta de débito; muchos estados exigen credenciadoraCartao |
| CreditoLoja | Crédito en la tienda, venta a plazo |
| ValeAlimentacao | Vale de alimentación; acepta credenciadoraCartao |
| ValeRefeicao | Vale de comida; acepta credenciadoraCartao |
| ValePresente | Vale regalo; acepta credenciadoraCartao |
| ValeCombustivel | Vale de combustible; acepta credenciadoraCartao |
| BoletoBancario | Boleto bancario; acepta credenciadoraCartao |
| DepositoBancario | Depósito bancario |
| PagamentoInstantaneoPix | Pix dinámico; muchos estados exigen credenciadoraCartao |
| TransferenciaBancaria | Transferencia bancaria; acepta credenciadoraCartao |
| 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 cuando una falla de hardware impide integrar el pago y la emisión offline |
| PagamentoInstantaneoPixAutomatico | Pix automático, cobro recurrente |
| TransferenciaTefBookTransfer | Transferencia TEF entre cuentas del mismo banco |
| PagamentoPosterior | Pago posterior; valor 0, la suma puede quedar por debajo del total y no hay vuelto |
| SemPagamento | Sin pago. La NFC-e no lo acepta |
| Outros | Otros; exige descricao |
pedido.pagamento.formas[].credenciadoraCartao.tipoIntegracaoPagamentoIntegración de la terminal de tarjeta
Obligatorio siempre que se envíe credenciadoraCartao; vacío o fuera de la tabla devuelve 10022004.
| Valores | Significado |
|---|---|
| NaoIntegradoAoSistemaDeGestao | Terminal no integrada a la caja; bandeira opcional |
| IntegradoAoSistemaDeGestao | Terminal integrada a la caja; exige cnpj y codigoAutorizacao |
pedido.pagamento.formas[].credenciadoraCartao.bandeiraMarca de la tarjeta
Sin distinguir mayúsculas; la plataforma lo convierte al código oficial. En la NFC-e, una marca fuera de la tabla devuelve 10022004.
| 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 |
| Amex | Igual a AmericanExpress |
| Outros | Otra marca |
cliente.tipoPessoaTipo de comprador
Debe coincidir con el largo de cpfCnpj. Algunos estados no aceptan consumidor identificado por CNPJ en la NFC-e; en ellos, emita NF-e.
| Valores | Significado |
|---|---|
| F | Persona física (CPF) |
| J | Persona jurídica (CNPJ) |
cliente.endereco.ufEstado del consumidor
La NFC-e es solo dentro del estado: la dirección y transporte.enderecoEntrega.uf deben ser del estado del emisor. Sin EX. Vale también para transporte.transportadora.uf.
| 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 |
cliente.endereco.cidadeCódigo IBGE del municipio
Tabla larga; consulte los códigos de municipios del IBGE. Municipio del estado del emisor. Vale también para pedido.municipioOcorrencia, transporte.enderecoEntrega.cidade, itens[].impostos.issqn.municipioFatoGerador e itens[].impostos.issqn.municipioIncidencia.
| Valores | Significado |
|---|---|
| NNNNNNN | 7 dígitos |
itens[].cfopCFOP aceptados en la NFC-e
Solo estos 10 códigos, todos de salida dentro del estado. Algunos estados liberan otros pares de CFOP y código del ICMS; fuera de ellos devuelve 10022004. La empresa MEI solo usa 5102.
| Valores | Significado |
|---|---|
| 5101 | Venta de producción propia. ICMS sin ST: CST 00 / 20 / 40 / 41 / 90 o CSOSN 102 / 103 / 300 / 400 / 900 |
| 5102 | Reventa de mercadería de terceros. Mismos códigos sin ST que 5101 |
| 5103 | Venta de producción propia fuera del establecimiento. Mismos códigos sin ST que 5101 |
| 5104 | Reventa de mercadería de terceros fuera del establecimiento. Mismos códigos sin ST que 5101 |
| 5115 | Venta de mercadería recibida en consignación mercantil. Mismos códigos sin ST que 5101 |
| 5405 | Venta de mercadería con ICMS ya retenido por ST. CST 60 o CSOSN 500 |
| 5656 | Venta de combustible a consumidor final. Exige el bloque combustivel; CST 60 / 61 o CSOSN 500 |
| 5667 | Venta de combustible a consumidor final fuera del establecimiento. Exige el bloque combustivel; CST 60 / 61 o CSOSN 500 |
| 5910 | Obsequio o bonificación. Acepta los códigos con y sin ST |
| 5933 | Servicio gravado por el ISSQN. Exige impostos.issqn en lugar de icms y ncm = 00; la factura necesita al menos una línea de mercadería |
itens[].ncmCódigo NCM del producto
Tabla larga de la Nomenclatura Común del Mercosur; no se lista aquí.
| Valores | Significado |
|---|---|
| NNNNNNNN | Línea de mercadería, 8 dígitos |
| 00 | Línea de servicio con CFOP 5933 |
itens[].impostos.issqn.exigibilidadeExigibilidad del ISS
| Valores | Significado |
|---|---|
| 1 | Exigible |
| 2 | No incidencia |
| 3 | Exención |
| 4 | Exportación |
| 5 | Inmunidad |
| 6 | Suspendida por decisión judicial; informe processo |
| 7 | Suspendida por proceso administrativo; informe processo |
transporte.frete.modalidadeModalidad del flete
Fuera de la entrega solo SemFrete, el valor por defecto.
| Valores | Significado |
|---|---|
| SemFrete | Sin flete |
| 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[].origemOrigen del producto
| 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.situacaoTributariaCST del ICMS en la NFC-e (régimen normal)
Subconjunto de la tabla de la NF-e. Los demás CST devuelven 10022004.
| Valores | Significado |
|---|---|
| 00 | Gravada íntegramente. Envíe aliquota; CFOP sin ST |
| 20 | Con reducción de base. Exige aliquota y percentualReducaoBase; codigoBeneficioFiscal según el estado |
| 40 | Exenta. codigoBeneficioFiscal según el estado |
| 41 | No gravada. codigoBeneficioFiscal según el estado |
| 60 | ICMS cobrado anteriormente por ST. retencaoAnterior opcional; CFOP 5405, 5656, 5667 o 5910 |
| 61 | Monofásica cobrada anteriormente (combustibles). monofasico y el bloque combustivel |
| 90 | Otras. Solo en los estados que la admiten en la NFC-e; en los demás devuelve 10022004 |
| 02 / 15 / 53 | Monofásica propia, con retención o diferida. La NFC-e no lo acepta |
| 10 / 30 / 70 | Con cobro de ST en esta factura. La NFC-e no lo acepta |
| 50 / 51 | Suspensión o diferimiento. La NFC-e no lo acepta |
itens[].impostos.icms.situacaoTributariaCSOSN del ICMS en la NFC-e (Simples Nacional)
Subconjunto de la tabla de la NF-e. La empresa MEI solo usa 102 o 300 con CFOP 5102.
| Valores | Significado |
|---|---|
| 102 | Gravada sin permiso de crédito. Nada más en el ICMS |
| 103 | Exención por franja de ingresos. Nada más en el ICMS |
| 300 | Inmune. Nada más en el ICMS |
| 400 | No gravada. Nada más en el ICMS |
| 500 | ICMS cobrado anteriormente por ST. retencaoAnterior opcional; CFOP 5405, 5656, 5667 o 5910 |
| 900 | Otros. Solo en los estados que lo admiten en la NFC-e; en los demás devuelve 10022004 |
| 101 | Con permiso de crédito. La NFC-e no lo acepta |
| 201 / 202 / 203 | Con cobro de ST en esta factura. La NFC-e no lo acepta |
itens[].impostos.pis.situacaoTributariaCST del PIS y de la COFINS en la NFC-e
No se acepta 03 porque la NFC-e no tiene los campos de cálculo por cantidad; 50 a 75 y 98 son códigos de entrada y la NFC-e siempre es de salida. Los dos tributos usan la misma tabla.
| Valores | Significado |
|---|---|
| 01 | Gravado a la alícuota básica |
| 02 | Gravado a alícuota diferenciada |
| 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 |
| 99 | Otras operaciones |
| 03 | Gravado por cantidad. La NFC-e no lo acepta |
| 50–75 / 98 | Códigos de entrada. La NFC-e no lo acepta |
itens[].impostos.cofins.situacaoTributariaCST de la COFINS en la NFC-e
Misma tabla que el PIS en la NFC-e.
| Valores | Significado |
|---|---|
| 01 | Gravado a la alícuota básica |
| 02 | Gravado a alícuota diferenciada |
| 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 |
| 99 | Otras operaciones |
| 03 | Gravado por cantidad. La NFC-e no lo acepta |
| 50–75 / 98 | Códigos de entrada. La NFC-e no lo acepta |
itens[].impostos.ibsCbs.situacaoTributariaCST del IBS/CBS en la NFC-e
Solo para empresa del régimen normal (CRT 3); en los demás regímenes el grupo se ignora. Omitido vale 000. Los otros códigos de la NF-e exigen grupos que la NFC-e no tiene.
| Valores | Significado |
|---|---|
| 000 | Tributación íntegra |
| 200 | Alícuota reducida; la reducción viene de la clasificación |
| 410 | Inmunidad o no incidencia |
| 620 | Monofásica (combustibles). Solo la clasificación 620006, con monofasico y el bloque combustivel |
| 510 / 515 | Diferimiento; la NFC-e no tiene percentualDiferimento. La NFC-e no lo acepta |
| 550 | Suspensión; la NFC-e no tiene tributacaoRegular. La NFC-e no lo acepta |
| 800 / 810 / 811 | Transferencia de crédito, ZFM o ajuste. La NFC-e no lo acepta |
| 010 / 011 / 220 / 221 / 222 / 400 / 820 / 830 | Códigos que la plataforma aún no soporta. La NFC-e no lo acepta |
itens[].impostos.ibsCbs.classificacaoTributariaClasificación tributaria del IBS/CBS en la NFC-e
Omitido vale 000001. Los 3 primeros dígitos deben coincidir con situacaoTributaria. 200022 y 200024 no se aceptan porque exigen tributacaoRegular.
| 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 % |
| 200023 | Bienes intermedios entre industrias incentivadas; reducción del 100 % |
| 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 |
| 620006 | Tributación monofásica sobre combustibles cobrada anteriormente |
itens[].impostos.issqn.itemListaServicoÍtem de la lista de servicios
Tabla larga anexa a la Ley Complementaria 116/2003; no se lista aquí.
| Valores | Significado |
|---|---|
| NN.NN | Ítem y subítem, por ejemplo 14.01 |
itens[].medicamento.codigoAnvisaRegistro del medicamento en la ANVISA
| Valores | Significado |
|---|---|
| NNNNNNNNNNN | Registro de 11 dígitos |
| NNNNNNNNNNNNN | Registro de 13 dígitos |
| ISENTO | Medicamento dispensado de registro; exige motivoIsencao |
itens[].combustivel.codigoANPCódigo ANP del combustible
Tabla larga de productos de la ANP; no se lista aquí. Define si percentualBiocombustivel, origens y los porcentajes de GLP son obligatorios.
| Valores | Significado |
|---|---|
| NNNNNNNNN | 9 dígitos |
| 210203001 | GLP; exige percentualGLP, percentualGasNaturalNacional y percentualGasNaturalImportado sumando 100 |
itens[].combustivel.origens[].ufOrigemEstado de origen del combustible
Código IBGE de 2 dígitos, no la sigla.
| Valores | Significado |
|---|---|
| 11 | RO |
| 12 | AC |
| 13 | AM |
| 14 | RR |
| 15 | PA |
| 16 | AP |
| 17 | TO |
| 21 | MA |
| 22 | PI |
| 23 | CE |
| 24 | RN |
| 25 | PB |
| 26 | PE |
| 27 | AL |
| 28 | SE |
| 29 | BA |
| 31 | MG |
| 32 | ES |
| 33 | RJ |
| 35 | SP |
| 41 | PR |
| 42 | SC |
| 43 | RS |
| 50 | MS |
| 51 | MT |
| 52 | GO |
| 53 | DF |
itens[].cestCódigo CEST
Tabla larga; no se lista aquí. Código del Convênio ICMS 142/2018 vigente.
| Valores | Significado |
|---|---|
| NNNNNNN | 7 dígitos |
itens[].impostos.icms.codigoBeneficioFiscalCódigo de beneficio fiscal
Cada estado tiene su tabla; no se lista aquí. Use la tabla de cBenef publicada por la SEFAZ del estado del emisor; un código fuera de ella la SEFAZ lo rechaza con 946.
| Valores | Significado |
|---|---|
| XXNNNNNN | 8 caracteres, por ejemplo PR800001 |
| XXNNNNNNNN | 10 caracteres |
| SEM CBENEF | Sin beneficio; solo en estados que no publicaron tabla. La SEFAZ-SP no lo acepta |
| Código | HTTP | |
|---|---|---|
| 10022024 | 400 | Código IBGE ausente y no se pudo completar por el CEP: el CEP no está en la base, corresponde a más de un municipio o es de otro estado. Envíe el código IBGE o verifique cep / uf. |
| 10005215 | 400 | Clase de impuesto de otro tipo: la NF-e solo referencia clases NFe y la NFC-e solo clases NFCe; el mensaje señala la línea y el código. |
| 10005220 | 400 | La clase referenciada está IncompativelComRegime con el CRT o el régimen de PIS/COFINS actuales de la empresa; sustituya la clase entera por el régimen nuevo. |
| 10001002 | 400 | Línea con classeImposto que envía icms o issqn en impostos sin enviar cfop: no hay fila de la clase de donde tomar el CFOP; el mensaje señala itens[n].cfop. |
| 10005209 | 400 | La clase de impuesto referenciada no tiene fila que sirva para la factura en un grupo que la línea necesita (ICMS, o ISSQN en la línea de servicio, PIS, COFINS); el mensaje señala el grupo, el escenario, el tipo de cliente y si el comprador es no contribuyente. |
| 10005202 | 400 | La clase de impuesto referenciada en la línea no existe en esta empresa, fue eliminada o es de otra empresa; el mensaje señala la línea y el código. |
| 10005205 | 400 | La fila elegida de la clase de impuesto tiene un grupo o campo que la NFC-e no acepta (como ipi, ST, DIFAL, PIS por cantidad); el mensaje señala el campo. |
| 10003000 | 404 | empresaId no encontrado. |
| 10022001 | 400 | NFC-e no habilitada para el ambiente actual. Envíe emissaoNFeConsumidor en el registro. |
| 10022002 | 400 | La empresa no puede emitir: no aprobada o certificado no disponible. |
| 10022003 | 400 | ambienteEmissao distinto del ambiente actual de la empresa. |
| 10022004 | 400 | Infringe una regla de la NFC-e; mensagem indica cuál. Corrija o emita NF-e. |
| 10022009 | 400 | El estado exige QR Code v2 y la empresa no tiene CSC utilizable. El QR Code v2 lo activa la plataforma para la empresa y el CSC solo tiene efecto en producción; contacte a la plataforma. |
| 10001001 | 400 | Validación de campo; mensagem indica el campo. |
| 10005000 | 400 | El motor tributario rechazó los impuestos; mensagem da el motivo. |
