/financeiro/retencoes · "Retenções e DARF"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

- 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 …".
- 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."
- 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).
- 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.
- 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."
- 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

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.
Resultado: "XML da DCTFWeb guardado (recibo …): N débito(s) reconhecido(s) no arquivo."
Explicado em detalhes na Figura 1.
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.
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.
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.
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

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.
Resultado: "XML da DCTFWeb guardado (recibo …): N débito(s) reconhecido(s) no arquivo."
Explicado em detalhes na Figura 1.
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.
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.
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.
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)
- Avisos de erro e de sucesso.
- 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.
- Cartões: "Devido (retenções)", "Em guias", "Com DARF emitido", "Pago (sistema)", "Pago na Receita".
- 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."
- "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."
- "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.