PODER JUDICIÁRIO

ESTADO DO RIO DE JANEIRO

Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

Manual do Usuário

Gerar GRERJ Compartilhada

via Web Service
SATI – Módulo Dívida Ativa

Template Versão 1.2

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

SUMÁRIO

1. Objetivo........................................................................................................................................................... 3

2. Destinatários ................................................................................................................................................... 4

3. Procedimento Proposto ................................................................................................................................... 4

4. Pré-Requisito Para Utilização do Serviço......................................................................................................... 5

5. Cadastro de Usuários ...................................................................................................................................... 6

6. Cadastro de Contas ........................................................................................................................................ 7

7. Procedimentos para Implantação .................................................................................................................... 8

Análise da Documentação ...................................................................................................................... 8

Acesso ao Web Service para Obtenção do WSDL .................................................................................. 8

Adaptação do Sistema do Conveniado.................................................................................................... 8

Cadastro de Grerjs.................................................................................................................................. 8

Impressão de Grerjs................................................................................................................................ 8

8. Contatos ......................................................................................................................................................... 9

Atendimentos – 08h às 20h ..................................................................................................................... 9

Cadastro de Usuários ............................................................................................................................. 9

9. Perguntas mais Frequentes ........................................................................................................................... 10

Dados Enviados.................................................................................................................................... 10

Acesso ao Web Service ........................................................................................................................ 10

Funcionamento do Web Service............................................................................................................ 10

Segurança das Informações.................................................................................................................. 11

Identificação do Usuário ........................................................................................................................ 11

Disponibilidade do Serviço .................................................................................................................... 12

10. Descrição do Web Service – Métodos e Parâmetros ................................................................................. 13

GerarGuiaEletronicaWin32 ................................................................................................................... 13

11. Histórico de Versões ................................................................................................................................. 16

Gerar GRERJ Compartilhada via Web Service Página 2 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

1. Objetivo

O Objetivo do módulo é permitir a geração da GRERJ (Guia de Recolhimento de Receita

Judiciária) eletrônica compartilhada da Dívida Ativa de forma rápida e segura, por meio de
um serviço (Web Service) disponibilizado na Internet. A GRERJ gerada conterá os valores das
custas judiciais referentes ao processo de execução fiscal, os valores do tributo devido e dos
honorários advocatícios.

Resumidamente, os conveniados deverão adicionar à sua aplicação (web ou desktop) o

serviço. O envio das informações será feito através de uma chamada de função, passando
os parâmetros necessários. Esta mesma função retornará o número da GRERJ para posterior
impressão. Os detalhes técnicos do serviço estão descritos no item 9 deste documento.

As Grerjs pagas são automaticamente vinculadas ao processo judicial constante em seu

cadastro, dispensando o peticionamento ao cartório para o qual foi distribuído.

O serviço estará disponível no horário de funcionamento do sistema GRERJ Eletrônica,

todos os dias da semana, exceto nos casos previstos para manutenção dos servidores.

Gerar GRERJ Compartilhada via Web Service Página 3 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

2. Destinatários

Governo estadual e prefeituras que já assinaram ou que desejam realizar o convênio

com o Tribunal de Justiça do Estado Rio de Janeiro.

3. Procedimento Proposto

Figura 1 – Procedimento Ilustrado.

Gerar GRERJ Compartilhada via Web Service Página 4 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

4. Pré-Requisito Para Utilização do Serviço

 Login (identificação de usuário) e senha fornecida pelo TJERJ.

 Ter as contas para recebimento do tributo e dos honorários advocatícios

cadastradas no sistema do TJERJ.

 Adaptação do sistema do conveniado ou desenvolvimento de aplicativo para ter

acesso ao serviço (Web Service) disponibilizado pelo TJERJ.

 Acesso à Internet.

 Para a impressão da GRERJ é necessário ter instalado em seu computar o

programa Adobe Reader versão 8.1 ou superior.

Gerar GRERJ Compartilhada via Web Service Página 5 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

5. Cadastro de Usuários

Para o cadastro de login e senha de acesso, o conveniado deverá enviar um ofício à

DGTEC, informando o(s) nome(s) do(s) representante(s) anexando cópia(s) do RG e do CPF
do(s) mesmo(s) – (ver 8. Contatos). O(s) representante(s) deverá(ão) ser servidor(es).

De posse da identificação (login e senha), o representante terá acesso ao sistema SATI

– Sistema de Apoio e Tratamento de Informações - Módulo Web, existente no Portal do Poder
Judiciário do Estado do Rio de Janeiro (http://www.tjrj.jus.br – Serviços  Sistemas). Ao
acessar o sistema, as informações sobre o conveniado deverão ser complementadas e/ou
alteradas.

Neste sistema, o representante também poderá consultar os valores atualizados da

tabela de custas de dívida ativa do ano corrente, como também os relatórios contendo a
listagem das Grerjs emitidas pelo conveniado, por período, e a listagem das Grerjs pagas
por período.

OBSERVAÇÃO: O usuário que não utilizar o serviço por mais que 120
dias terá o login inativado. O mesmo ocorrerá após três tentativas
seguidas com senha inválida ou cinco tentativas com senha inválida,
alternadas com logins válidos, desde que ocorridos no mesmo dia.

Nestes casos, para reativar o usuário será necessário entrar em contato

com o Service Desk do TJERJ (ver 8. Contatos).

As senhas expirarão em 90 dias após a última troca. No caso do acesso

via Web Service, o sistema não impedirá o acesso com a senha
expirada.

Gerar GRERJ Compartilhada via Web Service Página 6 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

6. Cadastro de Contas

Os conveniados deverão possuir 2 (duas) contas cadastradas no banco arrecadador do

PJERJ. Isso possibilitará a inclusão das mesmas na Grerj. Uma conta servirá para arrecadar
os valores referentes ao tributo e a outra servirá para arrecadar os valores destinados aos
honorários advocatícios.

As contas deverão ser informadas ao PJERJ através de uma comunicação eletrônica (e-
mail) à Divisão de Arrecadação (DGPCF-DEGAR-DIARR) com a seguinte formatação:

 Destinatário: diarr@tjrj.jus.br.

 Assunto: Cadastro de Contas para GRERJ Compartilhada de Dívida Ativa.

 Conteúdo: Nome do correntista, CNPJ, conta referente ao tributo (Agência – Conta

– DV) e conta referente aos honorários (Agência – Conta – DV).

Gerar GRERJ Compartilhada via Web Service Página 7 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

7. Procedimentos para Implantação

Análise da Documentação

Nesta etapa, o(s) representante(s) da área técnica do conveniado deverá(ão) analisar

este manual e a descrição do serviço.

As dúvidas devem ser encaminhadas ao Departamento de Atendimento ao Usuário –

DEATE (ver 8. Contatos).

Acesso ao Web Service para Obtenção do WSDL

Pode ser obtido em:

https://www3.tjrj.jus.br/SATIExternoWS/SATIGuiaEletronica.asmx?wsdl

Adaptação do Sistema do Conveniado

Com base no WSDL, os analistas irão adaptar ou desenvolver funções dos seus sistemas
de informação para a geração de Grerjs com o envio dos dados solicitados.

Cadastro de Grerjs

De posse do login e da senha de acesso, além de possuir as contas devidas cadastradas

no sistema do PJERJ, será possível realizar o cadastro de uma Grerj caso o sistema local já
esteja devidamente adaptado.

Toda Grerj criada é de produção! É de responsabilidade do conveniado verificar se os

valores informados correspondem aos exibidos na Grerj.

O método a ser utilizado será o “GerarGuiaEletronicaWind32” (ver 10. Descrição do Web

Service – Métodos e Parâmetros).

Impressão de Grerjs

Para imprimir uma Grerj, o sistema deverá ter o número da Grerj e chamar a seguinte
URL: https://www3.tjrj.jus.br/grerjweb4/reimpressao.do?numGuia=<número da Grerj
retornada>&edg=1

O parâmetro <número da Grerj retornada> deverá ser substituído pelos 13 dígitos da Grerj. Caso
o número comece por “0” (zero), este também deverá ser incluído.

Gerar GRERJ Compartilhada via Web Service Página 8 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

8. Contatos
Atendimentos – 08h às 20h

Central de Atendimento ao Usuário (Service Desk) – (21) 3133-9100.

Para dúvidas, problemas, erros, acessos, etc., o conveniado deverá sempre registrar o
atendimento informando tratar-se do sistema SATI. Informe também o seu município e e-
mail para contato.

Cadastro de Usuários

Enviar Ofício a Diretoria Geral de Tecnologia da Informação do Tribunal de Justiça do

Estado do Rio de Janeiro, aos cuidados do Ilmo. Sr. Diretor Geral da DGTEC (não colocar
nome), informando o(s) nome(s) do(s) representante(s), anexando cópias do RG e do CPF
do(s) mesmo(s), além de e-mail e telefone para contato. O(s) representante(s) deverá(ão)
ser servidor(es).

O ofício deverá ser enviado para o e-mail do setor de suporte: sesfi@tjrj.jus.br

Gerar GRERJ Compartilhada via Web Service Página 9 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

9. Perguntas mais Frequentes

Dados Enviados

 Como é feito o envio dos dados?

Os dados são enviados através dos argumentos da função “GerarGuiaEletronicaWin32”.

Esta função registra os dados do documento pago enviado.

 Posso enviar dados referentes a vários processos ou um processo com várias

parcelas em uma única chamada ao Web Service?

Não. Cada chamada deverá se referir a uma parcela. Sendo assim, se houve um
parcelamento de custas e taxa de um processo em 2 parcelas, deverão ter 2 chamadas, pois
são dois documentos distintos. Cada chamada conterá os dados relativos à uma parcela
específica.

 Como serão respondidos os dados que foram enviados ao Web Service?

O serviço fará uma validação dos dados para verificar conformidades entre datas,
valores, entre outros. O retorno dessa validação será o número da GRERJ cadastrada, em
caso de sucesso. Havendo problemas, o serviço retornará uma exceção com a mensagem
de erro.

Cabe ao conveniado tratar esse retorno para evitar novas ocorrências de erros. Vale
lembrar que o município deve verificar se os valores das custas e taxas das guias enviadas
estão de acordo com os valores vigentes para o ano.

Acesso ao Web Service

 Há alguma restrição a quantidade de chamadas que podem ser feitas por dia por
determinada prefeitura?

A princípio não.

Funcionamento do Web Service

 Há algum método de “login”? Como é feito o “login”?

Gerar GRERJ Compartilhada via Web Service Página 10 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

O login é feito a cada chamada do método. Os dados do usuário são passados em

parâmetros desse método.

Ao entrar em nossa rede esses dados trafegam criptografados via HTTPS e, ao chegar a
nosso banco o serviço, utiliza-se de algoritmo “md5” para descriptografar.

 Deve ser feito o controle da sessão via cookies ou similar, no cliente Web Service?

Não. O serviço não necessita de controle de sessão.

Segurança das Informações

 Os dados obtidos por meio do serviço são criptografados? Qual o tipo de

criptografia utilizada?

Sim. É utilizada a criptografia do tipo “MD5” para login e os dados trafegarão via HTTPS.

 Quais são as garantias de que a solução apresentada para gestão de senhas e

acesso é confiável? Quais as medidas para evitar, por exemplo, que algum
servidor ou terceiro obtenha senha de uma das operadoras?

A política de controle de acesso aos sistemas, servidores e bancos de dados utilizada no

TJERJ não é divulgada para não comprometer a segurança dos sistemas e infraestrutura. No
entanto, até a presente data, desde que o sistema de segurança do TJERJ foi implantado,
não tivemos nenhuma ocorrência de quebra de sigilo de senha por terceiro ou funcionário
da DGTEC.

Identificação do Usuário

 Existe alguma regra para formação da senha de acesso ao serviço? Por exemplo:
deverá ter letras e números, caracteres especiais, na troca da senha não poderá
repetir alguma já utilizada anteriormente, etc.

A senha deve ter no mínimo 5 caracteres e não pode ser igual ao login. Além de não
poder ser composta por caracteres sequenciais (Ex: 12345, ABCDEF, 987654, HGFEDC).

 Para quem a senha será entregue?

Gerar GRERJ Compartilhada via Web Service Página 11 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

A senha será entregue para o representante do conveniado. Na entrega, a senha já

estará expirada, sendo possível alterá-la no portal do TJERJ.

 O serviço fará a verificação de senha expirada?

Não. O usuário pode optar por alterar a senha quando desejar.

Disponibilidade do Serviço

 Os casos de indisponibilidade do serviço serão avisados com antecedência? Quais

as janelas de indisponibilidade?

Atendendo ao solicitado, informamos que o TJERJ busca manter os servidores, aplicações

e bancos de dados disponíveis 24 horas por dia x 7 dias na semana, durante todo o ano.
Interrupções só são realizadas por necessidades de manutenção na infraestrutura, hardware
ou software, que são sempre avisadas com antecedência através do site do TJERJ ou através
das próprias aplicações.

Gerar GRERJ Compartilhada via Web Service Página 12 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

10. Descrição do Web Service – Métodos e Parâmetros

GerarGuiaEletronicaWin32

Objetivo: Enviar os dados para o cadastro da GRERJ através dos parâmetros repassados
para a função.

Parâmetros

pLogin:

 Login do usuário cadastrado no TJERJ (colocar letras em CAIXA ALTA).

pSenha:

 Senha do usuário cadastrado no TJERJ.

pCodOrgao:

 Código do órgão do usuário cadastrado no TJERJ. Numérico (5).

codigoCidade:

 Código Cidade. Numérico (5)

dataVencimento:

 Data de vencimento da Grerj. Alfanumérico no formato dd/MM/yyyy.

cpfCnpjContribuinte:

 CPF ou CNPJ do contribuinte que pagará a Grerj. Somente números.

nomeContribuinte:

 Nome do contribuinte que pagará a Grerj. Alfanumérico.

numeroProcesso:

 Número do processo. Alfanumérico: X(25).

 Exemplos: 2004.121.003017-9; 0000123-45.2009.8.02.0012; 20041210030179;

Gerar GRERJ Compartilhada via Web Service Página 13 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

valorTributoParcela:

 Valor correspondente ao tributo municipal da parcela. Numérico (15,2)

 Exemplo: 156987,25

valorHonorarioParcela:

 Valor correspondente aos honorários advocatícios da parcela. Numérico (15,2)

 Exemplo: 156987,25

valorTotalDivida:

 Valor correspondente ao total da dívida do contribuinte. Numérico (15,2)

 Exemplo: 156987,25

numeroParcela:

 Número da parcela atual a ser paga. Numérico (3).

 Caso seja cota única, deverá ser preenchido com 999.

totalParcelas:

 Total de parcelas com custas e taxa. Numérico (3).

Retorno: Número da GRERJ.

Alfanumérico (13 dígitos) – Exemplos: 1122507055563, 2140407055149,

0170708080890, etc.

Exceções:

O sistema poderá retornar uma exceção referente a um parâmetro inválido fornecido.

Exemplos: “CPF/CNPJ é inválido”, “Processo Judicial inválido”, etc.

OBSERVAÇÃO:

Havendo retorno de qualquer exceção, o sistema não gera a GRERJ.

Gerar GRERJ Compartilhada via Web Service Página 14 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

Gerar GRERJ Compartilhada via Web Service Página 15 de 16

 PODER JUDICIÁRIO
ESTADO DO RIO DE JANEIRO
Diretoria Geral de Tecnologia da Informação
Departamento de Suporte e Atendimento

11. Histórico de Versões

Versão Data Descrição da alteração Responsável
1.0 12/05/2017 Elaboração do Manual Claudio Blanco

Gerar GRERJ Compartilhada via Web Service Página 16 de 16