Modificando detalhes do cliente

Solução

Um usuário pode modificar os detalhes de um cliente, executando as seguintes tarefas:

• Designar um contato diferente a um cliente de negócio
• Modificar o endereço de um cliente de negócio ou cliente consumidor

Um usuário pode designar um contato diferente a um cliente de negócio. A API getCustomerDetails é chamada para preencher a lista suspensa Contato na tela Detalhes da oportunidade. Um usuário também pode criar um novo contato e designar o contato ao cliente de negócio na caixa de diálogo Incluir novo contato.

Um usuário pode modificar as informações de endereço de um cliente de negócio ou um cliente consumidor em uma oportunidade. Um usuário pode selecionar um endereço existente ou incluir um novo endereço para o cliente ou o contato. A API getCustomerDetails é chamada para preencher a lista suspensa Endereços existentes na caixa de diálogo Editar endereço.

Na caixa de diálogo Incluir novo contato e na caixa de diálogo Editar endereço, os nomes da cidade e do estado em que o cliente ou o contato reside podem ser derivados dos campos país ou região e Código de endereçamento postal, se a empresa tiver definido um esquema de região no Channel Applications Manager.

A API getRegionList é chamada para recuperar os nomes da cidade e estado. O esquema de região chamado corresponde à empresa à qual o usuário pertence. Se diversos valores forem recuperados para os nomes de cidade e estado, o primeiro valor retornado pela API getRegionList será exibido.

Quando um endereço é incluído ou modificado, a API verifyAddress é chamada para verificar o endereço. Se a verificação de endereço falhar e o Address Verification System (AVS) retornar vários endereços, o usuário poderá selecionar um endereço da lista. A API manageCustomer é chamada para salvar as mudanças feitas nas informações de contato e de endereço de um cliente. Quando um novo endereço é incluído para um cliente ou um contato, ele é salvo no cliente ou no contato como um endereço adicional. Se o sinalizador AllAddressesVerified for passado como ''Y'' no XML de entrada da API verifyAddress, o Sterling™ Field Sales não tentará verificar nenhum endereço na oportunidade ou cotação, a menos que algum deles seja alterado.

A API manageOpportunity é chamada para salvar as mudanças feitas na oportunidade.

Solução de saída de usuário de verificação de endereço

O user exit YCDVerifyAddressWithAVSUE permite que o Sterling Field Sales interaja com o AVS externo. A saída de usuário YCDVerifyAddressWithAVSUE é chamada a partir da API verifyAddress. A saída de usuário retorna uma saída XML, que é igual à saída da API verifyAddress. Para obter mais informações sobre o user exit YCDVerifyAddressWithAVSUE, consulte o IBM Sterling® Order Management: Javadoc.

O atributo AVSReturnCode retornado pela API verifyAddress e a saída de usuário YCDVerifyAddressWithAVSUE pode ter os seguintes valores:

• VERIFIED se o endereço for válido.
• FAILED se o endereço não for válido.
• AVS_DOWN se o sistema AVS não puder se conectar.

Impacto no usuário final

Com base na configuração, o campo Estado é exibido como uma lista suspensa ou uma caixa na caixa de diálogo Incluir novo contato e na caixa de diálogo Editar endereço.

implementação

Esta seção explica as configurações para essa funcionalidade:

• É possível configurar o esquema de região a ser usado para derivar os nomes da cidade e estado quando um usuário insere o endereço de um novo contato para um cliente de negócio ou modifica o endereço de um cliente.
• Deve-se implementar a saída de usuário YCDVerifyAddressWithAVSUE para verificar os endereços com o AVS.