As integrações com Magalu Marketplace e Amazon Seller Central sincronizam produtos (push) e pedidos (pull) em produção. OAuth, refresh automático de tokens e fluxo de pedidos passando por Canais → Pedidos recebidos (sem auto-conversão). Esta página detalha como conectar e o que cada provider exige.
Conectar
Magalu
- Canais → Marketplaces → Magalu → Conectar.
- Você é redirecionado pra developer.magalu.com, autoriza o app, e volta pro Jefacil com status “Conectado”.
- Passo manual obrigatório: preencha o External User ID no painel da conexão. A Magalu não retorna o seller_id no token OAuth, então o Jefacil precisa que você cole o ID que aparece no Magalu Seller Center (campo “ID do vendedor”). Sem isso, o push e o pull retornam erro de autorização.
Amazon
- Canais → Marketplaces → Amazon → Conectar.
- Login with Amazon (LWA) abre — autoriza o app no Amazon Developer Console e volta com status “Conectado”.
- Pré-requisito de infra: a SP-API exige AWS Signature V4 (SigV4) em cada request. O backend só consegue chamar se as variáveis
AWS_ACCESS_KEY_IDeAWS_SECRET_ACCESS_KEYestiverem configuradas no.env. Sem elas, o login funciona mas o sync devolve erro de credenciais. Fale com a gente no WhatsApp se precisar de orientação no setup AWS — depende da sua conta de seller.
Push de produtos
Magalu
Push básico via api.magalu.com: nome, preço, descrição, fotos e categoria. Anúncios são criados sob a sua loja Magalu. Use o botão “Publicar produtos” no card do canal pra disparar o sync da loja ativa.
Amazon
Listings Items API. A estratégia muda conforme o que o produto tem cadastrado:
| Cenário | Estratégia | Resultado |
|---|---|---|
| Produto tem GTIN preenchido | LISTING_OFFER_ONLY | Vincula uma oferta sua a um listing já existente no catálogo Amazon. Recomendado quando o produto já é vendido na Amazon — você só entra como vendedor competitivo. |
Produto sem GTIN mas com product_type | LISTING | Cria listing novo. Você precisa ter preenchido os atributos obrigatórios do product_type escolhido (varia por categoria). |
| Produto sem nenhum dos dois | — | Entra em errors com missing_gtin_or_product_type. Cadastre GTIN ou product_type antes de tentar de novo. |
Os campos avançados (GTIN, MPN, brand, product_type, google_product_category) ficam na aba Avançado do formulário de produto. Ver Catálogo.
Pull de pedidos
Pedidos de Magalu e Amazon chegam em Canais → Pedidos recebidos com status PENDING. Você revisa, converte em venda pelo PDV, e o Jefacil dá baixa de estoque + emite NFC-e como qualquer venda. Input externo nunca mexe em estoque sem revisão humana — ver Pedidos recebidos pra fluxo completo.
- Magalu — listagem via API + endpoint do Jefacil. Cron de refresh dos tokens roda a cada 30min.
- Amazon —
/orders/v0da SP-API com paginação. Mesmo cron de refresh cobre os tokens LWA.
Limitações
- Magalu — External User ID manual. Se você trocar de seller dentro da mesma conta, atualize o campo no painel. O Jefacil não detecta a troca sozinho.
- Amazon — rate limits da SP-API. A Amazon impõe quotas por endpoint. Pull excessivo retorna 429; o Jefacil faz backoff exponencial mas em caso de saturação intermitente, espace os disparos manuais.
- Sem auto-conversão de pedidos. Mesmo com tudo configurado, todo pedido passa por revisão antes de virar venda. Cancelamento do cliente no marketplace não sincroniza pra trás — você descarta manualmente.
- Atributos de produto não-básicos. Tanto Magalu quanto Amazon têm campos próprios (variação de cor, dimensão de envio, EAN secundário). Esses ficam vazios no push inicial — você complementa direto no Seller Center quando precisar.
Quando usar (vs. hub intermediário)
Pra quem vende em poucos marketplaces, conectar direto pelo Jefacil evita pagar mensalidade de hub e mantém o catálogo sincronizado num lugar só.
Pra quem precisa de muitos marketplaces simultâneos (>5) com regras complexas de pricing/estoque, considere usar Bling, Tiny ERP ou Olist como camada intermediária — você usa o Jefacil como ERP principal e o hub distribui pros N marketplaces. Perde algum controle fino, ganha cobertura sem manter N integrações.