Plugg.to

Autor: Thiago Alves

Data de criação: 24/08/2021

Configurando o acesso à API

Credenciais de Acesso

Inicialmente, será necessário adicionar a credencial de acesso ao MarketPlace. está deve ser adiquirida diretamente com a Plugg.to.

Após adicione nosso plugin a sua conta Plugg.to atente-se que a integração oficial é BRERP DevCoffee.

Ainda dentro das configurações do Plugg.to Para considerar um pedido integrado, utilizamos como base a Plataforma padrão configurada.

Acesse o menu lateral > Configurações > Plataforma Padrão e selecione a inetgração configurada anteriormente como padrão.

Para iniciar a configuração, adicione essas informações no BrERP, para isso abra o Menu > MarketPlaces > Configuração do MarketPlace.

Para configurar primeiramente deve-se selecinar a integração Plugg.to. Após adicionar todas as credenciais da API, selecione a organização em que o pedido será criado e adicione um nome para facilitar a identificação.

Configurações Adicionais

Após configurado o marketPlace, novas abas serão habilitadas Configurações do Parceiro de Negócios e Configurações do Pedido.

Essas informações irão sobrescrever as configurações iniciais do parceiro de negócios e da ordem de venda durante a obtenção dos pedidos.

Atenção

Para Plugg.to o campo Último Pedido, possui um formato: Plugg.To: é um código, como o exemplo: 5d00a279b2714d02d0d3feaa

Também há a Flag:

Fixar Pedido: onde poderá fixar a chave preenchida na obtenção. Recomenda-se deixar fixa a chave do primeiro pedido obtido durante a implantação.

Exceções de Pedido

É possível criar várias configurações adicionais, que sobrescrevem as padrões descritas acima, para isso, clique na aba de Exceção.

Após os pedidos serem importados, serão comparados com o Canal de Origem e o Status das abas de Exceções e caso forem iguais, o pedido será criado com essas informações, e caso contrário, as informações Padrões (Conforme descrito anteriormente) serão utilizadas.

Filtrando os pedidos obtidos

No BrERP é possível filtrar os pedidos recebidos do Marketplace, a seguir será apresentado as possibilidades de filtros.

Filtrando por estado do pedidos

Apenas é necessário a criação do “Status de Pedido do MarketPlace” no BrERP e que esse status seja informado nas configurações adicionais, conforme descrito anteriormente.

No Plugg.to há status pré-definido.

Para o Plugg.To só é necessário o campo “Value”, que deve ser estritamente idêntico ao da tabela abaixo, já o campo “Name” pode ser qualquer outro valor para sua identificação.

Nome	Value
Pedido Pago	pending
Pedido Pago, porem frete não	partial_payment
Pedido Pago e aprovado	approved
Esperando pela Fatura	waiting_invoice
ERP não é capaz de gerar Fatura	invoice_error
Fatura feita	invoice
Pedido enviado e código de rastreio informado	shipping_informed
MarketPlace aceitou o envio e já informou o cliente	shipped
MarketPlace não aceitou o envio, necessário corrigir a Fatura	shipped_error
Entregue	delivered
Cancelado	caceled
O pedido não será enviado até o MarketPlace aprovar a ordem	under_review

Configurando os Produtos

Para obtenção/atualização/criação das informações dos produtos do marktplace o campo “É enviado aos MarketPlace?” deve ser marcado como verdadeiro.

É habilitado a aba “Descrição do MarketPlace”. Cada um dos marketplaces tem sua peculiaridade que será descrita a seguir.

• Plugg.To: Deverá ser informado o SKU do produto no campo "SKU (UCE)" do BRERP.

Atualizando Produto individualmente

Para obtenção/atualização das informações do produto do marktplace é só rodar o processo "Retorna um produto do MarketPlace" na janela produto. Esse mesmo processo pode ser rodado da aba "Descrição"

Atualizando todos os Produtos disponíveis

Para obtenção/atualização das informações dos produtos do marktplace é só rodar o processo "Retorna Todos os Produtos do MarketPlace" do menu.

Enviando Produto individualmente

Para criação/atualização das informações do produto do marktplace é só rodar o processo "Criar ou Atualizar um produto do MarketPlace" na janela produto. Esse mesmo processo pode ser rodado da aba "Descrição" e também atravez do Menu.

Copiando uma Descrição

Caso desejar, é possível duplicar a atual aba de Descrição do Produto. A descrição será duplicada substituindo a Organização e a Configuração do MarketPlace informadas.

Utilizando o MarketPlace

Obter os Pedidos

Após abrir o processo de obtenção de pedidos, será necessário informar apenas a configuração de qual MarketPlace será obtido.

Ajustando Pedidos inválidos

Após realizar o processo acima, pode ocorrer de alguns pedidos serem invalidados por falta de informações, assim será apresentado uma mensagem, verifique a imagem a seguir:

Clique no link com icone de Zoom para acessar a janela Pedido Obtidos do MarketPlace, assim irá apresentar a mensagem de erro relatando o que precisa ser ajustado.

No Plugg.to é possível integrar outros MarketPlaces através dele, sendo assim foi Adicionado novo campo Id do Pedido Original em Pedidos Obtidos do MarketPlace, está melhoria foi implementada para Parceiros que possuem integração de outras plataformas dentro do Plugg.to, onde o pedido passa a ter o ID oriundo do Plugg.to e da integração feita através do mesmo.

Ajuste as informações necessárias e salve, clicando no botão com icone de disquete, assim se todas os dados estiverem corretas o pedido ficará Válido.

Deletar Produto do MarketPlace

Acesse o cadastro do produto e vá na aba Descrição do MarketPlace, clique na engrenagem e clique em Deletar Produto.

Atualizando os Pedidos na Lista de Embarque

Nos Detalhes da Lista de Embarque é obrigatório adicionar o código de rastreio para que seja possível atualizar o pedido. O pedido pode ser atualizado um a um na aba Detalhes da linha de embarque, ou então atualizar todos os pedido no cabeçalho da Lista de Embarque.