Aut. Cml. - E-Commerce
Descrição
Implantação e Configuração do E-commerce
Pré-Requisitos
ERP-Viasoft
E-Commerce (k4Sale nossa plataforma)
Integrador (Sw que precisa ser desenvolvido).
Passo a Passo
Seguir instruções abaixo:
Empresa>> Configurações>> Gerais>> Aba 13/14 - E-Commerce
Preencher os dados de acordo com os fornecidos pela integradora;
Usuário;
Senha;
URL da API;
entre outros.
Marcar Checkbox “Usa E-Commerce = SIM” aba E-Commerce do Produto;
Inserir informações desejadas para os Produtos.
5. Critérios para sincronização no Produto;
a) Saldo;
b) Cod. Barras;
c) Descrição reduzida, Descrição Completa;
d) Imagem;
e) Preço;
f) Categoria.
Status do Pedido
PEDIDOSTATUS INTEGER, - Ao inserir um pedido, inserir com zero (0) e quando for faturado, altera para um (1) - Abaixo os Status:
0 - Novo (é cadastrado mas não lista na entrega da reserva)
1 - Pendente (habilita para entrega)
2 - Entregue Parcial
3 - Cancelado
4 - Entrega parcial e cancelado
5 - Totalmente entregue
Tabelas para Integração (Retorno)
Tabela de Cabeçalho do pedido WECPEDIDO:
PEDCODIGO VARCHAR(20) NOT NULL, - Código de pedido do E-Commerce
CLICODIGO INTEGER, - Essa informação poderá ser vazio
**Abaixo são informações relacionadas ao cliente:
CLINOMERAZAOSOC VARCHAR(60),
CLICNPJF VARCHAR(14),
CLIEMAIL VARCHAR(250),
CLIENDERECO VARCHAR(70),
CLINUMERO VARCHAR(10),
CLICOMPL VARCHAR(900), - Complemento/Observações
CLIBAIRRO VARCHAR(60),
CLICEP VARCHAR(8),
CLICIDADE VARCHAR(40),
CLIESTADO VARCHAR(40),
CLIPAIS VARCHAR(20),
CLITEL VARCHAR(14),
PEDATA TIMESTAMP, - Data do pedido
PEDSUBTOTAL DOUBLE PRECISION, - Valor total do pedido sem considerar desconto
PEDFORMAENTREGA VARCHAR(20), - Não precisa informar, não utilizamos na importação
PEDFRETE VARCHAR(20), - Valor de Frete
PEDTIPOPAGTO VARCHAR(40), - Pode ser informado o tipo de pagamento, mas não usamos
PEDFORMAPAGTO VARCHAR(40), - Vai gravar no campo ‘Condição de Pagamento’ na reserva, que é um campo texto
PEDTIPOCC VARCHAR(40), - não precisa mandar nada
PEDTOTAL DOUBLE PRECISION, - Total do pedido - não usamos na geração da reserva
PEDTRANSACAOID VARCHAR(40) - não precisa mandar nada
ENTENDERECO VARCHAR(70),- Endereço de Entrega (informar somente se for diferente do endereço padrão);
ENTNUMERO VARCHAR(10),
ENTCOMPL VARCHAR(900),
ENTBAIRRO VARCHAR(60),
ENTCEP VARCHAR(8),
ENTCIDADE VARCHAR(40),
ENTESTADO VARCHAR(40),
ENTPAIS VARCHAR(20),
ENTTEL VARCHAR(14),
DATADOWNLOAD TIMESTAMP, - não usamos, pode usar para seu controle
IDCIDADE VARCHAR(5), - Precisa mandar, Código IBGE
ENTIDCIDADE VARCHAR(5),
NROPED VARCHAR(15), ** Campo gerado automático - uso interno Viasoft
PEDDESCONTO DOUBLE PRECISION - Desconto no total do pedido
Tabela de Itens do Pedido WECPEDIDOITEM:
PEDCODIGO VARCHAR(20) NOT NULL, - Código de pedido do E-Commerce
SEQITEM INTEGER NOT NULL, - Sequencial do item no pedido no E-Commerce
IDITEM VARCHAR(20), - Código do item
DESCRICAO VARCHAR(40),
SUBTOTAL DOUBLE PRECISION, - Valor unitário x quantidade
QUANTIDADE DOUBLE PRECISION,
DESCONTO DOUBLE PRECISION, - desconto do item
VALORTOTAL DOUBLE PRECISION - Valor total do item considerando o desconto
Processos de comunicação (e-Commerce e ERP)
1 - Gravação do pedido originado no e-Commerce no ERP
1.1 - Pedido é efetuado no e-Commerce.
1.2 - Integrador ao estourar gatilho (tempo configurado, ex: 5 minutos)
A - Solicita pedidos ainda não importados no e-Commerce;
B - Grava pedidos no ERP (tabelas desejadas);
C - Atualiza Status do pedido no e-Commerce (Ex. Importado = true / código do pedido no ERP).
2 - Atualização de estoque.
Após importar os pedidos (tendo pedido ou não)
2.1 - Integrador solicita lista de produtos do e-commerce (com código de integração, campo cód. externo).
2.2 - Faz looping sobre a lista de produtos recebida e um a um.
A - Pega o estoque no ERP;
B - Grava estoque no e-Commerce.
3 - Faturado o Pedido no ERP
3.1 - Integrador pega a informação de pedido faturado;
3.2 - Atualiza o Status de pedido no e-Commerce.
Obs:
Produtos serão cadastrados manualmente no e-Commerce.
Não faz parte do escopo desta versão de projeto de Integrador.
Questões importantes:
Onde será gravado o n°. do pedido no E-Commerce? (é em "PEDCODIGO"?)
Sim, o número do pedido do E-Commerce deve ser gravado no WECPEDIDO.PEDCODIGO.
Posso colocar qualquer código de cliente? (ex: um cliente novo... qual código o Integrador irá gravar em "CLICODIGO")
Nesse campo envia vazio. Basta alimentar o campo CLICNPJF com o CPF/CNPJ.
Se tentar gravar um cliente com CPF/CNPJ que já exista na base do ERP, o que acontecerá?
O Sistema gerencia, caso não exista no banco, ira cadastrar, se existir ira carregar o cadastro que já existe.
Como acessar o estoque atual do produto?
A informação do saldo dos produtos fica no campo: ITEMESTAB.QUANTIDADE. Esse é o saldo total do produto.