RMS - VEN - API VEN V2 – Central de Atendimento TOTVS

Dúvida
Para enviar as informações de pedidos que foram realizados no e-commerce, o sistema terceiro (não desenvolvido pela TOTVS) deve consumir a API VEN no endpoint SaleOrders (Post)

Ambiente
Retail Manager System - RMS - Todas as versões.

Pré-requisitos:

CAD_V2: Para que os produtos sejam integrados no e-commerce (dados cadastrais), o sistema terceiro (não desenvolvido pela TOTVS) deve consumir a API CAD no endpoint Products.
Documentação:https://tdn.totvs.com/display/public/LRMS/Manual+de+cadastro+de+clientes+para+acesso+a+API

Download: https://suporte.totvs.com/portal/p/10098/download?e=977963

API-MANAGER

Documentação: Manual de instalação e configuração RMS | API Manager

Download: https://suporte.totvs.com/portal/p/10098/download?e=976314

APIZEUS
Download: https://suporte.totvs.com/portal/p/10098/download?e=986136

AUTH7
Download: https://suporte.totvs.com/portal/p/10098/download?e=986137

Objeto de Banco: (PC_TSV_VEN / AG3PVECP) apenas a título de informação.

Solução
No exemplo abaixo, faremos a criação de um pedido de venda através do endpoint SaleOrders (Post).

Através do método Post, inserimos os valores no JSON que corresponde a cada informação relativo ao pedido de venda. Algumas informações são obrigatórias como exemplo ( Loja de venda e origem, código do Vendedor, código da agenda) entre outros. Na documentação seguinte explica cada valor representado no Json: https://tdn.totvs.com/pages/releaseview.action?pageId=498705701

POST - Json

No Json os pedidos que já foram pagos, eles integram com o Status 0 (Cadastrado).

Além disso para que o pedido grave como uma venda Não presencial (Oriunda do e-commerce), é necessário que no SaleOrder receba o valor no withdrawType = 1, indicando que é uma ENTREGA( AG3PVECP - PED_RETIRA_ENTREGA_CP = 1), consequentemente indicará que o pedido é da Web (AG3PVECP - PED_FLAG_PRESENCIAL = 2). Vejamos nas imagens abaixo como gravou na tabela AG3PVECP e no RMS as informações relativas ao pedido.

Necessário também incluir o número do pedido Web (orderNumber). No exemplo foi inserido o número do pedido = 100.

Json - Pedido 10048.

Pedido criado na tabela AG3PVECP.

Obs: Quando falamos de pedido do e-commerce, o programa RMS que integra esses pedidos é o VATPEDCN, não o VATVENDA.

Vamos consultar o pedido no VATPEDCN.

1 - Todo pedido que foi pago deve ser enviado (POST) pela API com o Status 0

1.1 - Este pedido cai no Vendas como cadastrada e no Vendas segue o fluxo normal do processo já existente;

2 - Para os pedido que não foram pagos, como itens que fora escolhido o tipo de pagamento boleto é preciso ser enviado pela API com o Status 21

2.1 - Este Status 21 significa que é análise de crédito, e desta forma o pedido irá aparecer no VATPEDCN

2.1.1 - Após este pedido for pago é preciso ALTERAR (PUT) o pedido passando o Status 0 e assim seguir o fluxo como informado em 1

2.1.2 - Caso o pedido não seja pago é preciso ALTERAR (PUT) o pedido passando o Status 90 e assim o pedido será colocado como Suspenso, e poderá ser cancelado no VATPEDCN

3 - Se o pedido já estiver com o Status 0, ou seja, cadastrado no Vendas ele pode ser cancelado no próprio Vendas ou na Logística;

3.1 - Uma vez que esteja na Logística o pedido já estará com o Status 60 e assim ao ser cancelado na Logística o mesmo ficará com o Status 79 (DEVOLVIDO LOGÍSTICA) e assim poderá ser cancelado no VATPEDCN.

PS: Para todos os pedidos da WEB é obrigatório informar o número do pedido da WEB 'orderNumber' desde a primeira interação, pois, é desta forma que o Vendas irá receber o número de pedido da WEB e o mesmo fica gravado na tabela do vendas (AG3PVECP- [coluna PED_NUM_PEDIDO_WEB ]) com tal número onde é possível efetuar buscas pelo mesmo, bem como diferenciar o que é Pedido de Vendas com Origem WEB ou não;

Olá,

RMS - VEN - API VEN V2

0 Comentários

Olá ,

Olá ,

Olá ,

Olá,