How to connect Infinity with easySales: a complete setup guide
Connect the Infinity marketplace to easySales: the VTEX application key, why the reference ID decides whether offers can be created, category mapping, linking existing offers and what each error means.
What connecting Infinity gives you
With Infinity connected, easySales sends your products to the marketplace, keeps their prices and stock in step, imports the orders and invoices them through your billing software — from the same screens you use for every other channel.
Before you start
An Infinity seller account
Infinity runs on VTEX, and the integration talks to your own Infinity account — you need to be selling there, or approved to.
An application key with roles
Generated in your Infinity account: an App key and an App token. A key with no roles authenticates as nobody and every call fails.
Your account name
The first part of your Infinity admin address — easysales429 in easysales429.myvtex.com.
Categories mapped, before you send offers
An offer with no Infinity category cannot be created. Category and category mapping are the two largest reasons offers sit still, ahead of everything else combined.
Step 1 — Create an application key in Infinity
Infinity runs on VTEX, so the credentials are a VTEX application key: a key and a token generated inside your own Infinity account, not a username and password.
In the Infinity admin, open your account settings and find Application keys. Create a key for easySales, give it the roles it needs to read and write products and orders, then generate it. You end up with two values — an App key and an App token — and you need both.
You also need the account name: the first part of your Infinity admin address. In https://easysales429.myvtex.com the account name is easysales429.
Step 2 — Connect in easySales
Go to Integrations → Marketplaces and search for infinity.
Press Connect on the Infinity card. The form has two tabs, Main settings and Additional settings.
| Field | What it is for |
|---|---|
| Connection Name | Your own name for this connection. It never reaches Infinity. |
| New order custom status | Optional. Lands imported Infinity orders on a status you defined instead of the default new-order one. |
| Price Addition | A percentage added to the product price before it is sent. 10% on a 100 RON product sends 110 RON. |
| Default shipping tax | The VAT rate applied to the shipping line on Infinity orders. |
| Invoice Series | The series invoices for Infinity orders are issued on. |
| Vat Payer | Yes if your company charges VAT, No otherwise. The choice sets the rate sent with the offers. |
| Send as reference ID | Internal ID or SKU — what Infinity stores as the reference for each offer. See the step below before choosing. |
| Account name |
The first part of your Infinity admin address: in easysales429.myvtex.com it is easysales429.
|
| App key and App token | The application key generated in your Infinity account. Both are required. |
Step 3 — Decide the reference ID before you send anything
Send as reference ID is the field the old documentation never mentioned, and it is the one that decides whether your offers can be created at all.
Step 4 — Additional settings
| Setting | What it does |
|---|---|
| Send offer prices to marketplace | Sends price changes from easySales to Infinity. Turn it off if prices are managed on Infinity's side. |
| Send offer stock to marketplace | Sends stock changes from easySales to Infinity. |
| Automatically enable offers when products have stock | Re-enables an offer by itself when its product goes from zero stock to some. Off by default, and worth turning on if you often run out and restock. |
Step 5 — Map your categories before you send offers
An offer only leaves easySales once it has an Infinity category. Category problems are by far the largest cause of stuck offers: a product with no Infinity category, or one whose category has never been mapped.
Open Marketplace → Categories, pick Infinity, and map the categories your products sit in to Infinity's own. Then check weight, which is the next most common cause after those two.
Step 6 — Offers you already have on Infinity
If you were already selling on Infinity before connecting, those offers are imported into Marketplace → Offers, on the Infinity tab, and they arrive unlinked. Linking an offer to the product in easySales is what lets price and stock updates flow.
Step 7 — Sending new products
From Products, filter by Without offers on → Infinity so you only see products that are not on the marketplace yet, then use Add offer on the ones you want to send.
Orders and invoices
New Infinity orders are imported into Orders like any other channel. Two settings on the connection shape what happens to them: Invoice Series decides the series their invoices are issued on, and New order custom status lets you land them on a status of your own instead of the default one.
When the connection stops working
| What you see | What to do |
|---|---|
| Missing category / Missing category mapping | The product has no Infinity category, or the category it sits in has not been mapped. Map it under Marketplace → Categories. Together these are the reason for the majority of stuck offers. |
| Invalid weight | Infinity will not take the product's weight. Correct it on the product. |
| Title is too long (max 120 characters) | Shorten the product name, or the name sent to this marketplace. |
| Description can not be empty | Add a description to the product. |
| Missing product brand | The product has no brand, and Infinity requires one. |
| Mandatory characteristics missing | The Infinity category expects characteristics the product does not have. Fill them in from the offer's edit screen. |
| Product rejected by marketplace | Infinity refused the offer itself. The detail is on the offer; it is usually a catalogue rule on their side. |
A product with external id "…" already exists.
|
The offer is already on Infinity. Link the imported offer to your product instead of sending a new one. |
Cannot authenticate request: failed to authenticate with provided credentials
|
The application key no longer works — deleted, or its roles were removed. Generate a new one in Infinity and update the connection. |
Price Variation Not Allowed: BasePrice Variation: Price exceeds allowed limits
|
Infinity caps how far a price may move in one step. Change it in smaller increments, or lift the limit on their side. |