Layout Integração Ecommerce/pedidos

De Wiki AnDes Sistemas
Revisão de 12h47min de 13 de setembro de 2017 por Johnny vaz (discussão | contribs) (Modelos XSD)

(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)
Ir para: navegação, pesquisa

Importação de Pedidos entre o Sistema AnDes e Ecommerce

Resumo

Este projeto determina como executará o processo de Importação dos Pedidos / Itens Vendidos no Ecommerce para o Sistema AnDes

Introdução

O Ecommerce é responsável por captar os pedidos através de seu portal. O sistema da AnDes gerará as notas baseados nos pedidos que forem importados. Haverá uma comunicação entre os dois sistemas requisitando os pedidos gerados.

Processo

O Ecommerce disponibilizará um serviço onde receberá os parâmetros de email e senha para autenticação e um intervalo de dias a serem listados os pedidos, em formato XML como está descrito no arquivo ws_pedido.xsd.

O sistema AnDes fará o requisito ao sistema Vetros e recebendo este XML o processará e disponibilizará ao cliente uma tela onde ele poderá selecionar os pedidos que serão importados.

Quando o usuário confirmar a importação, o sistema AnDes gerará os pedidos baseados nos dados recebidos e a cada pedido importado, será enviado o número do pedido ao Ecommerce para que a mesma marque o pedido como importado e não mais o disponibilize para importação.

Sugerimos ao Ecommerce dois padrões de url onde:

  • Para listar os pedidos:

http://www.xxxx.com.br/listarPedidos?email=xxx&senha=xxxxx&periodo=60

  • Para confirmar importação:

http://www.xxxx.com.br/confirmarImportacaoPedido?email=xxx&senha=xxxxx&pedido=123

Sobre a estrutura do XML

O XML de importação de Pedidos tem toda a sua estrutura explicada em detalhes no arquivo ws_pedido.xsd, mas em resumo a estrutura é formada pela tag inicial dados, ela tem somente a função de organizar a importação. Dentro dela temos duas tags sendo a primeira clientes e a segunda pedidos.

Na tag clientes é opcional sendo que ela existirá sempre que o Ecommerce receber um novo cliente ou se alguma informação clientes tiver sido alterada.

Cada cliente virá numa tag chamada cliente, e seus dados deverão vir no padrão exposto no xsd.

A tag pedidos é opcional sendo que ela existirá quando houver pelo menos um pedido a ser importada.

Cada pedido virá na tag pedido. Detalhes ver no xsd.