Mudanças entre as edições de "Integração de endereços de entrega"

De GeoSales
Ir para navegação Ir para pesquisar
 
(36 revisões intermediárias por 4 usuários não estão sendo mostradas)
Linha 6: Linha 6:
 
|-
 
|-
 
| 21/11/2018  || Ryvane Maria || Criação do documento
 
| 21/11/2018  || Ryvane Maria || Criação do documento
 +
|-
 +
| 15/04/2018  || Ryvane Maria || Alteração referente ao número de Transportadora
 
|-
 
|-
 
|}
 
|}
Linha 11: Linha 13:
 
== Necessidade ==
 
== Necessidade ==
  
−
Além disso, para frete do tipo Redespacho, o endereço de entrega será setado automaticamente de acordo com a transportadora selecionada.
+
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 ==
 
== Solução ==
  
−
Deverá ser realizada a integração dos possíveis endereços de entrega alternativos. Este endereço alternativo deve ser cadastrado previamente no DataSul, e será disponibilizado para seleção pelo vendedor.
+
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.
  
−
Além disso, para frete do tipo Redespacho, o endereço de entrega será setado automaticamente de acordo com a transportadora selecionada.
+
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 ==
 
== Implementação ==
  
−
=== Desenvolvimento ===  
+
=== 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. Essa parametrização será feita exclusivamente no ERP.
 +
 
 +
'''- Validar endereço para frete Redespacho:'''
  
−
=== Integração ===
+
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 ===
 
=== Estrutura de banco ===
  
−
{| class="wikitable"
+
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.
−
! colspan="5"  | TABELA
 
−
|-
 
−
! Coluna
 
−
! Tipo
 
−
! Obrigatório
 
−
! Chave Primária
 
−
! Explicação
 
−
|-
 
−
| NOME DO CAMPO
 
−
| TIPO DO CAMPO
 
−
| SIM/NAO
 
−
| SIM/NAO
 
−
| EXPLICAÇÃO SOBRE O CAMPO
 
−
|-
 
−
|}
 
  
 
== Regras de Negócios ==
 
== Regras de Negócios ==
  
−
'''[RN1] - '''
+
'''[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 ==
 
== Regras de Integração ==
  
−
'''[RI1] - '''
+
AS REGRAS DE INTEGRAÇÃO ABAIXO SERÃO DEFINIDAS EM DOCUMENTO TÉCNICO POSTERIOR.
  
−
== Resultados Esperados ==
+
'''[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.
  
−
=== Protótipos ===
+
'''[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.
  
−
=== Fluxos Padrão ===
+
'''[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 ==
 
== Aprovação ==
Linha 71: Linha 112:
  
 
|-  
 
|-  
−
| Desenvolvimento - GeoSales || Pessoa que aprovou || 00/00/0000
+
| Gerente TI - GeoSales || Leonardo Sousa || 18/12/2018
 
|-  
 
|-  
−
| Integração - GeoSales || Pessoa que aprovou || 00/00/0000
 
−
|-
 
−
| Configurações - GeoSales || Pessoa que aprovou || 00/00/0000
 
−
|-
 
 
|}
 
|}
  
Linha 83: Linha 120:
 
{| class="wikitable"
 
{| class="wikitable"
 
! Setor  
 
! Setor  
−
! Aprovado Por
+
! style="width:200px" |Aprovado Por
−
! Data
+
! style="width:200px" |Data
−
! Assinatura
+
 
−
|-
+
|-
−
| Gerente TI - Cliente || Pessoa que aprovou || 00/00/0000 ||
+
| TI - Montana || ||  
−
|-
 
−
| Gerente de Projeto - Cliente || Pessoa que aprovou || 00/00/0000 ||
 
 
|-  
 
|-  
−
| Gerente Comercial - Cliente || Pessoa que aprovou || 00/00/0000 ||
+
| Gestor do Projeto - Montana || ||  
 
|-  
 
|-  
 +
| Diretoria - Montana ||  ||
 
|}
 
|}

Edição atual tal como às 19h18min de 25 de abril de 2019

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. Essa parametrização será feita exclusivamente no ERP.

- 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
Disponível em “http://wiki.geosales.com.br:8000/index.php?title=Integração_de_endereços_de_entrega&oldid=11717”