Stone Tax API

Permite a emissão de uma Nota Fiscal Eletrônica (NFe) de devolução utilizando como base o arquivo XML da nota de origem.

O recurso realiza a leitura do arquivo fornecido, correlaciona os itens para estorno e aplica as regras fiscais de devolução
conforme o regime tributário do emissor e a natureza da operação.

Este endpoint simplifica o processo de devolução ao extrair dados diretamente do XML original, exigindo apenas a relação de itens e quantidades a serem devolvidas.

⚠️ ATENÇÃO: O arquivo XML deve ser enviado em formato Base64. Certifique-se de que a nota de origem esteja autorizada na SEFAZ, pois chaves de acesso inexistentes ou canceladas impedirão a emissão.

⚙️ REGRA DE NEGÓCIO: Caso a devolução seja parcial, informe apenas os itens e quantidades correspondentes no objeto de itens. Para devolução total, a lista deve refletir exatamente o conteúdo da nota de origem.

🧪 TESTE: Em ambiente de homologação, as notas emitidas possuem sem valor jurídico e não afetam o estoque real ou limites fiscais junto à SEFAZ.

Realiza a transmissão de uma NFe 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 Eletrônicas (NFe) 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 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.

Retorna o status de uma nota fiscal identificada pelo código ERP ou chave de acesso.

🔍 IDENTIFICAÇÃO: O filtro aceita a chave de acesso da nota fiscal (44 dígitos numéricos) ou o código ERP informado pelo integrador no momento da emissão.

📋 RETORNO: Inclui modelo, série, número, chave de acesso, status, protocolos de autorização/cancelamento e mensagem da SEFAZ.