¶ Como Gerar DARF com Código de Barras?
O DARF com Código de Barras é a rotina responsável pela geração de DARFs integrada via API, permitindo o envio de débitos federais para processamento e obtenção do documento com código de barras de forma automatizada. A rotina está disponível nos módulos Fiscal e Controle de Tributos e utiliza a API Questor ou a API Integra Contador, conforme a configuração do escritório.
Caminho da rotina no módulo Fiscal: Obrigações > Fiscal - Apurações de Impostos > Impostos > DARF com Código de Barras.
Caminho da rotina no módulo Controle de Tributos: Operações > Controle de Tributos > Movimento > Débitos > DARF com Código de Barras.
¶ Pré-requisitos
Para utilizar a rotina, os seguintes itens devem estar atendidos.
- Os débitos devem estar previamente cadastrados no módulo Controle de Tributos, pois os dados utilizados na geração do DARF têm origem nesse cadastro.
- Para geração via API Integra Contador, é necessário realizar o cadastro no SERPRO e concluir a configuração das chaves e do certificado no Questor antes de utilizar a rotina.
¶ Parâmetros
Os parâmetros determinam quais débitos serão listados para envio à API. Todos os campos abaixo estão localizados na tela inicial da rotina.
- Empresa: Identifica a empresa.
- Filial: Identifica a filial.
- Período Inicial: Define o início do período a ser filtrado.
- Período Final: Define o fim do período a ser filtrado.
- Filtrar: Define o critério de data utilizado no filtro. As opções disponíveis são Data Apuração e Data Vencimento.
- Imposto: Permite selecionar os impostos para os quais o DARF deve ser gerado.
- Imprimir Observações: Controla o texto de observações que será incluído no DARF. Selecione "Não" para não incluir observações, "Sim" para utilizar a observação cadastrada no imposto no Controle de Tributos, ou "Outro" para digitar um texto personalizado no campo abaixo.
- Observações: Campo de digitação livre, habilitado quando a opção "Outro" for selecionada em Imprimir Observações. O texto informado será incluído no DARF gerado.
¶ Consulta e envio dos débitos
Após preencher os parâmetros, execute a rotina. Os débitos localizados com base nos filtros informados serão listados na aba Dados.
Cada débito exibe um status que indica sua situação no processo de geração. Os status disponíveis na aba Dados são os seguintes.
- Aguardando: Débito filtrado e disponível para envio via API.
- Andamento: Débito selecionado e já enviado para a fila da API.
- Verificar: Débito que apresentou falha ou erro e não teve o DARF gerado.
- Sucesso: Débito processado com êxito; o DARF foi gerado corretamente.
Para enviar os débitos à API e iniciar a geração dos DARFs, selecione os débitos desejados na listagem e execute a ação Enviar API. Após o envio, o status de cada débito é atualizado automaticamente conforme o progresso, passando pelas etapas: Aguardando, Em Andamento, Concluído e Erro.
¶ Ações disponíveis
As ações ficam disponíveis na grade de débitos conforme o status de cada registro. As opções existentes são as seguintes.
- Abrir / Baixar PDF: Habilitada para débitos com status Sucesso. Ao clicar, o PDF do DARF é aberto para que seja baixado.
- Reenviar API: Habilitada para débitos com status de Erro. Reenvia o débito para a fila da API para uma nova tentativa de geração.
- Excluir: Habilitada para débitos com Erro ou para situações em que se deseja gerar um novo DARF. Remove o registro da fila da API.
- Visualizar Log: Exibe o log com os retornos recebidos da API para o débito selecionado.
- Enviar E-Doc: Habilitada para débitos com DARF gerado com Sucesso. Publica o PDF do DARF no ambiente de Documentos Enviados do E-Doc no Questor Zen.
⚠️ Atenção!
Para que a funcionalidade de envio da guia para o e-Doc funcione corretamente, é necessário realizar previamente as Configurações de Obrigações Fiscais/Previdenciárias.
¶ Envio para o e-Doc em lote
Para enviar várias guias para o e-Doc simultaneamente, basta:
- Selecionar as guias que deseja enviar;
- Certificar-se de que as guias estejam com status Concluído;
- Clicar no ícone Enviar e-Doc.
¶ Configuração da API Integra Contador
O Integra Contador é uma plataforma do SERPRO que disponibiliza serviços voltados ao mercado contábil e fiscal. Para utilizar a geração de DARF por meio dessa API, é necessário realizar o cadastro do escritório ou empresa no SERPRO e obter as chaves de acesso.
O cadastro deve ser realizado diretamente no portal da SERPRO. Após o acesso à Área do Cliente, as chaves Consumer Key e Consumer Secret serão disponibilizadas e deverão ser inseridas na configuração do Questor.
📌 Orientação importante!
Para realizar o cadastro no SERPRO e obter as chaves de acesso, acesse o portal do Integra Contador:
Portal do Cliente SERPRO
Com as chaves em mãos, realize as configurações no Questor acessando Operações > Fiscal - Configurações > Configurações > Opções Gerais, no detalhe Integra Contador, e execute os seguintes passos.
- Marque a opção de serviço DARF.
- Informe o Contratante como Escritório.
- Informe as chaves Consumer Key e Consumer Secret obtidas no portal do SERPRO.
- Envie um certificado digital válido compatível com o CNPJ do escritório cadastrado na Personalização do sistema.
O envio do certificado é realizado na rotina do módulo Gerenciador de Empresas, em Operações > Rotinas Societário > Certificado Outorga:
⚠️ Atenção!
A API do Integra Contador valida o CNPJ da Personalização com o CNPJ do Certificado enviado. O CNPJ configurado nas Opções Gerais é o responsável pelo recebimento das cobranças, pois o SERPRO realiza a cobrança por quantidade de requisições efetuadas na API.
Concluídas as configurações, a rotina DARF com Código de Barras funcionará da mesma forma descrita nas seções anteriores: selecione os débitos pelos parâmetros e execute o envio para a fila da API.
¶ Informações gerais
Algumas regras gerais definem o comportamento da geração conforme a configuração ativa no sistema.
- Sempre que a opção DARF estiver selecionada na configuração do Integra Contador em Opções Gerais, todos os DARFs serão gerados por meio da API Integra Contador.
- Caso a opção DARF não esteja selecionada nessa configuração, a geração ocorrerá pela API Questor.