Painel de integração

Painel de integração e Passo a passo para implantação/Integração Totali x EmE4

[Instalação:]

Feito via Jenkins

[Link]

[Para executar o backend]

docker run -d -p 3000:80 –restart always -e bancoTotali=”” -e bancoTotaliGuarda=”” -e bancoEme4=”” -e bancoHangfire=”” -e TZ=America/Sao_Paulo -e statusPost=”true” -e hangfire=”true” –name=Disapar integraapi

(Descrição de variáveis de ambiente)

BancoTotali = String de conexão banco totali (PostgreSQL)
Banco Eme4 = String de conexão banco eme4 (OracleSQL ou MicrosoftSQLServer)
BancoTotaliGuarda = String de conexão banco guarda totali (PostgreSQL)
BancoHangfire = String de conexão banco gerenciado pelo Painel para controle de jobs e logs (MicrosoftSQLServer)
TZ = Timezone para as datas da aplicação
StatusPost = True ou False para definir se o painel pode ou não interferir nos dados do EME4 ou Totali
Hangfire = True ou False para definir se o painel terá os jobs em execução

(Demais parâmetros do docker:)

-d = Executar em modo dettached (não abre o console da aplicação em execução)
-p = Define as portas de SAÍDA:ENTRADA dos dados
–name = Nome do contêiner
integraapi = Nome da imagem

Executando os dois comandos, teremos um painel de integração rodando de forma manual.

No entanto, todo o processo é automático pelo jenkins, quando é feito um commit no repositório git na branch main, ele dispara o processo acima descrito, incluindo git clone e build das imagens docker.

Sendo resumido da seguinte forma:

Assim que o painel estiver em execução, teremos as seguintes URL’s:

https://painelintegracao-disapar-api.datainfo.inf.br/hangfire

Responsável pelo agendamento e gerenciamento das tarefas

https://painelintegracao-disapar-api.datainfo.inf.br/swagger/index.html

Documentação dos endpoints

https://painelintegracao-disapar.datainfo.inf.br

Comparação de registros entre EME4 x Totali (usar login do EME4)

———————–///——————————-///——————————///———————————-

(Para ativar a exportação de registros do EME4 para o Totali deve-se fazer o seguinte:)

(Acessar a documentação dos endpoints)

https://painelintegracao-disapar-api.datainfo.inf.br/swagger/index.html

(Fazer login (com usuário e senha do EME4)

(E executar esta requisição com estes parâmetros)

{

“SetStatusDoctoError”: “0 * * * *”,

“ImportCtrlAltTab.Venda”: “* * * * *”,

“ImportCtrlAltTab.Produto”: “*/5 * * * *”,

“ImportCtrlAltTab.Diverso”: “*/5 * * * *”

}

———————-///————————-///—————————///—————————–///——————

1. Totali Commerce Config – Cadastro Série, Filial, Almoxarifado e ECF

2. Totali Commerce Backoffice – Cadastro Planos de Pagamento

3. Totali Commerce Config – Cadastro Tipos de Cobrança

4. Totali Commerce Config – Cadastro Contas Tesouraria/Cartões e Regra para Código Fiscal

5. Totali Commerce Config – Cadastro Contas Tesouraria/Cartões e Regra para Código Fiscal

6. Totali Commerce Backoffice – Configuração e Exportação de Dados do EME4

7. EME4 – Integração Externa – Painel Conferência Documentos Timu

8. Geração carga de registros completa do EME4 para a Totali

Gerar uma carga completa de todos os dados necessários para funcionamento da Integração.

9. EME4 – Integração Pedidos com Totali

10. Criar um Tipo de Cobrança com o código [-1] – “Recebe Caixa”

Para documentos com pagamento a vista a Totali envia o campo TIPOCOBRANCAPAGAMENTO na TIMU_LIQUIDACAODOCTO como -1 por padrão e é necessário que tenha esse código criado na tabela M3_TIPCOB do EME4 para integrar corretamente.

11. Na Totali o campo de unidade possui apenas 2 posições.

Por isso para a integrar o documento da TIMU, o EME4 utiliza o campo “Unidade SPED” para integrar.

Esse campo deve ser informado com as duas primeiras caracteres do campo “Código” da unidade, se não for informado a Unidade SPED vai dar erro dizendo que não encontrou a unidade.

12. Criar séries de documento no TTConfig conforme as séries existentes no EME4 (primeiramente na totali, depois na EME4 – tem que ser revisado)

13. Ativar integração EME4 no WSMiddleware

Para iniciar integração entre EME4 e Totali é necessário ativar a integração no WSMiddleware dentro da aba “Integração no WSMiddleware” conforme imagem abaixo:

14. Totali Commerce Backoffice – Configuração e Importação de Dados do EME4

15. Totali Commerce Backoffice – Cadastro Usuários, Permissões e Papéis

16. Totali Middleware – Integração Nativa Totali x EME4 – Configuração

17. Cadastrar os parâmetros de integração no Commerceweb

É necessário que sejam criados esses parâmetros, caso contrário o Middleware não irá fazer a integração.

Acesse a tela de Parâmetros de Configuração de Sistema, clique no botão de adicionar e insira os parâmetros a seguir.

Parâmetros de exportação para o EME4:

IPO_EXP_EME4 – Varejo

Criar o parâmetro Tipo de exportação EME4, para a maioria dos clientes será criado como V – VAREJO
DAT_PRI_MOV_EXP_EME4

Criar parâmetro de primeiro movimento a ser considerado na exportação para EME4, normalmente é colocado a data que for iniciado a integração