Contabilium is an Argentine cloud ERP with AFIP electronic invoicing. With the integration on, every wholesale order reaches Contabilium formatted and ready to invoice, and Contabilium's price and stock show up in your catalog.
Step by step
- In Contabilium, generate the API Key from your account settings and note the integration ID.
- In VentasxMayor go to Settings → ERP and pick Contabilium.
- Fill in ID, Email (your Contabilium account email) and API KEY.
- If you use specific warehouses or price lists, enter the exact name under Deposit and Price List.
- Click Verify Configuration: it checks the credentials, the warehouse and the list against Contabilium and shows you errors and warnings before you operate.
- Save. Once Email and API KEY are filled in, the Sync Support block appears.
- Pass your Contabilium support team the URL from the Webhook configuration data box so they notify you of changes instantly.
Configuration fields
| Field | Description |
|---|---|
| ID | Identifier of your integration in Contabilium. |
| Your Contabilium account email. | |
| API KEY | Key generated in your account settings. |
| Deposit | Exact name of the warehouse stock is read from. Empty = general stock. |
| Price List | Exact name of the main list. Empty = the default one. This is the list applied to customers with no list of their own. |
| Additional lists | Extra lists for customers with an assigned list. The list code in VentasxMayor has to match the list name in Contabilium exactly. Each extra list is one more pass over the catalog on every sync. |
| Sync prices | Off: only stock is synced and you manage prices in the store. |
| No Stock | Does not bring stock from Contabilium. For anyone selling to order or made to order. |
| No Tax | Prices sent with the order do not carry added VAT. Off, 21% is added when they are sent. |
| Final price? | Brings Contabilium's "Precio Final" instead of the "Precio Base". |
| Discount in items | The order discount is spread as a per-product allowance, instead of travelling as separate discount lines. |
| Product name in invoice | Puts the product name before the variant name in the Concepto field. |
What syncs and in which direction
| What | Direction | When |
|---|---|---|
| Orders | Store → Contabilium | On confirmation, and again if you edit and save the order |
| Price and stock | Contabilium → Store | When you save a product, when the webhook fires, and with Update all products |
The order carries the buyer's data, the items with code, quantity, unit price, VAT and allowance, the payment and shipping surcharges as extra lines, the notes and the date. The status is sent as Aceptada, or Cancelada if you voided the order.
Only price and stock travel from Contabilium to the store. Products are neither created nor deleted, and name, description, categories and photos are never touched.
How the data requests are batched: when you save a product, or when Contabilium fires a webhook, the code goes into a queue. A central process takes that queue every 60 seconds and asks Contabilium for the updated data, instead of making one request per change. That minute is the maximum delay between the notification and the new price in your store.
Change notifier (webhook)
Contabilium can notify your store the moment a product changes. The ERP screen shows a Webhook configuration data box with the URL their team has to register, and a copy button. The URL includes the {CODIGO} placeholder, which the notifier replaces with the code of the product that changed.
To confirm notifications are arriving, look at Integration activity: Last push received tells you at a glance. If it says "Never", the notifier is not configured. This is the quietest failure mode of this integration, because everything looks fine while the stock goes stale.
Forcing a sync
In the Sync Support block:
- Update all products: walks the entire catalog. It takes several minutes, cannot be interrupted, and may overwrite changes made by hand.
- Update product: type a SKU Code in the field above and the button switches to syncing only that product. This is the only integration with this option.
If you cannot find it or it does not sync
- A product is at 0 and Contabilium shows stock. With Deposit configured, stock is read from that warehouse and no other. If the units are in a different warehouse, the store sees 0. Leave the field empty to use general stock.
- "Can I exclude some products from the sync?" There is no per-product exclusion. The levers are global: Sync prices, No Stock, or removing the product's code so it stops matching Contabilium.
- "How do I export the products I have not loaded into Contabilium yet?" In the product list, filter the ERP column by Not synced and export the result. That is exactly the list of codes Contabilium does not recognize.
- Products with the warning triangle. See the "Not synced" warning in the ERP integration article.
- An order did not arrive. The error stays in the order's own ERP communication log, with the Retry button, and also in Integration activity.
- Rate limit errors (429). When Contabilium answers that there are too many requests, we wait 60 seconds and retry automatically. If it happens often, you may be updating too many products at once; try during quieter hours.
- I edited the order and the change did not arrive. If you already changed the order's status in Contabilium (invoiced it, moved it to a quote), it is Contabilium that stops accepting changes. From our side the resend is attempted anyway. Make the adjustment in both systems.
Tips
- The Deposit and Price List names have to be exact. Use Verify Configuration to confirm instead of guessing.
- Review No Tax and Final price? carefully: the wrong combination makes the buyer see one price while Contabilium records another.
- Adding Additional lists multiplies the time each sync takes. Only add the ones you really use.