Nexus Atlas

Financeiro

Retenções e DARF (Integra Contador — SERPRO)

Mostra, por contrato de gestão e tributo , quanto se deve das retenções da competência, quanto já está em guia, quanto tem DARF emitido, quanto foi pago no sistema e quanto a Receita registrou como pago . Daqui saem: - o DARF de cada guia, pelo SICALC da API Integra Contador do SERPRO, com o valor…

Onde encontrar/financeiro/retencoes · "Retenções e DARF"
Quem abrequem trabalha no financeiro (interno). Gerar DARF, consultar a Receita, buscar a DCTFWeb e testar a conexão: financeiro.darf; apurar e dividir guia: financeiro.guia.

Para que serve

Mostra, por contrato de gestão e tributo, quanto se deve das retenções da competência, quanto já está em guia, quanto tem DARF emitido, quanto foi pago no sistema e quanto a Receita registrou como pago. Daqui saem:

  • o DARF de cada guia, pelo SICALC da API Integra Contador do SERPRO, com o valor que o sistema apurou;
  • a divisão de uma guia em duas, quando convém pagar separado;
  • a consulta do que a Receita tem como pago pelo CNPJ da filial (PagtoWeb);
  • o XML da DCTFWeb da matriz, para o confronto com o apurado.

Cada requisição à API é cobrada pelo SERPRO. Por isso nada consulta a Receita sozinho ao abrir a tela: a pessoa pede, vê quantas chamadas vai fazer, e o gasto do mês fica à vista. Gerar o DARF não paga nada: o pagamento continua pelo título da guia.

A tela, marcação por marcação

As figuras abaixo mostram a tela como ela aparece para quem usa. Os números em vermelho marcam os botões e campos; logo abaixo de cada figura, cada número é explicado: onde fica, o que faz e o que acontece depois.

Visão geral da tela

1Atualizar com a Receita2Confrontar com a DCTFWeb3CSV4Apurar5Gerar de novo6PDF
Figura 1 — Retenções e DARF (Integra Contador — SERPRO)
O que cada marcação faz
1
Atualizar com a Receita
  • Aparece quando: chave financeiro.darf; desligado sem linhas.
  • Pede confirmação? Sim — "Atualizar com a Receita": consulta os pagamentos registrados (PagtoWeb) pelo CNPJ de cada contrato de gestão, arrecadados do 1º dia da competência até o fim do mês seguinte; "N requisição(ões) cobrada(s) pela API (uma por contrato de gestão). Ambiente: …". Botão "Consultar".
  • Resultado: "N pagamento(s) registrado(s) pela Receita no período, casados com as guias pelo número do DARF." Falha em parte: "N pagamento(s) lidos; falhou em …".
2
Confrontar com a DCTFWeb
  • Aparece quando: chave financeiro.darf. Pede confirmação? Sim — "Busca o XML da DCTFWeb da matriz na competência … 1 requisição cobrada pela API." Botão "Buscar o XML".
  • Resultado: "XML da DCTFWeb guardado (recibo …): N débito(s) reconhecido(s) no arquivo."
3
CSV
  • Baixa uma linha por guia (contrato de gestão, CNPJ, tributo, origem, código, competência, vencimento, devido, em guias, guia principal/complementar, valor, situação, DARF, data do DARF, pagamentos na Receita).
4
Apurar
  • Aparece quando: chave financeiro.guia, linha sem guia e com valor devido. O que faz: apura as guias daquele contrato de gestão na competência: "N guia(s) apurada(s) para <contrato>."
  • Onde aparece: na coluna das guias da linha do tributo, depois do texto "sem guia apurada". Clicar apura na hora (sem janela) e mostra "N guia(s) apurada(s) para <contrato>."; a guia aparece na mesma linha, com "sem DARF", "Gerar DARF" e, se tiver mais de uma retenção, "Dividir". Quem pode: financeiro.guia.
5
Gerar de novo
  • Aparece quando: chave financeiro.darf, guia aberta e sem DARF de produção ("Gerar de novo" para o DARF de demonstração).
  • Pede confirmação? Sim — "Gerar o DARF de <tributo> — <contrato>": competência, código, valor, quantidade de retenções, vencimento e CNPJ; "O DARF é gerado no SICALC (SERPRO) com este valor. É uma requisição cobrada pela API. Gerar não paga nada: o pagamento continua pelo título da guia." e o ambiente (em vermelho na produção). Botão "Gerar DARF".
  • O que faz: emite o DARF (receitas de uso da matriz — IRRF, CSRF… — saem no CNPJ da matriz, com a filial na observação) e guarda o PDF na guia. "DARF N gerado (produção) — total consolidado R$ …. O PDF está na guia."
  • Se der errado: "Só se emite DARF de guia aberta." · "Esta guia já tem o DARF N." · "A guia de … não tem código de receita numérico (…): o SICALC precisa do código. Peça à contabilidade o código deste tributo e cadastre-o na guia." · "O contrato de gestão não tem CNPJ cadastrado (vem do certificado dele, em Gestão de Materiais › Certificados)." · "O SICALC não emitiu o DARF: <mensagem da Receita>" · "O DARF veio, mas não consegui guardar o PDF…" · "Sem permissão para emitir DARF e consultar a Receita."
6
PDF
  • Abrem o PDF do DARF e o XML da DCTFWeb guardados (link de 5 minutos).
  • Observação: O PDF só existe depois de "Gerar DARF", que emite o DARF no SICALC do SERPRO — requisição cobrada e irreversível —. Abre o arquivo guardado (link de 5 minutos). Quem vê: quem vê a guia.

Guia aberta do mês, antes do DARF

1Atualizar com a Receita2Confrontar com a DCTFWeb3CSV4Apurar5Gerar de novo6PDF
Figura 2 — Retenções e DARF (Integra Contador — SERPRO): Guia aberta do mês, antes do DARF
O que cada marcação faz
1
Atualizar com a Receita

Pede confirmação? Sim — "Atualizar com a Receita": consulta os pagamentos registrados (PagtoWeb) pelo CNPJ de cada contrato de gestão, arrecadados do 1º dia da competência até o fim do mês seguinte; "N requisição(ões) cobrada(s) pela API (uma por contrato de gestão). Ambiente: …". Botão "Consultar".

Explicado em detalhes na Figura 1.

2
Confrontar com a DCTFWeb

Resultado: "XML da DCTFWeb guardado (recibo …): N débito(s) reconhecido(s) no arquivo."

Explicado em detalhes na Figura 1.

3
CSV

Baixa uma linha por guia (contrato de gestão, CNPJ, tributo, origem, código, competência, vencimento, devido, em guias, guia principal/complementar, valor, situação, DARF, data do DARF, pagamentos na Receita).

Explicado em detalhes na Figura 1.

4
Apurar

O que faz: apura as guias daquele contrato de gestão na competência: "N guia(s) apurada(s) para <contrato>."

Explicado em detalhes na Figura 1.

5
Gerar de novo

O que faz: emite o DARF (receitas de uso da matriz — IRRF, CSRF… — saem no CNPJ da matriz, com a filial na observação) e guarda o PDF na guia. "DARF N gerado (produção) — total consolidado R$ …. O PDF está na guia."

Explicado em detalhes na Figura 1.

6
PDF

Abrem o PDF do DARF e o XML da DCTFWeb guardados (link de 5 minutos).

Explicado em detalhes na Figura 1.

Guia com DARF (PDF), retenção confirmada a apurar (Apurar) e XML da DCTFWeb

1Atualizar com a Receita2Confrontar com a DCTFWeb3CSV4Apurar5Gerar de novo6PDF
Figura 3 — Retenções e DARF (Integra Contador — SERPRO): Guia com DARF (PDF), retenção confirmada a apurar (Apurar) e XML da DCTFWeb
O que cada marcação faz
1
Atualizar com a Receita

Pede confirmação? Sim — "Atualizar com a Receita": consulta os pagamentos registrados (PagtoWeb) pelo CNPJ de cada contrato de gestão, arrecadados do 1º dia da competência até o fim do mês seguinte; "N requisição(ões) cobrada(s) pela API (uma por contrato de gestão). Ambiente: …". Botão "Consultar".

Explicado em detalhes na Figura 1.

2
Confrontar com a DCTFWeb

Resultado: "XML da DCTFWeb guardado (recibo …): N débito(s) reconhecido(s) no arquivo."

Explicado em detalhes na Figura 1.

3
CSV

Baixa uma linha por guia (contrato de gestão, CNPJ, tributo, origem, código, competência, vencimento, devido, em guias, guia principal/complementar, valor, situação, DARF, data do DARF, pagamentos na Receita).

Explicado em detalhes na Figura 1.

4
Apurar

O que faz: apura as guias daquele contrato de gestão na competência: "N guia(s) apurada(s) para <contrato>."

Explicado em detalhes na Figura 1.

5
Gerar de novo

O que faz: emite o DARF (receitas de uso da matriz — IRRF, CSRF… — saem no CNPJ da matriz, com a filial na observação) e guarda o PDF na guia. "DARF N gerado (produção) — total consolidado R$ …. O PDF está na guia."

Explicado em detalhes na Figura 1.

6
PDF

Abrem o PDF do DARF e o XML da DCTFWeb guardados (link de 5 minutos).

Explicado em detalhes na Figura 1.

Como a tela está organizada (de cima para baixo)

  1. Avisos de erro e de sucesso.
  2. Quadro da API — "API Integra Contador (SERPRO) · ambiente produção ou demonstração" (e "· desligada" quando desativada), "credenciais no cofre: sim/não", "certificado da matriz: CNPJ, válido até …" (ou "não instalado"), "requisições este mês: N (N em produção)", "última consulta de pagamentos: …" e o botão "Testar conexão". No ambiente de demonstração, tudo é fictício e sem valor.
  3. Cartões: "Devido (retenções)", "Em guias", "Com DARF emitido", "Pago (sistema)", "Pago na Receita".
  4. Cartão principal: "Competência" (mês; padrão o mês passado) · "Contrato de gestão" ("Todos") · "Atualizar com a Receita" · "Confrontar com a DCTFWeb" · "CSV". Texto: "IRRF e CSRF entram na competência do pagamento da nota; INSS retido e ISS, na da emissão. "Devido" soma as retenções confirmadas e não isentas; "Em guias" é o que a apuração já transformou em guia por contrato de gestão. Cada guia gera o próprio DARF; para pagar separado, divida a guia antes de gerar."
    • Tabela: Contrato de gestão (CNPJ) · Tributo (folha/fornecedor, código, quantas retenções) · Vence · Devido · Em guias ("falta apurar R$ …" em amarelo) · Guias e DARF · Pago na Receita (valor e os documentos de arrecadação).
    • Em "Guias e DARF", por guia: valor, "(guia N)", situação, título e data de pagamento; selo "DARF <número>" (verde em produção, amarelo "(demonstração)") ou "sem DARF"; botões "PDF", "Gerar DARF"/"Gerar de novo" e "Dividir". Sem guia: "sem guia apurada" e "Apurar".
    • Vazia: "Nenhuma retenção nem guia nesta competência."
  5. "Confronto com a DCTFWeb" — "Os débitos declarados pela matriz, por código de receita, contra o que o sistema apurou em guias (todos os contratos de gestão somados)." Botão "XML". "Consultado em … · recibo …". Tabela Código · Descrição · Declarado · Saldo a pagar · Sistema (em guias) · Diferença (verde se zero). Sem consulta: "Ainda não consultada nesta competência." XML sem débito reconhecido: "O XML foi guardado, mas nenhum débito foi reconhecido no leiaute — abra o arquivo."
  6. "Notas de serviço emitidas contra a filial no mês, com retenção" — "Tudo o que o fisco entregou como tomador, paga ou não: o INSS retido conta pela emissão; IRRF e CSRF, só quando a nota é paga." Tabela Contrato de gestão · Fornecedor · Nota · Valor · IRRF · INSS · CSRF · Situação ("paga em …", "atestada, não paga" ou a situação da nota).

Botões

Os botões marcados nas figuras estão explicados junto de cada figura (seção “A tela, marcação por marcação”). A seguir, os demais botões desta tela — os que só aparecem em outras situações —, com o que fazem e onde ficam.

"Testar conexão" (mostra "Testando…")

  • Aparece quando: chave financeiro.darf. O que faz: só obtém o token do SERPRO — não consulta nem emite nada. "Conexão com o SERPRO OK (produção): token novo/reaproveitado para o CNPJ … — <titular>. Nada foi consultado nem emitido."

"Dividir"

  • Aparece quando: chave financeiro.guia, guia aberta, sem título, sem DARF e com mais de uma retenção. O que faz: abre "Dividir a guia de <tributo> — <contrato>".

Janelas

"Dividir a guia de <tributo> — <contrato de gestão>"

  • Mostra: "Marque as retenções que vão para uma guia separada (mesmo tributo e competência). Cada guia gera o próprio DARF." Tabela com a caixa "Separar <fornecedor>", Fornecedor, Nota, Pagamento, Retido. Rodapé: "Para a nova guia: R$ … (N de N); fica na atual R$ …."
  • Botões: "Cancelar" · "Abrir guia nova com as marcadas" (mostra "Dividindo…"; desligado sem marcação ou com todas marcadas).
  • Resultado: "Guia dividida: N retenção(ões) foram para uma guia nova (…). Cada uma gera o próprio DARF."

Perguntas que as pessoas fazem

  • Quanto custa? → Cada requisição (DARF, consulta de pagamentos por contrato de gestão, XML da DCTFWeb) é cobrada pelo SERPRO; o contador "requisições este mês" mostra o uso. "Testar conexão" não consulta nem emite.
  • Gerei o DARF; está pago? → Não. Pague pelo título da guia (Contas a pagar / remessa). Depois, "Atualizar com a Receita" mostra o que a Receita registrou.
  • "falta apurar R$ …" → Há retenção confirmada ainda fora de guia: "Apurar".
  • Preciso de dois DARFs para a mesma guia. → "Dividir" antes de gerar.
  • O DARF saiu no CNPJ da matriz. → Receitas de uso por matriz (IRRF, CSRF…) saem no CNPJ da matriz; a observação identifica o contrato de gestão.

Ligações com outros módulos e telas

  • Guias de recolhimento — apuração, título e baixa das guias.
  • Gestão de Materiais › Certificados — certificado digital e CNPJ de cada contrato de gestão; a API do SERPRO roda no serviço do Materiais.
  • Contas a pagar / Remessa bancária — pagamento do título da guia.
  • Contabilidade (Reinf/DCTFWeb) — conferência dos débitos declarados.

Nexus Atlas · As imagens mostram o sistema com dados fictícios.