...

Adpater responsável pelo cadastro de Cliente x Fornecedor com o BackOffice RM, assim viabilizando o CRUD completo do cadastro por recebimento / envio de mensagem de integração.            

• Foram criado três novos campos para cliente / fornecedor, 
  - Código Externo, Código de loja e Código de filial de integração.
   
• São habilitado na tela de cliente / fornecedor quando EAI 2.0 Ativo.
• São habilitado para edição quando entidade CUSTOMERVENDOR parametrizada para envio.
• Particularidade para o código de filial de integração, pois sua visualização / edição dependem do nível de compartilhamento, quando exclusivo por filial no Protheus); 
•  Ao efetuar o conversor, será acertado todos os cadastros já existentes na base para que os mesmo contemplem código externo e filial.

Regras para código Externo

O código externo foi criado para armazenamos o código do cliente / fornecedor do sistema integrado.

Exemplo:

Dessa forma é possível realizar uma pesquisa no RM pelo código externo que representa o código do sistema integrado.

• • Envio de RM
    
    
    • Ao incluir um novo registro no RM para Cliente / Fornecedor, será necessário informar para o código externo qual o código no sistema de origem.
      Caso o código do cliente / fornecedor seja gerado através de auto incremento, ("Parâmetro do financeiro Usar código sequencial'). foi criado o parâmetro "CODEXTERNOIGUALOCFO" para que
      o código externo acompanhe o código do cliente / fornecedor RM. Dessa forma, o Código externo é gerado automaticamente. Caso o parâmetro "CODEXTERNOIGUALOCFO"  esteja
      desabilitado, será obrigatório informar o código externo no momento da inclusão do Cliente / Fornecedor. 
    • Se a integração SIGAMNT x BackOffice RM no EAI 2.0 está ativa os campos: Código Externo, Código Loja e Filial de Integração não ficam habilitados no cadastro de Cliente/Fornecedor.
       
       
  • Recebimento RM
    
    • Com o objetivo de manter o código externo identifico ao sistema integrado,  código externo sempre é alterado no RM no recebimento da mensagem.
      

Modulo: Gestão Financeira

Solution: RM.Fin.TotvsMessage.Adapter

Escopo:

Mapeamento de Campos de Envio

Tabela: FCFO

...

Parâmetros:

CODCLASSIFICPAIS: Este parâmetro tem a responsabilidade de ser o código da tabela de classificação de país. Como o código do País no Protheus é baseado na tabela de classificação do IBGE, deve-se
cadastrar esta tabela no RM (BackOffice / Gestão Fiscal / Mais... / Endereços / Classificação de País.) e definir nos parâmetros de integração qual será o código desta tabela.
    No cadastro de Classificação de País incluir uma tabela de classificação.
    No cadastro de País abrir o anexo Codificação de País e incluir a tabela de classificação informando o Código País.
    Nos Parâmetros de Integração informar no parâmetro "CODCLASSIFICPAIS" o código da tabela de classificação utilizada e associado ao país.

Envio

• Quando for informado no RM um endereço com país diferente de Brasil, o código e a descrição do Estado será enviado como EX e ESTRANGEIRO. Esta regra será aplicada para os endereços: principal (Address), cobrança (BillingInformation) e entrega (ShippingAddress )

Recebimento

• Para o recebimento, não é permitido o recebimento cujo o tipo do cliente / fornecedor seja ambos.
• Não é permitido o recebimento de cliente Global.
• Caso o nível de compartilhamento do Protheus seja compartilhado por filial, o novo campo de código de filial ser preenchido como vazio.
• Caso o nível de compartilhamento no Protheus seja exclusivo por filial, o novo campo de código de filial recebera o seu valor.
• Não deve configurar a mascara de cliente / fornecedor;
• Caso o código do cliente / fornecedor seja por auto-incremento, deve configurar o parâmetro do financeiro Usar código sequencial.
• Quando integrado com Protheus, e o código não for por auto-incremento, existem dois parâmetros para definir o tamanho do código da loja e código do cliente / fornecedor. Isso é aplicado pelo chamada do PVI.

...

Testes Realizados:

RM Folha x BackOffice Protheus

CustomerVendor_2_003.xsd

Envio de Fornecedor do Protheus, módulo Financeiro, para o RM Labore

Não faz parte : Envio ou recebimento de Clientes através da mensagem CUSTOMERVENDOR.

As configurações iniciais desta integração criará um parâmetro chamado "RH_CLIFORAUTOINC" que irá definir se utiliza Auto incremento ou não para o campo "FCFO.CODCFO".
Caso o parâmetro não seja "De auto incremento", a máscara do código do Cliente/Fornecedor deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Protheus:

Ex: "QQQQQQQQ". [Permite qualquer caractere limitado a 8 posições].

Caso o parâmetro seja de "auto incremento", a máscara deve ser definida como "" (vazio) e o parâmetro do financeiro "Usar código sequencial (se máscara for numérica)" deve ser marcado.

RM TIN/TOP  x BackOffice Protheus

/*Geração da chave do CLI/FOR para quando estiver com a integração do TIN/TOP x Protheus

            * habilitada e com o parâmetro CLIFORAUTOINC como FALSE.

            **/

1000    TOTVS Incorporação x BackOffice Protheus

0    CLIFORAUTOINC    False

0    CLIFORGLOBAL    False

Dúvidas

-Cliente fornecedor
-CODMUNICIPIO
por que o existem o código municipio > 5 para cliente fornecedor
if (!String.IsNullOrEmpty(codMunicipio) && codMunicipio.Length > 5)
rowMensagemOrigem["CODMUNICIPIO"] = codMunicipio.Substring(codMunicipio.Length - 5);

Envio RM >> Protheus

1-Acessado Nova MDI >> BackOffice >> Cadastro>> Cliente / Fornecedor
1.1 Cadastrando Cliente /  fornecedor
1.1.1 Erro: " Um ou mais campos obrigatórios não foram preenchidos. xxxxxxxxxxxxxxxxxx -> xxxxxxxxxx Pasta Código."
                 ( Houve inconsistências com valor padrão / Inicializador de código no Protheus para o código de cliente / Fornecedor). Foi necessário remover o inicializador padrão de  A1_COD no Protheus.

1.1.2 Parâmetros utilizados neste teste.

• Desabilitado - Usar código Sequencial ( se a mascara for numérica)
• Vazio           - Mascara para o código de cliente / fornecedor.

Com essas opções, como o código de cliente / fornecedor é gerado? Porque o campo o código de cliente / fornecedor esta sempre bloqueado na tela, quando EAI2.0 Ativo.?
O código de cliente fornecedor "CODCFO" é gerado a partir das informações dos novos campos: CODEXTERNO, CODLOJA E CODFILIALINTEGRACAO.

O CODCFO é concatenado com :

• • CODLOJA  ( código da loja ("código da loja é gerado com zero a esquerda conforme o parametro "SIZECODLOJA")
  • SEPARADOR  ponto e virgula. ";"
  • PAGREC ( Quando Cliente = "C"  quando fornecedor = "F")
  • CODEXTERNO ( Informado pelo usuário através da tela de cadastro de cliente / fornecedor
  • CODFILIALINTEGRACAO ( Retorna o código filial quando o nível de compartilhamento for exclusivo por filial no Protheus, caso contrário vazio); 

1.1.3 Quando a inclusão do cliente / fornecedor é gerado por terceiros, "PVI, através de dataserver" o Código será gerado com base no ultimo cliente / fornecedor gerado +1;

1.2 Mensagem enviada ao Protheus com sucesso. Registro Incluído Corretamente. 

1.3 Alterado registro no RM >> cliente / Fornecedor refletido no Protheus.

1.3 Excluído registro no RM >> cliente / Fornecedor refletido no Protheus.

2.0 - Testado a tela de cadastro de cliente / fornecedor conforme os novos campos: Código Externo, Código de loja e Código de filial de integração.

• São habilitado na tela de cliente / fornecedor quando EAI 2.0 Ativo.
• São habilitado para edição quando entidade CUSTOMERVENDOR parametrizada para envio.
• Particularidade para o código de filial de integração, pois sua visualização / edição dependem do nível de compartilhamento, quando exclusivo por filial no Protheus); 

3.0 - Caso o Protheus esteja configurado com o campo código com default, o código externo enviado do RM é desconsiderado pelo Protheus, colocando o seu código sequencial de sua tabela.