A integração foi disponibilizada via EAI2 (mensagem padronizada) com a utilização das seguintes transações:
| Transação | Versão |
|---|
| CustomerVendor (cliente\fornecedor) | 2.006 |
| Seller (representante) | 3.000 |
| AccountReceivableDocument (títulos do contas a receber) | 2.008 |
A documentação referente às transações utilizadas pode ser acessada no link oficial de mensagens padronizadas Totvs: https://api.totvs.com.br
- Parametrizações no produto:
Deverá ser habilitada a opção de integração "Integração MasterSales" no Parâmetros de integração EMS - programa "prgint\utb\utb036za.r".
Nesta tela também serão efetuadas algumas parametrizações referente a replicação de dados conforme tabela que segue:
| Campo | Detalhamento |
|---|
| Matriz Trad Organiz | Matriz de tradução de Unidade Organizacional que será utilizada entre EMS5 e EMS2. - Caso não informado será assumida a matriz padrão "EMS2".
|
| Grupo Cliente (Criação ERP) | Definir o grupo de cliente padrão que deverá ser utilizado para efetivação no ERP de clientes incluídos via MasterSales. |
| Grupo Fornecedor (Criação ERP) | Definir o grupo de fornecedor padrão que deverá ser utilizado para efetivação no ERP de fornecedores incluídos via MasterSales. |
| Replica Fornecedores | Quando marcado, indica que serão replicados também os fornecedores do ERP para MasterSales. - Independente deste parâmetro, pessoas cadastradas no Datasul como cliente e fornecedor simultaneamente serão replicadas.
|
| Grupos Cliente (Replicação) | Definir os grupos de clientes que deverão ser replicados\considerados na carga inicial de dados. - Este grupo de clientes irá filtrar também: Envio das mensagens CustomerVendor e AccountReceivableDocument (irá enviar somente quando o cliente for vinculado ao\aos grupo(s) informado(s) nesta parametrização).
|
| Grupos Fornecedor (Replicação) | Definir os grupos de fornecedores que deverão ser replicados\considerados na carga inicial de dados. - Este grupo de fornecedor irá filtrar também: Envio da mensagem CustomerVendor.
|
A carga inicial de dados será feita pela rotina de "Integração para Aplicações Externas":
Deverá estar criada a integração padrão "MasterSales":
Ao clicar em "Aplicações" da integração é possível parametrizar o servidor RPW para execução da carga de dados (Datasul para EAI):
Ao clicar no botão "Entidades" poderão ser determinadas as entidades para a carga e também delimitados os filtros de importação, para as que possuem:
Após parametrizados os filtros, basta clicar em "Executar entidade" para efetuar a carga da entidade parametrizada ou então em "Executar Integração" para efetuar a carga de todas as entidades selecionadas.
IMPORTANTE:
- O quadro em vermelho corresponde aos filtros que serão aplicados na carga de dados para a mensagem de "AccountReceivableDocument". Além do(s) estabelecimento(s), espécie(s) e data inicial de emissão dos títulos que devem ser considerados, essa mensagem será enviada somente para os clientes do(s) grupo(s) parametrizado(s) no Parâmetro de integração EMS (utb036za);
- Estabelecimento e espécie devem ser informados sempre separados por vírgula "," ou "*" para considerar todos;
- A data deve respeitar o formato DD/MM/YY ou DD/MM/YYYY;
- Representantes não possuem filtros, será feita a carga de todos os cadastrados no ERP;
- Clientes respeitarão o mesmo filtro na carga e no envio das mensagens, ou seja, serão enviados apenas os relacionados aos grupos informados no Parâmetro de integração EMS (utb036za).
Antes de efetivar a carga no botão "Executar Integração", deverão ser selecionadas as entidades que devem ser consideradas nesse processamento (botão "entidades"), conforme exemplo que segue:
Após selecionadas as entidades, basta clicar no botão "executar integração" da tela "Aplicações".
- Após feita a carga inicial de dados, com o EAI devidamente configurado com as rotas de envio ativas, as mensagens começarão a ser enviadas respeitando os seguintes critérios:
| Mensagem | Versão | Filtro de envios das mensagens |
|---|
| CustomerVendor (cliente\fornecedor) | 2.006 | Grupos de clientes\fornecedores parametrizados no UTB036ZA (Parâmetros de integração EMS). |
| Seller (representante) | 3.000 | Sem Filtros. Serão enviados todos os representantes. |
| AccountReceivableDocument (títulos do contas a receber) | 2.008 | Grupos de clientes parametrizado no UTB036ZA (Parâmetros de integração EMS) - No caso do título, serão enviados apenas títulos cujo cliente esteja vinculado ao grupo parametrizado. |
