Stone Tax API

Parâmetros da NFS-e.

Permite definir os parâmetros de emissão da NFS-e.

⚠️ ATENÇÃO: É necessário observar se o emissor já realizou emissão de NFS-e antes em outro sistema e definir a série e numeração única adequada para evitar rejeição por duplicidade.

post

Path Parameters

documentoEmissorstringrequired

Documento do emissor.

Body

Dados dos parâmetros da NFS-e.

DefinirParametrosNfseInputModel

Dados para definição dos parâmetros de NFS-e.

* Additional properties are NOT allowed.
sequenciaAutomaticaboolean

Indica se a sequência da numeração do DPS será automática ou manual.

seriestring | null

Série do DPS. (Apenas se a sequência for automática)

numeroUltimoDpsinteger | null(int64)

Número do último DPS emitido. (Apenas se a sequência for automática)

enviarEmailNfsebooleanrequired

Enviar e-mail com a NFS-e para o cliente de forma automática.

opcaoSimpleNacionalstring

Opção pelo Simples Nacional para fins do ISSQN (opSimpNac).

Allowed values:NaoOptanteOptanteMeEppAcimaLimiteOptanteMicroempresaAteSubLimite

regimeEspecialTributacaostring

Regime especial de tributação do prestador (regEspTrib).

Allowed values:NenhumMicroempresaMunicipalEstimativaSociedadeProfissionaisCooperativaMeiMeEppSimplesNacional

regimeApuracaoSimplesNacionalstring

Regime de apuração do Simples Nacional (regApuracao).

Allowed values:TributosFederaisEMunicipalPeloSnTributosFederaisPeloSnEIssqnPelaNfseTributosFederaisEMunicipalPelaNfse

diasInutilizacaoAutomaticainteger(int32)

Quantidade de dias para inutilização automática de numerações não utilizadas.

>= 1<= 30

aliquotaEfetivaSnnumber | null(double)

Alíquota efetiva do Simples Nacional (pTotTribSN) em %.
Obrigatório (aceitando 0) para emissores do Simples Nacional e MEI.
Não deve ser informado para emissores de Lucro Real e Lucro Presumido.

Response

No Content

post/api/v1/Emissor/{documentoEmissor}/Parametros/Nfse/Definir

Body

{ "enviarEmailNfse": false }
 

Listar emissores.

Permite listar todos os emissores so aplicativo. O recurso possui filtros não obrigatórios e mecanismo de paginação.

get

Query Parameters

buscastring

Filtrar por nome, documento ou identificador por texto.

documentoEmissorstring

Filtrar pelo documento do emissor.

dataCriacaoInicialstring(date-time)

Filtrar pela data de criação inicial.

dataCriacaoFinalstring(date-time)

Filtrar pela data de criação final.

statusstring

Status do emissor.

Allowed values:InativoAtivo

tipoDocumentostring

Tipo de documento do emissor.

Allowed values:CpfCnpj

regimeTributarioarray[string]

Regime tributário do emissor.

Allowed values:MeiSimplesNacionalSimplesNacionalExcessoReceitaLucroPresumidoLucroReal

estabelecimentostring

Tipo de estabelecimento do emissor quanto ao IPI.

Allowed values:OutrosIndustriaOuEquiparado

offsetinteger(int32)

Paginação da listagem - offset.

Default:1

limitinteger(int32)

Paginação da listagem - limit.

Default:10

Response

OK

EmissorListagemViewModelListPaginationResponse

* Additional properties are NOT allowed.
offsetinteger(int32)
limitinteger(int32)
totalinteger(int32)
dataarray | null[object]

Dados do emissor exibidos na listagem.

* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1/Emissor/Listar
 

Obter detalhe.

Permite obter os dados cadastrais completos do emissor selecionado.

get

Path Parameters

documentostringrequired

Documento do emissor.

Response

OK

EmissorDetalheViewModel

Dados detalhados do emissor.

* Additional properties are NOT allowed.
documentostring | null

Documento (CPF/CNPJ) do emissor.

tipoDocumentostring

Tipo de documento do emissor.

Allowed values:CpfCnpj

nomestring | null

Nome ou Razão Social do emissor.

nomeFantasiastring | null

Nome fantasia do emissor.

regimeTributariostring

Regime tributário do emissor.

Allowed values:MeiSimplesNacionalSimplesNacionalExcessoReceitaLucroPresumidoLucroReal

aliquotaCreditoSimplesnumber | null(double)

Alíquota do crédito de icms do simples nacional consedido em operações de revenda do regime Simples Nacional.

tipoIcmsStstring

Tipo de ICMS ST do emissor.

Allowed values:SubstitutaSubstituida

tipoEstabelecimentostring

Tipo de estabelecimento do emissor quanto ao IPI.

Allowed values:OutrosIndustriaOuEquiparado

telefonestring | null

Telefone de contato.

inscricaoMunicipalstring | null

Inscrição municipal do emissor.

cnaestring | null

Código CNAE principal.

cnaeSecundariostring | null

Código CNAE secundário.

enderecoobject

Dados do emissor.

* Additional properties are NOT allowed.
Show Child Parameters
inscricoesEstaduaisarray | null[object]

Dados da inscrição estadual do emissor.

* Additional properties are NOT allowed.
Show Child Parameters
certificadoDigitalobject

Informações do certificado digital.

* Additional properties are NOT allowed.
Show Child Parameters
parametrosNfeobject

Parâmetros da NF-e.

* Additional properties are NOT allowed.
Show Child Parameters
parametrosNfceobject

Parâmetros da NFC-e.

* Additional properties are NOT allowed.
Show Child Parameters
parametrosNfseobject

Parâmetros da NFS-e.

* Additional properties are NOT allowed.
Show Child Parameters
dataCriacaostring(date-time)

Data de criação do emissor no sistema.

ultimaAlteracaostring(date-time)

Data de última alteração dos dados do emissor no sistema.

statusstring

Status do emissor.

Allowed values:InativoAtivo

bilhetagemobject

Dados da bilhetagem do emissor.

* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1/Emissor/{documento}/ObterDetalhe
 

CatalogoProduto

Controlador responsável pelo Catálogo de Produtos e inteligência fiscal da Stone Tax API.

Fornece operações para a identificação e curadoria de mercadorias, permitindo buscas assertivas
baseadas em identificadores globais e descrições comerciais para facilitar o processo de faturamento.

Por meio desta controller é possível obter a tributação de produtos,
utilizando filtros por EAN (GTIN) ou descrição, além de retornar informações de
tributação e classificação fiscal essenciais para a conformidade da emissão.

Todos os recursos disponibilizados exigem autenticação e operam sob o contexto do
Emissor informado no cabeçalho, garantindo que as regras fiscais aplicadas correspondam
ao perfil tributário da entidade solicitante.

Obter tributação do produto.

Busca informações detalhadas referentes a tributação de um produto. Poderá ser utilizado código de barras, descrição ou hash para realizar as buscas.

⚠️ ATENÇÃO: É indicado vincular e salvar o HASH do resultado ao cadastro do produto do sistema consumidor do serviço. O HASH será utilizado para acompanhamento de atualizações futuras da tributação do mesmo.

🧪 TESTE: Em ambiente de desenvolvimento/sandbox, os dados dos tributos retornados são fictícios e gerados automaticamente para testes. Não utilize como fonte da verdade em produção. Já em relação ao EAN, o sistema irá validar normalmente, de maneira que para teste de EANs inválidos ou NÃO ENCONTRADOS, poderá aplicar EANs reais.

🔍 BUSCA POR DESCRIÇÃO: O ideal é utilizar a busca por descrição quando o produto NÃO POSSUI EAN. A busca por EAN apresenda dados assertivos enquanto pela descrição será aplicado um algorítmo para identificar a tributação do produto.

post

Headers

DocumentoEmissorstringrequired

Documento do emissor.

Body

Dados de input para a consulta.

ConsultarProdutoInputModel

Dados para consultar a tributação do produto.

* Additional properties are NOT allowed.
tipoFiltrostringrequired

Tipo de filtro do catálogo de produto.

Allowed values:EanDescricaoSimilarHash

filtrostringrequired

Dado de filtragem para consulta do produto (EAN ou descrição similar).

>= 1 characters

codigoMunicipioDestinostring | null

Código do município do destino. (Necessário somente se o destinatário for de outro município)

finalidadestring

Finalidade da operação fiscal.

Allowed values:VendaConsumidorFinalNaoContribuinteVendaConsumidorFinalContribuinteVendaParaRevendaBonificacaoTransferencia

situacaoEspecialDestinatariostring

Situação especial do destinatário da operação fiscal.

Allowed values:IndustrialDistribuidorAtacadistaProdutorRuralArmazemGeralOrgaoPublico

origemProdutostring

Origem do produto para consulta.

Allowed values:NacionalEstrangeiraImportacaoDiretaEstrangeiraAdquiridaMercadoInternoNacionalConteudoImportacaoSuperior40A70NacionalPPBNacionalConteudoImportacaoInferior40EstrangeiraImportacaoDiretaSemSimilarEstrangeiraAdquiridaMercadoInternoSemSimilarNacionalConteudoImportacaoSuperior70

produtoFabricacaoPropriaboolean | null

Indica se o produto consultado é de fabricação própria ou não. (Default false)

destinatarioSimplesNacionalboolean | null

Indica se o destinatário é optante pelo Simples Nacional. (Default false)

destinatarioSubstitutoTributarioboolean | null

Indica se o destinatário é substituto tributário. (Default false)

mercadoriaProduzidaZFMboolean | null

Indica se a mercadoria é produzida na Zona Franca de Manaus. (Default false)

Response

OK

ConsultarProdutoViewModel

Dados de retorno da consulta da tributação do produto.

* Additional properties are NOT allowed.
hashstring | null

Hash da consulta - identificador do produto dentro da aplicação para lastro de consulta de atualização de tributos.

ncmstring | null

NCM do produto.

descricaoNcmstring | null

Descrição do NCM.

inicioVigenciaNcmstring(date)

Data de início da vigência do NCM.

Example:2025-03-31

finalVigenciaNcmstring | null(date)

Data do fim da vigência do NCM.

ceststring | null

CEST do produto.

cfopstring | null

CFOP da operação.

icmsobject

Dados do ICMS incidentes na operação - Regime “Normal”.

* Additional properties are NOT allowed.
Show Child Parameters
icmssnobject

Dados do ICMSST incidentes na operação - Simples Nacional.

* Additional properties are NOT allowed.
Show Child Parameters
ipiobject

Dados do IPI incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
pisobject

Dados do PIS incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
cofinsobject

Dados do COFINS incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
ibsobject

Dados do IBS incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
cbsobject

Dados do CBS incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
impostoSeletivoobject

Dados do Imposto Seletivo (IS) incidentes na operação.

* Additional properties are NOT allowed.
Show Child Parameters
post/api/v1/CatalogoProduto/Tributacao

Body

{ "tipoFiltro": "Ean", "filtro": "filtro" }