Online sales channels

Connect the online store to Tenka's stock and orders. Each channel has a feed address (the catalog) and a webhook address (the orders); Shopify and Nuvemshop are also fetched by themselves every 15 minutes.

The list shows each channel with its type, store, last fetch and its message; filter, save views and export as in any list. New channel and editing open the record, which shows the channel feed and webhook and, in the Orders received tab, what came in through it.

The ⋮ on each row (and the top of the record) holds the channel actions: fetch orders now (Shopify, Nuvemshop and authorized Mercado Livre), test the connection and authorize on Mercado Livre, and record by hand an order that came through it. Only people who can edit the screen see these actions.

One line per variant: SKU, EAN, style, size, color, e-commerce list price and availability (balance minus what is reserved for orders). Integrators and social media catalogs read this address.

POST in JSON: {"id", "cliente": {"nome", "documento", "email", "telefone"}, "itens": [{"sku", "quantidade", "preco"}], "total"}. Each id enters once; an unregistered SKU shows in the log with its code.

Shopify: the store is yourstore.myshopify.com and the token is from a private app with order read access. Nuvemshop: the store is the store number and the token is the app's. The token is stored encrypted; blank when editing keeps the stored one.

Mercado Livre: create an app in the Mercado Livre developer panel, register in it the return address shown here, paste the Client ID and Secret in the channel, save and tap the key to authorize. Paid orders come in by themselves with the shipment id, and the label comes out through the shipping center. Shopee and Shein: export the orders as a spreadsheet in their panel and upload it here — the preview shows each order before saving. Every channel order is born with its shipment in the queue, in the channel default method.

In Shopify and Nuvemshop channels, the "Send Tenka's stock to the store" option makes the job (every 30 minutes) push the available quantity of each size and color — only those that changed since the last send, up to 150 per round. A SKU the store does not have is counted in the channel message. The token needs permission to write inventory (on Shopify, also to read locations). It comes off: turn it on only if the real stock lives in Tenka.

In your Mercado Livre app, register the notifications address shown at the bottom of the screen and tick the orders_v2 and shipments topics. That way a paid order enters right away, the Mercado Envios label is downloaded when the shipment is ready and the shipment follows shipped, delivered and not delivered. The lightning bolt (Test connection) checks the authorization and says what is missing: Client ID, Secret or authorizing.

The API token and the Mercado Livre Secret are stored encrypted. In the record the field shows empty with a note that a value is stored: leave it blank to keep it, or paste a new one to replace it. The Shopee and Shein spreadsheet stays at the top of the list, with the preview before saving.

The three new channels are ready to switch on and being certified: each one needs its own seller account, the app authorization and, for testing, the marketplace's test environment. Once on, they work like Mercado Livre. With "issue NF-e" on, the order's invoice is created as a draft; Shein requires an NF-e per order and receives the authorized invoice. An order paid on the channel is retail and isn't subject to the wholesale closed grid. Mark which group stores "sell online": their stock counts toward the channels' availability, minus what is reserved.

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.