Rotina de importação de receita e despesa – via API

Modificado em Qui, 1 Set, 2022 na (o) 1:51 PM


1. Informações Gerais

 

Objetivo:

 

Desenvolver importação dos lançamentos de receita e despesa disponibilizados pelo sistema da RJ (WS Integrações Totalbus – RJ INTEGRA)

 

Detalhes:

 

  • PSE: 42768  

 

  • Módulo: RET 

 

  • Acesso: 

 

Módulo RET à Cadastros à Arrecadação > Relacionamento genérico

 

Módulo RET à Guia de viagem à Importação de dados à Parâmetros de importação de receita e despesa - API

 

Módulo RET à Guia de viagem à Importação de dados à Importação de receita / despesa - API

 

Módulo RET à Lançamentos à Despesa

 

Módulo RET à Lançamentos à Receita

 

 

Informações Adicionais:


 N/A

 

2. Relacionamento genérico

 

Para que seja possível realizar a importação das receitas e despesas, via API, antes é necessário fazer os cadastros de relacionamento genérico (DE-PARA).

Itens obrigatórios:

  • Agência;
  • Tipo de receita;
  • Tipo de despesa;
  • Tipo de forma de pagamento + bandeira;
  • Tipo de despesa por forma de pagamento.

 

Relacionamento de agência

 

Relacionamento de tipo de receita

 

Relacionamento de tipo de despesa

 

Relacionamento de forma de pagamento + bandeira

 

Relacionamento de despesa por forma de pagamento


3. Parâmetros de importação de receita e despesa - API

 

Além do cadastro de relacionamento genérico, o usuário precisa cadastrar as parametrizações referente a importação, como por exemplo, endereço da API, usuário, senha, etc.

 

Parâmetros da aba “Parâmetros gerais”:

  • Empresa e filial que o movimento será gravado;
  • Usuário padrão que ficará registrado nos lançamentos;
  • Turno padrão que ficará registrado nos lançamentos;
  • URL da API, referente ao movimento de receita e despesa;
  • URL da API, referente ao cadastro de receita e despesa;
  • Usuário e senha para conectar na API;
  • Código da empresa na API.

 

Aba “Parâmetros gerais”

Parâmetros da aba “Relacionamento genérico”:

  • Código de r. genérico da agência;
  • Código de r. genérico do tipo de receita;
  • Código de r. genérico do tipo de despesa;
  • Código de r. genérico da forma de pagamento + bandeira;
  • Código de r. genérico da despesa por forma de pagamento;
  • Código de r. genérico da receita por forma de pagamento;
  • Código da forma de pagamento que será desconsiderado na importação, ou seja, o sistema não criticará a falta de r. genérico, porém não gravará o lançamento desse código na execução da rotina.

 

Aba “Relacionamento genérico”


 4.Importação de receita/despesa – API

 

Para executar a importação, basta selecionar a opção “Importação”, em seguida informar o código do parâmetro de importação, a data do movimento, e por último clicar no botão “Importar”.

 

 

 

 

No caso de inconsistências, o sistema exibirá as críticas, tanto no grid, como em relatório, bastando o usuário clicar no ícone “imprimir”.


 

 

Já no processo de exclusão, o usuário deve selecionar a opção “exclusão”, informar o período que fez a importação (não confundir com data do movimento), e clicar no botão de pesquisar.

 

Com isso o sistema apresentará todos os movimentos importados no período, deixando em vermelho os dias que poderão ser excluídos, e em verde os que estão bloqueados.

 

Para excluir, deve marcar o movimento correspondente, e em seguida clicar no botão “Excluir”.

 

 

 

Regras:

 

Não é possível fazer a importação de forma parcial, ou seja, caso seja apresentada crítica em ao menos um registro, então o usuário, primeiro deverá sanar a inconsistência, e só depois tentar importar novamente.

 

No momento da importação, caso o sistema encontre encerramento diário da arrecadação para dia do movimento, então apresentará crítica.

 

Na exclusão também será verificada a existência do encerramento diário, bloqueando os movimentos encerrados.


 

5. Telas de lançamento de receita/despesa

 

Após a execução da rotina de importação, os lançamentos serão apresentados na mesma tela de lançamento manual, tendo como identificador, uma frase padrão, no campo de descrição detalhada.

 

Formato da descrição detalhada:

 

Frase padrão + data que o usuário importou o movimento + nome do arquivo

 

 

Regras:

 

Após a importação são admitidas alterações e exclusões no movimento, como forma de correção, flexibilizando assim o fechamento do caixa. Todavia, caso a empresa/filial esteja utilizando o parâmetro “Fechar caixa na importação de receita e despesa”, as movimentações ficam bloqueadas, sendo liberadas apenas mediante a exclusão da importação.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo