{"openapi":"3.1.0","info":{"title":"binobo · API das tabelas fiscais da NFS-e e da reforma tributária","version":"1.0.0","summary":"cTribNac, LC 116, NBS, cClassTrib, CST, indOp e alíquotas de ISS por município. Grátis e sem cadastro.","description":"Tabelas oficiais da NFS-e nacional e do IBS/CBS (LC 214/2025), reproduzidas sem interpretação do Portal Nacional da NFS-e e do portal SVRS. Tabelas carregadas em 2026-10-26. Sem chave de API; limite de 60 requisições por minuto e 5.000 por dia por IP. Também disponível como servidor MCP em https://www.binobo.com.br/tabelas/mcp.","contact":{"name":"binobo","url":"https://www.binobo.com.br/tabelas/api"},"license":{"name":"Dados públicos; citar a fonte e a versão","url":"https://www.binobo.com.br/tabelas/api"}},"externalDocs":{"description":"Documentação e exemplos","url":"https://www.binobo.com.br/tabelas/api"},"servers":[{"url":"https://www.binobo.com.br/tabelas/api/v1"}],"paths":{"/versao":{"get":{"operationId":"versao","summary":"Versão das tabelas","description":"Data de carga e versão de cada tabela oficial.","parameters":[],"responses":{"200":{"description":"Versão das tabelas","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/ctribnac":{"get":{"operationId":"buscarServico","summary":"Buscar cTribNac por descrição","description":"Busca códigos de tributação nacional pela descrição do serviço (todas as palavras) ou pelo início do código.","parameters":[{"name":"q","in":"query","required":true,"description":"Texto ou início do código (mín. 3 caracteres)","schema":{"type":"string","maxLength":100},"example":"software"},{"name":"limite","in":"query","required":false,"description":"Até 20 resultados (padrão 10)","schema":{"type":"string","maxLength":100},"example":"10"}],"responses":{"200":{"description":"Buscar cTribNac por descrição","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/ctribnac/{codigo}":{"get":{"operationId":"consultarCtribnac","summary":"Código de tributação nacional","description":"Ficha do cTribNac: LC 116, onde o ISS é devido, NBS, cClassTrib, CST, indOp e alíquota de ISS mais comum.","parameters":[{"name":"codigo","in":"path","required":true,"description":"cTribNac de 6 dígitos","schema":{"type":"string","maxLength":100},"example":"010101"}],"responses":{"200":{"description":"Código de tributação nacional","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/lc116/{subitem}":{"get":{"operationId":"consultarLc116","summary":"Subitem da LC 116","description":"Subitem da lista de serviços da LC 116/2003 com os cTribNac e NBS correlacionados.","parameters":[{"name":"subitem","in":"path","required":true,"description":"Subitem, ex.: 1.01 ou 1-01","schema":{"type":"string","maxLength":100},"example":"1.01"}],"responses":{"200":{"description":"Subitem da LC 116","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/nbs/{codigo}":{"get":{"operationId":"consultarNbs","summary":"Código NBS","description":"Nomenclatura Brasileira de Serviços 2.0: descrição, hierarquia e subitens da LC 116.","parameters":[{"name":"codigo","in":"path","required":true,"description":"NBS de 9 dígitos","schema":{"type":"string","maxLength":100},"example":"101011100"}],"responses":{"200":{"description":"Código NBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/cclasstrib":{"get":{"operationId":"listarCclasstrib","summary":"Listar cClassTrib","description":"Classificações tributárias do IBS/CBS, com filtro por CST e pelas aceitas na NFS-e.","parameters":[{"name":"cst","in":"query","required":false,"description":"CST de 3 dígitos","schema":{"type":"string","maxLength":100},"example":"200"},{"name":"nfse","in":"query","required":false,"description":"true para só as aceitas na NFS-e","schema":{"type":"string","maxLength":100},"example":"true"}],"responses":{"200":{"description":"Listar cClassTrib","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/cclasstrib/{codigo}":{"get":{"operationId":"consultarCclasstrib","summary":"Classificação tributária do IBS/CBS","description":"cClassTrib: CST, redução de alíquota, vigência, base legal e serviços que a usam.","parameters":[{"name":"codigo","in":"path","required":true,"description":"cClassTrib de 6 dígitos","schema":{"type":"string","maxLength":100},"example":"200027"}],"responses":{"200":{"description":"Classificação tributária do IBS/CBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/cst":{"get":{"operationId":"listarCst","summary":"Listar CST do IBS/CBS","description":"Códigos de situação tributária do IBS e da CBS.","parameters":[],"responses":{"200":{"description":"Listar CST do IBS/CBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/cst/{codigo}":{"get":{"operationId":"consultarCst","summary":"CST do IBS/CBS","description":"CST e as classificações do grupo.","parameters":[{"name":"codigo","in":"path","required":true,"description":"CST de 3 dígitos","schema":{"type":"string","maxLength":100},"example":"000"}],"responses":{"200":{"description":"CST do IBS/CBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/indop":{"get":{"operationId":"listarIndop","summary":"Listar indOp","description":"Indicadores de operação do IBS/CBS.","parameters":[],"responses":{"200":{"description":"Listar indOp","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/indop/{codigo}":{"get":{"operationId":"consultarIndop","summary":"Indicador de operação","description":"Onde a operação é considerada realizada (art. 11 da LC 214/2025).","parameters":[{"name":"codigo","in":"path","required":true,"description":"indOp de 6 dígitos","schema":{"type":"string","maxLength":100},"example":"100301"}],"responses":{"200":{"description":"Indicador de operação","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/iss/{ibge}":{"get":{"operationId":"aliquotasIssPorIbge","summary":"Alíquotas de ISS do município (IBGE)","description":"Alíquotas de ISS parametrizadas pelo município no padrão nacional, ou de um serviço com ctribnac.","parameters":[{"name":"ibge","in":"path","required":true,"description":"Código IBGE de 7 dígitos","schema":{"type":"string","maxLength":100},"example":"4106902"},{"name":"ctribnac","in":"query","required":false,"description":"cTribNac de 6 dígitos","schema":{"type":"string","maxLength":100},"example":"010101"}],"responses":{"200":{"description":"Alíquotas de ISS do município (IBGE)","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/adesao":{"get":{"operationId":"resumoAdesao","summary":"Adesão ao Emissor Nacional (país)","description":"Quantos municípios emitem pelo Emissor Nacional e quais têm início de vigência futuro, pela lista oficial acompanhada todo dia.","parameters":[],"responses":{"200":{"description":"Adesão ao Emissor Nacional (país)","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/adesao/{ibge}":{"get":{"operationId":"adesaoMunicipio","summary":"O município já emite pelo Emissor Nacional?","description":"Situação do município na lista oficial de aderentes do gov.br, com a data de vigência.","parameters":[{"name":"ibge","in":"path","required":true,"description":"Código IBGE de 7 dígitos","schema":{"type":"string","maxLength":100},"example":"4106902"}],"responses":{"200":{"description":"O município já emite pelo Emissor Nacional?","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/adesao-por-nome":{"get":{"operationId":"adesaoMunicipioPorNome","summary":"Adesão pelo nome do município","description":"Mesma consulta por nome e UF.","parameters":[{"name":"municipio","in":"query","required":true,"description":"Nome do município","schema":{"type":"string","maxLength":100},"example":"Curitiba"},{"name":"uf","in":"query","required":true,"description":"UF","schema":{"type":"string","maxLength":100},"example":"PR"}],"responses":{"200":{"description":"Adesão pelo nome do município","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/calculo/iss":{"get":{"operationId":"calcularIss","summary":"Calcular ISS e retenção","description":"ISS da nota com a alíquota oficial do município, onde o ISS é devido e se o tomador PJ retém (LC 116/2003, art. 6º).","parameters":[{"name":"ibge","in":"query","required":false,"description":"Código IBGE do município do ISS","schema":{"type":"string","maxLength":100},"example":"4106902"},{"name":"ctribnac","in":"query","required":true,"description":"cTribNac","schema":{"type":"string","maxLength":100},"example":"010101"},{"name":"valor","in":"query","required":true,"description":"Valor do serviço (R$)","schema":{"type":"string","maxLength":100},"example":"1500.00"},{"name":"tomadorPj","in":"query","required":false,"description":"true se o tomador é PJ","schema":{"type":"string","maxLength":100},"example":"true"},{"name":"mei","in":"query","required":false,"description":"true se o prestador é MEI","schema":{"type":"string","maxLength":100},"example":"false"}],"responses":{"200":{"description":"Calcular ISS e retenção","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/simulacao/ibs-cbs":{"get":{"operationId":"simularIbsCbs","summary":"Simular IBS e CBS","description":"IBS e CBS de uma operação num ano da transição (2026 a 2033), com a redução da cClassTrib. Estimativa com alíquotas de referência ajustáveis.","parameters":[{"name":"valor","in":"query","required":true,"description":"Valor (R$)","schema":{"type":"string","maxLength":100},"example":"10000"},{"name":"cclasstrib","in":"query","required":false,"description":"cClassTrib","schema":{"type":"string","maxLength":100},"example":"200027"},{"name":"ano","in":"query","required":false,"description":"Ano","schema":{"type":"string","maxLength":100},"example":"2033"},{"name":"aliquotaCbs","in":"query","required":false,"description":"CBS de referência (%)","schema":{"type":"string","maxLength":100},"example":"8.8"},{"name":"aliquotaIbs","in":"query","required":false,"description":"IBS de referência (%)","schema":{"type":"string","maxLength":100},"example":"17.7"}],"responses":{"200":{"description":"Simular IBS e CBS","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/regime/{cnpj}":{"get":{"operationId":"regimeTributario","summary":"Regime de tributação pelo CNPJ","description":"MEI, Simples Nacional (com a data da opção) ou regime regular (Lucro Presumido ou Real), pelo cadastro público do CNPJ. 10 consultas por minuto por IP.","parameters":[{"name":"cnpj","in":"path","required":true,"description":"CNPJ com 14 dígitos","schema":{"type":"string","maxLength":100},"example":"00000000000191"}],"responses":{"200":{"description":"Regime de tributação pelo CNPJ","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/sugestao/servico":{"get":{"operationId":"sugerirServico","summary":"Código de serviço pelo CNAE ou CNPJ","description":"Sugere o cTribNac pela atividade (CNAE de 7 dígitos ou CNPJ de 14).","parameters":[{"name":"cnae","in":"query","required":false,"description":"CNAE","schema":{"type":"string","maxLength":100},"example":"6201501"},{"name":"cnpj","in":"query","required":false,"description":"CNPJ","schema":{"type":"string","maxLength":100},"example":"00000000000191"}],"responses":{"200":{"description":"Código de serviço pelo CNAE ou CNPJ","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/validacao/dps":{"post":{"operationId":"validarDps","summary":"Validar DPS","description":"Confere o XML da DPS contra as tabelas oficiais (códigos e coerência). Corpo XML ou JSON {\"xml\": \"...\"}, até 64 KB.","requestBody":{"required":true,"content":{"application/xml":{"schema":{"type":"string"}},"application/json":{"schema":{"type":"object","properties":{"xml":{"type":"string"}},"required":["xml"]}}}},"responses":{"200":{"description":"Resultado da validação","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}},"/iss":{"get":{"operationId":"aliquotasIssPorNome","summary":"Alíquotas de ISS do município (nome e UF)","description":"Mesma consulta por nome do município e UF.","parameters":[{"name":"municipio","in":"query","required":true,"description":"Nome do município","schema":{"type":"string","maxLength":100},"example":"Curitiba"},{"name":"uf","in":"query","required":true,"description":"UF","schema":{"type":"string","maxLength":100},"example":"PR"},{"name":"ctribnac","in":"query","required":false,"description":"cTribNac de 6 dígitos","schema":{"type":"string","maxLength":100},"example":"010101"}],"responses":{"200":{"description":"Alíquotas de ISS do município (nome e UF)","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"$ref":"#/components/responses/NaoEncontrado"},"429":{"$ref":"#/components/responses/Limite"}}}}},"components":{"responses":{"NaoEncontrado":{"description":"Código não encontrado nas tabelas carregadas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}},"Limite":{"description":"Limite por IP excedido (60/min, 5.000/dia)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Erro"}}}}},"schemas":{"Erro":{"type":"object","properties":{"erro":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}