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

JavaScript errors detected

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

If this problem persists, please contact our support.