Integrações Descontinuadas

Autor: Gustavo Francisco

Data de criação: 03/01/2020

Revisor: Ellem Cristina Ferraciolli

Data de revisão: 29/09/2020

Revisor: Thiago Teófilo

Data de revisão: 24/08/2021

Configurando o acesso à API

Credenciais de Acesso

Inicialmente, será necessário adicionar as credenciais de acesso ao MarketPlace. Cada MarketPlace tem suas credenciais de acesso, entre em contato com o seu marketplace para conseguir os acessos necessários. Os marketplaces integrados no BrERP são o Plugg.To, Adena, InfoAr, Moovin e o Skyhub. Como exemplo, temos o acesso ao Adena. Para isso, acesse a url do seu marketplace do Adena, conecte-se com suas credenciais.

E então adicione essas informações no BrERP, para isso abra o Menu > MarketPlaces > Configuração do MarketPlace.

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.

Destaque Para cada marketPlace o campo Último Pedido, possui um formato diferente. Verifique abaixo o padrão de cada integração:

• Adena: DD/MM/AAAA (25/09/2019)
• InfoAr: AAAA-MM-DD (2019-09-25)
• Moovin: AAAA-MM-DD hh:mm:ss (2019-09-25 17:38:45)
• SkyHub: AAAA-MM-DDThh:mm:ss (2019-09-25T17:38:45)

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.

Novamente, para cada marketplace tem uma sequencia de status permitido.

Para o Adena, o campo “Value” e o campo “Status Url” deve ser estritamente idêntico ao da tabela abaixo (se não tiver Status Url, o pedido com esse status não pode ser filtrado, apenas poderá ser atualizado), já o campo “Name” pode ser qualquer outro valor para sua identificação.

Value	Status Url	Descrição	Pago	Observações
pr		Pedido Recebido	Não	Retornado apenas no momento de criação do pedido na loja no método de todos os pedidos
ag	aguargando_pagamento	Aguardando o Pagamento	Não	Retornado pelo método aguardando_pagamento e todos os pedidos
pa	analise	Pedido em análise	Não	Retornado pelo método analise e todos os pedidos
pp	pagos	Pago pago	Sim	Retornado pelo método pagos e todos os pedidos
ps		Pago em separação	Sim	Retornado pelo método de todos os pedidos
le		Liberado para envio	Sim	Retornado pelo método de todos os pedidos
pe	enviados	Pedido enviado	Sim	Retornado pelo método enviados e todos os pedidos
pent	entregues	Pedido entregue	Sim	Retornado pelo método entregues e todos os pedidos

Para o InfoAr 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. Link para documentação deles: InfoAr

Nome	Value
Aguardando Pagamento	status.waiting_payment
Pago	status.paid
Não autorizado	status.payment_refused
Aguardando envio	status.waiting_shipment
Em separação	status.preparing_shipment
Enviado	status.shipped
Aguardado retirada	status.waiting_pick_up
Entregue	status.delivered
Cancelado	status.canceled
Faturado	status.billed
Faturado parcialmente	status.billed_partial
Devolvido parcialmente	status.returned_partial
Devolvido	status.returned

Para o Moovin 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. Link para documentação deles: Moovin

codigo_status	descricao_loja	descricao_loja	descricao_loja
1	Em compra	Em compra	pendente
2	Pendente	Pendente	pendente
3	Em Análise	Em Análise	pendente
4	Aprovado	Crédito e Cadastro Aprovados	aprovado
5	Aguardando ClearSale	Em análise	pendente
6	Ag. Conf. de Estoque	Em Análise	pendente
7	Ag. Produto	Em Análise	pendente
8	Aguardando Retirada	Aguardando Retirada	transporte
9	Faturado - NF	Aprovado para envio	aprovado
10	Cancelado Pagamento	Cancelado	cancelado
11	Cancelado Análise	Cancelado	cancelado
12	Devolvido	Devolvido	completo
13	Entregue atrasado	Entregue	completo
14	Entregue	Entregue	completo
15	Furtado	Transporte	transporte
16	Entregue indenizado	Entregue	completo
17	Transporte	Transporte	transporte
18	Transporte Atrasado	Transporte	transporte
19	Transporte Problema	Transporte	transporte
20	Trasporte Conceito	Transporte	transporte
21	Fraude	Cancelado	cancelado
28	Pendente Retorno	Pendente	pendente
29	Troca	Em processo de troca	completo
30	Aguardando estoque (pré-venda).	Aguardando estoque (pré-venda)	aprovado
31	Saiu para entrega	Saiu para entrega	transporte
32	Aprovação parcial de Cartão	Aprovação parcial de Cartão	pendente
66	Estornado	Cancelado	cancelado

Para o SkyHub 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. Link para documentação deles: SkyHub

Value	Chave de Busca	Tipo	Descrição
order_canceled	Cancelado (SkyHub)	CANCELED	Canceled é o status que o pedido recebe quando o mesmo foi cancelado, seja porque o cliente desistiu da compra ou o lojista não tem mais o estoque para atender ao pedido.
order_shipped	Pedido Enviado (SkyHub)	SHIPPED	Shipped é o Status que o pedido recebe quando o lojista envia os dados de NFe e Código de Rastreio.
complete	Completo (entregue) (SkyHub)	DELIVERED	Delivery é o status que o pedido recebe quando foi entregue ao cliente.

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.

Para o Adena, deverá ser informado o SKU do produto no campo "SKU (UCE)" do BRERP. Na aba "Descrição" é obrigatório preencher os campos “Configuração do MarketPlace”, “Identificador MarketPlace” e “Categoria”. O campo Identificador (ID) do produto no Adena pode ser encontrado conforme o print a seguir.

Clica no botão de zoom (botão azul selecionado no print abaixo) ou no botão de edição (botão amarelo selecionado). O ID do produto vai estar na url, conforme o print abaixo (nesse exemplo o ID é 965)

• InfoAr: Deverá ser informado os campos "Nome (MarketPlace)", "Marca do Produto (MarketPlace)", "Comprimento do Produto (MarketPlace)" e "Altura do Produto (MarketPlace)" e "Comprimento do Produto (MarketPlace)" devem ser informados em cm. Na aba "Descrição" é obrigatório o “Configuração do MarketPlace”, "Identificador MarketPlace" e "Descrição MarketPlace". De acordo com a InfoAr podem causar a reprovação do produto na plataforma o não preenchimento da Descrição do produto (campo "Descrição MarketPlace" no BRERP) com texto de garantia e a Tensão em caso de aparelhos eletronicos, e as dimensões do produto. Para indisponibilizar um produto, o estoque deve ser zerado e o status "Disponivel no MarketPlace" deve ser desmarcado.

• Moovin: Deverá ser informado o SKU do produto no campo "SKU (UCE)" do BRERP. Na aba "Descrição" é obrigatório preencher os campos “Configuração do MarketPlace”, “Identificador MarketPlace”.

• Skyhub: Deverá ser informado o SKU do produto no campo "SKU (UCE)" do BRERP. Na aba "Descrição" é obrigatório preencher os campos “Configuração do MarketPlace”, “Identificador MarketPlace”, "Descrição MarketPlace", "Categoria".

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.

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.

**Esta opção só é possivel realizar com a integração SkyHub

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.