Passar para o conteúdo principal

Aprimorando o detalhamento das apurações e recibos via API

Escrito por Marcos Hermes
Atualizado hoje

Este artigo é voltado para o time técnico e usuários que utilizam as integrações do OneFlow com sistemas de auditoria e conferência.

Com foco em tornar a troca de dados mais transparente e rica, atualizamos nossas APIs de apuração para fornecer um nível de detalhamento que vai muito além do valor total.

Para que sistemas de auditoria externa e conferência automática funcionem com precisão, não basta saber o valor total a recolher; é preciso entender a composição de cada cálculo.

Nesta atualização, as APIs de Apurações Federais e de Recibos de Pagamento foram expandidas para entregar dados segmentados e informações acessórias fundamentais para a conformidade fiscal.


O que mudou nas APIs de Apuração?

Anteriormente, ao consultar uma apuração de impostos federais, o sistema retornava apenas o campo TOTAL_APURADO. Agora, o retorno foi segmentado da seguinte forma:

1. IRPJ e CSLL

Além do total consolidado, a API agora detalha individualmente:

  • Base de Cálculo e Valor Apurado (separados para IRPJ e CSLL).

  • Valores de meses anteriores (para controle de compensações).

2. PIS e COFINS

A conferência ficou mais simples com a separação de:

  • PIS: Base de cálculo, valor apurado e valor do mês anterior.

  • COFINS: Base de cálculo, valor apurado e valor do mês anterior.

3. MEI (Microempreendedor Individual)

Para o MEI, incluímos campos vitais para o controle de limites:

  • Faturamento anual e saldo de faturamento.

  • Detalhamento de valores de ICMS, ISS, INSS e Salário Mínimo de referência.

4. Simples Nacional

O retorno do Simples Nacional agora traz o "raio-x" completo da guia:

  • Fator R: Percentual aplicado.

  • RBA e RBT12: Receitas Brutas (Anual e acumulada dos últimos 12 meses).

  • Valores Fixos: ICMS e ISS fixos, se houver.

  • Segmentação Interna/Externa: Detalhamento por mercado interno e externo, tanto por caixa quanto por competência.


Novidades na API de Recibos de Pagamento (Folha)

Para o fechamento da Folha de Pagamento, a API de totais de recibos (FPG_GET_RECIBOSTOTAL) recebeu um incremento importante:

  • Inclusão do INSS Patronal: Agora é possível extrair a base de cálculo do INSS Patronal (baseINSSPatronal) diretamente do resumo dos recibos, facilitando a conferência com a DCTFWeb.


Padronização Técnica e Limpeza de Dados

Além do conteúdo, melhoramos a forma como os dados são entregues. Corrigimos um comportamento nas strings de resposta:

  • Remoção de espaços (Trim): Os campos CODIGO e DESCRICAO agora retornam strings limpas, sem espaços em branco desnecessários ao final.

    • Exemplo anterior: "CODIGO": "ISS "

    • Como é agora: "CODIGO": "ISS"

💡 Dica para Desenvolvedores: Se o seu sistema utiliza validações exatas de texto para o código do imposto, essa mudança garante que você não precise mais tratar a string manualmente para remover espaços.


Por que essas alterações são benéficas?

  1. Auditoria Automática: Ferramentas parceiras podem validar se a Base de Cálculo bate exatamente com o faturamento importado.

  2. Redução de Erros: Com a segmentação de PIS e COFINS, fica mais fácil identificar divergências em alíquotas específicas.

  3. Transparência: O OneFlow deixa de ser uma "caixa preta" de cálculos e passa a expor toda a memória de cálculo via integração.


Quer mais detalhes sobre as nossas APIs? acesso o artigo: Apis OneFlow

Respondeu à sua pergunta?