Skip to main content
Skip table of contents

Job

Pré-Requisito de usuário: Permissão de acesso no Settings da NFS-e.

Pré-requisito do processo:

  • Requisito mínimo para configurar um Job de Entrada é possuir o agendamento e integração configurados.

  • Requisito mínimo para configurar um Job de Saída ou Upload é possuir a Conexão de Entrada configurada.

  • Demais configurações do sistema são opcionais de configuração, ficando a encargo do cliente configurar ou não as funcionalidades do módulo NFS-e.

Para realizar a configuração acesse o Settings e navegue até o menu de Jobs de Trabalho, selecione a aba Job;

1. Clique em Criar um novo job ((mais));

2. Informe os dados necessários;

3. Clique em Concluir.

Configure o comportamento desejado, tendo em vista:

Replicar jobs a partir de um modelo: A funcionalidade está disponível na tela de configuração de Job.

Funcionalidade é responsável por realizar a duplicação de Jobs através de um modelo pré-definido, ou seja, o sistema irá herdar as informações base a partir deste modelo.

  • Ctrl+N: Adiciona uma nova configuração de Job.

  • Ctrl+D: Deleta a configuração do job selecionada.

  • Para editar as configurações do Job que está sendo duplicado basta um duplo click sobre a informação que se deseja editar.

DICAS

((erro)) Este ícone representa que existe informações incorretas na linha de configuração do Job, ou seja, basta colocar o mouse sobre o ícone para verificar os campos que estão preenchidos incorretamente.

(✅) Este ícone representa que não existe nenhum tipo de erro na configuração, assim, o campo gravar será habilitado.

O Job do sistema permite configurar os seguintes Jobs de trabalho: “entrada”, “saída” ou “upload”, sendo que:

  • Job do tipo Entrada: Este tipo de Job realiza a consulta de NFS-e que foi emitida contra o prestador de serviço, ou seja, realiza a consulta de notas tomadas pelo prestador de serviço.

Neste tipo de Job não é informado o CNPJ Prestador, por este motivo o serviço de licença utiliza o CNPJ do Certificado vinculado ao mesmo.

IMPORTANTE:

Implementada a configuração de lista de CNPJ e Inscrição municipal para NFS-e de Entrada. Quando configurado uma lista de CNPJ e Inscrição municipal, o sistema irá realizar a consulta automática ou manual no Web Service da prefeitura, assim, criando uma requisição para cada CNPJ e Inscrição Municipal configurada na lista.

  • Job do tipo Saída: Este tipo de Job realiza o envio e consulta da RPS, se foi convertida em NFS-e ou qual o tipo de erro de negócio foi gerada no webservice da prefeitura e retorna este tipo de processo através da integração.

  • Job do tipo Upload: Este tipo de Job realiza a conversão do documento original gerado pelo ERP, para o layout da prefeitura. Este tipo de Job não realiza o envio do documento para o webservice da prefeitura, o tramite de envio deve ser realizado manualmente, com o respectivo retorno do documento para ser inserido no NFS-e.

  • Job do tipo Entrada OCR: Este tipo de Job captura o documento de NFS-e de Entrada (nota emitida contra o prestador de serviço), que se encontra no diretório configurado e insere o documento no  NFS-e.        

IMPORTANTE:

O Sistema estará preparado para a Entrada OCR quando configurado uma lista de municípios e inscrição municipal.

Atenção:

As funcionalidades de entrada e entrada OCR não estão disponíveis para envio e consulta via Web Service e e-Agente.

Configurações do Job

Ao abrir a tela de criação do Job, são exibidos os campos:

  • No campo Nome, informe o nome utilizado para identificar o Job.

  • No campo Certificado, escolha um certificado que esteja homologado e que será usado para assinar os RPS.

  • No campo Tipo de dados de entrada, escolha o formato do arquivo que será utilizado pelo aplicativo. Poderá ser usado o formato .TXT ou .XML, o formato do arquivo dependerá do padrão que o ERP do cliente irá gerar.

  • No campo Cidade, escolha a cidade para onde serão enviados os documentos RPS.

  • No campo Versão Layout, escolha a Versão do Layout que será utilizado.

  • No campo Tipo Job, escolha o tipo de Job Entrada, Saída, Upload e Entrada OCR.

  • No campo Tipo de Ambiente, informe o tipo de ambiente utilizado Produção ou Homologação.

Produção, Jobs que emitem para o ambiente de Produção do Web Service.

Homologação, Jobs que emitem para o ambiente de Homologação do Web Service.

IMPORTANTE

A opção de Homologação ou Produção não faz referência ao tipo de ambiente do web service da prefeitura.

  • No campo CNPJ Certificado, é informado o CNPJ do certificado do prestador de serviços. Este campo é preenchido automaticamente ao selecionar o certificado desejado.

  • No campo CNPJ Prestador, informe o CNPJ da empresa Prestadora de Serviços que está sendo cadastrada no Job.

  • No campo Inscrição Municipal, informe a inscrição municipal da empresa prestadora de serviços que está sendo cadastrada no Job.

  • Timeout WS Prefeitura (ms): Tempo em que a aplicação mantém aberta a conexão no envio de mensagens com o Web Service da prefeitura.

  • Tempo espera consulta (seg): Tempo de espera entre o envio e a primeira consulta para obter o status da nota.

  • Intervalo entre consultas (seg): Intervalo de tempo entre cada nova tentativa de consulta. Este tempo é somando a cada nova tentativa, ou seja, é incrementado cada vez que a aplicação tentar fazer uma nova consulta. Exemplo de configuração com 20 segundos:

2º Tentativa: 20 segundos;

3º Tentativa: 40 segundos;

4º Tentativa: 60 segundos;

5º Tentativa: 80 segundos;

6º Tentativa: 100 segundos;

7º Tentativa: 120 segundos.

  • Tempo limite de soma consultas (seg): Tempo limite para não incrementar mais o campo "Intervalo entre consultas". Exemplo de configuração com 120 segundos:

2º Tentativa: 20 segundos;

3º Tentativa: 40 segundos;

4º Tentativa: 60 segundos;

5º Tentativa: 80 segundos;

6º Tentativa: 100 segundos;

7º Tentativa: 120 segundos;

8º Tentativa: 120 segundos;

9º Tentativa: 120 segundos..

Informações dos dados do Job
  • No campo JobKey, informe um número único para cada Job, este é utilizado para identificar uma conexão de saída com o banco de dados.

  • O campo Limitar, é utilizado se a conexão de entrada de arquivos for baseada em banco de dados, ele habilita o campo quantidade documentos por processo.

  • O campo Quantidade documentos por processo, é utilizado se a conexão de entrada de arquivos for baseada em banco de dados. Informe o número de registros que o serviço NDDigital NFS-e Input irá capturar do banco de dados em cada processo realizado.

  • O campo Série RPS, é utilizado para converter a série da RPS enviada pelo ERP.

  • Configurar Pós Conversão, siga os passos para realização da configuração no link: Configurar Pós Conversão.

  • Utilizar processamento sequencial, esta opção deve ser utilizada quando há necessidade de um controle de processamento sequencial de forma simultaneamente, onde o controle dos processamentos dos documentos será realizado através do job:

* Utilizar processamento sequencial por CNPJ, esta opção deve ser selecionada quando o controle dos processamentos dos documentos será realizado através do CNPJ do prestador, quando tiver mais de um job configurado com o mesmo CNPJ do prestador em mais de um job;

* Utilizar controle de numeração, esta opção deve ser selecionada quando o controle do processamento dos documentos for realizado através do número informado no job, onde a funcionalidade realiza o ajuste do número da RPS para o número esperado pelo webservice da prefeitura, este controle é realizado por Job ou por CNPJ dependendo da configuração habilitada;

* Utilizar controle por série, esta opção deve ser selecionada quando o controle do processamento dos documentos for realizado através do número da RPS, onde é registrado a série de acordo com o enviado no documento e a sequencia é controlada conforme a série enviada, sendo possível várias séries para um mesmo job;

* Número da sequencia, Este campo é utilizado para preencher o valor da próxima RPS da sequência que é solicitado pelo Webservice da prefeitura.

  • Utilizar integração, esta opção de ser selecionada para a integração de documentos depois de processados:

* Integração baseada em Arquivo, onde os retornos são gravados em arquivos salvos em um diretório;

* Integração baseada em Banco de dados, onde os retornos são gravados em uma tabela do banco de dados.

  • Utilizar regras para Inscrição Municipal do Tomador, a opção deve ser marcada quando for utilizar as regras para a Inscrição Municipal do Tomador:

* Não Enviar – Inscrição Municipal do Tomador fora do município;

* Não Enviar – Inscrição Municipal do Tomador dentro do município;

* Nunca Enviar.

  • Utilizar B2B, esta opção deve ser selecionada para o envio dos documentos processados, informando qual o tipo de documento será enviado:

* XML RPS;

* XML NFSe;

* PDF RPS;

* PDF NFSe;

* PDF Boleto.

ATENÇÃO:

Esta opção só é exibida se as opções de B2B estiverem habilitadas. Se desejar habilitar, siga as instruções descritas no link Configurações email.

  • Conexão de Entrada Baseada em, depende do modo que o ERP irá se comunicar com a aplicação:

* Arquivo, esta opção deve ser selecionada quando o ERP trabalha com conexão de entrada via arquivo, onde o documento original é depositado em um diretório no qual o input vai pegar o arquivo;

* Banco de dados, esta opção deve ser selecionada quando o ERP trabalha com conexão de entrada via banco de dados, onde o documento original é depositado em uma tabela no banco de dados na qual o input vai pegar o arquivo.

  • Configurações de integração, se o usuário desejar receber uma confirmação da conversão do documento de envio em arquivo:

* Integrar RPS, esta opção irá integrar um retorno informando quando a RPS estiver convertida no Layout do Web Service da prefeitura.

* Integrar conteúdo da RPS, esta opção irá integrar o conteúdo da RPS convertida;

* Não integrar rejeições, esta opção irá integrar apenas os documentos de sucesso, como autorização e cancelamento.

  • Integrar com NDDConnector, opção utilizada para integrar o NFSe de recepção com o módulo NDDConnector.

  • Utilizar conexões Cold, opção deve ser marcada quando o Job utilizar conexão com o banco de conexão cold.

Atenção:

Esta opção só é exibida se as opções de conexão Cold estiverem habilitadas. Se desejar habilitar siga as instruções descritas no link Configurações Gerais.

  • Utilizar impressões RPS, opção deve ser marcada quando desejar utilizar a impressão de RPS.

  • Utilizar impressões NFSe, opção deve ser marcada quando desejar utilizar a impressão de NFSe.

  • Utilizar impressões de boletos, opção deve ser marcada quando desejar utilizar a impressão de boleto.

  • Utilizar campos automáticos, opção deve ser marcada se o job utilizar esta funcionalidade.

  • Utilizar campos customizáveis, opção deve ser marcada caso deseje concatenar os campos cadastrados em Customização de campo.

  • Utilizar grupos de Conversão, se o job a ser cadastrado for utilizar esta funcionalidade.

  • Utilizar conversão de código de erro, se o job a ser cadastrado for utilizar esta funcionalidade.

  • Imprimir documento já existente no banco de dados, se o job a ser cadastrado for utilizar esta funcionalidade.

  • Utilizar assunto/corpo de e-mail, para utilizar o assunto e corpo de e-mail no B2B que será enviado pelo aplicativo.

  • Adicionar DDD ao número do telefone do Prestador, caso deseje realizar a concatenação do telefone mais o DDD do Prestador.

  • Adicionar DDD ao número do telefone do Tomador, caso deseje realizar a concatenação do telefone mais o DDD do Tomador.

  • Remover nono dígito do prestador, para não ser informado o nono dígito do telefone do prestador no documento.

  • Remover nono dígito do tomador, para não ser informado o nono dígito do telefone do tomador no documento.

  • Customizar dados do local de prestação, caso deseje realizar a verificação do código do município enviado, se for diferente do prestador, os dados são montados com o valor do tomador de serviço, caso os dados sejam iguais será montado com o valor do endereço do prestador.

  • Agrupamento do processamento (AppConnector), caso deseje realizar o agrupamento dos documentos com AppConnector, para habilitar está funcionalidade é necessário que o AppConnector esteja instalado. A funcionalidade Agrupamento do processamento (AppConnector) só irá funcionar para jobs configurados em XML, conexão em entrada baseada em banco de dados e layout 5.0.

Cidade

Exemplo de Preenchimento da funcionalidade.

Dentro das configuração do Job, e na tela que é exibida. É preciso informar o endereço do Web Service de produção ou homologação onde será realizada a consulta das notas de entrada, ou então selecionar um município no campo Prefeitura que já foi cadastrado anteriormente.

Logotipo

Exemplo de Preenchimento da funcionalidade.

Ainda dentro das configuração do Job, e na tela que é exibida. É possível selecionar uma logo já cadastrada, ou então cadastrar uma nova logo. A escolha de uma logo não é obrigatória.

IMPORTANTE:

A funcionalidade “Agrupamento do processamento (AppConnector)” só irá funcionar para jobs configurados em XML, conexão em entrada baseada em banco de dados e layout 5.0.

DICA

  • Para Editar job, selecione o documento desejado na planilha Job e clique no botão Editar job selecionado, localizado no canto superior esquerdo da tela (imagem de um lápis);

  • Para Duplicar job, selecione o documento desejado na planilha job e clique no botão Replicar jobs a partir de um modelo, localizado no canto superior esquerdo da tela (imagem de uma pizza fatiada);

  • Para Remover job, selecione o documento desejado na planilha job e clique o botão Remover job selecionado, localizado no canto superior esquerdo da tela (imagem da letra X).

{{component-feedback-article}}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.