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 y retiro en el estado | transporte.enderecoEntrega y transporte.enderecoRetirada 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, y en los ítems pedido, notaReferenciada, valorFrete, valorSeguro, impostos.ipi, impostos.icms.substituicaoTributaria, impostos.icms.difal.
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" } }}]}
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; los lugares de entrega y retiro quedan en el estado del emisor |
| OperacaoPresencialForaDoEstabelecimento | Venta presencial fuera de la tienda, como feria o puesto ambulante; no envíe transportista |
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 |
| Outros | Otros; exige descricao |
pedido.pagamento.formas[].credenciadoraCartao.bandeiraMarca 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 |
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.pis.situacaoTributariaCST 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.situacaoTributariaCST 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 |
| Código | HTTP | |
|---|---|---|
| 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. |