Integração de endereços de entrega

Histórico de Alterações

Data	Quem	Comentários
21/11/2018	Ryvane Maria	Criação do documento
15/04/2018	Ryvane Maria	Alteração referente ao número de Transportadora

Necessidade

Existem algumas políticas que exigem que os possíveis endereços de entrega de um pedido estejam previamente cadastrado e previsto antes do cadastro de pedidos É necessário que a definição de endereço de entrega seja limitada aos endereços de entrega já cadastrados.

Além disso, para alguns tipos de frete, o endereço de entrega deverá ser obrigatoriamente o endereço da transportadora. Isso ocorre por exemplo, no frete Redespacho, onde é negociado com o cliente que a entrega seja feita em uma transportadora específica definida previamente pelo cliente, e a partir daí esta transportadora será então responsável pela entrega do pedido.

Solução

O GeoSales irá trazer do ERP o cadastro de possíveis endereços de entrega, associados a um cliente. Esses endereços de entrega serão disponibilizados para seleção pelo vendedor, na definição de endereço de entrega no momento do cadastro de pedidos.

Deverá ser trazido do ERP, também, o endereço da transportadora. Ao passo que o vendedor seleciona o tipo de frete, por exemplo o tipo 'Redespacho' e a transportadora desejada este endereço será setado automaticamente no pedido, e não poderá ser alterado.

Implementação

Desenvolvimento

- Integrar informações de endereço de entrega alternativos:

Os possíveis endereços de entrega de um cliente deverão ser parametrizados exclusivamente no ERP, e serão trazidos ao GeoSales através da tabela XXXX e dos seguintes campos: YZYZ.

- Integrar informações de transportadora:

O cadastro de informações de transportadora deverão ser parametrizados exclusivamente no ERP, e serão trazidos ao GeoSales através da tabela XXXX e dos seguintes campos: YZYZ.

- Selecionar transportadora no cadastro de pedidos:

O vendedor deve selecionar a transportadora no cadastro de um pedido. É importante lembrar que, para determinados tipos de frete, por exemplo 'Redespacho', a responsabilidade da entrega é dividida entre duas transportadoras diferentes. Portanto, são utilizadas duas transportadoras diferentes para finalizar a entrega do pedido.

Por este motivo, o vendedor deve selecionar não só a transportadora alternativa que irá fazer a entrega no endereço da próxima transportadora, mas também deve selecionar a transportadora que irá efetivar a entrega, ou seja, entregar o pedido no endereço do cliente. A 'transportadora alternativa', realiza a entrega no endereço da transportadora oficial, que, por sua vez, é responsável pelo fim do trajeto, entregando o pedido no endereço do cliente.

Para que isso seja possível, será criado um novo campo de transportadora, para que o usuário selecione a 'transportadora alternativa'. Essa transportadora será responsável pelo primeiro trajeto do pedido, que terá como finalidade realizar a entrega no endereço da transportadora oficial, que também será selecionada pelo usuário.

- Salvar endereço de entrega alternativo no GeoSales:

Os dados trazidos do ERP serão salvos no GeoSales com finalidade de exibir estes endereços no cadastro de pedidos.

Abaixo pode-se visualizar os dados que serão salvos nessa tabela: (a definir, endereço completo do cliente, código do cliente, etc)

- Selecionar endereço de entrega no cadastro de pedidos:

No momento do cadastro de pedidos, para selecionar o endereço de entrega, o GeoSales irá disponibilizar para seleção pelo usuário a lista de endereços de entrega parametrizados anteriormente para aquele cliente.

- Validar endereço para frete Redespacho:

Inicialmente, o GeoSales irá verificar o tipo de frete do pedido. Após essa validação, o GeoSales irá verificar também qual foi a transportadora oficial selecionada.

Caso o tipo de frete verificado seja 'Redespacho', o endereço de entrega da transportadora será setado no campo definido para informação de endereço de entrega, e não poderá ser alterado.

- Enviar transportadora ao ERP:

Junto a integração das informações do pedido, será integrado também o código da transportadora. Este código de transportadora será salvo nos campos padrões do ERP XYXY da tabela YYYY do ERP. Porém, para alguns tipos de frete, como 'Redespacho', a transportadora selecionada se refere a transportadora auxiliar, onde a empresa deverá realizar a entrega, por este motivo, nestes casos, o GeoSales irá preencher a informação de transportadora no campo XXXX da tabela padrão do pedido YYYY, setando no campo padrão de transportadora XYXY a transportadora padrão ‘x’.

- Enviar endereço de entrega ao ERP:

O endereço de entrega será enviado ao ERP através dos campos padrão de integração.

Estrutura de banco

Os dados serão salvos na tabela ENDERECO_PEDIDO, e é necessário que sejam cadastradas as informações necessárias no ERP, para que sejam trazidas e salvas no Geosales.

Regras de Negócios

[RN1] - A transportadora só pode ter um endereço de entrega cadastrado no Geosales

[RN2] - Para alguns tipos de frete, será possível parametrizar a obrigatoriedade da seleção da transportadora e do endereço de entrega.

[RN3] - Caso o usuário altere a transportadora, o endereço de entrega deverá ser revalidado. Isso quer dizer que o usuário deverá selecionar novamente o endereço de entrega associado a nova transportadora.

[RN4] - Caso o usuário altere o tipo de frete, o GeoSales irá validar as informações de endereço de entrega novamente. Isso quer dizer que caso o usuário altere o tipo de frete, será necessário definir novamente o endereço de entrega, de acordo com as parametrizações definidas para o novo tipo de frete.

[RN5] - É importante salientar que o cálculo de frete a ser aplicado irá considerar o endereço de entrega apresentado neste documento.

Regras de Integração

AS REGRAS DE INTEGRAÇÃO ABAIXO SERÃO DEFINIDAS EM DOCUMENTO TÉCNICO POSTERIOR.

[RI1] - Os possíveis endereços de entrega de um cliente deverão ser parametrizados exclusivamente no ERP, e serão trazidos ao GeoSales através da tabela XXXX e dos seguintes campos: YZYZ.

[RI2] - O cadastro de informações de transportadora deverão ser parametrizados exclusivamente no ERP, e serão trazidos ao GeoSales através da tabela XXXX e dos seguintes campos: YZYZ.

[RI3] - Junto a integração das informações do pedido, serão integradas também as informações de transportadora. Os dados de transportadora serão salvos no campo XYXY da tabela YYYY do ERP.

[RI4] - Quando o tipo de frete estiver indicando o uso de endereço de entrega da transportadora, como ocorre com o frete 'Redespacho', a transportadora selecionada se refere a transportadora onde a empresa deverá realizar a entrega, por este motivo, nestes casos, o GeoSales irá preencher a informação de transportadora no campo XXXX da tabela YYYY, setando no campo padrão de transportadora XYXY a transportadora padrão ‘x’.

[RI5] - É importante salientar que a qualidade dos endereços deverá ser controlada exclusivamente no ERP. Ou seja, o GeoSales não irá tratar endereços de entrega incorretos ou abreviados.

[RI6] - O tipo de frete 'Redespacho' será enviado ao ERP com sendo o tipo de frete 'FOB'.

Aprovação

Considero aprovada a documentação da funcionalidade especificada acima, e autorizo a implementação da mesma no Sistema GeoSales, em nome da Organização a qual estou vinculado.

GeoSales

Setor	Aprovado Por	Data
Gerente TI - GeoSales	Leonardo Sousa	18/12/2018

Empresa solicitante

Setor	Aprovado Por	Data
TI - Montana
Gestor do Projeto - Montana
Diretoria - Montana