{"openapi":"3.1.0","info":{"title":"API de dados fiscais do Buscador NCM","version":"1.0.0","summary":"Conjunto e prova, nunca veredito.","description":"**Base dedicada:** `https://api.buscadorncm.com.br/v1`: JSON sempre, sem `Accept`, versionada no caminho; `/` devolve o catálogo e `/openapi.json` esta especificação. Atalhos: `/v1/operacao` = `/v1/qual-codigo-fiscal`; `/v1/delta[/dominio]` = `/v1/api/delta[/dominio]`; `/v1/monitor` = `/v1/api/monitor`.\n**No site:** a representação JSON mora na URL canônica de cada recurso e é pedida com `Accept: application/json`, na mesma arquitetura do `Accept: text/markdown`.\n\nErros seguem a RFC 9457 (`type`, `title`, `status`, `detail`) junto do objeto `erro` (`codigo`, `mensagem`, `documentacao`). Toda resposta do host da API traz `X-Request-Id` (o identificador da borda) e `X-Api-Version`.\n\n**Três camadas.** BÁSICA (nível 0, com a chave grátis desde 03/11/2026): NCM resumido, busca, capítulos, CFOP, CEST, CNAE, NBS, LC 116, cTribNac, cClassTrib, CST, cBenef, rejeições da NF-e, erros da NFS-e, municípios, GTIN, agenda de vigência futura e delta. COMPLETA E CRUZADA (nível 1, `x-api-key`): ficha consolidada do NCM, lote, ICMS-ST por rota, conferência CST × cClassTrib × NCM, serviço (cTribNac × LC 116 × NBS), validação de XML e monitor. PRÉ-NOTA (nível 2, `x-api-key`): operação → conjunto (CFOP, CST, PIS/COFINS) e o item fiscal inteiro antes de emitir, com as rejeições que o dado prova e a trilha de cada decisão.\nCota diária por plano e por CONTA (as chaves de uma conta dividem a cota desde 08/out/2026), contada em Brasília; nível 0 com limite de rajada por IP. Desde 03/11/2026 o nível 0 pede chave: sem ela respondem só o catálogo, esta especificação, a saúde e o exemplo de cada rota (401 `chave_ausente` com o passo a passo no resto). O lote de NCM é dos planos pagos. POST só em `/ncm/lote`, `/nfe/validar` e `/pre-nfe`.\n\n**Campo vazio nunca vem como `null`.** Vem como `{ ausente: true, motivo, explicacao }`. Os motivos estão em `components.schemas.Ausencia`.\n\nA API devolve o conjunto que a legislação admite, o discriminador que separa um código do outro, a base legal e a data de cada fonte. A caracterização da operação (destinação, destinatário, UF) é de quem emite.","contact":{"name":"Buscador NCM","url":"https://buscadorncm.com.br/contato"},"termsOfService":"https://buscadorncm.com.br/termos-de-uso","x-geradoEm":"2026-11-18T07:22:03.044Z","x-pacote":{"cfopCatalogo":{"fonte":"Tabela de CFOP do SPED Fiscal — Convênio s/nº de 15/12/1970 e Ajustes SINIEF","codigos":620},"cfopIndicadores":{"fonte":"Tabela de CFOP — Portal Nacional da NF-e (IT 2023.002 v2.10)","arquivo":"IT-2023-002-v2.10-Tabela-CFOP-Descricao.xlsx","extraidoEm":"2026-09-28","codigos":619},"cfopNotas":{"fonte":"Anexo II do Convênio s/nº, de 15 de dezembro de 1970 (CFOP) — CONFAZ","ato":"Ajuste SINIEF 03/24","inicioVigencia":"2024-06-01","baixadoEm":"2026-09-02","url":"https://www.confaz.fazenda.gov.br/legislacao/ajustes/sinief/cfop_cvsn_1-6.24"},"cfopCruzamentos":{"geradoEm":"2026-11-09","regrasTotais":1336,"regrasQueEnumeramCfop":48,"regrasQueConsultamIndicador":21},"rejeicoes":{"fonte":"MOC NF-e/NFC-e — Regras de Validação (consolidação HTML do Portal SPED Sefa-PR)","url":"https://moc.sped.fazenda.pr.gov.br/NFe_NFCe/RegrasDeValidação.html","baixadoEm":"2026-11-09","codigos":1061,"comRegraEstruturada":1027},"operacoes":{"fonte":"CFOP: catálogo oficial SPED (sped_xref.cfopCatalog, Convênio s/nº 1970 e Ajustes SINIEF); CST ICMS/CSOSN/PIS-COFINS: ver fiscal_axes.json. Leis PIS/COFINS conferidas no texto consolidado do Planalto em 14/jul/2026","validadoEm":"2026-07-14","total":66}}},"servers":[{"url":"https://api.buscadorncm.com.br/v1","description":"Base dedicada da API: JSON sempre, sem header Accept"},{"url":"https://buscadorncm.com.br","description":"URL canônica do site, que exige `Accept: application/json`"}],"tags":[{"name":"nivel-0","description":"Dado aberto, com a chave grátis desde 03/11/2026"},{"name":"nivel-1","description":"ICMS-ST por rota (exige chave)"},{"name":"nivel-2","description":"Operação → conjunto (exige chave)"}],"paths":{"/ncm/{codigo}":{"get":{"tags":["nivel-0","nivel-1"],"summary":"NCM: ficha consolidada com chave; sem chave, só o exemplo","description":"O II que vale hoje sai em importacao.impostoDeImportacao.emVigor (TEC ou o regime vigente sem Ex e sem cota que a fixa); importacao.impostoDeImportacao.aliquota é a TEC.","parameters":[{"name":"codigo","in":"path","required":true,"description":"NCM de 8 dígitos (aceita com pontos)","schema":{"type":"string","pattern":"^[0-9.]{8,10}$"}}],"responses":{"200":{"description":"resumo (nível 0) ou ficha completa (nível 1, com x-api-key)","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela vigente; se o código tem vigência futura conhecida, o detalhe diz a data e o ato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ncm/94036000\""}]}},"/{recurso}/buscar":{"get":{"tags":["nivel-0"],"summary":"Busca por prefixo de código ou palavra da descrição oficial","parameters":[{"name":"recurso","in":"path","required":true,"description":"onde buscar","schema":{"type":"string","enum":["ncm","cest","cfop","cnae","nbs","lc116","ctribnac"]}},{"name":"q","in":"query","required":true,"description":"código ou palavras","schema":{"type":"string"}},{"name":"limite","in":"query","required":false,"description":"até 100 (padrão 20)","schema":{"type":"string"}},{"name":"pagina","in":"query","required":false,"description":"a partir de 1","schema":{"type":"string"}}],"responses":{"200":{"description":"resultados com pontos e cobertura","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"sem ?q=","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ncm/buscar?q=moveis\""}]}},"/ncm/capitulos":{"get":{"tags":["nivel-0"],"summary":"Capítulos da NCM","responses":{"200":{"description":"capítulos","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ncm/capitulos\""}]}},"/ncm/familias":{"get":{"tags":["nivel-0"],"summary":"Famílias de NCM","description":"Cada família lê um bloco da ficha do NCM. A lista e a ficha saem do mesmo dado.","responses":{"200":{"description":"famílias com a contagem de NCMs","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ncm/familias\""}]}},"/ncm/familia/{familia}":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"NCMs de uma família","description":"Os NCMs com o bloco presente e o resumo dele. Código extinto que a fonte ainda cita sai em foraDaNcmVigente.","parameters":[{"name":"familia","in":"path","required":true,"description":"antidumping, lessin, producao-nacional, ex-tarifario, regimes-temporarios, bk-bit ou pis-cofins","schema":{"type":"string","enum":["antidumping","lessin","producao-nacional","ex-tarifario","regimes-temporarios","bk-bit","pis-cofins"]}}],"responses":{"200":{"description":"NCMs da família","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"família inexistente","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/ncm/familia/antidumping\""}]}},"/ncm/capitulo/{cap}":{"get":{"tags":["nivel-0"],"summary":"Códigos de um capítulo","parameters":[{"name":"cap","in":"path","required":true,"description":"dois dígitos","schema":{"type":"string","pattern":"^[0-9]{2}$"}}],"responses":{"200":{"description":"códigos do capítulo","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"capítulo sem NCM vigente","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ncm/capitulo/94\""}]}},"/ncm/lote":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Lote de até 200 NCMs (planos pagos)","description":"Só nos planos pagos: com a chave de avaliação a resposta é 403 `nivel_nao_liberado`; consulte `/ncm/{codigo}` um por vez.","parameters":[{"name":"codigos","in":"query","required":true,"description":"NCMs separados por vírgula","schema":{"type":"string"}},{"name":"resumo","in":"query","required":false,"description":"1 para a forma resumida","schema":{"type":"string"}}],"responses":{"200":{"description":"itens por código","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"mais de 200 ou nenhum","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/ncm/lote?codigos=94036000,30049069\""}]},"post":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Lote de até 2.000 NCMs (planos pagos)","description":"Só nos planos pagos: com a chave de avaliação a resposta é 403 `nivel_nao_liberado`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["codigos"],"properties":{"codigos":{"type":"array","items":{"type":"string"},"maxItems":2000},"resumo":{"type":"boolean"}}}}}},"responses":{"200":{"description":"itens por código","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"corpo fora do contrato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -X POST -H \"x-api-key: $NCM_API_KEY\" -H \"content-type: application/json\" -d '{\"codigos\":[\"94036000\",\"30049069\"]}' \"https://api.buscadorncm.com.br/v1/ncm/lote\""}]}},"/cest/{codigo}":{"get":{"tags":["nivel-0"],"summary":"CEST com os NCMs associados","parameters":[{"name":"codigo","in":"path","required":true,"description":"7 dígitos (aceita com pontos)","schema":{"type":"string"}}],"responses":{"200":{"description":"CEST","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora do Convênio ICMS 142/18","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cest/2806100\""}]}},"/cnae/{codigo}":{"get":{"tags":["nivel-0"],"summary":"CNAE com riscos, fator R e ocupações","parameters":[{"name":"codigo","in":"path","required":true,"description":"7 dígitos (aceita 4751-2/01)","schema":{"type":"string"}}],"responses":{"200":{"description":"subclasse","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da CNAE 2.3","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cnae/4751201\""}]}},"/nbs/{codigo}":{"get":{"tags":["nivel-0"],"summary":"NBS com LC 116 e reforma","parameters":[{"name":"codigo","in":"path","required":true,"description":"9 dígitos (aceita 1.0101.30.00)","schema":{"type":"string"}}],"responses":{"200":{"description":"código NBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da NBS 2.0","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/nbs/101013000\""}]}},"/lc116/{item}":{"get":{"tags":["nivel-0"],"summary":"Item da lista do ISS","parameters":[{"name":"item","in":"path","required":true,"description":"no formato 14-01 (14.01 redireciona)","schema":{"type":"string"}}],"responses":{"200":{"description":"item","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da LC 116","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/lc116/14-01\""}]}},"/ctribnac/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Código de tributação nacional da NFS-e","parameters":[{"name":"codigo","in":"path","required":true,"description":"6 dígitos","schema":{"type":"string"}}],"responses":{"200":{"description":"cTribNac","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ctribnac/140101\""}]}},"/cclasstrib/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Classificação tributária do IBS/CBS","parameters":[{"name":"codigo","in":"path","required":true,"description":"6 dígitos","schema":{"type":"string"}}],"responses":{"200":{"description":"cClassTrib","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela oficial","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cclasstrib/200032\""}]}},"/cst/{tabela}/{codigo}":{"get":{"tags":["nivel-0"],"summary":"CST de ICMS, PIS, COFINS, CSOSN ou IBS/CBS","parameters":[{"name":"tabela","in":"path","required":true,"description":"tabela","schema":{"type":"string","enum":["icms","pis","cofins","csosn","ibs-cbs"]}},{"name":"codigo","in":"path","required":true,"description":"código","schema":{"type":"string"}}],"responses":{"200":{"description":"código","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cst/pis/01\""}]}},"/cbenef/{uf}/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Código de benefício fiscal da UF","parameters":[{"name":"uf","in":"path","required":true,"description":"sigla","schema":{"type":"string"}},{"name":"codigo","in":"path","required":true,"description":"ex.: sp010010","schema":{"type":"string"}}],"responses":{"200":{"description":"cBenef","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela da UF","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cbenef/sp/sp010010\""}]}},"/nfse/erros/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Erro ou alerta da NFS-e","parameters":[{"name":"codigo","in":"path","required":true,"description":"ex.: e1521, a1","schema":{"type":"string"}}],"responses":{"200":{"description":"mensagem e solução","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora das tabelas","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/nfse/erros/e1521\""}]}},"/municipios/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Município pelo código IBGE (cMun)","parameters":[{"name":"codigo","in":"path","required":true,"description":"7 dígitos","schema":{"type":"string"}}],"responses":{"200":{"description":"município","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/municipios/3550308\""}]}},"/iss/{municipio}":{"get":{"tags":["nivel-0"],"summary":"ISS do município: convênio, alíquota por cTribNac, retenções, benefícios (nBM), mudanças e arrecadação","description":"O que a prefeitura cadastrou no Sistema Nacional NFS-e, que é o que a Sefin Nacional usa para validar a DPS. Alíquota -1 nunca sai: não incidência vem como ausência declarada. Empresa do Simples Nacional não usa a alíquota do município.","parameters":[{"name":"municipio","in":"path","required":true,"description":"código IBGE de 7 dígitos","schema":{"type":"string","pattern":"^[0-9]{7}$"}}],"responses":{"200":{"description":"ISS do município","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela do IBGE","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/iss/3550308\""}]}},"/iss/{municipio}/{ctribnac}":{"get":{"tags":["nivel-0"],"summary":"Códigos municipais (cTribMun) de um serviço no município, com nome, alíquota e vigência","description":"Aceita o cTribNac com 6 dígitos (010701), com pontos (01.07.01) ou o código completo de 9 dígitos com o sufixo municipal (01.07.01.001). Traz onde o ISS é devido, a retenção (lei nacional, art. 6º e regras municipais), os benefícios gerais que alcançam o código e as mudanças.","parameters":[{"name":"municipio","in":"path","required":true,"description":"código IBGE de 7 dígitos","schema":{"type":"string"}},{"name":"ctribnac","in":"path","required":true,"description":"010701, 01.07.01 ou 01.07.01.001","schema":{"type":"string"}}],"responses":{"200":{"description":"ISS do serviço no município","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"código fora do formato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"município ou cTribNac fora das tabelas","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/iss/3550308/01.07.01\""}]}},"/icms":{"get":{"tags":["nivel-0"],"summary":"ICMS das 27 UFs: alíquota geral, lei e fundo de pobreza","responses":{"200":{"description":"as 27 UFs com o link do detalhe","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/icms\""}]}},"/icms/{uf}":{"get":{"tags":["nivel-0"],"summary":"ICMS da UF: alíquota geral, fundo, interestadual, ST, cBenef, EFD, GNRE, 52/91, reforma e inscrição estadual","description":"A alíquota geral é a modal da lei estadual; mercadoria com alíquota própria na lei paga a dela. A faixa do fundo é o que o campo da NF-e aceita, não a lista de produtos. `alteradaEm` só sai quando a alíquota mudou; ausente, vale a da lei de origem.","parameters":[{"name":"uf","in":"path","required":true,"description":"sigla, ex.: sp","schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}}],"responses":{"200":{"description":"ICMS da UF","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"sigla que não é UF","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/icms/sp\""}]}},"/ie/{uf}/{numero}":{"get":{"tags":["nivel-0"],"summary":"Inscrição estadual: dígito verificador pela fórmula da UF","description":"Confere formato e dígito pela fórmula que cada secretaria publica (roteiro de crítica do Sintegra; Goiás com as exceções da SEFAZ-GO; SP com o produtor rural P). `digitoConfere: true` diz que o número é bem formado, não que a inscrição existe ou está ativa: para isso, `consultaOficial`.","parameters":[{"name":"uf","in":"path","required":true,"description":"sigla, ex.: sp","schema":{"type":"string"}},{"name":"numero","in":"path","required":true,"description":"a inscrição, com ou sem pontuação (SP produtor rural: P mais 12)","schema":{"type":"string"}}],"responses":{"200":{"description":"validação com o cálculo","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"número com caractere inválido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"sigla que não é UF","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ie/sp/110042490114\""}]}},"/cbo/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Ocupação da CBO 2002","parameters":[{"name":"codigo","in":"path","required":true,"description":"6 dígitos (aceita 2522-10)","schema":{"type":"string"}}],"responses":{"200":{"description":"ocupação","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da CBO 2002","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cbo/252210\""}]}},"/darf/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Código de receita do DARF","parameters":[{"name":"codigo","in":"path","required":true,"description":"4 dígitos","schema":{"type":"string"}}],"responses":{"200":{"description":"código de receita","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela do SIEF","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/darf/2172\""}]}},"/natureza-juridica/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Natureza jurídica (Concla/IBGE)","parameters":[{"name":"codigo","in":"path","required":true,"description":"4 dígitos (aceita 206-2)","schema":{"type":"string"}}],"responses":{"200":{"description":"natureza jurídica","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela de 2021","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/natureza-juridica/206-2\""}]}},"/dirbi/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Benefício fiscal da DIRBI","parameters":[{"name":"codigo","in":"path","required":true,"description":"o identificador do benefício, como na ficha do site","schema":{"type":"string"}}],"responses":{"200":{"description":"benefício","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora do Anexo Único","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dirbi/programa-emergencial-de-retomada-perse\""}]}},"/dfe/cstat/{codigo}":{"get":{"tags":["nivel-0"],"summary":"cStat em todos os documentos fiscais eletrônicos","parameters":[{"name":"codigo","in":"path","required":true,"description":"número do cStat","schema":{"type":"string"}}],"responses":{"200":{"description":"cStat por documento","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"código que nenhum documento usa","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dfe/cstat/539\""}]}},"/dere/codtrib/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Código de tributação da DeRE","parameters":[{"name":"codigo","in":"path","required":true,"description":"até 9 dígitos","schema":{"type":"string"}}],"responses":{"200":{"description":"codTrib","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora da tabela 11 da DeRE","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dere/codtrib/110111001\""}]}},"/dere/tabelas/{numero}":{"get":{"tags":["nivel-0"],"summary":"Tabela da DeRE inteira","parameters":[{"name":"numero","in":"path","required":true,"description":"ex.: 13, 12.1","schema":{"type":"string"}}],"responses":{"200":{"description":"tabela","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora das 16 tabelas","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dere/tabelas/13\""}]}},"/dere/erros/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Mensagem de erro da DeRE","parameters":[{"name":"codigo","in":"path","required":true,"description":"ex.: ms1004","schema":{"type":"string"}}],"responses":{"200":{"description":"mensagem","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"fora do Anexo II","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dere/erros/ms1004\""}]}},"/dir/leiaute":{"get":{"tags":["nivel-0"],"summary":"Leiaute da DIR","responses":{"200":{"description":"blocos e campos","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/dir/leiaute\""}]}},"/gtin/{gtin}":{"get":{"tags":["nivel-0"],"summary":"Validação de GTIN","parameters":[{"name":"gtin","in":"path","required":true,"description":"8, 12, 13 ou 14 dígitos (ou sem-gtin)","schema":{"type":"string"}},{"name":"ncm","in":"query","required":false,"description":"cruza com o Anexo I da NT 2021.003","schema":{"type":"string"}}],"responses":{"200":{"description":"situação e rejeição prevista","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/gtin/7891000325858?ncm=04022110\""}]}},"/agenda":{"get":{"tags":["nivel-0"],"summary":"Mudanças oficiais com vigência futura","parameters":[{"name":"ncms","in":"query","required":false,"description":"filtra por NCMs","schema":{"type":"string"}},{"name":"futuras","in":"query","required":false,"description":"1 para só as que ainda não vigem","schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"description":"AAAA-MM-DD","schema":{"type":"string"}}],"responses":{"200":{"description":"agenda e calendário dos DF-e","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/agenda?futuras=1\""}]}},"/reforma/calcular":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"IBS e CBS de um cClassTrib num ano da transição","parameters":[{"name":"cclasstrib","in":"query","required":true,"description":"6 dígitos","schema":{"type":"string"}},{"name":"valor","in":"query","required":false,"description":"base em reais, para receber os valores","schema":{"type":"string"}},{"name":"ano","in":"query","required":false,"description":"de 2026 a 2033; ano sem alíquota fixada sai a fixar","schema":{"type":"string"}}],"responses":{"200":{"description":"alíquota efetiva, valores e a origem do cálculo","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"cClassTrib, valor ou ano fora do formato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/reforma/calcular?cclasstrib=200030&valor=1000&ano=2026\""}]}},"/simples/calcular":{"post":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"IBS e CBS do Simples Nacional (NT 2026.005), com o contrato da API do motor oficial","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["id","versao","data","tpDoc","CRT","itens"],"properties":{"id":{"type":"string"},"versao":{"type":"string"},"data":{"type":"string","format":"date"},"tpDoc":{"type":"string"},"CRT":{"type":"string"},"tpEnteGov":{"type":"string"},"itens":{"type":"array","maxItems":500,"items":{"type":"object"}}}}}}},"responses":{"200":{"description":"objetos por item e o total, como o motor oficial","content":{"application/json":{"schema":{"type":"object"}}}},"422":{"description":"erro de entrada, com os códigos VSN do motor","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -X POST -H \"x-api-key: $NCM_API_KEY\" -H \"content-type: application/json\" -d '{\"id\":\"exemplo-1\",\"versao\":\"1.0\",\"data\":\"2027-01-15\",\"tpDoc\":\"55\",\"CRT\":\"1\",\"tpEnteGov\":\"\",\"itens\":[{\"numero\":1,\"cClassTrib\":\"000001\",\"cAtivSN\":\"01\",\"baseCalculo\":\"1000.00\",\"valorImpostoSeletivo\":\"0\",\"pIBSSN\":\"0.5\",\"pCBSSN\":\"2.75\"},{\"numero\":2,\"cClassTrib\":\"410001\",\"cAtivSN\":\"01\",\"baseCalculo\":\"200.00\",\"valorImpostoSeletivo\":\"0\"}]}' \"https://api.buscadorncm.com.br/v1/simples/calcular\""}]}},"/reforma/conferir":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"CST × cClassTrib × NCM","parameters":[{"name":"ncm","in":"query","required":true,"description":"8 dígitos","schema":{"type":"string"}},{"name":"cst","in":"query","required":false,"description":"CST do IBS/CBS","schema":{"type":"string"}},{"name":"cclasstrib","in":"query","required":false,"description":"cClassTrib","schema":{"type":"string"}},{"name":"documento","in":"query","required":false,"description":"55 (padrão) ou 65","schema":{"type":"string"}},{"name":"destinacao","in":"query","required":false,"description":"resposta da operação","schema":{"type":"string"}},{"name":"destinatario","in":"query","required":false,"description":"resposta da operação (mercado ou administracao-publica)","schema":{"type":"string"}},{"name":"regimeOperacao","in":"query","required":false,"description":"normal ou diferimento","schema":{"type":"string"}},{"name":"naturezaProduto","in":"query","required":false,"description":"resposta da operação","schema":{"type":"string"}}],"responses":{"200":{"description":"conferência","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"sem NCM ou sem CST/cClassTrib","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/reforma/conferir?ncm=30049069&cst=200&cclasstrib=200032\""}]}},"/servico":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"cTribNac × LC 116 × NBS × IBS/CBS (e o ISS do município)","parameters":[{"name":"ctribnac","in":"query","required":false,"description":"6 dígitos","schema":{"type":"string"}},{"name":"lc116","in":"query","required":false,"description":"item, ex.: 14.01","schema":{"type":"string"}},{"name":"nbs","in":"query","required":false,"description":"9 dígitos","schema":{"type":"string"}},{"name":"municipio","in":"query","required":false,"description":"código IBGE de 7 dígitos: acrescenta issMunicipal (exige ?ctribnac=)","schema":{"type":"string"}}],"responses":{"200":{"description":"cruzamento do serviço","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"nenhum código informado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/servico?ctribnac=140101&municipio=3550308\""}]}},"/nfe/validar":{"post":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Validação do XML da NF-e/NFC-e (em memória, sem gravar)","parameters":[{"name":"perspectiva","in":"query","required":false,"description":"destinatario: acrescenta a leitura de quem recebe","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"xml":{"type":"string"}}}}}},"responses":{"200":{"description":"achados, resumo e X-Retencao: nenhuma","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"corpo vazio ou com DOCTYPE/ENTITY","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"413":{"description":"acima de 5 MB","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -X POST -H \"x-api-key: $NCM_API_KEY\" --data-binary @nota.xml \"https://api.buscadorncm.com.br/v1/nfe/validar\""}]}},"/pre-nfe":{"get":{"tags":["nivel-2"],"security":[{"ApiKey":[]}],"summary":"Pré-nota de um item","description":"Operação + item → os campos da NF-e (CFOP, idDest, indIEDest, indFinal), CST ou CSOSN, DIFAL com quem paga, ICMS-ST da rota, IPI, PIS/COFINS, IBS/CBS, uTrib, GTIN, CEST e cBenef, com as rejeições que o dado prova, as pendências (cada uma com o parâmetro que a responde) e a trilha. `X-Resposta-Sha256` carimba o corpo. Parâmetro desconhecido ou valor fora das opções → 400.","parameters":[{"name":"sentido","in":"query","required":false,"description":"Saída (você emite) ou entrada (você recebe a mercadoria). Decide a nota: sem ele a resposta traz a pendência e pronto=false.","schema":{"type":"string","enum":["saida","entrada"]},"example":"saida"},{"name":"natureza","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["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","compra-industrializacao","compra-comercializacao","compra-comercializacao-st","compra-servico-issqn","compra-uso-consumo","compra-ativo-imobilizado","transferencia-producao","transferencia-adquirida","remessa-industrializacao","retorno-industrializacao","retorno-industrializacao-recebido","remessa-vasilhame","remessa-conserto","retorno-conserto","remessa-consignacao","venda-a-ordem-vendedor-remetente","venda-a-ordem-remessa-destinatario","venda-a-ordem-adquirente-originario","venda-a-ordem-entrada-destinatario","venda-entrega-futura-faturamento","venda-entrega-futura-entrega","compra-entrega-futura-faturamento","compra-entrega-futura-recebimento","ind-conta-ordem-venda-fornecedor","ind-conta-ordem-remessa-fornecedor","ind-conta-ordem-entrada-industrializador","ind-conta-ordem-retorno-industrializador","ind-conta-ordem-compra-adquirente","remessa-venda-fora","venda-efetivada-fora","retorno-venda-fora","entrega-cooperativa-preco-a-fixar","fixacao-preco-cooperativa","fornecimento-ato-cooperativo","entrada-ato-cooperativo","industrializacao-efetuada","industrializacao-efetuada-sem-transito","industrializacao-recebida","industrializacao-recebida-sem-transito","retorno-industrializacao-nao-aplicada","entrada-industrializacao-nao-aplicada","aquisicao-servico-issqn","prestacao-servico-issqn","aquisicao-servico-comunicacao","prestacao-servico-comunicacao","aquisicao-servico-transporte","prestacao-servico-transporte","compra-industrializacao-st","compra-ativo-imobilizado-st","compra-uso-consumo-st","devolucao-venda-producao-st","devolucao-venda-revenda-st","transferencia-comercializacao-st","transferencia-industrializacao-st"]},"example":"venda-producao-propria"},{"name":"regime","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["real","presumido","simples"]},"example":"real"},{"name":"tributacao","in":"query","required":false,"description":"Situação do ICMS nesta operação. Decide a nota: sem ele a resposta traz a pendência e pronto=false.","schema":{"type":"string","enum":["tributada","tributada-st","st-anterior","reducao","isenta","isenta-st","nao-tributada","suspensao","diferimento","outras"]},"example":"tributada"},{"name":"origem","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["0","1","2","3","4","5","6","7","8"]},"example":"0"},{"name":"uf_origem","in":"query","required":false,"description":"UF do emitente. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufOrigem.","schema":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"]},"example":"RS"},{"name":"uf_destino","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO","EX"]},"example":"SP"},{"name":"ambito","in":"query","required":false,"description":"Opcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada.","schema":{"type":"string","enum":["interna","interestadual","exterior"]}},{"name":"destinatario","in":"query","required":false,"description":"Destinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação.","schema":{"type":"string","enum":["contribuinte","isento","nao-contribuinte"]},"example":"nao-contribuinte"},{"name":"consumidor_final","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["sim","nao"]},"example":"sim"},{"name":"perfil","in":"query","required":false,"description":"Perfil do tomador, só nos grupos de comunicação e transporte.","schema":{"type":"string","enum":["mesma-natureza","industrial","comercial","prestador-transporte","geradora-energia","produtor-rural"]}},{"name":"perfil_emitente","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["regular","rural-nao-contribuinte","nanoempreendedor","templo","sem-fins-lucrativos","condominio"]}},{"name":"documento","in":"query","required":false,"description":"Modelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55. Também aceito como modelo.","schema":{"type":"string","enum":["55","65"]}},{"name":"orgao_publico","in":"query","required":false,"description":"Venda a órgão público: a nota pede a Nota de Empenho (rejeição 359). Também aceito como orgaoPublico.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"nota_empenho","in":"query","required":false,"description":"Número da Nota de Empenho (xNEmp) na venda a órgão público. Também aceito como notaEmpenho, xNEmp.","schema":{"type":"string"}},{"name":"ref_nfe","in":"query","required":false,"description":"Chave de 44 dígitos da nota de origem (refNFe), nas devoluções. Também aceito como refNFe.","schema":{"type":"string","pattern":"^[0-9]{44}$"}},{"name":"data_emissao","in":"query","required":false,"description":"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.","schema":{"type":"string","format":"date"}},{"name":"municipio_destino","in":"query","required":false,"description":"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.","schema":{"type":"string"}},{"name":"ente_gov","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["1","2","3","4"]}},{"name":"cnpj_destinatario","in":"query","required":false,"description":"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.","schema":{"type":"string"}},{"name":"cnpj_emitente","in":"query","required":false,"description":"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.","schema":{"type":"string"}},{"name":"porta_a_porta","in":"query","required":false,"description":"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.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"medicamento","in":"query","required":false,"description":"Como este medicamento se enquadra? (pergunta sobre o produto) Também aceito como medicamento.","schema":{"type":"string","enum":["indicacao-art146","registrado","veterinario","outro"]}},{"name":"preparo_no_estabelecimento","in":"query","required":false,"description":"O item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)? Também aceito como preparoNoEstabelecimento.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"destino_zfm_alc","in":"query","required":false,"description":"Para quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio? Também aceito como destinoZfmAlc.","schema":{"type":"string","enum":["zfm-industria","zfm","alc","outro"]}},{"name":"industrializado_nacional","in":"query","required":false,"description":"O item é bem material industrializado de origem nacional? (pergunta sobre o produto) Também aceito como industrializadoNacional.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"classe_bem_zfm","in":"query","required":false,"description":"Que tipo de bem é este, para o crédito presumido da Zona Franca de Manaus? (pergunta sobre o produto) Também aceito como classeBemZfm.","schema":{"type":"string","enum":["consumo-final","capital","intermediario","informatica"]}},{"name":"adquirente_cooperativa","in":"query","required":false,"description":"Para quem a cooperativa vende nesta operação? Também aceito como adquirenteCooperativa.","schema":{"type":"string","enum":["associado-regular","associado-nao-contribuinte","terceiro"]}},{"name":"venda_para_cooperativa","in":"query","required":false,"description":"Esta venda é para a cooperativa de que a empresa é associada? Também aceito como vendaParaCooperativa.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"adquirente_automovel","in":"query","required":false,"description":"Quem compra este automóvel? Também aceito como adquirenteAutomovel.","schema":{"type":"string","enum":["taxista","pcd","outro"]}},{"name":"automovel_art149","in":"query","required":false,"description":"Este automóvel cumpre os requisitos do art. 149 para o comprador da venda? (pergunta sobre o produto) Também aceito como automovelArt149.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"produto_projeto_automotivo","in":"query","required":false,"description":"O item é veículo do projeto incentivado, fabricado ou montado no estabelecimento habilitado? (pergunta sobre o produto) Também aceito como produtoProjetoAutomotivo.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"livro_jornal_periodico","in":"query","required":false,"description":"O item é livro, jornal ou periódico? (pergunta sobre o produto) Também aceito como livroJornalPeriodico.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"papel_para_impressao","in":"query","required":false,"description":"O papel é destinado à impressão de livros, jornais ou periódicos? (pergunta sobre o produto) Também aceito como papelParaImpressao.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"fonograma_nacional","in":"query","required":false,"description":"É fonograma ou videofonograma musical produzido no Brasil? (pergunta sobre o produto) Também aceito como fonogramaNacional.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"in_natura","in":"query","required":false,"description":"O produto é fornecido in natura? (pergunta sobre o produto) Também aceito como inNatura.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"industrializador_exportador","in":"query","required":false,"description":"O adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11? Também aceito como industrializadorExportador.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"adquirente_nao_contribuinte","in":"query","required":false,"description":"O adquirente é produtor rural ou transportador autônomo não contribuinte? Também aceito como adquirenteNaoContribuinte.","schema":{"type":"string","enum":["produtor-rural","transportador-autonomo","nao"]}},{"name":"bem_da_lista_art110","in":"query","required":false,"description":"O produto é o bem descrito no item da lista do art. 197 dos regulamentos? (pergunta sobre o produto) Também aceito como bemDaListaArt110.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"produto_do_item_anexo","in":"query","required":false,"description":"O produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto) Também aceito como produtoDoItemAnexo.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"combustivel_monofasico","in":"query","required":false,"description":"Este combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia? Também aceito como combustivelMonofasico.","schema":{"type":"string","enum":["contribuinte","revenda","nao"]}},{"name":"destinacao","in":"query","required":false,"description":"Nesta operação, a que se destina o produto? Também aceito como destinacao.","schema":{"type":"string","enum":["alimentacao-humana","insumo-agropecuario","outro"]}},{"name":"adquirente","in":"query","required":false,"description":"Quem é o adquirente nesta operação?","schema":{"type":"string","enum":["mercado","administracao-publica"]}},{"name":"regime_operacao","in":"query","required":false,"description":"A operação está sujeita a diferimento? Também aceito como regimeOperacao.","schema":{"type":"string","enum":["normal","diferimento"]}},{"name":"evento_saude","in":"query","required":false,"description":"A operação ocorre sob situação de emergência de saúde pública reconhecida? Também aceito como eventoSaude.","schema":{"type":"string","enum":["nao","sim"]}},{"name":"natureza_produto","in":"query","required":false,"description":"Qual é a natureza deste item? (pergunta sobre o produto) Também aceito como naturezaProduto.","schema":{"type":"string","enum":["saude-menstrual","higiene-limpeza","outro"]}},{"name":"papel_cadeia","in":"query","required":false,"description":"Qual é o papel da empresa na cadeia para os itens desta planilha? Também aceito como papelCadeia.","schema":{"type":"string","enum":["fabricante-importador","atacado-varejo","outro"]}},{"name":"regime_apuracao","in":"query","required":false,"description":"Qual é o regime de apuração de PIS/COFINS da empresa? Também aceito como regimeApuracao.","schema":{"type":"string","enum":["simples","cumulativo","nao-cumulativo"]}},{"name":"diferimento","in":"query","required":false,"description":"Atalho de regime_operacao: sim = diferimento.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"emergencia_saude","in":"query","required":false,"description":"Atalho de evento_saude. Também aceito como emergenciaSaude.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"ncm","in":"query","required":true,"description":"NCM do item, 8 dígitos (aceita pontos).","schema":{"type":"string","pattern":"^[0-9.]{8,10}$"},"example":"94036000"},{"name":"cest","in":"query","required":false,"description":"CEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM.","schema":{"type":"string"}},{"name":"gtin","in":"query","required":false,"description":"cEAN: GTIN do produto ou SEM GTIN. Também aceito como cEAN, cean.","schema":{"type":"string"}},{"name":"gtin_tributavel","in":"query","required":false,"description":"cEANTrib: GTIN da unidade tributável ou SEM GTIN. Também aceito como gtinTributavel, cEANTrib, ceantrib.","schema":{"type":"string"}},{"name":"utrib","in":"query","required":false,"description":"Unidade tributável informada (conferida contra a tabela só na exportação). Também aceito como uTrib.","schema":{"type":"string"}},{"name":"cst_ibs_cbs","in":"query","required":false,"description":"CST do IBS/CBS informado, 3 dígitos. Também aceito como cstIbsCbs.","schema":{"type":"string"}},{"name":"cclasstrib","in":"query","required":false,"description":"cClassTrib informado, 6 dígitos. Também aceito como cClassTrib.","schema":{"type":"string"}},{"name":"cst_pis","in":"query","required":false,"description":"CST de PIS/COFINS informado, 2 dígitos. Também aceito como cstPis, cst_pis_cofins.","schema":{"type":"string"}},{"name":"cbenef","in":"query","required":false,"description":"cBenef informado (conferido na tabela da UF de origem). Também aceito como cBenef.","schema":{"type":"string"}},{"name":"importado","in":"query","required":false,"description":"Mercadoria importada (interestadual de 4%). Sem ele vale a origem.","schema":{"type":"string","enum":["sim","nao"]}},{"name":"carga_propria","in":"query","required":false,"description":"Carga própria do substituto na operação interna, percentual de 0 a 100. Também aceito como cargaPropria.","schema":{"type":"number","minimum":0,"maximum":100}},{"name":"valor","in":"query","required":false,"description":"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.","schema":{"type":"string"}},{"name":"quantidade","in":"query","required":false,"description":"Quantidade tributável do item (padrão 1). Também aceito como qTrib.","schema":{"type":"string"}},{"name":"cst_regular","in":"query","required":false,"description":"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.","schema":{"type":"string"}},{"name":"cclasstrib_regular","in":"query","required":false,"description":"cClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001. Também aceito como cclasstribRegular, cClassTribReg.","schema":{"type":"string"}},{"name":"descricao","in":"query","required":false,"description":"Descrição do produto, só devolvida na resposta.","schema":{"type":"string"}},{"name":"referencia","in":"query","required":false,"description":"Seu identificador do item (código do produto, linha do pedido), devolvido igual na resposta. Também aceito como id.","schema":{"type":"string"},"example":"PED-1042-3"}],"responses":{"200":{"description":"item fiscal; header X-Resposta-Sha256","content":{"application/json":{"schema":{"type":"object","not":{"required":["erro"]},"required":["recurso","nfe","operacao","difal","ncm","icmsSt","pisCofins","ibsCbs","trilha","rejeicoesPrevistas","avisos","pendencias","pronto","leitura"],"properties":{"recurso":{"type":"string","const":"pre-nfe"},"referencia":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}],"description":"o `referencia` que você enviou, igual"},"entrada":{"type":"object","description":"operação e item como foram lidos"},"nfe":{"type":"object","description":"os campos da NF-e que a operação decide","properties":{"natOp":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"CFOP":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"idDest":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"indIEDest":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"indFinal":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"modelo":{"type":"string","enum":["55","65"]},"tpNF":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]}}},"operacao":{"type":"object","description":"natureza, cfop (com admissíveis e perfil de risco), icms ou csosn, pisCofins e ibsCbsDaOperacao, pelo motor do /qual-codigo-fiscal"},"difal":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"devido":{"type":"boolean"},"responsavel":{"type":"string","enum":["remetente","destinatario"]},"grupoNaNota":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"rejeicaoSemGrupo":{"type":"string"},"baseLegal":{"type":"string"},"calculadora":{"type":"string","format":"uri"}}},{"$ref":"#/components/schemas/Ausencia"}]},"ncm":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"ipi":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"icmsSt":{"oneOf":[{"$ref":"#/components/schemas/ConsultaSt"},{"$ref":"#/components/schemas/Ausencia"}]},"pisCofins":{"type":"object"},"ibsCbs":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"estado":{"type":"string"},"motivo":{"type":"string"},"candidatos":{"oneOf":[{"type":"array","items":{"type":"object"}},{"$ref":"#/components/schemas/Ausencia"}]},"respostasUsadas":{"type":"object"},"cbsCombustivel":{"oneOf":[{"$ref":"#/components/schemas/CbsCombustivel"},{"$ref":"#/components/schemas/Ausencia"}],"description":"combustível do monofásico: a CBS é valor por unidade (Portaria MF nº 3.074/2026, efeitos em jan/2027). O mesmo bloco sai em reforma.cbsCombustivel da ficha de NCM"}}},{"$ref":"#/components/schemas/Ausencia"}]},"ibsCbsCalculado":{"type":"object","description":"o grupo IBS/CBS pelo motor da Calculadora de Tributos portado (igual ao JAR oficial no gabarito): `vinculo` diz se o NCM está na lista do cClassTrib (REG-011 quando não está; a SEFAZ autoriza o par errado) e, com `valor`, `grupo` traz o IBSCBS do motor (gIBSCBS, gTribRegular, gTribCompraGov) e `localidadeIncidencia` a UF e o município usados","properties":{"motor":{"type":"string","description":"versão do banco da Calculadora"},"vinculo":{"type":"object"},"grupo":{"type":"object"},"oper":{"type":"object"},"localidadeIncidencia":{"type":"object"},"simulado":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"recusa":{"type":"object"}}},"unidadeTributavel":{"type":"object"},"gtin":{"type":"object"},"cbenef":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"trilha":{"type":"array","items":{"type":"object","properties":{"camada":{"type":"string"},"decisao":{"type":"string"},"porque":{"type":"string"},"fonte":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]}}}},"rejeicoesPrevistas":{"type":"array","description":"só regra cuja condição o dado enviado PROVA","items":{"type":"object","properties":{"codigo":{"type":"string"},"motivo":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"campo":{"type":"string"},"porque":{"type":"string"},"ficha":{"type":"string","format":"uri"}}}},"avisos":{"type":"array","items":{"type":"object","properties":{"tipo":{"type":"string"},"texto":{"type":"string"},"rejeicao":{"type":"string"}}}},"pendencias":{"type":"array","description":"o que falta responder; `parametro` é o nome a enviar na próxima chamada","items":{"type":"object","required":["camada","eixo","parametro","pergunta","opcoes"],"properties":{"camada":{"type":"string","enum":["operacao","item","icms-st","ibs-cbs"]},"eixo":{"type":"string"},"parametro":{"type":"string"},"pergunta":{"type":"string"},"opcoes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rotulo":{"type":"string"}}}},"campoNaNota":{"type":"string"},"ajuda":{"type":"string"}}}},"dataEmissao":{"type":"object","description":"a data que decidiu a resposta: a `data_emissao` enviada, ou nenhuma (o ICMS-ST usa o dia de hoje)","required":["informada"],"properties":{"data":{"type":"string","format":"date","description":"só quando informada"},"informada":{"type":"boolean"},"nota":{"type":"string"}}},"pronto":{"type":"boolean","description":"true só sem rejeição prevista e sem pendência"},"leitura":{"type":"string"},"meta":{"type":"object"}}}}}},"400":{"description":"parâmetro desconhecido, valor fora das opções, UF ou NCM fora do formato. Também quando o âmbito contradiz as UFs. `erro.detalhes[]` traz o nome, o recebido e as opções","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/pre-nfe?sentido=saida&natureza=venda-producao-propria&regime=real&tributacao=tributada&origem=0&uf_origem=RS&uf_destino=SP&destinatario=nao-contribuinte&consumidor_final=sim&ncm=94036000&referencia=PED-1042-3\""}]},"post":{"tags":["nivel-2"],"security":[{"ApiKey":[]}],"summary":"Pré-nota de até 500 itens na mesma operação","description":"Uma consulta da cota por item conferido. Chave desconhecida em `operacao` → 400; em cada item, campos extras do seu ERP são ignorados. Item inválido volta com `erro` na posição dele, sem derrubar o lote e sem gastar cota.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["itens"],"properties":{"operacao":{"type":"object","properties":{"sentido":{"type":"string","enum":["saida","entrada"],"description":"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":{"type":"string","enum":["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","compra-industrializacao","compra-comercializacao","compra-comercializacao-st","compra-servico-issqn","compra-uso-consumo","compra-ativo-imobilizado","transferencia-producao","transferencia-adquirida","remessa-industrializacao","retorno-industrializacao","retorno-industrializacao-recebido","remessa-vasilhame","remessa-conserto","retorno-conserto","remessa-consignacao","venda-a-ordem-vendedor-remetente","venda-a-ordem-remessa-destinatario","venda-a-ordem-adquirente-originario","venda-a-ordem-entrada-destinatario","venda-entrega-futura-faturamento","venda-entrega-futura-entrega","compra-entrega-futura-faturamento","compra-entrega-futura-recebimento","ind-conta-ordem-venda-fornecedor","ind-conta-ordem-remessa-fornecedor","ind-conta-ordem-entrada-industrializador","ind-conta-ordem-retorno-industrializador","ind-conta-ordem-compra-adquirente","remessa-venda-fora","venda-efetivada-fora","retorno-venda-fora","entrega-cooperativa-preco-a-fixar","fixacao-preco-cooperativa","fornecimento-ato-cooperativo","entrada-ato-cooperativo","industrializacao-efetuada","industrializacao-efetuada-sem-transito","industrializacao-recebida","industrializacao-recebida-sem-transito","retorno-industrializacao-nao-aplicada","entrada-industrializacao-nao-aplicada","aquisicao-servico-issqn","prestacao-servico-issqn","aquisicao-servico-comunicacao","prestacao-servico-comunicacao","aquisicao-servico-transporte","prestacao-servico-transporte","compra-industrializacao-st","compra-ativo-imobilizado-st","compra-uso-consumo-st","devolucao-venda-producao-st","devolucao-venda-revenda-st","transferencia-comercializacao-st","transferencia-industrializacao-st"],"description":"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":{"type":"string","enum":["real","presumido","simples"],"description":"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":{"type":"string","enum":["tributada","tributada-st","st-anterior","reducao","isenta","isenta-st","nao-tributada","suspensao","diferimento","outras"],"description":"Situação do ICMS nesta operação. Decide a nota: sem ele a resposta traz a pendência e pronto=false."},"origem":{"type":"string","enum":["0","1","2","3","4","5","6","7","8"],"description":"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":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"],"description":"UF do emitente. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufOrigem."},"uf_destino":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO","EX"],"description":"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":{"type":"string","enum":["interna","interestadual","exterior"],"description":"Opcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada."},"destinatario":{"type":"string","enum":["contribuinte","isento","nao-contribuinte"],"description":"Destinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação."},"consumidor_final":{"type":"string","enum":["sim","nao"],"description":"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":{"type":"string","enum":["mesma-natureza","industrial","comercial","prestador-transporte","geradora-energia","produtor-rural"],"description":"Perfil do tomador, só nos grupos de comunicação e transporte."},"perfil_emitente":{"type":"string","enum":["regular","rural-nao-contribuinte","nanoempreendedor","templo","sem-fins-lucrativos","condominio"],"description":"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":{"type":"string","enum":["55","65"],"description":"Modelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55. Também aceito como modelo."},"orgao_publico":{"type":"string","enum":["sim","nao"],"description":"Venda a órgão público: a nota pede a Nota de Empenho (rejeição 359). Também aceito como orgaoPublico."},"nota_empenho":{"type":"string","description":"Número da Nota de Empenho (xNEmp) na venda a órgão público. Também aceito como notaEmpenho, xNEmp."},"ref_nfe":{"type":"string","pattern":"^[0-9]{44}$","description":"Chave de 44 dígitos da nota de origem (refNFe), nas devoluções. Também aceito como refNFe."},"data_emissao":{"type":"string","format":"date","description":"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":{"type":"string","description":"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":{"type":"string","enum":["1","2","3","4"],"description":"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":{"type":"string","description":"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":{"type":"string","description":"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":{"type":"string","enum":["sim","nao"],"description":"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":{"type":"string","enum":["indicacao-art146","registrado","veterinario","outro"],"description":"Como este medicamento se enquadra? (pergunta sobre o produto) Também aceito como medicamento."},"preparo_no_estabelecimento":{"type":"string","enum":["sim","nao"],"description":"O item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)? Também aceito como preparoNoEstabelecimento."},"destino_zfm_alc":{"type":"string","enum":["zfm-industria","zfm","alc","outro"],"description":"Para quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio? Também aceito como destinoZfmAlc."},"industrializado_nacional":{"type":"string","enum":["sim","nao"],"description":"O item é bem material industrializado de origem nacional? (pergunta sobre o produto) Também aceito como industrializadoNacional."},"classe_bem_zfm":{"type":"string","enum":["consumo-final","capital","intermediario","informatica"],"description":"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":{"type":"string","enum":["associado-regular","associado-nao-contribuinte","terceiro"],"description":"Para quem a cooperativa vende nesta operação? Também aceito como adquirenteCooperativa."},"venda_para_cooperativa":{"type":"string","enum":["sim","nao"],"description":"Esta venda é para a cooperativa de que a empresa é associada? Também aceito como vendaParaCooperativa."},"adquirente_automovel":{"type":"string","enum":["taxista","pcd","outro"],"description":"Quem compra este automóvel? Também aceito como adquirenteAutomovel."},"automovel_art149":{"type":"string","enum":["sim","nao"],"description":"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":{"type":"string","enum":["sim","nao"],"description":"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":{"type":"string","enum":["sim","nao"],"description":"O item é livro, jornal ou periódico? (pergunta sobre o produto) Também aceito como livroJornalPeriodico."},"papel_para_impressao":{"type":"string","enum":["sim","nao"],"description":"O papel é destinado à impressão de livros, jornais ou periódicos? (pergunta sobre o produto) Também aceito como papelParaImpressao."},"fonograma_nacional":{"type":"string","enum":["sim","nao"],"description":"É fonograma ou videofonograma musical produzido no Brasil? (pergunta sobre o produto) Também aceito como fonogramaNacional."},"in_natura":{"type":"string","enum":["sim","nao"],"description":"O produto é fornecido in natura? (pergunta sobre o produto) Também aceito como inNatura."},"industrializador_exportador":{"type":"string","enum":["sim","nao"],"description":"O adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11? Também aceito como industrializadorExportador."},"adquirente_nao_contribuinte":{"type":"string","enum":["produtor-rural","transportador-autonomo","nao"],"description":"O adquirente é produtor rural ou transportador autônomo não contribuinte? Também aceito como adquirenteNaoContribuinte."},"bem_da_lista_art110":{"type":"string","enum":["sim","nao"],"description":"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":{"type":"string","enum":["sim","nao"],"description":"O produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto) Também aceito como produtoDoItemAnexo."},"combustivel_monofasico":{"type":"string","enum":["contribuinte","revenda","nao"],"description":"Este combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia? Também aceito como combustivelMonofasico."},"destinacao":{"type":"string","enum":["alimentacao-humana","insumo-agropecuario","outro"],"description":"Nesta operação, a que se destina o produto? Também aceito como destinacao."},"adquirente":{"type":"string","enum":["mercado","administracao-publica"],"description":"Quem é o adquirente nesta operação?"},"regime_operacao":{"type":"string","enum":["normal","diferimento"],"description":"A operação está sujeita a diferimento? Também aceito como regimeOperacao."},"evento_saude":{"type":"string","enum":["nao","sim"],"description":"A operação ocorre sob situação de emergência de saúde pública reconhecida? Também aceito como eventoSaude."},"natureza_produto":{"type":"string","enum":["saude-menstrual","higiene-limpeza","outro"],"description":"Qual é a natureza deste item? (pergunta sobre o produto) Também aceito como naturezaProduto."},"papel_cadeia":{"type":"string","enum":["fabricante-importador","atacado-varejo","outro"],"description":"Qual é o papel da empresa na cadeia para os itens desta planilha? Também aceito como papelCadeia."},"regime_apuracao":{"type":"string","enum":["simples","cumulativo","nao-cumulativo"],"description":"Qual é o regime de apuração de PIS/COFINS da empresa? Também aceito como regimeApuracao."},"diferimento":{"type":"string","enum":["sim","nao"],"description":"Atalho de regime_operacao: sim = diferimento."},"emergencia_saude":{"type":"string","enum":["sim","nao"],"description":"Atalho de evento_saude. Também aceito como emergenciaSaude."}}},"itens":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"object","required":["ncm"],"properties":{"ncm":{"type":"string","pattern":"^[0-9.]{8,10}$","description":"NCM do item, 8 dígitos (aceita pontos)."},"cest":{"type":"string","description":"CEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM."},"gtin":{"type":"string","description":"cEAN: GTIN do produto ou SEM GTIN. Também aceito como cEAN, cean."},"gtin_tributavel":{"type":"string","description":"cEANTrib: GTIN da unidade tributável ou SEM GTIN. Também aceito como gtinTributavel, cEANTrib, ceantrib."},"utrib":{"type":"string","description":"Unidade tributável informada (conferida contra a tabela só na exportação). Também aceito como uTrib."},"cst_ibs_cbs":{"type":"string","description":"CST do IBS/CBS informado, 3 dígitos. Também aceito como cstIbsCbs."},"cclasstrib":{"type":"string","description":"cClassTrib informado, 6 dígitos. Também aceito como cClassTrib."},"cst_pis":{"type":"string","description":"CST de PIS/COFINS informado, 2 dígitos. Também aceito como cstPis, cst_pis_cofins."},"cbenef":{"type":"string","description":"cBenef informado (conferido na tabela da UF de origem). Também aceito como cBenef."},"importado":{"type":"string","enum":["sim","nao"],"description":"Mercadoria importada (interestadual de 4%). Sem ele vale a origem."},"carga_propria":{"type":"number","minimum":0,"maximum":100,"description":"Carga própria do substituto na operação interna, percentual de 0 a 100. Também aceito como cargaPropria."},"valor":{"type":"string","description":"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":{"type":"string","description":"Quantidade tributável do item (padrão 1). Também aceito como qTrib."},"cst_regular":{"type":"string","description":"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":{"type":"string","description":"cClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001. Também aceito como cclasstribRegular, cClassTribReg."},"descricao":{"type":"string","description":"Descrição do produto, só devolvida na resposta."},"referencia":{"type":"string","description":"Seu identificador do item (código do produto, linha do pedido), devolvido igual na resposta. Também aceito como id."}}}}}},"example":{"operacao":{"sentido":"saida","natureza":"venda-producao-propria","regime":"real","tributacao":"tributada","origem":"0","uf_origem":"RS","uf_destino":"SP","destinatario":"nao-contribuinte","consumidor_final":"sim"},"itens":[{"ncm":"94036000","referencia":"PED-1042-1"},{"ncm":"94017900","referencia":"PED-1042-2","cest":"2806100"}]}}}},"responses":{"200":{"description":"resultados por item, na ordem enviada","content":{"application/json":{"schema":{"type":"object","properties":{"recurso":{"type":"string","const":"pre-nfe-lote"},"itens":{"type":"integer"},"prontos":{"type":"integer"},"recusados":{"type":"integer"},"resultados":{"type":"array","items":{"oneOf":[{"type":"object","not":{"required":["erro"]},"required":["recurso","nfe","operacao","difal","ncm","icmsSt","pisCofins","ibsCbs","trilha","rejeicoesPrevistas","avisos","pendencias","pronto","leitura"],"properties":{"recurso":{"type":"string","const":"pre-nfe"},"referencia":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}],"description":"o `referencia` que você enviou, igual"},"entrada":{"type":"object","description":"operação e item como foram lidos"},"nfe":{"type":"object","description":"os campos da NF-e que a operação decide","properties":{"natOp":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"CFOP":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"idDest":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"indIEDest":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"indFinal":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"modelo":{"type":"string","enum":["55","65"]},"tpNF":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"valor":{"type":"integer"},"rotulo":{"type":"string"},"porque":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]}}},"operacao":{"type":"object","description":"natureza, cfop (com admissíveis e perfil de risco), icms ou csosn, pisCofins e ibsCbsDaOperacao, pelo motor do /qual-codigo-fiscal"},"difal":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"devido":{"type":"boolean"},"responsavel":{"type":"string","enum":["remetente","destinatario"]},"grupoNaNota":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"rejeicaoSemGrupo":{"type":"string"},"baseLegal":{"type":"string"},"calculadora":{"type":"string","format":"uri"}}},{"$ref":"#/components/schemas/Ausencia"}]},"ncm":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"ipi":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"icmsSt":{"oneOf":[{"$ref":"#/components/schemas/ConsultaSt"},{"$ref":"#/components/schemas/Ausencia"}]},"pisCofins":{"type":"object"},"ibsCbs":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"estado":{"type":"string"},"motivo":{"type":"string"},"candidatos":{"oneOf":[{"type":"array","items":{"type":"object"}},{"$ref":"#/components/schemas/Ausencia"}]},"respostasUsadas":{"type":"object"},"cbsCombustivel":{"oneOf":[{"$ref":"#/components/schemas/CbsCombustivel"},{"$ref":"#/components/schemas/Ausencia"}],"description":"combustível do monofásico: a CBS é valor por unidade (Portaria MF nº 3.074/2026, efeitos em jan/2027). O mesmo bloco sai em reforma.cbsCombustivel da ficha de NCM"}}},{"$ref":"#/components/schemas/Ausencia"}]},"ibsCbsCalculado":{"type":"object","description":"o grupo IBS/CBS pelo motor da Calculadora de Tributos portado (igual ao JAR oficial no gabarito): `vinculo` diz se o NCM está na lista do cClassTrib (REG-011 quando não está; a SEFAZ autoriza o par errado) e, com `valor`, `grupo` traz o IBSCBS do motor (gIBSCBS, gTribRegular, gTribCompraGov) e `localidadeIncidencia` a UF e o município usados","properties":{"motor":{"type":"string","description":"versão do banco da Calculadora"},"vinculo":{"type":"object"},"grupo":{"type":"object"},"oper":{"type":"object"},"localidadeIncidencia":{"type":"object"},"simulado":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"recusa":{"type":"object"}}},"unidadeTributavel":{"type":"object"},"gtin":{"type":"object"},"cbenef":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"trilha":{"type":"array","items":{"type":"object","properties":{"camada":{"type":"string"},"decisao":{"type":"string"},"porque":{"type":"string"},"fonte":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]}}}},"rejeicoesPrevistas":{"type":"array","description":"só regra cuja condição o dado enviado PROVA","items":{"type":"object","properties":{"codigo":{"type":"string"},"motivo":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"campo":{"type":"string"},"porque":{"type":"string"},"ficha":{"type":"string","format":"uri"}}}},"avisos":{"type":"array","items":{"type":"object","properties":{"tipo":{"type":"string"},"texto":{"type":"string"},"rejeicao":{"type":"string"}}}},"pendencias":{"type":"array","description":"o que falta responder; `parametro` é o nome a enviar na próxima chamada","items":{"type":"object","required":["camada","eixo","parametro","pergunta","opcoes"],"properties":{"camada":{"type":"string","enum":["operacao","item","icms-st","ibs-cbs"]},"eixo":{"type":"string"},"parametro":{"type":"string"},"pergunta":{"type":"string"},"opcoes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rotulo":{"type":"string"}}}},"campoNaNota":{"type":"string"},"ajuda":{"type":"string"}}}},"dataEmissao":{"type":"object","description":"a data que decidiu a resposta: a `data_emissao` enviada, ou nenhuma (o ICMS-ST usa o dia de hoje)","required":["informada"],"properties":{"data":{"type":"string","format":"date","description":"só quando informada"},"informada":{"type":"boolean"},"nota":{"type":"string"}}},"pronto":{"type":"boolean","description":"true só sem rejeição prevista e sem pendência"},"leitura":{"type":"string"},"meta":{"type":"object"}}},{"type":"object","required":["recurso","item","pronto","erro"],"properties":{"recurso":{"const":"pre-nfe"},"item":{"type":"integer","minimum":0},"pronto":{"const":false},"erro":{"type":"object","required":["codigo","mensagem"],"properties":{"codigo":{"type":"string"},"mensagem":{"type":"string"},"detalhes":{"type":"array","items":{"type":"object"}}}}}}]}},"meta":{"type":"object"}}}}}},"400":{"description":"parâmetro desconhecido, valor fora das opções, UF ou NCM fora do formato. Também quando o âmbito contradiz as UFs. `erro.detalhes[]` traz o nome, o recebido e as opções","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"413":{"description":"corpo acima de 1 MB","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -X POST -H \"x-api-key: $NCM_API_KEY\" -H \"content-type: application/json\" -d '{\"operacao\":{\"sentido\":\"saida\",\"natureza\":\"venda-producao-propria\",\"regime\":\"real\",\"tributacao\":\"tributada\",\"origem\":\"0\",\"uf_origem\":\"RS\",\"uf_destino\":\"SP\",\"destinatario\":\"nao-contribuinte\",\"consumidor_final\":\"sim\"},\"itens\":[{\"ncm\":\"94036000\",\"referencia\":\"PED-1042-1\"},{\"ncm\":\"94017900\",\"referencia\":\"PED-1042-2\"}]}' \"https://api.buscadorncm.com.br/v1/pre-nfe\""}]}},"/ibs-cbs/calcular":{"post":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"IBS e CBS do regime geral com o contrato do motor oficial (regime-geral)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["itens"],"properties":{"id":{"type":"string"},"versao":{"type":"string"},"dhFatoGerador":{"type":"string","format":"date-time"},"dataHoraEmissao":{"type":"string","format":"date-time"},"municipio":{"type":"integer"},"uf":{"type":"string"},"tpDoc":{"type":"integer"},"gCompraGov":{"type":"object","properties":{"tpEnteGov":{"type":"integer"},"tpOperGov":{"type":"integer"}}},"itens":{"type":"array","maxItems":500,"items":{"type":"object","properties":{"numero":{"type":"integer"},"ncm":{"type":"string"},"nbs":{"type":"string"},"cst":{"type":"string"},"cClassTrib":{"type":"string"},"baseCalculo":{"type":"number"},"quantidade":{"type":"number"},"unidade":{"type":"string"},"tributacaoRegular":{"type":"object"},"aliquotasNominais":{"type":"object"}}}}}}}}},"responses":{"200":{"description":"objetos por item e o total, como o motor oficial (cada item conta uma consulta da cota)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"campo inválido, como o motor oficial (base com mais de 2 casas, data fora do formato)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"404":{"description":"NCM, NBS, CST ou cClassTrib inexistente na data, com o código REG do motor","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"422":{"description":"erro do motor (REG-011, REG-012, CAL-007...), com o type, o title e o detail do motor oficial","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -X POST -H \"x-api-key: $NCM_API_KEY\" -H \"content-type: application/json\" -d '{\"id\":\"exemplo-1\",\"versao\":\"1.0.0\",\"dhFatoGerador\":\"2026-11-20T12:00:00-03:00\",\"municipio\":3550308,\"uf\":\"SP\",\"itens\":[{\"numero\":1,\"ncm\":\"84713012\",\"cst\":\"000\",\"cClassTrib\":\"000001\",\"baseCalculo\":1000,\"quantidade\":1,\"unidade\":\"UN\"}]}' \"https://api.buscadorncm.com.br/v1/ibs-cbs/calcular\""}]}},"/cnpj":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Cadastro do CNPJ para o motor fiscal: situação, UF, CNAE, Simples e MEI, IE, SUFRAMA, ente público e o ISS das atividades","parameters":[{"name":"cnpj","in":"query","required":true,"description":"14 caracteres, com ou sem máscara (aceita o CNPJ alfanumérico). Vai na query para não ficar no caminho dos logs","schema":{"type":"string"}},{"name":"data","in":"query","required":false,"description":"AAAA-MM-DD para o Simples e o MEI na data (padrão: hoje)","schema":{"type":"string"}}],"responses":{"200":{"description":"o registro do cadastro, sem nome nem endereço","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"CNPJ fora do cadastro aberto da safra","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"503":{"description":"cadastro não ligado nesta versão","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/cnpj?cnpj=00394460000141\""}]}},"/ibs-cbs/vinculo":{"get":{"tags":["nivel-0"],"summary":"cClassTrib × NCM ou NBS: o vínculo da Calculadora nos dois sentidos","parameters":[{"name":"ncm","in":"query","required":false,"description":"8 dígitos (ou nbs)","schema":{"type":"string"}},{"name":"nbs","in":"query","required":false,"description":"9 dígitos (ou ncm)","schema":{"type":"string"}},{"name":"cclasstrib","in":"query","required":false,"description":"6 dígitos: com ele a resposta diz se o par é aceito","schema":{"type":"string"}},{"name":"data","in":"query","required":false,"description":"AAAA-MM-DD (padrão: hoje)","schema":{"type":"string"}}],"responses":{"200":{"description":"aceita, porque, os códigos que aceitam e os prefixos do código","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"ncm e nbs juntos, ou fora do formato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/ibs-cbs/vinculo?ncm=84713012&cclasstrib=200003\""}]}},"/pre-nfse":{"get":{"tags":["nivel-2"],"security":[{"ApiKey":[]}],"summary":"Pré-NFS-e: o serviço inteiro antes de emitir, na ordem do Emissor Nacional","parameters":[{"name":"nbs","in":"query","required":true,"description":"9 dígitos","schema":{"type":"string"}},{"name":"municipio","in":"query","required":false,"description":"IBGE do prestador","schema":{"type":"string"}},{"name":"regime","in":"query","required":false,"description":"regular, simples ou mei","schema":{"type":"string"}},{"name":"data","in":"query","required":false,"description":"competência AAAA-MM-DD (padrão: hoje)","schema":{"type":"string"}},{"name":"ctribnac","in":"query","required":false,"description":"6 dígitos","schema":{"type":"string"}},{"name":"ctribmun","in":"query","required":false,"description":"sufixo municipal de 3 dígitos","schema":{"type":"string"}},{"name":"cindop","in":"query","required":false,"description":"6 dígitos","schema":{"type":"string"}},{"name":"tomador","in":"query","required":false,"description":"cnpj, cpf, exterior ou nao-identificado","schema":{"type":"string"}},{"name":"municipio_tomador","in":"query","required":false,"description":"IBGE","schema":{"type":"string"}},{"name":"municipio_prestacao","in":"query","required":false,"description":"IBGE","schema":{"type":"string"}},{"name":"ente_gov","in":"query","required":false,"description":"1 União, 2 Estado, 3 DF, 4 Município","schema":{"type":"string"}},{"name":"cst","in":"query","required":false,"description":"CST do IBS/CBS","schema":{"type":"string"}},{"name":"cclasstrib","in":"query","required":false,"description":"6 dígitos","schema":{"type":"string"}},{"name":"cst_regular","in":"query","required":false,"description":"grupo de tributação regular","schema":{"type":"string"}},{"name":"cclasstrib_regular","in":"query","required":false,"description":"grupo de tributação regular","schema":{"type":"string"}},{"name":"valor","in":"query","required":false,"description":"valor do serviço em reais","schema":{"type":"string"}},{"name":"retencao_iss","in":"query","required":false,"description":"sim ou nao, como a DPS vai sair: é conferido contra a regra do município (E0655 a E0657). Sem ele, a resposta recomenda o tpRetISSQN pela parametrização do ADN","schema":{"type":"string"}}],"responses":{"200":{"description":"campos, ISS, cIndOp, IBS/CBS, recusas previstas, pendências e trilha","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"parâmetro fora do formato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/pre-nfse?municipio=3106200&regime=regular&nbs=113022100&tomador=cnpj&municipio_tomador=3106200&valor=1000\""}]}},"/api":{"get":{"tags":["nivel-0"],"summary":"Catálogo do que existe, vocabulário de ausência e safra das fontes","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}}],"responses":{"200":{"description":"índice raiz","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/\""}]}},"/api/openapi.json":{"get":{"tags":["nivel-0"],"summary":"Esta especificação","responses":{"200":{"description":"OpenAPI 3.1","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/openapi.json\""}]}},"/api/saude":{"get":{"tags":["nivel-0"],"summary":"Estado do serviço, para ligar no seu monitoramento","description":"Atalho: `/v1/saude` responde o mesmo que esta rota. Sem chave, sem cache (`no-store`). Devolve 200 com `ok: true` quando o serviço responde, o pacote fiscal está sendo servido e a base de contas e chaves responde (`contasEChaves`, desde 08/out/2026: sem ela toda chamada com chave falha); **503 com `ok: false` e `degradado[]`** quando alguma dependência falta ou a base passa de 1,5 s em duas leituras seguidas (uma leitura lenta isolada não derruba o sinal, desde 11/out/2026). Afirma só o que mede: que a API responde, qual pacote está no ar e que as chamadas com chave conseguem ser autenticadas. Não afirma que uma regra fiscal está correta e por isso não constitui SLA.","responses":{"200":{"description":"no ar","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"servico":{"type":"string"},"versao":{"type":"string"},"build":{"type":"string"},"agora":{"type":"string","format":"date-time"},"pacoteFiscal":{"type":"string"},"contasEChaves":{"type":"object","properties":{"ok":{"type":"boolean"},"ms":{"type":"integer","description":"tempo da sonda da base, em milissegundos"}}},"degradado":{"type":"array","items":{"type":"string"}}}}}}},"503":{"description":"degradado: alguma dependência não respondeu","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/saude\""}]}},"/cfop":{"get":{"tags":["nivel-0"],"summary":"Índice dos 620 CFOPs","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}}],"responses":{"200":{"description":"índice","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cfop\""}]}},"/cfop/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Ficha do CFOP: descrição, nota do ato, 9 indicadores da NF-e, regras do MOC que o tocam, espelho, operações do assistente","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"codigo","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-7][0-9]{3}$"}}],"responses":{"200":{"description":"ficha","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"código fora do catálogo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/cfop/6107\""}]}},"/nfe/rejeicoes":{"get":{"tags":["nivel-0"],"summary":"Índice das 1061 rejeições da NF-e","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}}],"responses":{"200":{"description":"índice","content":{"application/json":{"schema":{"type":"object"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/nfe/rejeicoes\""}]}},"/nfe/rejeicoes/{codigo}":{"get":{"tags":["nivel-0"],"summary":"Rejeição: motivo, regra literal do MOC com exceções, obrigatória × facultativa, CFOPs e indicadores que a regra toca","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"codigo","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{3,4}$"}}],"responses":{"200":{"description":"ficha","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"código fora do MOC","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/nfe/rejeicoes/694\""}]}},"/api/delta":{"get":{"tags":["nivel-0"],"summary":"Índice dos deltas semânticos entre versões do pacote fiscal (reforma e icms-st): o último de cada domínio e o histórico. No host da API: /v1/delta","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}}],"responses":{"200":{"description":"índice","content":{"application/json":{"schema":{"type":"object","properties":{"ultimos":{"type":"object"},"historico":{"type":"array"}}}}}},"404":{"description":"nenhum delta publicado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/delta\""}]}},"/api/delta/{dominio}":{"get":{"tags":["nivel-0"],"summary":"O último delta do domínio: NCMs novos/removidos/alterados com os campos que mudaram (reforma: candidatos, vedados, seletivo, base, piscofins; icms-st: CEST×UF, alíquota, condição)","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"dominio","in":"path","required":true,"schema":{"type":"string","enum":["reforma","icms-st"]}}],"responses":{"200":{"description":"delta","headers":{"X-Delta":{"schema":{"type":"string"},"description":"de->para"}},"content":{"application/json":{"schema":{"type":"object","properties":{"dominio":{"type":"string"},"de":{"type":"string"},"para":{"type":"string"},"geradoEm":{"type":"string"},"resumo":{"type":"object"},"itens":{"type":"object","additionalProperties":{"type":"object","properties":{"tipo":{"type":"string","enum":["novo","removido","alterado"]},"campos":{"type":"array","items":{"type":"string"}}}}}}}}}},"404":{"description":"sem delta para o domínio","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl \"https://api.buscadorncm.com.br/v1/delta/reforma\""}]}},"/api/monitor":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Destes NCMs, quais mudaram nas fontes desde a versão X? (sem estado: o ERP pergunta quando quiser). No host da API: /v1/monitor","description":"Cruza a lista de NCMs com os deltas do domínio depois de `desde` (encadeando versões) ou só com o último delta. Para listas maiores que 2.000 ou aviso automático por e-mail/webhook assinado, cadastre um acompanhamento em Minha conta (o /app envia só a lista de NCMs).","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"ncms","in":"query","required":true,"description":"até 2.000 NCMs de 8 dígitos separados por vírgula","schema":{"type":"string"}},{"name":"dominio","in":"query","required":false,"description":"Padrão: reforma","schema":{"type":"string","enum":["reforma","icms-st"]}},{"name":"desde","in":"query","required":false,"description":"versão do pacote em que você conferiu (V0006); sem ela, só o último delta","schema":{"type":"string","pattern":"^V[0-9]{4}$"}},{"name":"ufs","in":"query","required":false,"description":"ICMS-ST: só mudanças que tocam estas UFs (SP,MG)","schema":{"type":"string"}}],"responses":{"200":{"description":"afetados","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"recurso":{"type":"string","const":"monitor"},"dominio":{"type":"string"},"consultados":{"type":"integer"},"desde":{"type":["string","null"]},"corrente":{"type":["string","null"]},"afetados":{"type":"integer"},"itens":{"type":"array","items":{"type":"object","properties":{"ncm":{"type":"string"},"tipo":{"type":"string"},"campos":{"type":"array","items":{"type":"string"}},"versoes":{"type":"array","items":{"type":"string"}}}}},"semMudanca":{"type":"boolean"}}}}}},"400":{"description":"lista vazia/longa, domínio ou versão fora do formato","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada ou cota diária esgotada","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/monitor?ncms=94036000,30049069&dominio=reforma\""}]}},"/icms-st/segmento/{segmento}/{uf}":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"Segmento + UF → MVA de referência com a faixa, a MVA de cada CEST do segmento e, com origem, quem retém","description":"Para precificar sem o CEST de cada item. A referência é orientação do segmento; o valor que vale é o do CEST. Mesmo pacote e mesma cota da consulta por NCM.","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"segmento","in":"path","required":true,"description":"slug do segmento, como na página /icms-st/{segmento}","schema":{"type":"string","example":"tintas-e-vernizes"}},{"name":"uf","in":"path","required":true,"description":"UF de destino em minúsculas, como na página /icms-st/{segmento}/{uf}. Maiúscula responde 301 para a minúscula.","schema":{"type":"string","enum":["ac","al","am","ap","ba","ce","df","es","go","ma","mg","ms","mt","pa","pb","pe","pi","pr","rj","rn","ro","rr","rs","sc","se","sp","to"],"example":"rj"}},{"name":"origem","in":"query","required":false,"description":"UF do remetente: com ela a resposta diz quem retém","schema":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"]}}],"responses":{"200":{"description":"segmento na UF","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"segmento desconhecido (a lista volta em `erro.detalhes[]`) ou UF inválida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada (Retry-After) ou cota diária esgotada (X-RateLimit-*)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/icms-st/segmento/tintas-e-vernizes/rj?origem=SP\""}]}},"/icms-st/consulta":{"get":{"tags":["nivel-1"],"security":[{"ApiKey":[]}],"summary":"NCM + UF de origem + UF de destino → estado de evidência do ICMS-ST, MVA original e ajustada, alíquotas, condição da UF, base legal e cobertura da prova","description":"Estado de evidência, nunca veredito: `com-st` (MVA publicada para CEST×UF), `com-st-so-ajustada` (a UF publica só a ajustada), `com-st-sem-mva` (o segmento afirma a UF, falta MVA para o CEST: sai a referência ou a faixa do segmento e a `pergunta`), `nao-afirmada`, `saida` (a UF saiu do ato), `sem-prova`, `origem-fora-do-alcance`, `sem-cest`, `cest-ambiguo` (o NCM tem mais de um CEST: `pergunta.opcoes` lista; repita com `cest=`). Mesmo motor e MESMO pacote versionado do auditor em lote (`/fiscal-pack/icms-st/manifest.json`). Pacote corrente: V0021 de 2026-11-13; fontes: MVA por CEST×UF de 2026-11-04, alíquotas de 2026-08-10. FCP e PMPF não são calculados: saem declarados em `condicoes` e `avisos`.","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"ncm","in":"query","required":true,"description":"NCM de 8 dígitos","schema":{"type":"string","pattern":"^[0-9.]{8,10}$"}},{"name":"origem","in":"query","required":true,"description":"UF do remetente","schema":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"]}},{"name":"destino","in":"query","required":true,"description":"UF do destinatário (igual à origem = operação interna)","schema":{"type":"string","enum":["AC","AL","AM","AP","BA","CE","DF","ES","GO","MA","MG","MS","MT","PA","PB","PE","PI","PR","RJ","RN","RO","RR","RS","SC","SE","SP","TO"]}},{"name":"cest","in":"query","required":false,"description":"SS.III.DD, obrigatório quando o NCM tem mais de um CEST","schema":{"type":"string","pattern":"^[0-9]{2}\\.?[0-9]{3}\\.?[0-9]{2}$"}},{"name":"importado","in":"query","required":false,"description":"1 = mercadoria importada (4%, Res. SF 13/2012)","schema":{"type":"string","enum":["0","1"]}},{"name":"carga_propria","in":"query","required":false,"description":"Percentual da carga própria do substituto na operação INTERNA; ajusta a MVA quando menor que a alíquota interna","schema":{"type":"number","minimum":0,"maximum":100}},{"name":"porta_a_porta","in":"query","required":false,"description":"sim = venda a revendedor porta a porta. O CEST do Anexo XXVI (venda porta a porta) só tem ST nesse canal (Convênio ICMS 45/1999): sem este parâmetro, NCM que só tem CEST desse anexo sai `so-porta-a-porta`","schema":{"type":"string","enum":["sim","nao"]}}],"responses":{"200":{"description":"estado e prova","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"epoch da próxima meia-noite em Brasília"},"X-Pacote-ICMS-ST":{"schema":{"type":"string"},"description":"versão do pacote que respondeu"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultaSt"}}}},"400":{"description":"NCM, UF ou CEST fora do formato. Também volta 400 o CEST que não pertence ao NCM: `erro.detalhes[]` traz o motivo e os CESTs do NCM","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada (Retry-After) ou cota diária esgotada (X-RateLimit-*)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/icms-st/consulta?ncm=94036000&origem=RS&destino=RJ&porta_a_porta=sim\""}]}},"/qual-codigo-fiscal":{"get":{"tags":["nivel-2"],"security":[{"ApiKey":[]}],"summary":"Operação caracterizada → conjunto CFOP + CST ICMS/CSOSN + CST PIS/COFINS, com base legal, avisos das regras 508/529/600 e a pergunta pendente","description":"Sem `destinatario` onde a operação desdobra o CFOP (saída interestadual de venda), `cfop.codigo` vem como `exige_resposta` e `cfop.admissiveis` traz os dois códigos com quem separa cada um. É o MESMO motor da página `/qual-codigo-fiscal`.","parameters":[{"name":"Accept","in":"header","required":false,"description":"Só no domínio do site (`buscadorncm.com.br`): nomeie `application/json`, senão a mesma URL devolve o HTML da página. No host da API (`api.buscadorncm.com.br`) não é preciso.","schema":{"type":"string","default":"application/json","example":"application/json"}},{"name":"sentido","in":"query","required":false,"description":"Saída (você emite) ou entrada (você recebe). Padrão: saida","schema":{"type":"string","enum":["saida","entrada"]}},{"name":"natureza","in":"query","required":false,"description":"Operação canônica. Padrão: venda-revenda","schema":{"type":"string","enum":["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","compra-industrializacao","compra-comercializacao","compra-comercializacao-st","compra-servico-issqn","compra-uso-consumo","compra-ativo-imobilizado","transferencia-producao","transferencia-adquirida","remessa-industrializacao","retorno-industrializacao","retorno-industrializacao-recebido","remessa-vasilhame","remessa-conserto","retorno-conserto","remessa-consignacao","venda-a-ordem-vendedor-remetente","venda-a-ordem-remessa-destinatario","venda-a-ordem-adquirente-originario","venda-a-ordem-entrada-destinatario","venda-entrega-futura-faturamento","venda-entrega-futura-entrega","compra-entrega-futura-faturamento","compra-entrega-futura-recebimento","ind-conta-ordem-venda-fornecedor","ind-conta-ordem-remessa-fornecedor","ind-conta-ordem-entrada-industrializador","ind-conta-ordem-retorno-industrializador","ind-conta-ordem-compra-adquirente","remessa-venda-fora","venda-efetivada-fora","retorno-venda-fora","entrega-cooperativa-preco-a-fixar","fixacao-preco-cooperativa","fornecimento-ato-cooperativo","entrada-ato-cooperativo","industrializacao-efetuada","industrializacao-efetuada-sem-transito","industrializacao-recebida","industrializacao-recebida-sem-transito","retorno-industrializacao-nao-aplicada","entrada-industrializacao-nao-aplicada","aquisicao-servico-issqn","prestacao-servico-issqn","aquisicao-servico-comunicacao","prestacao-servico-comunicacao","aquisicao-servico-transporte","prestacao-servico-transporte","compra-industrializacao-st","compra-ativo-imobilizado-st","compra-uso-consumo-st","devolucao-venda-producao-st","devolucao-venda-revenda-st","transferencia-comercializacao-st","transferencia-industrializacao-st"]}},{"name":"ambito","in":"query","required":false,"description":"Interna, interestadual ou exterior. Padrão: interna","schema":{"type":"string","enum":["interna","interestadual","exterior"]}},{"name":"regime","in":"query","required":false,"description":"Regime da empresa. Padrão: simples","schema":{"type":"string","enum":["real","presumido","simples"]}},{"name":"tributacao","in":"query","required":false,"description":"Situação do ICMS. Padrão: tributada","schema":{"type":"string","enum":["tributada","tributada-st","st-anterior","reducao","isenta","isenta-st","nao-tributada","suspensao","diferimento","outras"]}},{"name":"origem","in":"query","required":false,"description":"Origem da mercadoria (Tabela A). Padrão: 0","schema":{"type":"string","enum":["0","1","2","3","4","5","6","7","8"]}},{"name":"destinatario","in":"query","required":false,"description":"Só decide na saída interestadual de venda (fork 6101/6107 · 6102/6108). Informado fora disso → 400.","schema":{"type":"string","enum":["contribuinte","isento","nao-contribuinte"]}},{"name":"perfil","in":"query","required":false,"description":"Só decide nos grupos 1.300/1.350 e 5.300/5.350 (comunicação e transporte).","schema":{"type":"string","enum":["mesma-natureza","industrial","comercial","prestador-transporte","geradora-energia","produtor-rural"]}}],"responses":{"200":{"description":"conjunto","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"epoch da próxima meia-noite em Brasília"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operacao"}}}},"400":{"description":"eixo fora das opções: `erro.detalhes[]` nomeia o eixo, o valor recebido e as opções válidas","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"401":{"description":"chave ausente ou não reconhecida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"403":{"description":"chave revogada ou plano sem este nível","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"429":{"description":"rajada (Retry-After) ou cota diária esgotada (X-RateLimit-*)","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl -H \"x-api-key: $NCM_API_KEY\" \"https://api.buscadorncm.com.br/v1/operacao?sentido=saida&natureza=venda-producao-propria&ambito=interestadual&regime=real&tributacao=tributada&origem=0&destinatario=nao-contribuinte\""}]}}},"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Chave `ncm_…` (40 hex). `Authorization: Bearer ncm_…` também é aceito. Cotas dos planos de API: Avaliação: 100/dia · Pro API: 10.000/dia · API Escala: 100.000/dia. Acima disso, contrato anual."}},"schemas":{"Ausencia":{"type":"object","description":"Campo sem valor. NUNCA `null`: o motivo diz por que não há valor. Os motivos têm significados opostos.","required":["ausente","motivo","explicacao"],"properties":{"ausente":{"type":"boolean","const":true},"motivo":{"type":"string","enum":["nao_consta_na_fonte","fora_de_vigencia","sem_fim_publicado","fora_de_cobertura","nao_medido","regra_geral","exige_resposta","nao_se_aplica"]},"explicacao":{"type":"string"},"detalhe":{"type":"string"}}},"Erro":{"type":"object","required":["erro"],"properties":{"erro":{"type":"object","required":["codigo","mensagem","documentacao"],"properties":{"codigo":{"type":"string","enum":["recurso_inexistente","consulta_invalida","chave_ausente","chave_invalida","chave_revogada","nivel_nao_liberado","rajada","cota_diaria_esgotada","indisponivel"]},"mensagem":{"type":"string"},"detalhes":{"type":"array","items":{"type":"object","properties":{"eixo":{"type":"string"},"recebido":{"type":"string"},"mensagem":{"type":"string"},"opcoes":{"type":"array","items":{"type":"string"}}}}},"documentacao":{"type":"string","format":"uri"}}}}},"CbsCombustivel":{"type":"object","required":["aplicacao","natureza","ato","url","efeitos","combustiveis","ibs","texto"],"properties":{"aplicacao":{"type":"object","required":["estado","motivo"],"description":"o NCM sozinho não decide: \"condicional\" sem resposta (ficha e pré-nota sem combustivel_monofasico), \"aplicavel\" com combustivel_monofasico=contribuinte ou revenda. Com combustivel_monofasico=nao o bloco inteiro vira Ausencia","properties":{"estado":{"type":"string","enum":["condicional","aplicavel"]},"motivo":{"type":"string"}}},"natureza":{"type":"string"},"ato":{"type":"string","description":"Portaria MF nº 3.074/2026"},"url":{"type":"string","format":"uri"},"publicacaoDou":{"type":"string","format":"date"},"efeitos":{"type":"object","properties":{"mes":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"regra":{"type":"string"},"texto":{"type":"string"},"contagem":{"type":"string"}}},"baseDeCalculo":{"type":"string"},"combustiveis":{"type":"array","items":{"type":"object","required":["inciso","combustivel","cbs"],"properties":{"inciso":{"type":"string","description":"inciso do art. 172 da LC 214/2025"},"combustivel":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"cbs":{"oneOf":[{"type":"object","required":["valor","moeda","unidade","texto"],"properties":{"valor":{"type":"number"},"moeda":{"const":"BRL"},"unidade":{"type":"string","enum":["litro","quilo"]},"texto":{"type":"string"},"comoNoAnexo":{"type":"string"},"excecao":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]}}},{"$ref":"#/components/schemas/Ausencia"}]}}}},"ibs":{"type":"object","properties":{"desde":{"type":"integer"},"valor":{"$ref":"#/components/schemas/Ausencia"},"metodologia":{"type":"string"}}},"texto":{"type":"string","description":"a mesma frase da ficha HTML"}}},"ConsultaSt":{"type":"object","required":["recurso","estado","rotulo","temNumero","cests","avisos","proveniencia","meta"],"properties":{"recurso":{"type":"string","const":"icms-st"},"entrada":{"type":"object","description":"ncm, cest, origem, destino, importado, cargaPropria como foram lidos"},"estado":{"type":"string","enum":["com-st","com-st-so-ajustada","com-st-sem-mva","nao-afirmada","saida","sem-prova","origem-fora-do-alcance","sem-cest","cest-ambiguo","so-porta-a-porta","fora-porta-a-porta"]},"rotulo":{"type":"string"},"temNumero":{"type":"boolean","description":"true só em com-st e com-st-so-ajustada"},"cest":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"cests":{"type":"array","items":{"type":"object","properties":{"cest":{"type":"string"},"descricao":{"type":"string"},"segmento":{"type":"string"}}}},"pergunta":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"eixo":{"type":"string","enum":["cest","mva","preco","portaAPorta"]},"texto":{"type":"string"},"opcoes":{"type":"array"}}},{"$ref":"#/components/schemas/Ausencia"}]},"segmento":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"slug":{"type":"string"},"nome":{"type":"string"},"baseLegal":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"rota":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"estado":{"type":"string","enum":["afirmada","saida","nao-afirmada","saida-sem-data","sem-prova"]}}},{"$ref":"#/components/schemas/Ausencia"}]},"operacao":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"interna":{"type":"boolean"},"ajusteInterno":{"type":"boolean"},"aliqInterestadual":{"type":"object"},"aliqInterna":{"type":"object"}}},{"$ref":"#/components/schemas/Ausencia"}]},"mva":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"original":{"oneOf":[{"type":"number"},{"$ref":"#/components/schemas/Ausencia"}]},"ajustada":{"oneOf":[{"type":"number"},{"$ref":"#/components/schemas/Ausencia"}]},"soAjustada":{"type":"boolean"},"basePorPreco":{"type":"boolean"},"fonte":{"oneOf":[{"type":"string","enum":["cest-uf","protocolo","segmento-referencia"]},{"$ref":"#/components/schemas/Ausencia"}]}}},{"$ref":"#/components/schemas/Ausencia"}]},"condicoes":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"leque":{"description":"Só no `cest-ambiguo`: o que cada CEST possível daria nesta mesma operação (estado, rota, MVA original e ajustada), na ordem da `pergunta`. Não é recomendação: a consulta com `cest=` é a que vale. Nos outros estados, `Ausencia`.","oneOf":[{"type":"array","items":{"type":"object","required":["cest","estado","rotulo","temNumero"],"properties":{"cest":{"type":"string"},"estado":{"type":"string"},"rotulo":{"type":"string"},"temNumero":{"type":"boolean"},"rota":{},"retencao":{},"mva":{},"pergunta":{}}}},{"$ref":"#/components/schemas/Ausencia"}]},"avisos":{"type":"array","items":{"type":"string"}},"proveniencia":{"type":"object"},"meta":{"type":"object"}}},"Operacao":{"type":"object","required":["recurso","operacao","cfop","icms","csosn","pisCofins","avisos","meta"],"properties":{"recurso":{"type":"string","const":"operacao"},"entrada":{"type":"object","description":"os eixos como foram lidos, depois dos defaults"},"operacao":{"type":"object","properties":{"id":{"type":"string"},"rotulo":{"type":"string"},"sentido":{"type":"string"},"ambito":{"type":"string"},"confianca":{"type":"string","enum":["nucleo","confira"]},"baseLegal":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]}}},"cfop":{"type":"object","properties":{"codigo":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/Ausencia"}]},"admissiveis":{"type":"array","items":{"type":"object","properties":{"codigo":{"type":"string"},"quando":{"type":"array","items":{"type":"string"}}}}},"pergunta":{"type":"object"}}},"icms":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"cst":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"csosn":{"oneOf":[{"type":"object","not":{"required":["ausente"]},"properties":{"codigo":{"type":"string"}}},{"$ref":"#/components/schemas/Ausencia"}]},"pisCofins":{"type":"object"},"avisos":{"type":"array","items":{"type":"object","properties":{"rejeicao":{"type":"string"},"tipo":{"type":"string","enum":["cst-fora-da-relacao","cst-vedado"]},"ressalvas":{"type":"array","items":{"type":"string"}}}}},"difal":{"oneOf":[{"type":"object","not":{"required":["ausente"]}},{"$ref":"#/components/schemas/Ausencia"}]},"meta":{"type":"object","properties":{"versaoSite":{},"pacote":{"type":"object"}}}}}}},"x-vocabularioDeAusencia":{"nao_consta_na_fonte":"A fonte oficial não publica este dado para este código. Ausência na fonte não é zero nem negativa.","fora_de_vigencia":"O código existe no catálogo mas está fora da tabela vigente: serve para ler documento antigo, não para emitir documento novo.","sem_fim_publicado":"A fonte traz a coluna e ela vem vazia para todos os códigos: nenhum fim de vigência foi publicado até a data desta extração.","fora_de_cobertura":"Fora do que esta base cobre. Não equivale a \"procuramos e não existe\".","nao_medido":"Não medimos. Não interpretar como zero, vazio ou negativa.","regra_geral":"Procuramos dentro da cobertura declarada e não há exceção aplicável: a regra geral é a resposta.","exige_resposta":"Falta caracterizar um eixo da operação. O conjunto só fecha com essa resposta, e ela é de quem emite.","nao_se_aplica":"A pergunta não cabe neste código."}}