Histórico da Página

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Informações Gerais

Especificação

Produto

LOGIX

Módulo

WMS

Segmento Executor

Supply Chain

Projeto¹

LOGWMS01

IRM¹

Jira

server	JIRA Produção
serverId	0c783de1-186e-383b-975c-a1acd7d76cb5
key	LOGWMS01-545

Requisito¹

 Jira
serverJIRA Produção
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyLOGWMS01-884

Subtarefa¹

Chamado²

Não se aplica.

País

( X ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador

( ) USA ( ) Colombia ( ) Outro _____________.

Outros

Não se aplica.

Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).

Objetivo

Realizar a integração dos endereços de entrega dos clientes. Será previsto o envio e o recebimento destas informações.

Definição da Regra de Negócio

Aviso

title	Importante!

As informações referentes aos locais de entrega do cliente já são tratadas na mensagem CustomerVendor e continuarão da mesma forma, não sendo afetadas pelas alterações previstas nesta especificação.
A criação da mensagem exclusiva para integração dos locais de entrega (CustomerShippingAddress) visa atender à integração do WMS Logix com o TMS Protheus, onde estas informações não fazem parte do cadastro principal do cliente.
As duas mensagens (CustomerVendor e CustomerShippingAddress) poderão estar ativas no ambiente da integração, porém sempre que houver atualização de locais de entrega serão disparadas as duas mensagens, a primeira visando atualizar o cadastro de clientes do ERP Protheus e a segunda o TMS Protheus.

Rotina	Tipo de Operação	Opção de Menu	Regras de Negócio
EAIAdapterCustomerShippingAddress1	Criação		Adapter da mensagem CustomerShippingAddress
EAIHelperCustomerShippingAddress1	Criação		Helper da mensagem CustomerShippingAddress
VDPR248	Criação		Preparação de informações para integração de Locais de Entrega

Aviso

title	Atenção!

Os fontes EAIAdapterCustomerShippingAddress1 e EAIHelperCustomerShippingAddress1 devem ser gerados utilizando o programa EAI0032, conforme orientações para construção de adapters disponível no TDN (ver link 2. Geração Automática de Adapters). Ao gerar deixar desmarcada a opção "Gerar arquivo Master?".

Para que os fontes possam ser gerados será necessário utilizar o XSD da mensagem CustomerShippingAddress:

View file

name	CustomerShippingAddress_1_001.xsd
height	150

Dica

title	Dicas de como construir um adapter

Verificar as informações de cada página deste link: 3. Construção do Adapter

Para desenvolver o fonte VDPR248 considerar as regras abaixo:

************ VER ****************

Segue abaixo o detalhamento de cada tag existente na mensagem CustomerShippingAddress e como o sistema deverá tratar.

ENVIO:

Tag

Descrição

Regra a ser aplicada

CompanyId

Código da empresa

Código da empresa corrente (p_cod_empresa)

BranchId

Código da filial

NULO

CompanyInternalId

Chave interna da empresa

Código da empresa corrente (p_cod_empresa)

BranchInternalId

Chave interna da filial

NULO

CustomerCode

Código do cliente

Código do cliente ao qual pertence o local de entrega, recebido por parâmetro na função vdpr248_EAI_CustomerShippingAddress_envia().

¹GovernmentalInformation(¹)GovernmentalInformation.Id.Id

Identificação da informação

Deverá ser o número do CNPJ/CPF ou Inscrição Estadual (somente números).

Utilizar como base as lógicas existentes na função vdpr239_atualiza_business_content_Customer().

¹GovernmentalInformation(¹)GovernmentalInformation.Id.Attributes.scope

Escopo

Para CNPJ/CPF considerar o texto "Federal".

Para Inscrição Estadual considerar o texto "State".

¹GovernmentalInformation(¹)GovernmentalInformation.Id.Attributes.name

Nome da identificação

Para CNPJ considerar o texto "CNPJ".

Para CPF considerar o texto "CPF".

Para Inscrição Estadual considerar o texto "Inscricao Estadual".

¹GovernmentalInformation(¹)GovernmentalInformation.Id.Attributes.issueOn

Data em que a identificação foi emitida

NULO para CNPJ, CPF e Inscrição Estadual.

¹GovernmentalInformation(¹)GovernmentalInformation.Id.Attributes.expiresOn

Data de expiração da identificação

NULO para CNPJ, CPF e Inscrição Estadual.

InternalId

Chave interna do local de entrega

Concatenar o código do cliente e a sequência do local de entrega recebidos por parâmetro, separados por "|".

Exemplo: Cliente 1234, sequência local de entrega 3 => "1234|3"

Code

Código do local de entrega

Sequência do local de entrega recebido por parâmetro na função vdpr248_EAI_CustomerShippingAddress_envia().

ExternalId

Chave externa do local de entrega

NULO

²ShippingAddress(²)ShippingAddress.Address

Endereço

cli_end_ent_cobranca_entrega.logradouro / cli_end_ent.end_entrega

²ShippingAddress(²)ShippingAddress.Number

Número do endereço

cli_end_ent_cobranca_entrega.num_iden_lograd / NULO

²ShippingAddress(²)ShippingAddress.Complement

Complemento do endereço

cli_end_ent_cobranca_entrega.complemento_endereco / NULO

³ShippingAddress(³)ShippingAddress.City.CityCode

Código da cidade

clientes.cod_cidade / cli_ent_ent.cod_cidade

Nota

title	Nota

Verificar lógica existente na função vdpr239_retorna_endereco_cliente().

³ShippingAddress(³)ShippingAddress.City.CityInternalId

Chave interna da cidade

clientes.cod_cidade / cli_ent_ent.cod_cidade

³ShippingAddress(³)ShippingAddress.City.CityDescription

Descrição da cidade

cidades.den_cidade

²ShippingAddress(²)ShippingAddress.District

Bairro

cli_end_ent_cobranca_entrega.bairro_cobr_entga / cli_end_ent.den_bairro

³ShippingAddress(³)ShippingAddress.State.StateCode

Código do estado (UF)

cidades.cod_uni_feder

Nota

title	Nota

Verificar lógica existente na função vdpr239_retorna_endereco_cliente().

³ShippingAddress(³)ShippingAddress.State.StateInternalId

Chave interna do estado (UF)

cidades.cod_uni_feder

³ShippingAddress(³)ShippingAddress.State.StateDescription

Descrição do estado (UF)

uni_feder.den_uni_feder

³ShippingAddress(³)ShippingAddress.Country.CountryCode

Código do país

uni_feder.cod_pais

Nota

title	Nota

Verificar lógica existente na função vdpr239_retorna_endereco_cliente().

³ShippingAddress(³)ShippingAddress.Country.CountryInternalId

Chave interna do país

uni_feder.cod_pais

³ShippingAddress(³)ShippingAddress.Country.CountryDescription

Descrição do país

paises.den_pais

³ShippingAddress(³)ShippingAddress.ZIPCode

CEP

clientes.cod_cep / cli_end_ent.cod_cep

ShippingAddress.Region

Região

NULO

ShippingAddress.POBox

Caixa postal

NULO

(¹)Deverá gerar dois registros no record GovernmentalInformation: O primeiro para o CNPJ/CPF e o segundo para a Inscrição Estadual.

(²)Deverá ser analisado o parâmetro "vdp_utiliza_tela_endereco" (LOG00087):

Se estiver "S" deverá ser lida a tabela cli_end_ent_cobranca_entrega. Filtrar onde o tip_endereco seja igual a "E". Ordenar os registros pelo campo sequencia.
Se estiver "N" deverá ser lida a tabela cli_end_ent. Ordenar os registros pelo campo num_sequencia.

(³)Para estas tags não há correspondência na tabela cli_end_ent_cobranca_entrega. Neste caso deverá ser utilizada a informação padrão da tabela clientes.

RECEBIMENTO:

Tag	Descrição	Regra a ser aplicada
CompanyId	Código da empresa
BranchId	Código da filial
CompanyInternalId	Chave interna da empresa
BranchInternalId	Chave interna da filial
CustomerCode	Código do cliente
(¹)GovernmentalInformation.Id.Id	Identificação da informação
(¹)GovernmentalInformation.Id.Attributes.scope	Escopo
(¹)GovernmentalInformation.Id.Attributes.name	Nome da identificação
(¹)GovernmentalInformation.Id.Attributes.issueOn	Data em que a identificação foi emitida
(¹)GovernmentalInformation.Id.Attributes.expiresOn	Data de expiração da identificação
InternalId	Chave interna do local de entrega
Code	Código do local de entrega
ExternalId	Chave externa do local de entrega
(²)ShippingAddress.Address	Endereço
(²)ShippingAddress.Number	Número do endereço
(²)ShippingAddress.Complement	Complemento do endereço
(³)ShippingAddress.City.CityCode	Código da cidade
(³)ShippingAddress.City.CityInternalId	Chave interna da cidade
(³)ShippingAddress.City.CityDescription	Descrição da cidade
(²)ShippingAddress.District	Bairro
(³)ShippingAddress.State.StateCode	Código do estado (UF)
(³)ShippingAddress.State.StateInternalId	Chave interna do estado (UF)
(³)ShippingAddress.State.StateDescription	Descrição do estado (UF)
(³)ShippingAddress.Country.CountryCode	Código do país
(³)ShippingAddress.Country.CountryInternalId	Chave interna do país
(³)ShippingAddress.Country.CountryDescription	Descrição do país
(³)ShippingAddress.ZIPCode	CEP
ShippingAddress.Region	Região
ShippingAddress.POBox	Caixa postal

Fluxo do Processo

Cenários de Teste

Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.

Páginas filhas

Versões comparadas

Versão antiga 18

Nova versão 19

Chave

Informações Gerais

Objetivo

Fluxo do Processo

Cenários de Teste