| sentido | não | saida, entrada | Saída (você emite) ou entrada (você recebe a mercadoria). Decide a nota: sem ele a resposta traz a pendência e pronto=false. |
| natureza | não | venda-producao-propria, venda-revenda, venda-producao-propria-st, venda-revenda-st-substituto, venda-revenda-st-substituido, venda-ativo-imobilizado, bonificacao-doacao-brinde, amostra-gratis, devolucao-compra-industrializacao, devolucao-compra-comercializacao, devolucao-venda-producao, devolucao-venda-revenda e mais 54 | Operação canônica: decide o CFOP e o CST de PIS/COFINS. Decide a nota: sem ele a resposta traz a pendência e pronto=false. |
| regime | não | real, presumido, simples | Regime de apuração da SUA empresa: decide entre CST ICMS e CSOSN. Decide a nota: sem ele a resposta traz a pendência e pronto=false. |
| tributacao | não | tributada, tributada-st, st-anterior, reducao, isenta, isenta-st, nao-tributada, suspensao, diferimento, outras | Situação do ICMS nesta operação. Decide a nota: sem ele a resposta traz a pendência e pronto=false. |
| origem | não | 0, 1, 2, 3, 4, 5, 6, 7, 8 | Origem da mercadoria (Tabela A, 1º dígito do CST ICMS). 1, 2, 3 e 8 levam a interestadual de 4%. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como origem_mercadoria, origemMercadoria. |
| uf_origem | não | AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 15 | UF do emitente. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufOrigem. |
| uf_destino | não | AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 16 | UF do destinatário. EX na operação com o exterior. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufDestino. |
| ambito | não | interna, interestadual, exterior | Opcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada. |
| destinatario | não | contribuinte, isento, nao-contribuinte | Destinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação. |
| consumidor_final | não | sim, nao | Operação com consumidor final (indFinal): sim quando quem compra usa ou consome o bem (pessoa física, órgão público, empresa comprando para uso próprio). Também aceito como consumidorFinal, indFinal. |
| perfil | não | mesma-natureza, industrial, comercial, prestador-transporte, geradora-energia, produtor-rural | Perfil do tomador, só nos grupos de comunicação e transporte. |
| perfil_emitente | não | regular, rural-nao-contribuinte, nanoempreendedor, templo, sem-fins-lucrativos, condominio | Perfil declarado do emitente para IBS/CBS: produtor rural não contribuinte (art. 164), nanoempreendedor (art. 26, IV), entidade religiosa ou templo (art. 9º, II), entidade sem fins lucrativos do art. 9º, III ou condomínio edilício não optante pelo regime regular (art. 26, I). É condição da pessoa, não do produto. Confira os requisitos e eventual opção pelo regime regular. Também aceito como perfilEmitente. |
| documento | não | 55, 65 | Modelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55. Também aceito como modelo. |
| orgao_publico | não | sim, nao | Venda a órgão público: a nota pede a Nota de Empenho (rejeição 359). Também aceito como orgaoPublico. |
| nota_empenho | não | string | Número da Nota de Empenho (xNEmp) na venda a órgão público. Também aceito como notaEmpenho, xNEmp. |
| ref_nfe | não | formato ^[0-9]{44}$ | Chave de 44 dígitos da nota de origem (refNFe), nas devoluções. Também aceito como refNFe. |
| data_emissao | não | string | Data de emissão prevista, AAAA-MM-DD. Sem ela, vale o dia de hoje (Brasília). Decide a vigência das regras que têm data. Também aceito como dataEmissao, dhEmi. |
| municipio_destino | não | string | Código IBGE do município de destino (7 dígitos), onde o IBS e a CBS são devidos. Sem ele, o cálculo usa a capital da UF de destino: em 2026 e 2027 a alíquota de referência é a mesma em todo município. Também aceito como municipioDestino, cMunFG. |
| ente_gov | não | 1, 2, 3, 4 | Compra governamental: tipo do ente comprador (1 União, 2 Estado, 3 Distrito Federal, 4 Município). Com ele o grupo gTribCompraGov sai calculado. Também aceito como enteGov, tpEnteGov. |
| cnpj_destinatario | não | string | CNPJ do destinatário (14 caracteres). Pelo cadastro aberto da Receita, das UFs e da SUFRAMA, preenche o que faltar (UF, município, indIEDest pela IE da UF e o ente_gov da compra governamental) e avisa o que diverge do informado (situação cadastral, IE). O CNPJ não volta na resposta e não é guardado. Também aceito como cnpjDestinatario, CNPJDest. |
| cnpj_emitente | não | string | CNPJ do emitente (14 caracteres). Pelo cadastro aberto da Receita, preenche a UF de origem e o regime (Simples ou MEI na data da emissão) quando faltam, e avisa o que diverge (situação cadastral, regime). O CNPJ não volta na resposta e não é guardado. Também aceito como cnpjEmitente, CNPJEmit. |
| porta_a_porta | não | sim, nao | Venda a revendedor que vende porta a porta (Anexo XXVI do Convênio ICMS 142/2018 e Convênio ICMS 45/1999). Também aceito como portaAPorta. |
| medicamento | não | indicacao-art146, registrado, veterinario, outro | Como este medicamento se enquadra? (pergunta sobre o produto) Também aceito como medicamento. |
| preparo_no_estabelecimento | não | sim, nao | O item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)? Também aceito como preparoNoEstabelecimento. |
| destino_zfm_alc | não | zfm-industria, zfm, alc, outro | Para quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio? Também aceito como destinoZfmAlc. |
| industrializado_nacional | não | sim, nao | O item é bem material industrializado de origem nacional? (pergunta sobre o produto) Também aceito como industrializadoNacional. |
| classe_bem_zfm | não | consumo-final, capital, intermediario, informatica | Que tipo de bem é este, para o crédito presumido da Zona Franca de Manaus? (pergunta sobre o produto) Também aceito como classeBemZfm. |
| adquirente_cooperativa | não | associado-regular, associado-nao-contribuinte, terceiro | Para quem a cooperativa vende nesta operação? Também aceito como adquirenteCooperativa. |
| venda_para_cooperativa | não | sim, nao | Esta venda é para a cooperativa de que a empresa é associada? Também aceito como vendaParaCooperativa. |
| adquirente_automovel | não | taxista, pcd, outro | Quem compra este automóvel? Também aceito como adquirenteAutomovel. |
| automovel_art149 | não | sim, nao | Este automóvel cumpre os requisitos do art. 149 para o comprador da venda? (pergunta sobre o produto) Também aceito como automovelArt149. |
| produto_projeto_automotivo | não | sim, nao | O item é veículo do projeto incentivado, fabricado ou montado no estabelecimento habilitado? (pergunta sobre o produto) Também aceito como produtoProjetoAutomotivo. |
| livro_jornal_periodico | não | sim, nao | O item é livro, jornal ou periódico? (pergunta sobre o produto) Também aceito como livroJornalPeriodico. |
| papel_para_impressao | não | sim, nao | O papel é destinado à impressão de livros, jornais ou periódicos? (pergunta sobre o produto) Também aceito como papelParaImpressao. |
| fonograma_nacional | não | sim, nao | É fonograma ou videofonograma musical produzido no Brasil? (pergunta sobre o produto) Também aceito como fonogramaNacional. |
| in_natura | não | sim, nao | O produto é fornecido in natura? (pergunta sobre o produto) Também aceito como inNatura. |
| industrializador_exportador | não | sim, nao | O adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11? Também aceito como industrializadorExportador. |
| adquirente_nao_contribuinte | não | produtor-rural, transportador-autonomo, nao | O adquirente é produtor rural ou transportador autônomo não contribuinte? Também aceito como adquirenteNaoContribuinte. |
| bem_da_lista_art110 | não | sim, nao | O produto é o bem descrito no item da lista do art. 197 dos regulamentos? (pergunta sobre o produto) Também aceito como bemDaListaArt110. |
| produto_do_item_anexo | não | sim, nao | O produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto) Também aceito como produtoDoItemAnexo. |
| combustivel_monofasico | não | contribuinte, revenda, nao | Este combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia? Também aceito como combustivelMonofasico. |
| destinacao | não | alimentacao-humana, insumo-agropecuario, outro | Nesta operação, a que se destina o produto? Também aceito como destinacao. |
| adquirente | não | mercado, administracao-publica | Quem é o adquirente nesta operação? |
| regime_operacao | não | normal, diferimento | A operação está sujeita a diferimento? Também aceito como regimeOperacao. |
| evento_saude | não | nao, sim | A operação ocorre sob situação de emergência de saúde pública reconhecida? Também aceito como eventoSaude. |
| natureza_produto | não | saude-menstrual, higiene-limpeza, outro | Qual é a natureza deste item? (pergunta sobre o produto) Também aceito como naturezaProduto. |
| papel_cadeia | não | fabricante-importador, atacado-varejo, outro | Qual é o papel da empresa na cadeia para os itens desta planilha? Também aceito como papelCadeia. |
| regime_apuracao | não | simples, cumulativo, nao-cumulativo | Qual é o regime de apuração de PIS/COFINS da empresa? Também aceito como regimeApuracao. |
| diferimento | não | sim, nao | Atalho de regime_operacao: sim = diferimento. |
| emergencia_saude | não | sim, nao | Atalho de evento_saude. Também aceito como emergenciaSaude. |
| ncm | sim | formato ^[0-9.]{8,10}$ | NCM do item, 8 dígitos (aceita pontos). |
| cest | não | string | CEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM. |
| gtin | não | string | cEAN: GTIN do produto ou SEM GTIN. Também aceito como cEAN, cean. |
| gtin_tributavel | não | string | cEANTrib: GTIN da unidade tributável ou SEM GTIN. Também aceito como gtinTributavel, cEANTrib, ceantrib. |
| utrib | não | string | Unidade tributável informada (conferida contra a tabela só na exportação). Também aceito como uTrib. |
| cst_ibs_cbs | não | string | CST do IBS/CBS informado, 3 dígitos. Também aceito como cstIbsCbs. |
| cclasstrib | não | string | cClassTrib informado, 6 dígitos. Também aceito como cClassTrib. |
| cst_pis | não | string | CST de PIS/COFINS informado, 2 dígitos. Também aceito como cstPis, cst_pis_cofins. |
| cbenef | não | string | cBenef informado (conferido na tabela da UF de origem). Também aceito como cBenef. |
| importado | não | sim, nao | Mercadoria importada (interestadual de 4%). Sem ele vale a origem. |
| carga_propria | não | mín. 0 · máx. 100 | Carga própria do substituto na operação interna, percentual de 0 a 100. Também aceito como cargaPropria. |
| valor | não | string | Base de cálculo do IBS e da CBS do item, em reais (até 2 casas). Com ele a resposta traz o grupo IBS/CBS calculado pelo motor da Calculadora de Tributos. Também aceito como vBC, base_calculo, baseCalculo. |
| quantidade | não | string | Quantidade tributável do item (padrão 1). Também aceito como qTrib. |
| cst_regular | não | string | CST da tributação regular (grupo gTribRegular), só quando o cClassTrib exige o grupo: na Calculadora, o 200022, o 200024 e a série 550 (suspensão), a mesma marca que o Emissor Nacional usa. A resposta pede quando falta. Padrão 000. Também aceito como cstRegular, CSTReg. |
| cclasstrib_regular | não | string | cClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001. Também aceito como cclasstribRegular, cClassTribReg. |
| descricao | não | string | Descrição do produto, só devolvida na resposta. |
| referencia | não | string | Seu identificador do item (código do produto, linha do pedido), devolvido igual na resposta. Também aceito como id. |