- Criado por PRISCILLA DE PAULA SOUSA, última alteração por Nayara Dos Santos Silva em 03 jul, 2017
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 |
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;
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;
- 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."
- 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:
- 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;
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;
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|