Canais de venda online

Ligar a loja virtual ao estoque e aos pedidos do Tenka. Cada canal tem um endereço de feed (o catálogo) e um de webhook (os pedidos); Shopify e Nuvemshop também são buscadas sozinhas a cada 15 minutos.

A lista mostra cada canal com o tipo, a loja, a última busca e a mensagem dela; filtre, salve visões e exporte como em qualquer lista. Novo canal e edição abrem a ficha, que traz o feed e o webhook do canal e, na aba Pedidos recebidos, o que entrou por ele.

No ⋮ de cada linha (e no topo da ficha) ficam as ações do canal: buscar os pedidos agora (Shopify, Nuvemshop e Mercado Livre autorizado), testar a conexão e autorizar no Mercado Livre, e registrar à mão um pedido que veio por ele. Só quem pode alterar a tela vê essas ações.

Uma linha por variação: SKU, EAN, referência, tamanho, cor, preço da tabela de e-commerce e o disponível (saldo menos o reservado para pedidos). Integradores e catálogos de redes sociais leem este endereço.

POST em JSON: {"id", "cliente": {"nome", "documento", "email", "telefone"}, "itens": [{"sku", "quantidade", "preco"}], "total"}. Cada id entra uma vez; SKU sem cadastro aparece no registro com o código.

Shopify: a loja é sualoja.myshopify.com e o token é o de um app privado com leitura de pedidos. Nuvemshop: a loja é o número da loja e o token é o do aplicativo. O token fica guardado cifrado; em branco ao editar, mantém o guardado.

Mercado Livre: crie um aplicativo no painel de desenvolvedor do Mercado Livre, cadastre nele o endereço de retorno mostrado aqui, cole o Client ID e o Secret no canal, grave e toque na chave para autorizar. Os pedidos pagos entram sozinhos com o id do envio, e a etiqueta sai pela central de expedição. Shopee e Shein: exporte os pedidos em planilha no painel deles e envie aqui — a prévia mostra cada pedido antes de gravar. Todo pedido de canal já nasce com a expedição na fila, na modalidade padrão do canal.

Nos canais Shopify e Nuvemshop, a opção "Enviar o estoque do Tenka para a loja" faz o job (a cada 30 minutos) subir o disponível de cada tamanho e cor — só os que mudaram desde o último envio, até 150 por rodada. SKU que a loja não tem é contado na mensagem do canal. O token precisa da permissão de escrever estoque (na Shopify, também de ler locais). Vem desligado: ligue só se o estoque de verdade mora no Tenka.

No seu aplicativo do Mercado Livre, cadastre o endereço de notificações mostrado no fim da tela e marque os tópicos orders_v2 e shipments. Assim o pedido pago entra na hora, a etiqueta do Mercado Envios é baixada quando o envio fica pronto e a expedição acompanha enviado, entregue e não entregue. O raio (Testar conexão) confere a autorização e diz o que falta: Client ID, Secret ou autorizar.

O token da API e o Secret do Mercado Livre são guardados cifrados. Na ficha, o campo aparece vazio com o aviso de que há um valor guardado: deixe em branco para mantê-lo, ou cole um novo para trocar. A planilha da Shopee e da Shein continua no topo da lista, com a prévia antes de gravar.

Os três canais novos estão prontos para ligar e em homologação: cada um pede a conta de vendedor dele, a autorização do app e, para testar, o ambiente de testes do marketplace. Ligados, entram como o Mercado Livre. Com "emitir NF-e" ligado, a nota do pedido nasce em rascunho; a Shein exige NF-e por pedido e recebe a nota autorizada. O pedido pago no canal é varejo e não passa pela grade fechada do atacado. Marque nas lojas do grupo quais "vendem online": o saldo delas entra no disponível dos canais, sem o reservado.

O webhook do canal pode reenviar o mesmo evento. O Tenka casa o pedido pelo número externo do canal: se o segundo chegou com número diferente, foi o canal que criou dois pedidos. Confira na loja; cancele o duplicado aqui pelo número externo para o estoque voltar.