Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Especificação | |||
Produto | DATASUL | Módulo | MPD |
Segmento Executor | Manufatura | ||
Projeto1 | MANDIS-01 | IRM1 | MANDIS01-404 |
Requisito1 | MANDIS01-518 | Subtarefa1 |
|
Chamado2 |
| ||
País | ( x ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
Realizar a integração entre o ERP Datasul e a plataforma de E-commerce da Ciashop, visando o envio do preço do produto e do saldo disponível em estoque no ERP Datasul para o Ciashop.
A plataforma Framework Ciashop é uma plataforma em que o cliente pode montar sua própria loja de comércio eletrônico.
O Ciashop permite que o cliente monte sua própria loja virtual. Para estabelecer a estrutura da loja virtual com seus departamentos e itens postos a venda o ERP deverá fornecer tais informações. A loja virtual estará integrada com o ERP transmitindo para este os clientes e pedidos cadastrados na loja virtual.
A forma de comunicação entre ERP e Ciashop se dará por meio de mensagens enviadas e recebidas de um Web service RESTfull. Os Web services RESTful são serviços construídos com o estilo de arquitetura RESTful. A construção de Web services com a abordagem RESTful está surgindo como uma alternativa popular ao uso de tecnologias baseadas em SOAP para implantação de serviços na Internet, por ser mais leve e ter a capacidade de transmitir dados diretamente via HTTP.
O conceito de Marketplace (MP), no comércio eletrônico, é a utilização de uma loja virtual de terceiros para vender os seus produtos.Sales Hub é um aplicativo disponível para Lojas Framework da Ciashop que concentra diversos marketplaces, tais como Extra e Walmart. Através deste aplicativo é possível ofertar os produtos da loja nestes marketplaces e gerenciar os pedidos gerados nestes canais em sua própria loja.
A mensagem integrada segue o fluxo abaixo:
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
PD0624 - Integração Batch Ciashop | Criação | Logistica -> Pedidos -> Tarefas | N/A |
Programa:
PDP\PD0624.W
Função:
O PD0624 será um programa de relatório que será o responsável pelo envio dos registros selecionados no programa PD0623 para a loja virtual. Este programa terá a possibilidade de ter sua execução agendada no RPW.
Implementação:
Criar um programa de relatório com quatros páginas: Seleção, Parâmetros, Digitação e Impressão. Na página de seleção será incluído os campos faixa de Estabelecimento (inicial e final) e os campos faixa de Tabela de Preço (inicial e final). Na página de Parâmetros haverá quatro flag´s para permitir a seleção de qual tipo de mensagem será realizado o envio a loja virtual. Haverá um flag para Departamento, para Item, para Preço e para Saldo Estoque. Na aba Digitação será possível informar tabelas de preço.
Esse programa deverá realizar a busca nas tabelas depto-loja, item-loja, preco-item e saldo-estoq. A partir da busca nas respectivas tabelas chamar a API ciashop\dis-ciashop.p para o envio de dados do ERP Datasul para o Ciashop.
Caso a flag Preço esteja marcada, este programa deverá realizar a leitura dos registros gravados na tabela preco-item que ainda não foram enviados para o Ciashop e chamar a API ciashop\dis-ciashop.p ( responsável pela comunicação entre o ERP e Ciashop) passando a temp-table PricingTable. Nesta temp-table estarão inseridos todos os preços dos itens que serão enviados ao Ciashop por meio do método addVariantPricesERP.
O envio do preço (preco-item) para o Ciashop será feito através do método POST:
No primeiro {ERPID} será enviado o código do item\variante e no segundo {ERPID} será enviado o código da tabela de preço.
O preço do item será enviado por meio da temp-table PricingTable:
CREATE PricingTable.
ASSIGN PricingTable.price = Preço de venda FOB para o item, sem o frete incluso.
Exemplo de chamada para o método addVariantPricesERP:
RUN addVariantPricesERP IN handle api-ciashop (INPUT código do item\variante,
INPUT código da tabela de preço,
INPUT TABLE tabela contendo o preço do item,
OUTPUT TABLE tabela de erros).
Definição do campo price (preço do item) no Ciashop:
Visualização do preço do produto no Ciashop:
Caso a flag Saldo Estoque esteja marcada, este programa deverá realizar a leitura dos registros gravados na tabela saldo-estoq que ainda não foram enviados para o Ciashop ou que tiveram seu saldo alterado e chamar a API ciashop\dis-ciashop.p ( responsável pela comunicação entre o ERP e Ciashop) passando a temp-table Variant. Nesta temp-table estará inserida a quantidade disponível em estoque dos itens que foram enviados ao Ciashop. Enviar o saldo por meio do método updateVariantERP.
O envio da quantidade disponível (saldo-estoq) para o Ciashop será feito através do método PUT:
Definição do campo quantity (saldo disponível em estoque) no Ciashop:
O saldo disponível será enviado por meio da temp-table Variant:
CREATE Variant.
ASSIGN Variant.quantity = saldo disponível em estoque.
Exemplo de chamada para o método updateVariantERP:
RUN updateVariantERP IN handle api-ciashop (INPUT código do item\variante,
INPUT TABLE tabela contendo o saldo disponível,
OUTPUT TABLE tabela de erros).
Visualização do saldo disponível do produto no Ciashop:
Enviar o saldo disponível em estoque do item, programa CE0830, para o Ciashop:
* Campos: Categoria, Item, Preço e Saldo Estoque
* Campos: Tabela Preço e Descrição:
Quando a integração com a Ciashop estiver ligada o sistema deve apresentar, na tela do CD1506, um campo para que seja informado o nome do tipo de variação, por exemplo: Tamanho, Cor, Voltagem, etc. Estas opções poderão ser pré-cadastradas e se algum dia o cliente precisar de uma nova, deverá abrir chamado para Totvs.
Podemos gravar esta informação da seguinte forma:
1 - Tamanho
2 - Cor
3 - Voltagem
A informação poderá ser gravada no campo livre ieda parei aqui
Índice | Chave |
01 | saldo-item-loja ( cod-depos + cod-estabel + it-codigo + cod-refer |
Campo | cod-depos |
Tipo | Character |
Tamanho | x(03) |
Valor Inicial | |
Mandatório | Sim ( x ) Não ( ) |
Descrição | Depósito |
Título | Depósito |
Picture | x(03) |
Help de Campo | Código do Depósito |
Campo | cod-estabel |
Tipo | Character |
Tamanho | x(05) |
Valor Inicial | |
Mandatório | Sim ( x ) Não ( ) |
Descrição | Estabelecimento |
Título | Estabelecimento |
Picture | x(05) |
Help de Campo | Código do Estabelecimento |
Campo | cod-refer |
Tipo | Character |
Tamanho | x(08) |
Valor Inicial | |
Mandatório | Sim ( x ) Não ( ) |
Descrição | Referência |
Título | Referência |
Picture | x(08) |
Help de Campo | Código do Depósito |
Campo | it-codigo |
Tipo | Character |
Tamanho | x(16) |
Valor Inicial | |
Mandatório | Sim ( x ) Não ( ) |
Descrição | Item |
Título | Item |
Picture | x(16) |
Help de Campo | Código do Item |
Campo | quantidade |
Tipo | Decimal |
Tamanho | ->>>,>>>,>>9.9999 |
Valor Inicial | |
Mandatório | Sim ( x ) Não ( ) |
Descrição | Qtd Disponível |
Título | Qtd Disponível |
Picture | ->>>,>>>,>>9.9999 |
Help de Campo | Quantidade disponível em estoque |
Campo | dt-atualiza |
Tipo | Date |
Tamanho | 99/99/9999 |
Valor Inicial | |
Mandatório | Sim ( ) Não ( x ) |
Descrição | Dt Atualiza |
Título | Dt Atualiza |
Picture | 99/99/9999 |
Help de Campo | Data atualização do saldo no Ciashop |
Procedimentos
Procedimento | pd0624 | pd0624rp
|
Descrição | Integração Batch Ciashop | Integração Batch Ciashop |
Módulo | MPD | MPD
|
Programa base | pdp\pd0624.w | pdp\pd0624rp.p
|
Nome Menu | Integração Batch Ciashop | Integração Batch Ciashop |
Interface | GUI | GUI |
Registro padrão | Não | Não |
Visualiza Menu | Sim | Não |
Release de Liberação | 12.1.14 | 12.1.14 |
Programas
Programa | pd0624 | pd0624rp |
Descrição | Integração Batch Ciashop | Integração Batch Ciashop |
Nome Externo | pdp\pd0624.w | pdp\pd0624rp.p |
Nome Menu/Programa | Integração Batch Ciashop | Integração Batch Ciashop |
Nome Verbalizado[1] | Integração Batch Ciashop | Integração Batch Ciashop |
Procedimento |
|
|
Template | Relatório | Programa sem interface |
Tipo[2] | Relatório | Tarefas |
Interface | GUI | GUI |
Categoria[3] |
|
|
Executa via RPC | Não | Não |
Registro padrão | Não | Não |
Outro Produto | Não | Não |
Visualiza Menu | Sim | Sim |
Query on-line | Não | Não |
Log Exec. | Não | Não |
Rotina (EMS) |
|
|
Sub-Rotina (EMS) |
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
Compact[4] | Sim/Não | Sim/Não |
Home[5] | 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 |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
[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. |
---|