Páginas filhas
  • ER LOGWMS01-884 IN-11.5 Integração Cadastro Locais Entrega

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 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

Projeto1

LOGWMS01

IRM1

Jira
serverJIRA Produção
serverId0c783de1-186e-383b-975c-a1acd7d76cb5
keyLOGWMS01-545

Requisito1

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

Subtarefa1

 

Chamado2

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
titleImportante!

  1. 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.

  2. 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.

  3. 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

EAIAdapterCustomerShippingAddress1Criação Adapter da mensagem CustomerShippingAddress
EAIHelperCustomerShippingAddress1Criação Helper da mensagem CustomerShippingAddress
VDPR248Criação Preparação de informações para integração de locais de entrega
VDP0815Alteração Manutenção do cadastro de cliente/fornecedor
VDP0834Alteração Manutenção dos endereços de entrega do cliente
VDP10000Alteração Manutenção do cadastro de cliente/fornecedor
VDP90079Alteração Manutenção dos endereços de entrega do cliente
VDP0831Alteração Manutenção da distribuição geográfica do cliente
VDP0833Alteração Manutenção dos endereços de cobrança do cliente
VDP90065Alteração Carga inicial de clientes
VDP90078Alteração Manutenção dos endereços de cobrança do cliente
WMSR62Alteração Cadastra automático de cliente
Aviso
titleAtençã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
nameCustomerShippingAddress_1_001.xsd
height150

Dica
titleDicas de como construir um adapter
Verificar as informações de cada página deste link: 3. Construção do Adapter


 VDPR248 - Preparação de informações para integração de locais de entrega

  • Criar a função vdpr248_EAI_CustomerShippingAddress_envia().
    • Parâmetros:
      • Operação: "IN" para inclusão; "MO" para modificação; "EX" para exclusão.
      • Cliente: Código do cliente.
      • Sequência: Sequência do endereço de entrega.
      • Modo de exibição: "0" (zero) para ONLINE ou "1" (um) para BATCH.
    • Retorno:
      • Status do processamento: TRUE caso tenha ocorrido com sucesso ou FALSE em caso de erro.
    • Regras:
      • Validar se o tipo de operação enviado por parâmetro é válido. Caso negativo gerar a mensagem "Tipo de operação inválida" e retornar FALSE.
      • Validar se foram enviados os parâmetros de cliente e sequência. Se um destes parâmetros estiver nulo gerar a mensagem "Informe o cliente e a sequência do endereço de entrega." e retornar FALSE.
      • Verificar se existe a função EAIHelperCustomerShippingAddress1_esta_configurado_para_envio() no repositório. Se não existir deverá retornar TRUE neste ponto, não efetuando os procedimentos seguintes.
      • Se existir esta função a mesma deverá ser invocada, caso retorne FALSE significa que a integração da mensagem CustomerShippingAddress não está habilitada e neste caso deverá retornar TRUE neste ponto, não efetuando os procedimentos seguintes.
      • A partir deste ponto serão executadas as lógicas para acionar a função de integração da mensagem.
      • Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S"deverá ser lida a tabela cli_end_det_cobranca_entregautilizando o código do cliente e sequência recebidos por parâmetro e onde o campo tip_endereco seja igual a "E".
      • Ler também a tabela cli_end_entutilizando o código do cliente e sequência recebidos por parâmetro.
      • Chamar a função EAIMapper_clear().
      • Chamar a função EAIHelperCustomerVendor2_set_MessageType()passando como parâmetro "upsert" caso o parâmetro de tipo de operação seja igual a "IN" ou "MO", ou passando "delete" caso o tipo de operação seja "EX".
      • Chamar a função EAIMapper_set() para cada uma das informações abaixo:

Campo

Conteúdo a utilizar
cli_end_det_cobranca_entrega.empresap_cod_empresa
cli_end_det_cobranca_entrega.clienteCódigo do cliente recebido por parâmetro
cli_end_det_cobranca_entrega.num_cgc_cpfCampo clientes.num_cgc_cpf
cli_end_det_cobranca_entrega.ins_estadualCampo clientes.estadual
cli_end_det_cobranca_entrega.sequenciaSequência do local de entrega recebido por parâmetro
cli_end_det_cobranca_entrega.tip_logradouro

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.tip_logradouro.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar NULO.

cli_end_det_cobranca_entrega.logradouro

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.logradouro.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.end_entrega.

cli_end_det_cobranca_entrega.num_iden_lograd

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.num_iden_lograd.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar NULO.

cli_end_det_cobranca_entrega.complemento_endereco

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.complemento_endereco.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar NULO. 

cli_end_det_cobranca_entrega.endereco_completo

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.endereco_completo.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.end_entrega

cli_end_det_cobranca_entrega.bairro_cobr_entga

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo cli_end_det_cobranca_entrega.bairro_cobr_entga.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.den_bairro.

cli_end_det_cobranca_entrega.cidade

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo clientes.cod_cidade.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.cod_cidade.


Nos dois casos, após definir a origem do código da cidade, utilizar a tabela obf_cidade_ibge para buscar o código IBGE a ser considerado (campo cidade_ibge).

cli_end_det_cobranca_entrega.cep

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo clientes.cod_cep.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.cod_cep.

den_cidadeCampo cidades.den_cidade
cli_end_det_cobranca_entrega.cod_uni_federCampo cidades.cod_uni_feder
cli_end_det_cobranca_entrega.den_uni_federCampo uni_feder.den_uni_feder
cli_end_det_cobranca_entrega.cod_paisCampo uni_feder.cod_pais
cli_end_det_cobranca_entrega.den_paisCampo uni_feder.den_pais
cli_end_det_cobranca_entrega.cep

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "S" considerar o campo clientes.cod_cep.

Se o parâmetro "vdp_utiliza_tela_endereco" for igual a "N" considerar o campo cli_end_ent.cod_cep.

      • Chamar a função Chamar a função EAIAdapterCustomerVendor2_SendBusinessMessage() enviando como parâmetro "upsert" ou "delete", conforme o tipo de operação recebido por parâmetro.
      • O status de retorno da função vdpr248_EAI_CustomerShippingAddress_envia() deverá ser conforme o processamento da integração, retornado a partir da chamada da função EAIAdapterCustomerVendor2_SendBusinessMessage().

 

EAIAdapterCustomerShippingAddress1 - Adapter da mensagem CustomerShippingAddress

  • Na função EAIAdapterCustomerShippingAddress1_Install() deverá ser realizado o registro do InternalId referente ao local de entrega, utilizando como base a tabela cli_end_det_cobranca_entrega:

    Bloco de código
    titleInstalação do adapter
    collapsetrue
    IF NOT EAI_depara_existe("CustomerShippingAddress", "cli_end_det_cobranca_entrega") THEN
       CALL EAI_depara_register("CustomerShippingAddress", "cli_end_det_cobranca_entrega", "cliente|sequencia")
    END IF

     

  • Na função EAIAdapterCustomerShippingAddress1_LoadUsualContent() setar as informações da variável utilizada para a integração, conforme abaixo:

cidades.cod_uni_feder

TagDescriçãoRegra a ser aplicada
CompanyIdCódigo da empresaEAIMapper_getString("cli_end_det_cobranca_entrega.empresa")
BranchIdCódigo da filialNULO
CompanyInternalIdChave interna da empresaEAIMapper_getString("cli_end_det_cobranca_entrega.empresa")
BranchInternalIdChave interna da filialNULO
CustomerCodeCódigo do clienteEAIMapper_getString("cli_end_det_cobranca_entrega.cliente")
(¹)GovernmentalInformation.Id.IdIdentificação da informação

EAIMapper_getString("cli_end_det_cobranca_entrega.num_cgc_cpf")

Deverá ser aplicado um tratamento para extrair apenas os números do CNPJ/CPF ou Inscrição Estadual retornados pela função acima.

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

(¹)GovernmentalInformation.Id.Attributes.scopeEscopo

Para CNPJ/CPF considerar o texto "Federal".

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

(¹)GovernmentalInformation.Id.Attributes.nameNome 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.Id.Attributes.issueOnData em que a identificação foi emitidaNULO para CNPJ, CPF e Inscrição Estadual.
(¹)GovernmentalInformation.Id.Attributes.expiresOn  Data de expiração da identificaçãoNULO para CNPJ, CPF e Inscrição Estadual.
InternalIdChave interna do local de entrega

Concatenar o retorno das funções EAIMapper_getString("cli_end_det_cobranca_entrega.cliente") e EAIMapper_getInt("cli_end_det_cobranca_entrega.sequencia"), separando-os com "|" (pipe) e considerando a sequência com cinco dígitos, com zeros à esquerda.

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

CodeCódigo do local de entregaEAIMapper_getInt("cli_end_det_cobranca_entrega.sequencia")
ExternalIdChave externa do local de entregaNULO
(²)ShippingAddress.AddressEndereço

Se o retorno de EAIMapper_getString("cli_end_det_cobranca_entrega.tip_logradouro") for diferente de nulo e diferente de branco considerar:

EAIMapper_getString("cli_end_det_cobranca_entrega.tip_logradouro") + " " + EAIMapper_getString("cli_end_det_cobranca_entrega.logradouro")

caso contrário, apenas:

EAIMapper_getString("cli_end_det_cobranca_entrega.logradouro")

(²)ShippingAddress.NumberNúmero do endereço

EAIMapper_getString("cli_end_det_cobranca_entrega.num_iden_lograd")

(²)ShippingAddress.ComplementComplemento do endereço

EAIMapper_getString("cli_end_det_cobranca_entrega.complemento_endereco")

(³)ShippingAddress.City.CityCodeCódigo da cidade

 

EAIMapper_getString("cli_end_det_cobranca_entrega.cidade")

(³)ShippingAddress.City.CityInternalIdChave interna da cidade EAIMapper_getString("cli_end_det_cobranca_entrega.cidade")
(³)ShippingAddress.City.CityDescriptionDescrição da cidade (²)ShippingAddress.DistrictBairroEAIMapper_getString("cli_end_det_cobranca_entrega.bairro_cobr_entga / cli_end_ent.den_bairrocidade")
(³)ShippingAddress.State.StateCodeCódigo do estado (UF)
Nota
titleNota

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

(³)ShippingAddress.State.StateInternalIdChave interna do estado (UF)

cidades.cod_uni_feder

DistrictBairro

EAIMapper_getString("cli_end_det_cobranca_entrega.bairro_cobr_entga")

ShippingAddress.State.StateCodeCódigo (³)ShippingAddress.State.StateDescriptionDescrição do estado (UF)uni_feder.denEAIMapper_getString("cli_end_det_cobranca_entrega.cod_uni_feder(³)ShippingAddress.Country.CountryCodeCódigo do país")

###############AQUI##############

uni_feder.cod_pais

Nota
titleNota

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


(³)ShippingAddress.CountryState.CountryInternalIdStateInternalIdChave interna do paísestado (UF)

EAIMapper_getString("cli_end_det_cobranca_entrega.cod_uni_feder.cod_pais")

(³)ShippingAddress.CountryState.CountryDescriptionStateDescriptionDescrição do paíspaises.den_pais(³)ShippingAddress.ZIPCodeCEPestado (UF)EAIMapper_getString("clientes.cod_cep / cli_end_ent.cod_cepShippingAddress.RegionRegiãoNULOShippingAddress.POBoxCaixa postalNULO

(¹)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 (³)Para estas tags não há correspondência na tabela
det_cobranca_entrega.den_uni_feder")
ShippingAddress.Country.CountryCodeCódigo do paísEAIMapper_getString("cli_end_det_cobranca_entrega.cod_pais")

##################AQUI##################

Nota
titleNota

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


ShippingAddress.Country.CountryInternalIdChave interna do país

EAIMapper_getString("cli_end_det_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.
  • cod_pais")

    ShippingAddress.Country.CountryDescriptionDescrição do paísEAIMapper_getString("cli_end_det_cobranca_entrega.den_pais")
    ShippingAddress.ZIPCodeCEPUtilizar o EAIMapper_getString("
    cli_end_det_cobranca_entrega.cep"), efetuando tratamento para utilizar apenas os números (ver como exemplo a função vdpr239_retorna_valor_valido()).
    ShippingAddress.RegionRegiãoNULO
    ShippingAddress.POBoxCaixa postalNULO

    (¹)Deverá gerar dois registros no record GovernmentalInformation: O primeiro para o CNPJ/CPF e o segundo para a Inscrição Estadual. Neste caso deverá ser utilizada a informação padrão da tabela clientes.

     







    RECEBIMENTO - Upsert:

    • Inicialmente deverá ser utilizada a função EAI_depara_get_value() para verificar se existe o local de entrega já cadastrado no Logix para a chave interna enviada na mensagem.

      Bloco de código
      titleBuscando o InternalId
      collapsetrue
      LET l_internalValue = EAI_depara_get_value("CustomerShippingAddress",
                                                 _advpl_eai_get_message_info(g_eai_msg_negocio, 'MessageInformation.SourceApplication'),
                                                 EAIHelperCustomerShippingAddress1_get_BusinessContent_InternalId())
    • Se o conteúdo da variável l_internalValue for diferente de nulo deverá ser chamada a função EAI_depara_InternalId_get_value() para obter o código do cliente e a sequência do local de entrega.

      Bloco de código
      titleIdentificando o cliente e o sequência do local de entrega
      collapsetrue
      IF l_internalValue CLIPPED IS NOT NULL THEN
          LET l_cliente = EAI_depara_internalid_get_value('CustomerShippingAddress'    ,  #depara_id
                                                          l_internalValue ,               #valor interno
                                                          'cli_end_det_cobranca_entrega', #tabela interna
                                                          'cliente' )                     #Campo interno 
          LET l_sequencia = EAI_depara_internalid_get_value('CustomerShippingAddress'    ,  #depara_id
                                                            l_internalValue ,               #valor interno
                                                            'cli_end_det_cobranca_entrega', #tabela interna
                                                            'sequencia')                    #Campo interno 
      END IF 

       

    • Se o conteúdo da variável l_internalValue for igual a nulo deverá considerar o conteúdo da tag Code para a variável l_sequencia.

    • Se o conteúdo da variável l_internalValue for igual a nulo deverá tentar localizar o cliente pela conteúdo da tag GovernmentalInformation, buscando pelo CNPJ e Inscrição Estadual (campos num_cgc_cpf e ins_estadual, respectivamente). Caso encontre deverá armazenar o código do cliente na variável l_cliente.

    • Se depois da lógica acima o cliente ainda não puder ser identificado, considerar o conteúdo da tag CustomerCode para a variável l_cliente.

       
    • Se as variáveis referentes ao cliente (l_cliente) e sequência do local entrega (l_sequencia) não estiverem nulos, verificar se existe o registro correspondente na tabela de locais de entrega (considerar o parâmetro "vdp_utiliza_tela_endereco" para pesquisar na tabela cli_end_det_cobranca_entrega caso seja "S" ou na cli_end_ent caso seja "N").

    • Se encontrar o registro correspondente deverá ser considerado como alteração deste local de entrega, caso contrário deverá ser considerada inclusão de um novo local de entrega.

    • Para incluir/alterar o local de entrega deverá ser analisado o parâmetro "vdp_utiliza_tela_endereco" (LOG00087). Se estiver "S" deverá ser gravada a tabela cli_end_det_cobranca_entrega:

      CampoConteúdo a ser gravado
      clienteVariável l_cliente
      tip_endereco'E'
      sequenciaVariável l_sequencia
      tip_logradouroVerificar se no início da tag ShippingAddress.Address existe a palavra "RUA ", "R " ou "R: ".
      Se existir, pesquisar na tabela vdp_tip_logradouro por esta descrição de logradouro (campo des_logradouro).
      Se encontrar o registro, considerar o conteúdo do campo tip_logradouro.
      Se o início da tag não estiver conforme indicado inicialmente ou não encontrar o registro na vdp_tip_logradouro este campo deverá ficar nulo.
      logradouroTag ShippingAddress.Address
      num_iden_logradTag ShippingAddress.Number
      complemento_enderecoTag ShippingAddress.Complement
      endereco_completoConcatenar os conteúdos abaixo, separando cada um com um espaço em branco:
      * Tag ShippingAddress.Address
      * Tag ShippingAddress.Number
      * Tag ShippingAddress.Complement
      * Tag ShippingAddress.District
      bairro_cobr_entgaTag ShippingAddress.District
    • Independente do valor do parâmetro "vdp_utiliza_tela_endereco", sempre deverá ser gravada a tabela cli_end_ent:

      CampoConteúdo a ser gravado
      cod_clienteVariável l_cliente
      end_entregaSe a tag ShippingAddress.Number não estiver nula considerar ShippingAddress.Address + ShippingAddress.Number (separando as duas tags com um espaço em branco), caso contrário considerar somente ShippingAddress.Address
      den_bairroTag ShippingAddress.District
      cod_cidade

      Primeiramente deverá ser verificado se existe relacionamento de/para para o código interno da cidade, caso a tag ShippingAddress.City.CityInternalId esteja preenchida. Se existir deverá utilizar a função para EAI_depara_InternalId_get_value() para identificar o código da cidade do Logix. Se não encontrar a cidade seguindo as regras acima deverá tentar localizar a cidade utilizando a tag ShippingAddress.City.CityCode, buscando pelo código IBGE. Se não existir deverá gerar mensagem de erro de que não foi possível identificar a cidade.

      Bloco de código
      titleBuscar o código da cidade Logix
      collapsetrue
      LET l_cidade_logix = NULL
      IF EAIHelperCustomerShippingAddress1_get_BusinessContent_ShippingAddress_City_CityInternalId() IS NOT NULL AND
         EAIHelperCustomerShippingAddress1_get_BusinessContent_ShippingAddress_City_CityInternalId() <> ' ' THEN
         LET l_InternalId = EAI_depara_get_value('City',
                                                 _advpl_eai_get_message_info(g_eai_msg_negocio, 'MessageInformation.SourceApplication'),
                                                 EAIHelperCustomerShippingAddress1_get_BusinessContent_ShippingAddress_City_CityInternalId())
         IF l_InternalId IS NOT NULL AND
            l_InternalId <> ' ' THEN
            LET l_cidade_logix = EAI_depara_InternalId_get_value('City',
                                                                 l_InternalId,
                                                                 NULL,
                                                                 'cod_cidade')
         END IF
      END IF
         
      IF l_cidade_logix IS NULL OR
         l_cidade_logix = ' ' THEN
         WHENEVER ERROR CONTINUE
           SELECT cidade_logix
             INTO l_cidade_logix
             FROM cidades, obf_cidade_ibge
            WHERE cidade_ibge = _BusinessContent._ShippingAddress._City._CityCode
              AND cod_cidade = cidade_logix
         WHENEVER ERROR STOP
         IF sqlca.sqlcode <> 0 THEN
            CALL log0030_processa_mensagem('Código da cidade informado na integração inexistente.','excl',1)
            RETURN FALSE
         END IF
      END IF
      IF l_cidade_logix IS NULL OR
         l_cidade_logix = ' ' THEN
         CALL log0030_processa_mensagem('Não foi possível identificar a cidade na integração.','excl',1)
         RETURN FALSE
      ELSE
         WHENEVER ERROR CONTINUE
           SELECT cod_cidade
             FROM cidades
            WHERE cod_cidade = l_cidade_logix
         WHENEVER ERROR STOP
         IF sqlca.sqlcode <> 0 THEN
            CALL log0030_processa_mensagem('Código da cidade informado na integração inexistente.','excl',1)
            RETURN FALSE
         END IF
      END IF
      cod_cepTag ShippingAddress.ZIPCode
      num_cgcCampo num_cgc_cpf da tabela clientes
      ins_estadualCampo ins_estadual da tabela clientes
      num_sequenciaVariável l_sequencia
      cod_rotaCampo cod_rota da tabela clientes
      cod_localCampo cod_local da tabela clientes
      cod_pracaCampo cod_praca da tabela clientes

     

    RECEBIMENTO - Delete:

    • Inicialmente deverá ser utilizada a função EAI_depara_get_value() para verificar se existe o local de entrega cadastrado no Logix para a chave interna enviada na mensagem.

      Bloco de código
      titleBuscando o InternalId
      collapsetrue
      LET l_internalValue = EAI_depara_get_value("CustomerShippingAddress",
                                                 _advpl_eai_get_message_info(g_eai_msg_negocio, 'MessageInformation.SourceApplication'),
                                                 EAIHelperCustomerShippingAddress1_get_BusinessContent_InternalId())
    • Se o conteúdo da variável l_internalValue for diferente de nulo deverá ser chamada a função EAI_depara_InternalId_get_value() para obter o código do cliente e a sequência do local de entrega.

      Bloco de código
      titleIdentificando o cliente e o sequência do local de entrega
      collapsetrue
      IF l_internalValue CLIPPED IS NOT NULL THEN
          LET l_cliente = EAI_depara_internalid_get_value('CustomerShippingAddress'    ,  #depara_id
                                                          l_internalValue ,               #valor interno
                                                          'cli_end_det_cobranca_entrega', #tabela interna
                                                          'cliente' )                     #Campo interno 
          LET l_sequencia = EAI_depara_internalid_get_value('CustomerShippingAddress'    ,  #depara_id
                                                            l_internalValue ,               #valor interno
                                                            'cli_end_det_cobranca_entrega', #tabela interna
                                                            'sequencia')                    #Campo interno 
      END IF 

       

    • Se o conteúdo da variável l_internalValue for igual a nulo deverá considerar o conteúdo da tag Code para a variável l_sequencia.

    • Se o conteúdo da variável l_internalValue for igual a nulo deverá tentar localizar o cliente pela conteúdo da tag GovernmentalInformation, buscando pelo CNPJ e Inscrição Estadual (campos num_cgc_cpf e ins_estadual, respectivamente). Caso encontre deverá armazenar o código do cliente na variável l_cliente.

    • Se depois da lógica acima o cliente ainda não puder ser identificado, considerar o conteúdo da tag CustomerCode para a variável l_cliente.
       
    • Se as variáveis referentes ao cliente (l_cliente) e sequência do local entrega (l_sequencia) não estiverem nulos, verificar se existe o registro correspondente na tabela de locais de entrega (considerar o parâmetro "vdp_utiliza_tela_endereco" para pesquisar na tabela cli_end_det_cobranca_entrega caso seja "S" ou na cli_end_ent caso seja "N").

    • Se não encontrar o registro correspondente deverá apenas retornar TRUE como se a exclusão tivesse ocorrido normalmente, apenas para evitar erro no aplicativo de origem.

    • Se encontrar o registro deverá realizar a exclusão dos registros nas tabelas cli_end_det_cobranca_entrega e cli_end_ent, pesquisando pelo código do cliente e sequência do local de entrega.

     
     

    VDP0815 - Manutenção do cadastro de cliente/fornecedor

     

     

    VDP0834 - Manutenção dos endereços de entrega do cliente

     

     

    VDP10000 - Manutenção do cadastro de cliente/fornecedor

     

     

    VDP90079 - Manutenção dos endereços de entrega do cliente

     

     

    VDP0831 - Manutenção da distribuição geográfica do cliente

     

     

    VDP0833 - Manutenção dos endereços de cobrança do cliente

     

     

    VDP90065 - Carga inicial de clientes

     

     

    VDP90078 - Manutenção dos endereços de cobrança do cliente

     

     

    WMSR62 - Cadastra automático de cliente

     

     


    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.