Páginas filhas
  • ER_ Integração_MGV6_Global.

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

2045 - Exportações de Dados p/ Balança

Módulo

Autosserviço

Segmento Executor

Varejo

Requisito/Story/Issue

Integração MGV6 Global

Chamado/Ticket

3108.110145.2016 (HIS.03220.2016, HIS.03168.2016, HIS.03158.2016, HIS.03142.2016 HIS.03143.2016 e HIS.03160.2016)

País

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

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Objetivo

Integrar com webservice da toledo para carga de balança. 

Definição da Regra de Negócio

  

Rotina

Tipo de Operação

Opção de Menu

2045 - Exportações de Dados p/ Balança

Alteração

Menu do WinThor

2053 - Cadastrar Informações Nutricionais

Envolvida

Menu do WinThor

 

Expandir
titleHIS.03220.2016


INFNUTRI;

  • Executar o sql para gerar os dados do arquivos INFNUTRI e armazená-los para enviar viar REST;
  • Chamar requisição IniciarImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao
  • Corpo da requisição:

"loja"................: caso o parâmetro 'TIPOMGV' seja 'Global', usar a filial selecionada na 2045;
caso o parâmetro 'TIPOMGV' seja 'Padrão', usar o valor 1;
"palavraChave"........: 'SENHAWEBSERVICEBAL';
"quantidadeDeArquivos": 1;
"tipoDeImportacao"....: 1;

  • Em caso de sucesso, o WebService devolve o método 'IniciaImportacaoResult' com o "Codigo" numérico, "Importado" como true e "Msg" nulo;
  • Armazenar o valor do campo 'Código' para o próximo método;
  • Com os dados retornados com sucesso, gerar a requisição para ImportaInformacaoNutricional;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/ImportaInformacaoNutricional;
  • Corpo da requisição:

"numeroDaImportacao"...: é o código retornado no método "IniciaImportacao";
"informacoesNutricionais"...: gerar os itens abaixo:
"Código"................: código da informação nutricional com até 6 dígitos (PCPRODUTNUTRI.CODIGO - a ser criado);
"QtdPorcao".............: PCPRODUTNUTRI.PORCAO;
"UnidadePorcao".........: Validar o campo PCPRODUTNUTRI.UNIDADEPORCAO:

  • Caso seja 'G', enviar 0;
  • Caso seja 'ML', enviar 1;
  • Caso seja 'UN', enviar 2;
  • "ValorEnergetico".......: PCPRODUTNUTRI.VALORCALORICO (se não houver, mandar nulo);
  • "Carboidrato"...........: PCPRODUTNUTRI.CARBOIDRATOS (se não houver, mandar nulo);
  • "Proteínas".............: PCPRODUTNUTRI.PROTEINAS (se não houver, mandar nulo);
  • "GorduraTotal"..........: PCPRODUTNUTRI.GORDURATOTAL (se não houver, mandar nulo);
  • "GorduraSaturada".......: PCPRODUTNUTRI.GORDURASATURADA (se não houver, mandar nulo);
  • "GorduraTrans"..........: PCPRODUTNUTRI.GORDURATRANS (se não houver, mandar nulo);
  • "FibraAlimentar"........: PCPRODUTNUTRI.FIBRAALIMENTAR (se não houver, mandar nulo);
  • "Sódio".................: PCPRODUTNUTRI.SODIO (se não houver, mandar nulo);
  • Ao finalizar, chamar o método FinalizaImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao
  • Corpo da requisição:
    "numeroDaImportacao"....: é o código retornado no método "IniciaImportacao";
  • Em caso de retorno contendo erros ou códigos de produtos não importados, gerar log de acordo com o exemplo em anexo;
  • Log para conclusão da importação com sucesso e de erros; 
Expandir
titleHIS.03168.2016

ITENSMGV;

  • Executar o sql para gerar os dados do arquivo ITENSMGV e armazená-los para enviar via REST;
  • Chamar requisição IniciarImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao
  • Corpo da requisição:

"loja"................: caso o parâmetro 'TIPOMGV' seja 'Global', usar a filial selecionada na 2045;

caso o parâmetro 'TIPOMGV' seja 'Padrão', usar o valor 1;

"palavraChave"........: 'SENHAWEBSERVICEBAL';

"quantidadeDeArquivos": 1;

  "tipoDeImportacao"....: 1;

  • Em caso de sucesso, o WebService devolve o método "InicialImportacaoResult"com o "Código" numérico, "Importado" como true e "Msg" nulo;
  • Armazenar o valor do campo 'Codigo' para o próximo método;
  • Com os dados retornados com sucesso, gerar a requisição para ImportarItem;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/ImportaItem
  • Corpo da requisição:

"numeroDaImportacao"...: é o código retornado no método "IniciaImportacao";

"itens"................: gerar os itens abaixo:

"Codigo"................: código do produto com até 6 dígitos;

"Preco".................: preço de venda;

"CodDepartamento".......: código do departamento (fixo da rotina 2045 ou PCPRODUT.CODEPTO);

"TipoVendaInt"..........: tipo de produto (PCEMBALAGEM.TIPOEMBALAGEM: 0 para 'P' ou 1 'U');

"DiasValidade"..........: dias de validade do produto (PCEMBALAGEM.PRAZOVAL);

"Descritivo1aLinha".....: descrição do produto (NVL(PCEMBALAGEM.DESCRICAOECF,PCPRODUT.DESCRICAO)) até 25 caracteres;

"Descritivo2aLinha".....: caso haja, enviar PCPRODUT.DESCRICAO1;

"Descritivo3aLinha".....: enviar com espaços em branco;

"Descritivo4aLinha".....: enviar com espaços em branco;

"CodInfoExtra"..........: código da inf. extra do item. Caso não haja, enviar '0' (PCEMBALAGEM.CODINFEXTRABAL);

"CodImagem".............: enviar '0';

"CodInfoNutricional"....: código da informação nutricional. (PCEMBALAGEM.CODAUXILIAR). Caso não haja, enviar '0';

"CodGlaciamento"........: enviar '0';

"CodConservacao"........: enviar '0';

"CodFracionador"........: enviar '0';

"CodFornecedor".........: código do fornecedor. (PCPRODFILIAL.CODFORNEC). Caso não haja, enviar '0';

"CodTara"...............: código da tara (PCEMBALAGEM.TARAF. Caso não haja, enviar '0');

"CodMidia"..............: enviar '0';

"CodCampoExtra1"........: enviar espaços em branco;

"CodCampoExtra2"........: enviar espaços em branco;

"CodCampoExtra3"........: enviar espaços em branco;

"CodCampoExtra4"........: enviar espaços em branco;

"AtivaImprDataValidade".: imprime data de embalagem (Se PCEMBALAGEM.IMPDATAEMBALAGEMBALANCA for igual a "S", gravar "1", senão, "0");

"AtivaImprDataEmbalagem": (Se PCEMBALAGEM.PRAZOVAL for maior que zero, gravar "1", senão, "0");

  • Ao finalizar, chamar o método FinalizaImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao
  • Corpo da requisição:
    "numeroDaImportacao"....: é o código retornado no método "IniciaImportacao";
  • Em caso de retorno contendo erros ou códigos de produtos não importados, gerar log de acordo com o exemplo em anexo;
  • Log para conclusão da importação com sucesso e de erros;
Expandir
titleHIS.03158.2016
  • Gerar logs do web service, conforme informações abaixo, mostrar o retorno na rotina após a finalização do processo e gravar o mesmo em pasta a ser criada dentro do spool.
  • INTEGRACAO WEBSERVICE TOLEDO

----------------------------------
14/10/2016 10:00:00
EnderecoServidor.......:192.168.0.100:9300
Codigo.................:-4
Importado..............:null
Msg....................:"Você não esta autorizado a fazer comunicação."
----------------------------------
14/10/2016 10:02:00
EnderecoServidor.......:192.168.0.100:9300
Codigo.................:null
Importado..............:false
Msg....................:"Não havia uma importação iniciada para o número da importação infomado."
----------------------------------
14/10/2016 10:03:00
EnderecoServidor.......:192.168.0.100:9300
IMPORTACAO FINALIZADA COM SUCESSO
----------------------------------
14/10/2016 10:03:00
EnderecoServidor.......:192.168.0.100:9300
Codigo.................:4
Importado..............:false
Msg....................:"Item código 4: Erro ao salvar item na base de dados."

Expandir
titleHIS.03142.2016
  • Criar parâmetros para integração com o WebService Toledo:

"Utiliza Integração WebService Balança", por filial, valor padrão 'Não' (USAINTEGRACAOWEBSERVICEBAL);
Com o parâmetro acima marcado, disponibilizar os seguintes parametros:
"Endereço WebService": aceitar IP ou hostname do servidor (não permitir nulo) (ENDERECOWEBSERVICEBAL);
"Porta"..............: porta padrão do servidor: 9300. Permitir alteração (PORTAWEBSERVICEBAL);
"Palavra-chave MGV6".: informar a palavra-chave cadastrada na integração do MGV6 (não permitir nulo) (SENHAWEBSERVICEBAL);
"Tipo MGV"...........: selecionar 'Global' ou 'Padrão' (TIPOMGV);

  • Dentro da opção "Toledo", criar novo grupo de campos com as opções para integração:
  • Dados a serem enviados:

ITENSMGV;
INFNUTRI;
TXINFO;
Botão de enviar;
Botão de agendamento (hora e minutos);
Barra de progresso;
Este grupo de informações somente deverá ser criado se o parâmetro (USAINTEGRACAOWEBSERVICEBAL) estiver habilitado.

  • Método de envio:

Utilizar tecnologia REST;
Ao clicar em 'Enviar', a 2045 deve validar se é INFNUTRI, ITENSMGV e/ ou TXINFO;
O envio é baseado em 3 métodos: IniciaImportacao, ImportaItem e FinalizaImportacao (visualizar na história técnica);
Primeiro é o IniciaImportacao, depois o método INFNUTRI, ITENSMGV ou TXINFO e depois FinalizaImportacao;
A requisição deve ser montada da seguinte maneira:

Expandir
titleHIS.03143.2016

 

Expandir
titleHIS.03160.2016

 

Opcional

Protótipo de Tela

 

<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.

 

Protótipo 01

 

 

 Image Removed

 

 

 

 

 

 

Opcional

Fluxo do Processo

 

<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>. 

Opcional

Dicionário de Dados

 

Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/

  

Índice

Chave

01

<FI9_FILIAL+FI9_IDDARF+FI9_STATUS>

02

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF>

03

<FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO>

Campo

<AAA_PERESP>

Tipo

<N>

Tamanho

<6>

Valor Inicial

<Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. 

Mandatório

Sim (  ) Não (  )

Descrição

<Referência Mínima para Cálculo>

Título

<Ref.Calc.>

Picture

<@E999.99>

Help de Campo

<Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação>

 

(Opcional)

Grupo de Perguntas

 

<Informações utilizadas na linha Protheus>.

 

Nome: FINSRF2

X1_ORDEM

01

X1_PERGUNT

Emissão De

X1_TIPO

D

X1_TAMANHO

8

X1_GSC

G

X1_VAR01

MV_PAR01

X1_DEF01

Comum

X1_CNT01

'01/01/08'

X1_HELP

Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório 

 

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

 

Consulta: AMB

Descrição

Configurações de Planejamento

Tipo

Consulta Padrão

Tabela

“AMB”

Índice

“Código”

Campo

“Código”; ”Descrição”

Retorno

AMB->AMB_CODIGO

 
  • Criar campo para o código da informação nutricional de até 6 dígitos, manualmente;
  • PCPRODUTNUTRI.CODIGO VARCHAR2(6);
  • Caso o parâmetro 'USAINTEGRACAOWEBSERVICEBAL' esteja habilitado e o usuário edite ou crie uma informação nutricional e tente gravar, obrigar a informar um código;
  • Este campo só deverá ser mostrado na rotina, caso parâmetro 'USAINTEGRACAOWEBSERVICEBAL' estiver habilitado.

 

  • Não deve haver mais de um registro de informação nutricional com o mesmo código;
Expandir
titleHIS.03160.2016

TXINFO

  • Executar o sql para gerar os dados dos arquivos TXINFO e armazená-lo para enviar viar REST;
  • Chamar requisição IniciarImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao
  • Corpo da requisição:

"loja"................: caso o parâmetro 'TIPOMGV' seja 'Global', usar a filial selecionada na 2045;

caso o parâmetro 'TIPOMGV' seja 'Padrão', usar o valor 1;

"palavraChave"........: 'SENHAWEBSERVICEBAL';

"quantidadeDeArquivos": 1;

"tipoDeImportacao"....: 1;


  • Em caso de sucesso, o WebService devolve o método 'IniciaImportacaoResult' com o "Codigo" numérico, "Importado" como true e "Msg" nulo;
  • Armazenar o valor do campo 'Código' para o próximo método;
  • Com os dados retornados com sucesso, gerar a requisição para ImportaInformacaoExtra;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/ImportaInformacaoExtra
  • Corpo da requisição:

"numeroDaImportacao"...: é o código retornado no método "IniciaImportacao";

  • "iformacaoExtra"............: gerar os itens abaixo:

"Codigo"................: PCINFEXTRA.CODIGO;
"Observacao"............: PCINFEXTRA.DESCRICAO (se não houver, não enviar);
"Linha1"................: PCINFEXTRA.INGREDIENTE1;
"Linha2"................: PCINFEXTRA.INGREDIENTE2;
"Linha3"................: PCINFEXTRA.INGREDIENTE3;
"Linha4"................: PCINFEXTRA.INGREDIENTE4;
"Linha5"................: PCINFEXTRA.INGREDIENTE5;
"Linha6"................: PCINFEXTRA.INGREDIENTE6;
"Linha7"................: PCINFEXTRA.INGREDIENTE7;
"Linha8"................: PCINFEXTRA.INGREDIENTE8;
"Linha9"................: PCINFEXTRA.INGREDIENTE9;
"Linha10"................: PCINFEXTRA.INGREDIENTE10;
"Linha11"................: PCINFEXTRA.INGREDIENTE11;
"Linha12"................: PCINFEXTRA.INGREDIENTE12;
"Linha13"................: PCINFEXTRA.INGREDIENTE13;
"Linha14"................: PCINFEXTRA.INGREDIENTE14;
"Linha15"................: PCINFEXTRA.INGREDIENTE15;

  • Caso o ingrediente esteja nulo, não enviar;
  • Ao finalizar, chamar o método FinalizaImportacao;
  • Requisição: http://<ENDERECOWEBSERVICEBAL>:<PORTAWEBSERVICEBAL>/MGV6_WCF/REST/IniciaImportacao;
  • Corpo da requisição:
    "numeroDaImportacao"....: é o código retornado no método "IniciaImportacao";
  • Em caso de retorno contendo erros ou códigos de produtos não importados, gerar log de acordo com o exemplo em anexo;
  • Log para conclusão da importação com sucesso e de erros;

(Opcional)

Estrutura de Menu

 

<Informações utilizadas na linha Datasul>.

 

Procedimentos

 

Procedimento

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Módulo

 

 

 

Programa base

 

 

 

Nome Menu

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro padrão

Sim

Sim

Sim

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Release de Liberação

 

 

 

 

 

 

Programas

 

Programa

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Nome Externo

 

 

 

Nome Menu/Programa

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Nome Verbalizado[1]

(Max 254 posições)

(Max 254 posições)

(Max 254 posições)

Procedimento

 

 

 

Template

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

Tipo[2]

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoria[3]

 

 

 

Executa via RPC

Sim/Não

Sim/Não

Sim/Não

Registro padrão

Sim

Sim

Sim

Outro Produto

Não

Não

Não

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Query on-line

Sim/Não

Sim/Não

Sim/Não

Log Exec.

Sim/Não

Sim/Não

Sim/Não

Rotina (EMS)

 

 

 

Sub-Rotina (EMS)

 

 

 

Localização dentro da Sub Rotina (EMS)

 

 

 

Compact[4]

Sim/Não

Sim/Não

Sim/Não

Home[5]

Sim/Não

Sim/Não

Sim/Não

Posição do Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar os papeis com os quais o programa deve ser vinculado

 

 

 

 

Cadastro de Papéis

<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.

<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.

 

Código Papel

(máx 3 posições)

Descrição em Português*

 

Descrição em Inglês*

 

[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.

[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante

[3] Categorias são obrigatórias para os programas FLEX.

[4] Obrigatório quando o projeto for FLEX

[5] Obrigatório quando o projeto for FLEX

[6] Obrigatório quando o projeto for FLEX

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