Linha de Produto: | Microsiga Protheus | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmento: | Varejo | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Módulo: | SIGALOJA, SIGAFRT | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
Cadastros Iniciais: | Adapters EAI (CFGA020): Cliente, Produto, Estação de Trabalho, Vendedor, Forma de Pagamento, Unidade de Medida e Local de Estoque; De/Para Empresa Filial EAI (APCFG050). | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Parâmetro(s): | MV_EAIURL2, MV_EAIUSER, MV_EAIPASS, MV_LJMUDIN, MV_LJMUCH, MV_LJMUFI e MV_LJRMBAC | ||||||||||||||||||||||||||||||||||||||||||||||||||||
País(es): | Brasil | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Banco(s) de Dados: | Todos | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Tabelas Utilizadas: | SAE - Administração Financeira SX5 - Tabelas SB0 - Dados Adicionais - Loja SB1 - Descrição Genérica do Produto SLK - Código de Barras por Produto SLG - Estações NNR - Locais de Estoque SA1 - Clientes SA3 - Vendedores SAH - Unidades de Medida | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Sistema(s) Operacional(is): | Windows/Linux | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Chamados relacionados: | TUBW06 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Versões/Release: | 12.1.7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Versão Corrigida: | 12.1.7 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
Versão Expedida: | 12.1.7 |
Implementada no Venda Assistida e Totvs Pdv a funcionalidade de integração para o PDV do sistema Protheus (cadastros e movimentações do produto) com o BackOffice do sistema RM.
Como premissa da integração será a utilização de Mensagem Única.
O desenvolvimento se dará em 2 fases distintas sendo elas:
Fase 1
Fase 2
Importante
O fluxo destas integrações serão Protheus para RM
Pré-Requisitos
Adapters:
Configurar a Rotina do Adapter de acordo com os dados abaixo fornecidos e que já foram pré estabelecidos para a integração:
Lista de Adapters a serem incluídos:
Mensagem Única | Rotina Protheus | Mensagem | Descrição | Envia | Recebe | Método Protheus | Operação | Canal de Envio | Adapter Protheus | Versão |
Sim | MATA010 | Item | Produto | Não | Sim | Síncrono | Todas | EAI | MATI010 | 3.004 |
Sim | MATA030 | CustomerVendor | Cliente | Nâo | Sim | Síncrono | Todas | EAI | MATI030 | 2.002 |
Sim | AGRA045 | Warehouse | Armazéns de Estoque | Não | Sim | Síncrono | Todas | EAI | AGRI045 | 1.001 |
Sim | QIEA030 | UnitOfMeasure | Unidades de Medida | Não | Sim | Síncrono | Todas | EAI | QIEI030 | 2.002 |
Sim | LOJA121 | ListOfStationSalePoint | Lista de Estações de Trabalho | Não | Sim | Síncrono | Todas | EAI | LOJI121 | 1.000 |
Sim | MATA040 | Seller | Vendedor | Não | Sim | Síncrono | Todas | EAI | MATI040 | 2.001 |
Sim | LOJA070 | PaymentMethod | Forma de Pagamento/Adm. Fin. | Não | Sim | Sincrono | Todas | EAI | LOJI070 | 1.000 |
2. Ainda no módulo Configurador, alterar a configuração de compartilhamento de registros nas tabelas do Protheus, acesse Base de Dados/Dicionário/Base de Dados, pesquise pela tabela e a configure conforme especificado na tabela abaixo:
Entidade | Empresa | Unidade | Filial | Tabela Protheus |
Cliente | Compartilhado | Compartilhado | Compartilhado | SA1 |
Vendedor | Exclusivo | Exclusivo | Compartilhado | SA3 |
Dados Adicionais Loja | Exclusivo | Exclusivo | Compartilhado | SB0 |
Produto | Exclusivo | Exclusivo | Compartilhado | SB1 |
Produtos x Preços | Exclusivo | Exclusivo | Compartilhado | SBI |
Log de Modificações | Exclusivo | Exclusivo | Compartilhado | SLH |
Genérica | Exclusivo | Exclusivo | Compartilhado | SX5 |
Clique em atualizar Base de Dados para salvar as alterações.
Importante
Será necessário excluir a tabela SX5 via APSDU, após novo acesso ao Protheus, a tabela será recriada com as informações distribuídas por filial.
Efetuar Backup da tabela antes deste procedimento.
Importante
Será necessário efetuar os procedimentos de Compartilhamento de tabelas nos PDVs.
3. No Configurador (SIFACFG), acesse Ambientes/Schedule/Emp.Fil.Msg.Unica e cadastrar De-Para de Empresas e Filiais, preencher conforme os valores a seguir:
Exemplo:
Referência: RM
Company : 4
Branch: 20
Emp. Protheus: 01
Fil. Protheus: 0101005
Para integrações globais do sistema RM, a configuração será conforme exemplo abaixo:
Referência: RM
Company : 0
Branch:
Emp. Protheus: 01
Fil. Protheus: 0101005
4. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados e aumente tamanho do campo A1_COD:
5. No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados e adicione inicializador padrão para o campo A1_LOJA:
. 7. Como o tamanho do Código do Local de Estoque no sistema RM é 15 e no Protheus pode variar de 2 a 6, é possível inserir um inicializador padrão para este campo.
No Configurador (SIFACFG), acesse Base de Dados/Dicionário/Base de Dados e adicione inicializador padrão para o campo NNR_CODIGO:
Exemplo:
[Integracao EAI]
Main= LJISENDEAI
ENVIRONMENT=Ambiente
nParms=2
Parm1=99
Parm2=01
[OnStart]
RefreshRate=120
jobs=Integracao EAI
Cadastro de Unidade de Medida
Inclusão:
1. Após inclusão da Unidade de Medida no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SAH, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia Estoques / Unidades de Medida.
Sistema apresenta as Unidades de Medida existentes, se este item que foi incluído ainda não existe, será feita a inclusão, senão, permanecerá inalterada.
Alteração:
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Gerencia Estoques / Unidades de Medida
Sistema apresenta as Unidades de Medida existentes, se a Unidade de Medida estiver sendo utilizada em algum cadastro (ex: Produto), sistema não permitirá a exclusão.
Importante
RM deve enviar as integrações das Unidades de Medida padrões Protheus para que alimente as tabela De-Para.
Cadastro de Local de Estoque
Inclusão:
1. Após inclusão de Local de Estoque no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo NNR, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Locais de Estoque.
Sistema apresenta os Locais de Estoques existentes, sistema terá incluído o novo registro.
Alteração:
Importante
Caso seja efetuada a alteração de inativação do Local de Estoque no sistema RM e este não tenha movimentações, será excluído no sistema Protheus.
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Locais de Estoque
Sistema apresenta os Locais de Estoques existentes, o item em questão terá sido excluído da tabela.
Cadastro de Produto/Precificação/Código de Barras do Produto
Inclusão:
1. Após inclusão de Produto no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SB1, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Produtos
Sistema apresenta os Produtos existentes, sistema terá incluído o novo registro, verifique no rodapé que os preços de venda do produto também foram adicionados conforme integração.
Alteração:
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Produtos
Sistema apresenta os Produtos existentes, o item em questão terá sido removido da tabela juntamente com sua precificação.
Os Códigos de Barras correspondentes ao Produto também serão inseridos pela integração de Produtos, os eventos de Códigos de Barras estarão relacionados com os eventos da integração do Produto da seguinte forma:
Importante
O Protheus possui um tratamento onde um Código de Barras pode representar uma Caixa de Mercadorias, neste caso, deverá ser informado pela RM a quantidade de produtos para o Código de Barras que está sendo gerado, caso não seja informado, será considerado o valor default = 0, definindo assim que o Código de Barras representa apenas 1 produto.
Importante
As integrações de Unidade de Medida e Local de Estoque são pré-requisitos para a integração de Produtos e estão detalhadas neste documento.
Cadastro de Cliente
Inclusão:
1. Após a inclusão do Cliente no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SA1, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
Sistema apresenta os Clientes existentes, sistema terá incluído o novo registro.
Alteração:
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Clientes.
Sistema apresenta os Clientes existentes, o item em questão será excluído da tabela.
Importante
Este processo por padrão também trata a integração de Fornecedores, porém, nesta integração, serão integrados apenas Clientes.
Importante
Protheus possui um código de Cliente Padrão automático com base nos parâmetros MV_CLIPAD e MV_LOJAPAD, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.
Cadastro de Vendedor
Inclusão:
1. Após a inclusão do Vendedor no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SA3, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Vendedores.
Sistema apresenta os Vendedores existentes, sistema terá incluído o novo registro.
Alteração:
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Cadastros / Vendedores.
Sistema apresenta os Vendedores existentes, o item em questão terá sido excluído da tabela.
Importante
Protheus possui um código de Vendedor Padrão automático, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.
Cadastro de Estação de Trabalho (Pdv)
Inclusão:
1. Após a inclusão da Estação de Trabalho no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SLG, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações.
Sistema apresenta as Estações de Trabalho existentes, sistema terá incluído o novo registro.
Alteração:
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Ponto de Venda / Estações.
Sistema apresenta as Estações de Trabalho existentes, o item em questão terá sido removido da tabela.
Importante
A integração de Local de Estoque é pré-requisito para a integração de Estação de Trabalho e está detalhada neste documento.
Importante
Protheus possui um código de Estação de Trabalho Padrão automático, RM deve enviar a integração deste cliente para alimentar a tabela De-Para.
Cadastro de Forma de Pagamento/Administradoras Financeiras
Visto que a base Protheus possui carga com formas de pagamento padrão (obrigatoriamente constam na base de dados), deve-se efetuar o cadastro destas Formas de Pagamento no RM respeitando o mesmo código do Protheus para viabilizar a integração de registros que utilizem estas como parâmetro. A lista de forma de pagamentos padrão no Protheus e que devem ser cadastradas no RM com o mesmo código estão armazenadas na tabela SX5, Chave 24:
Importante
Se forem incluídas novas Formas de Pagamentos no Sistema RM diferentes das Formas de Pagamento pré-existente no Protheus, essas serão incluídas automaticamente.
Deverá ser informado pelo sistema RM o mesmo código da Forma de Pagamento Protheus conforme tabela SX5, Chave 24, desta forma, será alimentada a tabela de integração para utilização, se o usuário optar em trabalhar com código diferente do cadastro Protheus, os códigos devem ser inseridos manualmente nos parâmetros abaixo:
- MV_LJMUDIN: parâmetro de forma de pagamento para Dinheiro.
- MV_LJMUCH: parâmetro de forma de pagamento para Cheque.
- MV_LJMUFI: parâmetro de forma de pagamento para Financiado.
Importante
Os códigos deverão ser inseridos manualmente nos parâmetros, se a Forma de Pagamento alternativa for excluída, o código deverá ser apagado manualmente do parâmetro correspondente.
Importante
As Administradoras Financeiras serão inseridas manualmente no sistema Protheus e não terão integração com o sistema RM, deve-se preencher no campo Form Pg Ext (AE_CODEXT) a Forma de Pagamento Cartão de Crédito/Débito enviado pelo sistema RM, desta forma, será possível estabelecer a relação entre as entidades.
Inclusão:
1. Após a inclusão da Forma de Pagamento no sistema RM, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SX5, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no Configurador (SIGACFG), Ambiente / Cadastro / Tabelas, posicionar na chave 24 (Formas de Pagamento).
Sistema apresenta as Formas de Pagamento existentes, se este item ainda não existe, sistema fará a inclusão, senão, permanecerá inalterada.
Alteração:
Sistema apresenta as Formas de Pagamento existentes, verifique as alterações que foram efetuadas no item conforme integração.
Exclusão:
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, item deve ter sido excluído da tabela De-Para.
2. Acesse no Configurador (SIGACFG), Ambiente / Cadastro / Tabelas, posicionar na chave 24 (Formas de Pagamento).
Sistema apresenta as Formas de Pagamentos existentes, se esta for uma Forma de Pagamento nova, será excluída do cadastro, caso seja uma Forma de Pagamento já existente, permanecerá pois pertence aos cadastros padrões do sistema Protheus.
Cupom Fiscal/RPS
As Vendas Varejo serão realizadas no Sistema Protheus (Front Loja ou Totvs Pdv), poderão ser do tipo Cupom Fiscal ou RPS (Recibo Provisório de Serviço), após a finalização da venda, estas serão integradas com a Retaguarda (SigaLoja)
através dos processos já existentes no sistema Protheus.
Na Retaguarda (SigaLoja), as vendas serão integradas para o sistema RM através de comunicação via Mensagem Única, a verificação e envio será feita pelo job LjiSendEAI , este verificará os registros com o status de integração (L1_SITUA =
RX) e fará a chamada do EAI para envio, os campos necessários estão informados no XSD RetailSales_1_001.xsd, após a integração, se o retorno do sistema RM for OK, o campo L1_SITUA receberá o conteúdo OK, informando assim ao sistema
Protheus que a integração foi bem sucedida, caso retorno seja de erro, o campo L1_SITUA receberá o conteúdo ER, através do monitor EAI é possível verificar o motivo da divergência, após correção, basta alterar o conteúdo do campo L1_SITUA
para RX para que seja feita uma nova tentativa de integração.
Importante
As vendas emitidas e integradas corretamente não poderão ser alteradas, para estes casos, deverá haver cancelamento da venda e em seguida, refazê-la no Sistema Protheus.
Importante
O Job GravaBatch para geração das informações BackOffice não deverá ser configurado pois todo o controle será feito pelo sistema RM.
Importante
O envio das integrações de vendas serão de forma automática através do Job LjiSendEAI, sua configuração está detalhada em Configurações de ambiente.
Importante
A integração de venda será habilitada através do parâmetro MV_LJRMBAC.
Inclusão:
1. Após a inclusão de Cupom Fiscal ou RPS no sistema Protheus, no Configurador (SIGACFG), acesse Ambiente / Schedule / De-Para de Mensagem Única (APCFG070).
O sistema Protheus apresenta De-Para das integrações com o Sistema RM, localize o campo Alias com conteúdo SL1, após localize pelos campos Valor Externo que é a chave RM e Valor Interno que é a chave Protheus o item incluído.
2. Acesse no SigaLoja (SIGALOJA), Atualizações / Atendimento / Venda Assistida.
Sistema apresenta as Vendas existentes, se foi integrada corretamente estará com status de finalizada (L1_SITUA = OK)
Alteração:
Após a integração de Venda, não será possível fazer alterações, esta venda deverá ser excluída e refeita.
Exclusão:
Cancelamento de Cupom Fiscal/RPS
Os Cancelamentos de Vendas Varejo (Cupom Fiscal e RPS) serão realizadas no Sistema Protheus (Front Loja ou Totvs Pdv), estas serão integradas com a Retaguarda (SigaLoja) através dos processos já existentes no sistema Protheus.
Na Retaguarda (SigaLoja), os cancelamentos de vendas serão integradas para o sistema RM através de comunicação via Mensagem Única, a verificação e envio será feita pelo job LjiSendEAI , este verificará os registros com o status de
integração (LX_SITUA = RX) e fará a chamada do EAI para envio, após a integração, se o retorno do sistema RM for OK, o campo LX_SITUA receberá o conteúdo OK, informando assim ao sistema Protheus que a integração foi bem sucedida,
caso retorno seja de erro, o campo LX_SITUA receberá o conteúdo ER, através do monitor EAI é possível verificar o motivo da divergência, após correção, basta alterar o conteúdo do campo LX_SITUA para RX para que seja feita uma nova
tentativa de integração.
Os cancelamentos de vendas possuem duas modalidades:
1 – Cancelamento de uma venda já integrada ao BackOffice, ocorre quando a venda foi finalizada, após, efetuado seu cancelamento no Pdv, constará no sistema RM, a integração se dará pela rotina de venda, porém, com a tag correspondente (IsCanceled) com o valor indicando que trata-se de uma venda cancelada, os campos necessários estão informados no XSD RetailSales_1_001.xsd.
2 – Cancelamento de uma venda não integrada ao BackOffice, ocorre quando o cliente desiste da venda antes de sua finalização no Pdv, neste caso, não constará no sistema RM, a integração se dará pela rotina de venda, porém, com a tag correspondente (IsCanceled) com o valor indicando que trata-se de uma venda cancelada, os campos necessários estão informados no XSD RetailSales_1_001.xsd.