Marketplaces — Mercado Livre, Amazon, iFood e 99Food

O módulo Marketplaces liga as suas contas de venda em plataformas externas ao GamaERP. O objetivo é simples: o pedido feito na plataforma entra sozinho no sistema como uma venda, o estoque baixa e a nota sai pelo mesmo lugar — sem ninguém digitar o mesmo pedido duas vezes.

Cada canal tem a sua própria tela, aberta pelo menu Integrações: Mercado Livre, Amazon, Shopee, iFood e 99Food. Na tela do canal você encontra só o que é dele — a conexão da sua conta, os pedidos recebidos naquele canal e as ligações entre os anúncios dele e os seus produtos. Se quiser comparar os canais lado a lado, o link Todos os canais, no alto da tela, abre a visão geral.

Em que pé está cada canal

Preferimos dizer isto com todas as letras a deixar você descobrir na prática. Hoje o Mercado Livre é o único canal liberado, e nele funciona o caminho completo: você autoriza a sua conta, o sistema guarda o acesso com segurança e renova sozinho, e os pedidos passam a ser buscados de hora em hora — virando venda no sistema quando estão pagos e com os anúncios ligados aos seus produtos. Amazon, iFood e 99Food ainda dependem de cadastro e liberação nas próprias plataformas.

A busca automática roda de hora em hora. Se você acabou de vender e quer ver o pedido agora, use o botão Buscar pedidos agora no cartão do canal — ele faz a mesma leitura na hora, sem esperar.

Fica no menu lateral, dentro de Operações. Cada canal é contratado separadamente: você paga só pelo que usa. Os canais que a sua empresa não contratou continuam aparecendo na tela, com um cadeado, para você saber o que existe e poder pedir quando quiser.

Mercado Livre

Canal de venda de produtos em geral. Os pedidos pagos entram como venda, com o cliente, os itens e o frete.

Amazon

Canal de venda de produtos em geral, para quem vende como parceiro vendedor da Amazon.

iFood

Canal de delivery de alimentação. Os pedidos chegam ao sistema conforme entram na plataforma, sem passar pelo tablet e sem redigitação.

99Food

Canal de delivery de alimentação, com o mesmo funcionamento do anterior: o pedido entra direto no sistema.

Antes de conectar: ligar cada anúncio a um produto seu

Esta é a parte que faz a diferença entre o estoque certo e o estoque errado. A plataforma manda o código do anúncio dela; o sistema precisa saber qual produto do SEU cadastro corresponde àquele código. Sem essa ligação, o sistema não tem como adivinhar de onde tirar a quantidade vendida.

Abra o menu Integrações e clique no canal que você usa — cada integração tem a sua própria tela (Mercado Livre, Amazon, Shopee, iFood e 99Food).
Localize a lista de ligações entre anúncios e produtos.
Informe o código do anúncio exatamente como ele aparece na plataforma.
Escolha, no seu cadastro, o produto que corresponde àquele anúncio.
Repita para cada anúncio que você mantém publicado naquele canal.

Faça as ligações ANTES de conectar o canal. Assim o primeiro pedido já entra completo, em vez de ficar esperando você resolver com o cliente aguardando.

Como conectar um canal

Abra o menu Integrações e clique no canal que você usa — cada integração tem a sua própria tela (Mercado Livre, Amazon, Shopee, iFood e 99Food).
Encontre o canal que você quer conectar. Se ele estiver com cadeado, é porque ainda não foi contratado — fale com o nosso suporte.
Clique no botão de conectar daquele canal.
Você é levado ao site oficial da plataforma. Faça o login ali mesmo, com o seu usuário e a sua senha daquela plataforma — o GamaERP nunca pede nem guarda essa senha, em nenhum momento.
Revise as permissões que a plataforma pede e autorize o acesso.
A plataforma devolve você ao GamaERP automaticamente, e a tela passa a mostrar o canal como conectado.

Se a conexão não for concluída

Quando algo impede a conexão, a plataforma devolve você ao GamaERP e a tela mostra um aviso dizendo o que aconteceu. São quatro as situações, e cada uma tem uma saída diferente:

A autorização expirou ou é inválida: o pedido de conexão vale por dez minutos. Se você demorou nessa etapa, clique em conectar novamente e refaça o login na plataforma.
A plataforma não devolveu os dados da conta: aconteceu alguma falha do lado dela no meio do caminho. Tente conectar novamente.
A conta já está conectada a outra empresa no GamaERP: a mesma conta da plataforma não pode servir a duas empresas, senão o mesmo pedido entraria duas vezes e o estoque baixaria em dobro. Entre na outra empresa, desconecte a conta lá e conecte aqui.
A plataforma recusou a autorização: normalmente é o login feito numa conta diferente da que você quis conectar. Confira em qual conta você está logado na plataforma e tente de novo.

Como desconectar um canal

Abra o menu Integrações e clique no canal que você usa — cada integração tem a sua própria tela (Mercado Livre, Amazon, Shopee, iFood e 99Food).
Localize o canal conectado — ele aparece com o nome da conta ligada.
Clique em Desconectar.
O GamaERP apaga o acesso guardado e deixa de receber os pedidos daquele canal.

Desconectar não apaga nada do que já entrou: as vendas e os pedidos importados continuam no sistema. O que para é a entrada de pedidos novos daquele canal, até você conectar outra vez.

O que acontece quando o pedido entra

O pedido aparece na lista Pedidos recebidos, dentro da tela do canal, em Integrações.
Estando pago e com todos os anúncios ligados a produtos, ele vira uma venda em RASCUNHO no sistema, já com os itens, as quantidades e os valores.
O estoque daqueles produtos fica RESERVADO na mesma hora. O saldo disponível cai, então o anúncio para de vender o que você acabou de vender — mas a baixa definitiva só acontece quando você emitir a nota.
Quando você emitir a nota daquela venda, a reserva é liberada e vira a baixa normal. O item nunca sai duas vezes do seu saldo.
Pedido com pagamento ainda não confirmado também entra como venda, mas NÃO reserva estoque: seria tirar da prateleira um saldo por uma venda que pode não acontecer.

A nota fiscal continua sendo decisão sua. O sistema deixa a venda pronta, com os dados fiscais vindos do cadastro do produto — quem confere e emite é você, como em qualquer outra venda.

Pedidos retidos: o que são e o que fazer

Um pedido fica retido quando chega ao sistema mas alguma coisa impede que ele vire venda com segurança. Ele aparece na tela com o motivo escrito. São duas as situações:

Algum item do pedido não está ligado a nenhum produto do seu cadastro. Faça a ligação daquele código e o pedido é liberado.
A conta do pedido não fecha: a soma dos itens mais o frete, menos o desconto, não bate com o total informado pela plataforma. Confira o pedido na própria plataforma antes de liberar.

O sistema retém em vez de importar assim mesmo, e isso é proposital. Uma venda com valor errado sujaria o seu faturamento e a apuração do seu contador; uma baixa de estoque no produto errado faria o seu saldo mentir sem nada avisar. É melhor o pedido esperar dois minutos por você do que o erro entrar em silêncio e ser descoberto no fim do mês.

Pedido cancelado na plataforma

Quando o pedido é cancelado do lado da plataforma, ele entra no sistema apenas registrado: não vira venda e não mexe no seu estoque. O registro existe para que a plataforma pare de reenviá-lo, e para você conseguir consultar depois o que aconteceu com aquele número.

O mesmo pedido pode chegar mais de uma vez — as plataformas reenviam quando não recebem a confirmação de leitura. O sistema reconhece a repetição e não cria a venda duas vezes, então você não precisa se preocupar com pedido duplicado.