- Home
- Documentation
- Other marketplaces
- Sync Coppel with Shopify
Sync Coppel with Shopify
How to connect your Coppel shop to Toldo with an API key, what syncs with Shopify and how to accept each order in time, by hand or automatically.
This feature is rolling out: we're turning it on in stages with our founding partners. What this guide describes may change before general availability.
In short
You connect Coppel with an API key from your seller panel: Toldo checks it, shows you your shop and you confirm. Toldo sends your stock (at most one update a minute), creates Coppel orders in Shopify and sends Coppel the tracking. If Coppel asks you to accept each order, you accept or refuse it in Toldo before its deadline, or you turn on automatic acceptance, which is off by default. Coppel is in pilot.
Before you start
- Your Shopify store must be in Mexico. Coppel shows under Marketplaces for stores in Mexico.
- Create an API key. In your Coppel seller panel, in your user settings, create an API key. Ideally, do it with a user just for Toldo: that way, regenerating your own key never cuts the sync. The user must be able to manage the shop.
- Get your SKUs ready. Each Coppel offer is linked to a Shopify variant by its SKU, then by barcode. See Link listings.
- One Coppel shop, one Shopify store. A Coppel shop can be connected to only one Shopify store at a time.
Steps to connect Coppel
- Open Marketplaces in Toldo. In your Shopify admin, go to Toldo and open Marketplaces.
- Enter your key. Under Connect a channel, in the Coppel box, paste your key into API key. If your user has several shops, also enter the number of the shop you want to connect in Shop id (only if your user has several shops).
- Check the key. Click Check the key. Toldo tests it with a single read and shows you your shop: Connect [your shop] on Coppel?
- Connect. If it's the right shop, click Connect. If Coppel shows the shop as closed or suspended, Toldo tells you first. If you take more than 15 minutes, check the key again.
- Check your listings. Toldo takes you to the account's page. Within a minute it starts reading your offers, links them to your Shopify products and sends them stock with the default rules. Prices don't change until you turn on sending them. Only orders placed after you connect are imported.
If Coppel doesn't accept the key, you'll see "Coppel didn't accept this key. Copy it again from your Coppel seller panel." If the key's user can't read the shop, "This key's user can't read the shop: use a shop administrator's key."
How your key is kept
- Encrypted. Toldo stores the key encrypted and never writes it to its logs.
- Only for Coppel. Toldo only sends the key to Coppel.
- Tied to your shop. The key is tied to the shop you confirmed: even if your user gets another shop later, Toldo only works with that one.
What syncs
| What | What Toldo does |
|---|---|
| Listings | Reads all your offers once a day and links them to your Shopify variants. |
| Stock | Sends Shopify stock as a stock file, at most once a minute: that minute's changes go together. Coppel confirms it a few minutes later. |
| Prices | Off by default. If you turn it on, at most once a minute, with your price rules. Offers with a running or scheduled discount aren't repriced. |
| Orders | Checks your orders every 5 minutes and creates the ones Coppel has charged in Shopify, tagged "Coppel". |
| Order acceptance | If Coppel asks you to accept each order, you accept or refuse it in Toldo, or Toldo accepts it with automatic acceptance. |
| Tracking | Sends Coppel the tracking number and carrier of your Shopify fulfillment, and marks the order shipped. |
The stock rules are the same as on Mercado Libre. While a write waits for Coppel's confirmation, the account's page says so: "… writes wait for Coppel to confirm them." If Coppel doesn't confirm it, Toldo sends it again.
Accept Coppel orders
If your Coppel shop asks you to accept each order, the account's page shows the Order acceptance section, and each new order shows under Recent orders as "Waiting for your answer", with the Accept and Refuse buttons. A banner at the top of the page reminds you: "… Coppel orders wait for your answer: accept or refuse them before their deadline, or Coppel refuses them."
- The deadline. Coppel refuses orders that aren't accepted in time. Toldo doesn't know Coppel's deadline, so it shows no due date next to the order: answer as soon as you can.
- Accept or refuse. Accept accepts the whole order. Refuse asks you to confirm with Yes, refuse: Coppel cancels it and refunds the buyer, and this can't be undone.
- In Coppel's panel. You can also answer there. If you refuse it there, Toldo marks it cancelled the next time it reads your orders. If you accept it there, Toldo keeps showing it as "Waiting for your answer" until Coppel charges the buyer, and then it comes into Shopify.
- After you accept. The order shows as "Accepted, waiting for payment" and comes into Shopify when Coppel charges the buyer.
- Your other channels. From the moment the order arrives until it's in Shopify, its units are held back from the stock of all your channels. If you refuse it, they're offered again.
Toldo doesn't answer orders placed before you connected the account. Accepting an order never waits on your plan's limit: what waits, if you've reached the limit, is creating it in Shopify.
Automatic acceptance
Accept Coppel orders automatically is off by default. If you turn it on, Toldo accepts an order at once when every item is linked to a Shopify variant and Shopify has the stock at the locations that count, less the units you've already promised in other orders (accepted, waiting because of your plan's limit, failed or being created).
If that isn't the case, the order waits for your answer and the Activity says why: automatic acceptance is off, an item isn't linked, or Shopify doesn't have the stock for every item. Toldo checks the waiting orders again every time it reads your orders, in case you've linked the item or stock came in. When you turn the rule on, it checks the ones already waiting right away.
Shipping and tracking
- How the order arrives. Paid, tagged "Coppel", without creating a customer and with the shipping address. If Shopify doesn't accept the address, the order is created without it and the Activity asks you to copy it from Coppel. The shipping method says "Shipped by the seller".
- Tracking. Fulfil the order in Shopify with its tracking number and carrier: Toldo sends them to Coppel and marks the order shipped. If the tracking number is missing, the Activity lets you know.
- Carriers. Toldo uses the carriers Coppel has registered. If Coppel only takes its own and yours isn't one of them, you'll see "Coppel only takes its own carriers, and this one isn't among them."
- Cancellations. If Coppel cancels an order, Toldo cancels it in Shopify or, if it's already fulfilled, tags it so you can handle the return, just as with Mercado Libre.
Each imported order counts toward your plan's marketplace orders, which add up all your channels. See Plans and limits.
Invoicing
Toldo doesn't invoice your Coppel sales or upload invoices to Coppel. Their orders come into Shopify with the toldo-import tag, so they don't go into your factura global and can't be invoiced from the Self-invoicing portal. Invoice them as you do today.
Disconnect Coppel or change the key
- Disconnect. On the account's page, click Disconnect and confirm with Yes, disconnect. Toldo stops syncing the shop and deletes your key and its listing and order links; your rules are kept. A key can't be withdrawn from Toldo: generate a new one in your Coppel seller panel, so the one Toldo used stops working.
- If Coppel stops accepting the key (because you regenerated it or its user was removed), the account shows Reconnect needed and you'll see "Coppel no longer accepts the API key (regenerated, or its user removed): enter a new key." Click Connect again and enter your new key in the Coppel box.
Frequently asked questions
Can I accept only part of an order?
Not from Toldo: you accept or refuse the whole order.
Why does stock take a few minutes to show on Coppel?
Coppel takes at most one stock update a minute and applies it a few minutes later. Toldo groups each minute's changes into a single write and checks that Coppel confirms it.
Is Toldo an official Coppel app?
No. Toldo is an independent app that uses Coppel's seller API with your key.