Contexto de negócio (Introdução)

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

Modulo: Gestão Financeira

Solution: RM.Fin.TotvsMessage.Adapter

Identificador	Versão	Forma de Envio	Tipo do Adapter
CUSTOMERVENDOR	2.000	Síncrona	Envia
	2.002	Síncrona	Envia
	2.003	Síncrona	Envia

Escopo:

Pacote	Entidade	Versão	Envia	Recebe
TOTVS Folha pagto RM x Backoffice Protheus	Fornecedor	2.003	Não	Sim
TOTVS Folha pagto RM x Backoffice Protheus	Cliente	-	Não	Não

Mapeamento de Campos de Envio

Tabela: FCFO

Mensagem Padrão	Descrição	Campo	Valor	Tipo Campo	Tamanho	Versão
Mensagem Padrão	Descrição	Campo	Valor	Tipo Campo	Tamanho	1.000	2.000	^2.002	2.003	2.004
CompanyId	Código da empresa	CODCOLIGADA		DCODCOLIGADA	2				CODCOLIGADA
CompanyIntern alId	InternalId da empresa	CODCOLIGADA							2.003
Code	Código do fornecedor	CODCFO		varchar	25				2.003
StoreId	Loja								2.003
InternalId	InternalId do fornecedor	CODCOLIGADA	CODCFO						2.003
ShortName	Nome reduzido	NOMEFANTASIA		varchar	100				2.003
Type	Tipo	PAGREC	[Se Type = 'Customer'] PagRec=1 Senão se Type = 'Vendor' PagRec=2 Senão PagRec = 3	smallint	2				2.003
EntityType	Tipo do registro	PESSOAFISOUJUR	[Se EntityType = 'Person'] PessoaFisOuJur= F Senão PessoalFisOuJus= J	varchar	1				2.003
RegisterSituatio n	Situação	ATIVO	Se RegisterSituation = 'Active'] Ativo=1 Senão Ativo=0	smallint	2				2.003
GovernmentalI nformation. Id Name[CNPJ]	CNPJ/CPF	CGCCFO	Se Id[Name]= CPF'] ou Id[Name]= CNPJ'] CGCCFO=1 Senão Ativo=0	varchar	20				2.003
Address.Addre ss	Nome da rua	RUA		varchar	100				2.003
Address.Numb er	Número	NUMERO		varchar	8				2.003
Address.Compl ement	Complemento	COMPLEMENTO		DCOMPLEMENTO	60				2.003
Address.City.Ci tyInternalId	Código do município	CODMUNICIPIO		varchar	20				2.003
Address.City.Ci tyDescription	Nome cidade	CIDADE		DCIDADE	32				2.003
Address.District	Bairro	BAIRRO		DBAIRRO	80				2.003
Address.State. StateInternalId	Código do Estado	CODETD		varchar	2				2.003
Address.State. StateDescriptin	Descrição do estado	DESCETD							2.003
Address.Countr y.CountryIntern alId	Codigo do país	IDPAIS		smallint	2				2.003
Address.Countr y.CountryDescr iption	Nome do país	PAIS		varchar	20				2.003
Address.ZIPCo de	Cep	CEP		DCEP	9		CEP	CEP	CEP	CEP
Address.POBo x	Caixa postal	CAIXAPOSTAL		varchar	10				2.003
ListOfCommuni cationInformati on.Communicat ionInformation. PhoneNumber	Telefone	TELEFONE	CommunicationInfor mation [1]/PhoneNu mber [Primeira posição na lista de telefones da mensagem]	varchar	15		Não contem	Não contem	FaxNum	~~FaxNum~~
ListOfCommuni cationInformati on.Communicat ionInformation. FaxNumber	Fax	FAX	CommunicationInfor mation[1] /FaxNumb er [Primeira posição na lista de fax da mensagem]	varchar	15				2.003
ListOfCommuni cationInformati on.Communicat ionInformation. Email	E-mail	EMAIL	CommunicationInfor mation[1] /E-mail [Primeira posição na lista de e-mail da mensagem]	varchar	60				2.003

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.

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.

Temporário

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.

MATA020

CUSTOMERVENDOR

Sim

Não

Síncrono

Todas

EAI

2.003

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

Testes Realizados:

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);

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 / forncedor refletido no Protheus.

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