Stone Tax API

Realiza a verificação em tempo real da disponibilidade dos serviços da SEFAZ (Secretaria da Fazenda) para a autorização de documentos fiscais.

Este recurso é essencial para diagnosticar instabilidades no webservice de destino, permitindo que o sistema emissor decida pela ativação de regimes de contingência ou aguarde a normalização do serviço.

⚠️ ATENÇÃO: O tempo de resposta deste endpoint depende diretamente da latência do servidor governamental consultado. Recomenda-se implementar um timeout adequado no lado do cliente para evitar retenção de threads.

🧪 TESTE: Em ambiente de sandbox, o retorno pode simular um status de “Operação Normal” de forma estática ou refletir o ambiente de homologação da SEFAZ, dependendo da configuração da aplicação.

Realiza o processamento e a transmissão de uma Nota Fiscal de Consumidor Eletrônica (modelo 65) no modo automático, otimizando o preenchimento de campos tributários complexos por meio de automações internas da API.

⚠️ ATENÇÃO: Esta operação possui validade jurídica perante a SEFAZ. Certifique-se de que os dados do destinatário e dos itens estão corretos antes de processar a emissão, pois a autorização consome recursos do ambiente de produção.

🧪 TESTE: Em ambiente de sandbox, as notas emitidas NÃO possuem valor fiscal e são enviadas para os servidores de homologação da SEFAZ. Utilize este ambiente para validar a estrutura do JSON e o fluxo de resposta antes do go-live.

⚙️ PROCESSAMENTO: O retorno bem-sucedido confirma o recebimento pela mensageria.

Erro 422: A nota foi salva no sistema, mas não autorizada pela SEFAZ.

Ação necessária: Analisar o motivo da rejeição para reenviar o documento ou realizar o cancelamento para inutilizar a numeração junto ao fisco.

Realiza o processamento e a transmissão de uma Nota Fiscal de Consumidor Eletrônica (modelo 65) no modo simplificado, ocultando campos de base e valor de tributos calculados pelo sistema.

⚠️ ATENÇÃO: Esta operação possui validade jurídica perante a SEFAZ. Certifique-se de que os dados do destinatário e dos itens estão corretos antes de processar a emissão, pois a autorização consome recursos do ambiente de produção.

🧪 TESTE: Em ambiente de sandbox, as notas emitidas NÃO possuem valor fiscal e são enviadas para os servidores de homologação da SEFAZ. Utilize este ambiente para validar a estrutura do JSON e o fluxo de resposta antes do go-live.

⚙️ PROCESSAMENTO: O retorno bem-sucedido confirma o recebimento pela mensageria.

Erro 422: A nota foi salva no sistema, mas não autorizada pela SEFAZ.

Ação necessária: Analisar o motivo da rejeição para reenviar o documento ou realizar o cancelamento para inutilizar a numeração junto ao fisco.

Realiza o processamento e a transmissão de uma Nota Fiscal de Consumidor Eletrônica (Modelo 65) para a SEFAZ no modo completo, preenchendo todos os campos tributários.
O endpoint abrange desde a validação do schema XML até a assinatura digital e autorização em tempo real.

⚠️ ATENÇÃO: Certifique-se de que os dados de impostos (ICMS, PIS, COFINS) e as informações do destinatário estejam em conformidade com as regras fiscais vigentes para evitar rejeições de validação da SEFAZ.

🧪 TESTE: Em ambiente de homologação, as notas emitidas possuem sem valor fiscal. Utilize o CNPJ de teste apropriado e verifique se o prefixo da série está configurado para o ambiente de testes para evitar conflitos de numeração.

⚙️ PROCESSAMENTO: O retorno bem-sucedido confirma o recebimento pela mensageria.

Erro 422: A nota foi salva no sistema, mas não autorizada pela SEFAZ.

Ação necessária: Analisar o motivo da rejeição para reenviar o documento ou realizar o cancelamento para inutilizar a numeração junto ao fisco.

Realiza a transmissão de uma NFCe que foi emitida previamente sob o regime de contingência offline.
Este recurso é essencial para regularizar a situação fiscal de documentos gerados sem comunicação prévia com a SEFAZ devido a problemas técnicos.

⚠️ ATENÇÃO: A transmissão deve ser realizada respeitando os prazos legais estabelecidos pelo ajuste SINIEF para evitar penalidades. Certifique-se de que os dados do XML transmitido são idênticos aos do documento entregue ao consumidor.

⚙️ PROCESSAMENTO: O sistema validará a assinatura digital e o status do documento antes de submeter o lote para autorização. Caso o documento já tenha sido autorizado anteriormente, o serviço retornará o protocolo existente.