Stone Tax API

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.

Fornece uma listagem detalhada das Notas Fiscais de Consumidor Eletrônicas (NFCe) emitidas ou processadas pelo Emissor.

🔍 CAPACIDADE DE BUSCA: O recurso suporta filtros complexos que permitem a extração de relatórios e a reconciliação fiscal. O campo busca realiza uma varredura genérica em múltiplos campos (número, série, chave e participantes).

📑 PAGINAÇÃO: A API utiliza o modelo de offset e limit. Recomendamos o uso de limites baixos (ex: 50 registros) para garantir a performance da resposta e economia de banda.

⚖️ CONTEXTO FISCAL: Os resultados refletem o estado atual dos documentos na base da Stone Tax, permitindo filtrar por status específicos (Autorizada, Cancelada, Rejeitada, etc.) e intervalos de valores ou datas.

Fornece dados totalizados e consolidados de notas fiscais de consumidor eletrônicas (NFCe) com base nos filtros aplicados.
Este recurso é ideal para alimentar dashboards, painéis de conferência ou indicadores financeiros (KPIs),
permitindo uma visão macro do volume de documentos e valores sem a necessidade de processar a listagem completa.

A consulta suporta múltiplos critérios de filtragem, abrangendo desde dados básicos do documento (número, série, chave)
até informações de atores envolvidos (participante, transportador e intermediador).

🔍 DICA DE PERFORMANCE: Para consultas em grandes volumes de dados, priorize o uso da Chave de Acesso
ou o intervalo de Data de Emissão para garantir maior agilidade no retorno.