Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01.
Âncora
geral
geral
VISÃO GERAL

O plugin consiste na integração das despesas e receitas (importação de documentos CAR e exportação de documento CAP) com a API do parceiro e na importarção importação das baixas (CAP/CAR), que serão feitas sempre dos documento que forem liquidados (pagamento/recebimento na Superlógica). Caso o cliente/ fornecedor não esteja cadastrado na Superlógica, o plugin fará o registro, sempre concentrando o cadastro na base Hotal.


02.
Âncora

config

procar

config

procar

CONFIGURAÇÕES

PROCEDIMENTO CAR



Configuração

Importação de

Parâmetros

Cadastro necessário para a integração. Os seguintes cadastros precisam ser realizados:

Aba Parâmetros

  1. Grupo Conexão 
    1. Usuário: usuário da Superlógica
    2. Senha: senha da Superlógica
    3. App Token: chave de autenticação da API
    4. Access Token: código com as permissões do usuário
  2. Grupo Endpoint
    1. Listar Condomínios: https://api.superlogica.net/v2/condor/condominios/get?id=-1&somenteCondominiosAtivos=1&ignorarCondominioModelo=1&apenasColunasPrincipais=1&apenasDadosDoPlanoDeContas=0&comDataFechamento=1
    2. Listar Favorecidos: https://api.superlogica.net/v2/condor/fornecedores/index?contatosDoTipo=fornecedores&itensPorPagina=20&pagina=1
    3. Cadastrar Favorecidos: https://api.superlogica.net/v2/condor/fornecedores/?ID_CONDOMINIO_COND=80&ID_CONTATO_CON=&ST_CPF_CON=&ST_NOME_CON=&ST_FANTASIA_CON=&ST_INSCRICAOMUNICIPAL_CON=&ST_RG_CON=&ST_ORGAOEMISSOR_CON=&ST_TELEFONE_CON=&ST_FAX_CON=&ST_BAIRRO_CON=&ST_EMAIL_CON=&ST_CEP_CON=&ST_ENDERECO_CON=&ST_NUMEROENDERECO_CON=&ST_CIDADE_CON=&ST_ESTADO_CON=&ST_COMPLEMENTO_CON=&ST_INSS_CON=&NM_RPASEQUENCIAL_CON=&ID_TIPOCONTATO
    4. Listar Cobranças por Período: https://api.superlogica.net/v2/condor/cobranca/index
    5. Listar Despesas por Período: https://api.superlogica.net/v2/condor/despesas/index
    6. Cadastrar Nova Despesa: https://api.superlogica.net/v2/condor/despesas/
    7. Cadastrar Nova Despesa Parcelada: https://api.superlogica.net/v2/condor/despesas/

Image Removed

Após configurar os dados para conexão, clique no botão ao lado do campo "Senha" para validar a autenticação do token.

Image Removed

Aba Configuração

  1. Parâmetros Integração
    1. Atividade Projeto: cadastro do padrão
    2. Centro de Responsabilidade: cadastro do padrão
  2. De/Para
    1. Tipo de Recebimento: DePara com o plano de contas da Superlógica (campo 

Voltar ao topo

Configuração xxx

xxx:

  1. Cadastro
  2. xxx
  3. Tipo de Débito/Crédito
  4. Tipos de Débito/Crédito

xxx 

xxx.

Configuração xxx

xxx:

  1. Cadastro
  2. xxx
  3. xxx
  4. xxx
  5. xxx
  6. xxx

xxx.

ÂncoransunsuConfiguração xxx

xxx

  1. xxxx
  2. xxx
  3. xxx
  4. xxxx

xxx.

xxxx.   

03. ÂncoraprocprocPROCEDIMENTO

As etapas da integração consistem xxxx dos documentos no sistema.

Diagrama da integração

  • Geração xxx

xxx.   

    1. xxx.
    2. xxx
    3. xxx.
      1. xxx.
    4.   xxx.

xxx:

    1. xxx
    2. xxx
    3. xxx 

Voltar ao topo

  • Importação xxx

xxx.      

  • Baixa de Documentos

xxxx.

xxx.

    1. xxx.
    2. xxx.
    3. xxx:
      1. xxx.
      2. xxx.
    4. xxx.
    5. xxx. 

Funcionalidades xxx

xxx:

    • xxx.
    • xxx.
    • xxx.
    • xxx:
      • xxx.
      • xxx.      
04. ÂncoraarqarqCadastro Fornecedor

xxx.

05. ÂncoraprobprobSOLUÇÃO DE PROBLEMAS

Checklist em caso de problemas de funcionamento.

01. xxx 

R: xxx

02. xxx

R: xxx.

03. xxx

R: xxx:

    • Documento não localizado

04. xxxx

R: xxx.

05. xxxx

R: xxx.

documento

Os documentos serão consultados na API da Superlógica, selecionados e processados para serem integrados com a base CAR. Os documentos consultados na API da Superlógica em que o código correspondente do cliente não esteja cadastrado no Depara do plugin, serão destacados em vermelho.

Os dados do gris ainda poderão ser exportados para xlsx, clicando no botão "Excel".   

  1. Abrir o Painel Integração no caminho Integração Superlógica > Painel Integração 
  2. Selecionar no menu inferior esquerdo a opção Contas a Receber
  3. Clicar no submenu Importar, preencher o campo Data Geração Inicial e Final e clicar em Buscar
  4. Selecionar o documento a importar e clicar ou no menu contexto do botão direito do mouse e Importar Dados ou no botão Processar e confirmar a operação
  5. A importação será registrada no log da operação

Image Added

Image Added


Image Added


Image Added

Image Added

Image Added

Documentos sem Depara de cliente cadastrado

Em caso de importação de documentos sem Depara de cliente, o plugin fará a consulta do cpf/cnpj na base CAR e, caso seja localizado um único cadastro, irá gravar o código correspondente e então o documento será importado. Em caso de não localização, a operação será abortada e o log exibirá a mensagem de erro. 


  • Sem cadastro no CAR

Image Added

  • Documento em duplicidade

Image Added

  • Cliente com cadastro único e sem Depara

Obs.: Quando a Superlógica possuir mais de um cadastro do mesmo cliente, o plugin vai realizar a consulta do cpf/cnpj na base CAR e, caso seja localizado, gravar os códigos correspondentes desse cliente na tabela do plugin, sem considerar a regra de duplicidade do cadastro na Superlógica, validando apenas o cliente pelo documento (cpf/cnpj).

Image Added


Voltar ao topo


03.
Âncora
procap
procap
Procedimento CAP


Exportação de documento

Os documentos serão consultados na base CAP, selecionados e processados para serem exportados para a API Superlógica. 

Os dados do gris ainda poderão ser exportados para xlsx, clicando no botão "Excel".   

  1. Abrir o Painel Integração no caminho Integração Superlógica > Painel Integração
  2. Selecionar no menu inferior esquerdo a opção Contas a Pagar
  3. Clicar no submenu Exportar, preencher o campo Data Geração Inicial e Final e clicar em Buscar
  4. Selecionar o documento a exportar e clicar ou no menu contexto do botão direito do mouse e Exportar Dados ou no botão Processar e confirmar a operação
  5. A importação será registrada no log da operação

Image Added


Documentos sem fornecedor cadastrado na API

Ao exportar um documento da base CAP para a Superlógica, será consultado se o fornecedor possui código correspondente (id do fornecedor na Superlógica) cadastrado. Caso não possua, o plugin fará o cadastro do fornecedor na Superlógica e irá gravar o código correspondente na base Hotal. Com o cadastro realizado, o documento será exportado.

Obs.: Para isso, todo o cadastro de fornecedores será concentrado no CAP para que não haja duplicidade de cadastros.  


Image Added

Image Added


04.
Âncora
log
log
Log da Operação


Exibir Log com Mensagem de Erro da Integração

Os documentos que por algum erro não forem integrados, serão transferidos para a tela de Importados. Eles serão consultados pela data de geração do documento na Superlógica e serão tarjados na coloração vermelha.

A coluna Mensagem trará a descrição do erro da integração, mas é possível exibir o log completo do(s) documento(s). O log vai exibir o cliente, número do documento e qual o erro da operação. 

  1. Clicar no submenu Importado
  2. Preencher a Data Geração Inicial e Final e clicar no botão Buscar
  3. Selecionar o documento e clicar com o botão direito na opção "Mensagem de Erro"


Image Added

Image Added


Voltar ao topo


05.
Âncora
libera
libera
Liberação Documento



Liberação do documento importado/exportado

Liberação do documento importado/exportado 

A mensagem de erro na integração indicará qual o motivo da falha na operação. Após o ajuste do erro, o documento deve ser liberado para ser enviado novamente.

  1. Clicar no submenu Importado/exportado
  2. Preencher a Data Geração Inicial e Final e clicar no botão Buscar
  3. Selecionar o documento a ser liberado
  4. Clicar com o botão direito do mouse, opção Liberar Documento para Enviar Novamente
  5. Confirme a operação 


Image Added

Image Added

Image Added


Voltar ao topo



06.
Âncora
baixa
baixa
Baixa Documento



Atualização do status do documento importado e baixa

Os documentos integrados com sucesso da API da Superlógica serão transferidos para a tela de Importados/Exportados e listados no grid de acordo com o filtro de Data Geração inicial e final. Os documentos pendentes de recebimento terão a descrição Em Aberto na coluna Status Doc. e ficarão com a colaração amarela.

O botão Atualizar Baixa fará a consulta do status do documento na API Superlógica, atualizará a coluna Status Doc. com o texto Liquidado e mudará a coloração para azul. Nessa atualização, caso o documento liquidado na Superlógica possua alteradores eles serão lançados. Com a coluna Status Doc. atualizada, o documento pode ser selecionado e baixado.  

Obs.: Um documento baixado não poderá ser liberado para importar/exportar novamente, a não ser que seja estornado no sistema (vide próximo subitem)

  1. Clicar no submenu Importados, preencher o campo Data Geração Inicial e Final e clicar em Buscar
  2. Clicar no botão Atualizar Baixa
  3. Selecionar os documento com a coloração azul (coluna Status Doc. com o texto Liquidado)
  4. Selecionar o documento a baixar, clicar ou no menu contexto do botão direito do mouse e Baixar Documentos ou no botão Baixar e confirmar a operação
  5. A baixa será registrada no log da operação


Image Added


Image Added

Image Added

Image Added


Image Added


Image Added


Voltar ao topo



07.
Âncora
estorno
estorno
Estorno Documento



Procedimento para estorno

O fluxo do plugin é encerrado após a baixa, porém em caso de necessidade de estorno, ele deverá ser realizado de forma nativa no sistema, em seguida o status do documento poderá ser  retornado para "Em Aberto" e as operações realizadas novamente.

Premissa: Estornar de forma nativa um documento baixado no CAR.

  1. Preencher Data Geração Inicial e Fina
  2. Clicar em Buscar
  3. Clicar em Atualizar Baixa
  4. O documento estornado terá seu status alterado para "Em Aberto"
  5. Selecionar o documento
  6. Clicar em Atualizar Baixa para a consulta de Liquidação na API Superlogica
  7. O documento liquidado erá seu status alterado para "Liquidado"
  8. Selecionar o documento e clicar em Baixar

Image Added


Voltar ao topo

06. xxx

R: xxx.

07. Filtros 

R: xxx.

HTML<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style>