Linx Commerce
E-commerceLinx Commerce is the Brazilian ecommerce platform from Linx S.A., part of StoneCo. Agents poll orders into an ERP, push stock and price feeds from a warehouse system, manage SKUs, promotions and marketplace offers, and serve LGPD privacy requests.
What This Integration Enables
Linx Commerce is a Brazilian ecommerce platform, and the surface FlowRunner connects to is not the shopper facing storefront. It is the integration layer the platform expects a retailer's ERP and warehouse system to talk to, which is why the operations here are orders, stock, prices, fulfillment, and catalog rather than sessions and checkouts. The platform publishes no webhooks at all. What it publishes instead is a queue: every change lands in it, the consumer reads a page, does the work, and acknowledges only what succeeded. FlowRunner agents run that loop as designed, and the acknowledgment is deliberately the last step rather than the first.
The other thing this connector does is refuse to launder the platform's answers. A refused call here still returns a normal response and reports its outcome in the body, batch writes report valid and invalid rows rather than failing, and several writes are gated by switches that make a well formed request change nothing at all. This connector reads all of that and raises rather than passing a false success into the flow, which is what makes unattended runs worth allowing. It is also what makes the human-in-the-loop moments meaningful: when an agent stops here, it stops because something real was refused or something irreversible is next, not because a status code looked odd.
Without FlowRunner
With FlowRunner
Use Case Scenarios
-
Orders into the ERP, invoice and tracking back out
A schedule drains the order queue with Get Queue Orders, which returns each order complete rather than as a reference to fetch. The agent creates the sales order in Acumatica or NetSuite, waits for the confirmation, and only then calls Dequeue Queue Items for the orders that landed. When the fiscal invoice is issued, Set Order Invoice writes it back to the order, and when the carrier assigns a code, Update Order Package Tracking Number puts it where the shopper will look for it. Get Queue Items Count runs on every pass as a health check, because a backlog that climbs is the earliest sign that acknowledgment has stopped matching reality.
-
The nightly feed that can succeed and change nothing
A warehouse system exports stock and a buying team exports prices, sometimes through a sheet in Google Sheets. The agent pushes stock with Change SKU Inventories and prices with Save Product Price Bulk, then reads the per item results rather than the overall answer, because both routes report refused rows inside a response that otherwise looks clean. It also checks the switches it sent: a price written with the base price switch off is accepted and applied to nothing, which is the failure mode worth designing against because it produces no error anywhere. Rows below the reorder point from Search Inventory SKUs post to a buying channel in Slack so a purchaser can act while there is still time to act.
-
A privacy request answered by the right person
A data subject request arrives, usually as an email rather than as structured data. The agent parses the name, document number, and email out of it, runs Search Customers, and pulls each candidate with Get Person and Get Customer to assemble a comparison: which record has orders, which has the matching document number, which was created when. It writes nothing. The candidates and the original request go to the privacy owner, who identifies the data subject. Only then does the agent call Enqueue Anonymize Customer, and it confirms back with Enqueue Customer Export when the request also asked for a copy of the data.
Human-in-Loop Highlight
Enqueue Anonymize Customer is the one write in this connector aimed at destroying information deliberately, and it is the right operation for a Brazilian data subject request precisely because it strips the personal data while leaving the order history reportable. It also cannot be reversed, and the record it is pointed at is chosen by a match rather than by an identifier. Search Customers filters on stored fields, so an agent can find the three accounts whose document number or email resemble the one in an inbound request, and it cannot tell which of them is the person who wrote it. So it stops and asks the privacy owner: "This request names Ana Ribeiro and gives a document number ending 4471. Three customer records are close: one exact document match with no orders, one email match with 22 orders, one name match created last week. Which record is the data subject?" The agent gathered the candidates, wrote the comparison, and has the export ready. It did not decide whose data to erase, and it never reaches for Delete Customer, which sits in the same connector and would take the order history with the person.
Agent Capabilities
180 actionsConnection
2- Check Credentials Confirms the credentials and the tenant host are right. The connection test, and worth running first because a wrong password and a tenant using the other authentication scheme produce the same error.
- Get Master Status Reads the platform's own health signal for the tenant.
Integration Queues
8- Get Queue Orders Reads a page of the order queue and returns each order in full, which saves a second call per order.
- Get Queue Customers Reads a page of the customer queue and returns each customer in full.
- Search Queues Lists the tenant's queue aliases. Queue names are defined per tenant, so a flow discovers them rather than assuming them.
- Get Queue Retrieves one queue and its configuration.
- Get Queue Items Count Returns how many items are waiting. The cheap health check: a count that keeps climbing means the consumer is not acknowledging what it processed.
- Search Queue Items Reads a page of queued changes. Lock Items belongs on whenever more than one flow drains the same queue, or both pick up the same records.
- Dequeue Queue Items Acknowledges items as processed. Final: an acknowledged change is gone and the platform will not publish it again, so this runs after the downstream write lands, never before.
- Get Queue Item Queued Task Returns the task behind a queue item. Where to look when an item's attempt count keeps rising instead of the item clearing.
Orders
26- Search Orders Runs a filtered query over orders. Filters are expressions evaluated by the platform against the result rows, and pages count from zero.
- Search Orders By Seller Runs the same order query scoped to one marketplace seller.
- Search Order Candidates Finds carts that were started and never paid for. What Linx Commerce calls an order candidate, and the raw material for abandoned cart recovery.
- Get Order Retrieves one order by its internal identifier.
- Get Order By Number Retrieves one order by the number a shopper or a support agent would quote.
- Get Order Group Retrieves an order group, which is how a single purchase split across sellers or shipments is held together.
- Get Order Group By Number Retrieves an order group by its number.
- Update Order Updates an order's fields.
- Make Order Transition Moves an order to another status. Statuses and transition identifiers are defined per tenant, so they are read from the account rather than hard coded.
- Run Order Workflow Runs a configured order workflow, which is how the platform's own automation is invoked from a flow.
- Update Order Remarks Writes the order note. This replaces the existing note rather than appending to it, so a flow reads the current text first if it means to add to it.
- Set Order Invoice Writes the fiscal invoice back onto the order. The step that closes the loop after an ERP issues the document.
- Search Order Statuses Lists the order statuses this tenant actually uses.
- Get Order Status Retrieves one order status definition.
- Search Financial Order Info Queries the financial view of orders, which is what payment reconciliation is run against.
- Get Order Payments Lists the payments recorded against an order.
- Get Order Payment Retrieves one payment on an order.
- Search Order Packages Queries the packages an order was split into.
- Get Order Package Retrieves one package with its contents and state.
- Save Order Package Creates or updates a package on an order, which is how a warehouse system's pack decision reaches the storefront.
- Update Order Package Tracking Number Writes the carrier tracking code onto a package. The write a shopper actually sees.
- Get Shipment Retrieves one shipment record.
- Search Shipments Queries shipments, including by order and by state.
- Update Shipment Updates a shipment record.
- Search Payment Terms Lists the payment terms configured for the tenant.
- Get Payment Term Retrieves one payment term definition.
Fulfillment
9- Get Fulfillment Retrieves one fulfillment record.
- Search Fulfillments Queries fulfillments, including by state and store.
- Save Fulfillment Creates or updates a fulfillment, which is the record behind click and collect and ship from store.
- Update Fulfillment Updates a fulfillment using the platform's first generation shape, with a fulfillment status and a shipping block.
- Update Fulfillment V2 Updates a fulfillment using the platform's second shape, with a workflow type and a shipment block. Both routes exist and take different bodies, so a flow uses whichever the tenant's integration was built against.
- Run Fulfillment Workflow Advances a fulfillment through the tenant's configured workflow.
- Save Fulfillment Exception Records an exception on a fulfillment, such as a store that cannot pick the order.
- Save Fulfillment Treatment Records how a fulfillment exception was handled, which is the audit trail behind a reroute.
- Enqueue Fulfillment Status Notifications Queues the customer notifications for a fulfillment status change.
Payments
4- Get Transaction Retrieves one payment transaction with its provider detail.
- Search Transactions Queries payment transactions, which is what a settlement file is reconciled against.
- Get Order Payment Actions Lists the payment actions the provider currently allows on an order. What is permitted depends on how far the transaction has progressed, so this read belongs before any attempt to act.
- Invoke Order Payment Action Runs a payment action such as a capture or a cancel. A cancel is not reversible, and the connector refuses an action it does not recognize rather than passing an unknown value to the provider.
Customers
18- Search Customers Runs a filtered query over customers. The filter is an expression over stored fields, so matching a person from an inbound message is still a judgment rather than a lookup.
- Get Customer Retrieves one customer record.
- Save Customer Creates or updates a customer account.
- Save Person Creates or updates a customer as a natural person.
- Save Company Creates or updates a customer as a legal entity, which is the B2B side of the same account model.
- Get Person Retrieves the person view of a customer, with the personal fields.
- Get Company Retrieves the company view of a customer, with the entity fields.
- Delete Customer Deletes the customer record itself. For a privacy request this is the wrong tool, because anonymizing keeps the order history reportable and this does not.
- Save Customer Address Creates or updates an address on a customer account.
- Run Customer Transition Moves a customer through a configured status transition, such as approving a B2B account.
- Get Customer Status Retrieves a customer status definition.
- Get Customer Status By Integration ID Retrieves a customer status by the identifier the upstream system uses, which is how an ERP addresses a record it did not create.
- Save Customer Status Creates or updates a customer status definition.
- Search Customer Groups Lists the customer groups the tenant uses to decide pricing and visibility.
- Get Customer Group Retrieves one customer group.
- Save Customer Group Creates or updates a customer group.
- Delete Customer Group Deletes a customer group, along with the pricing and visibility rules keyed to it.
- Send Recover Customer Password Email Sends the platform's password recovery email to a customer. This reaches a real person, so it belongs in flows a support agent triggers rather than in an unattended sweep.
Catalog
62- Search Products Runs a filtered query over products.
- Get Product Retrieves one product by its platform identifier.
- Get Product By Integration ID Retrieves a product by the identifier the upstream system uses. The read a PIM sync is built on, because it addresses records by the sender's own key.
- Get Products By Integration ID Retrieves many products by upstream identifier in one call.
- Save Product Creates or replaces a product in full. Fields left out are written as empty, so this is the wrong write for an incremental content edit.
- Save Products Creates or replaces many products in one call and reports per item results, so a batch where half the rows were refused does not read as a clean success.
- Update Products Updates many products in one call, with the same per item reporting.
- Partial Update Product Patches only the fields sent, which makes it the safest product write on the platform. Its one sharp edge is the media replacement switch.
- Delete Product Permanently deletes a product, along with its reviews, media, and URL history.
- Delete Product By SKU Permanently deletes a product addressed by SKU.
- Activate Product Puts a product back on sale. The inverse of disabling, which is why disabling is preferred over deleting for a discontinued line.
- Disable Product By Integration ID Takes a product off sale by upstream identifier. Reversible, and it keeps the reviews, media, and URL history a deletion would take.
- Set Product Visibility Changes where a product is visible without changing whether it is active.
- Run Product Workflow Runs a configured product workflow, such as an approval path for new listings.
- Get Product Categories Lists the categories a product is filed under.
- Get Product SEO Returns a product's SEO fields, including the URL history that a deletion would destroy.
- Get Product Definition Retrieves a product definition, which is the attribute template a product type follows.
- Search Product Definitions Lists the product definitions the tenant has configured.
- Search Product Reviews Queries customer reviews on products.
- Save Product Review Creates or updates a product review, including its moderation state.
- Search SKUs Runs a filtered query over SKUs.
- Get SKU Retrieves one SKU.
- Get SKU By Integration ID Retrieves a SKU by the upstream system's identifier.
- Get SKUs By Integration ID Retrieves many SKUs by upstream identifier in one call.
- Save SKU Creates or updates a SKU.
- Add SKU To Product Attaches a SKU to a product, which is how a new size or color joins an existing listing.
- Remove SKU From Product Detaches a SKU from a product without deleting it.
- Delete SKU Permanently deletes a SKU.
- Delete SKU By SKU Permanently deletes a SKU addressed by its SKU code rather than its identifier.
- Get Product ID By SKU Integration ID Resolves an upstream SKU identifier to the platform's product identifier. The lookup that makes a warehouse feed addressable.
- Search Categories Runs a filtered query over categories in a catalog.
- Get Category Retrieves one category.
- Save Category Creates or updates a category.
- Delete Category Deletes a category and everything beneath it. Products filed only under it stop appearing in navigation.
- Move Category Moves a category to another parent, which rewrites the navigation path for everything under it.
- Get Category Properties Lists the properties defined on a category.
- Get Category Property Values Lists the values a category property can take, which is what a faceted filter is built from.
- Search Brands Queries the brands the tenant carries.
- Get Brand Retrieves one brand.
- Save Brand Creates or updates a brand.
- Desactivate Brand Takes a brand out of use. The vendor spells this operation this way, and the platform refuses any other spelling.
- Delete Brand Permanently deletes a brand.
- Search Catalogs Lists the catalogs the tenant runs. A tenant can run several with categories of the same name in each.
- Get Catalog Retrieves one catalog.
- Save Catalog Media Attaches images to a product. The keep only switch deletes every other image on the product, and the replace switch replaces the set rather than adding to it.
- Search Bundles Queries product bundles.
- Get Bundle Retrieves one bundle and its members.
- Get Bundle By SKU Retrieves the bundle a SKU belongs to.
- Add Product To Bundle Adds a product to a bundle.
- Edit Product Bundle Relation Changes how a product sits inside a bundle, such as its quantity or its role.
- Delete Bundle Deletes a bundle, leaving its member products on their own.
- Add Product Associations Creates cross sell and related product links between products.
- Get Association List Retrieves one association list and its members.
- Search Association Lists Queries the association lists the tenant has built.
- Delete Association List Deletes an association list and the merchandising links it carried.
- Search Warehouses Lists the warehouses configured for the tenant.
- Get Warehouse Retrieves one warehouse.
- Search Tags Lists the tags available for classifying catalog records.
- Search Flags Lists the flags the tenant uses to mark catalog records.
- Search Suppliers Lists the suppliers behind the catalog.
- Search Offers Queries marketplace seller offers.
- Save Offer Creates or updates a marketplace offer. Only the fields belonging to the slice named in the save type are applied, so a price sent while the call is set to stock is quietly ignored.
Inventory
9- Get Inventory Product Reads the stock position for a product.
- Get Inventory SKU Reads the stock position for a single SKU.
- Search Inventory SKUs Queries stock across SKUs. The read behind a reorder alert.
- Search Inventory SKUs With Parent ID Queries stock across SKUs including their parent product, which keeps variant level stock attached to the listing it belongs to.
- Change SKU Inventory Increments, decrements, or replaces a SKU's balance. A quantity of zero with the replace action empties the balance, which is a real instruction rather than an omitted field.
- Save SKU Inventory Writes a SKU's inventory record, including its backorder settings.
- Change SKU Inventories Applies a whole stock feed in one call and answers with valid and invalid product lists, so a batch where half the SKUs were refused still returns a valid envelope. Read the per item results.
- Change SKU Inventory Batch Applies a batch of stock changes as one unit of work.
- Search Inventory SKU Movements Returns the movement history behind a stock balance, which is what a discrepancy investigation is run from.
Pricing
10- Get Product Price Reads a product's price.
- Search Product Prices Queries prices across products, including by price list.
- Get SKU Price Reads a single SKU's price.
- Get SKU Prices Reads prices across a set of SKUs.
- Get Price List Retrieves one price list.
- Get Master Price List Retrieves the tenant's master price list, which is the base every other list is read against.
- Search Price Lists Lists the price lists the tenant runs.
- Save Product Price Writes a product's price. Two switches decide whether the base price and the promotional price are applied at all, so a value sent with the matching switch off is accepted and changes nothing.
- Save Product Prices Writes prices for many products, carrying the same per row switches.
- Save Product Price Bulk Writes a whole price feed in one call and reports per item results rather than failing the call.
Promotions
4- Get Promotion Retrieves one promotion and its rules.
- Search Promotions Queries the promotions configured for the tenant.
- Get Coupon Retrieves one coupon with its rules and limits.
- Search Coupons Queries coupons, including by campaign and validity.
Gift Certificates
6- Search Gift Certificates Queries gift certificates issued on the tenant.
- Get Gift Certificate Retrieves one gift certificate.
- Get Gift Certificate Balance Reads the remaining balance on a certificate. The read that belongs before any capture.
- Save Gift Certificate Creates or updates a gift certificate.
- Capture Gift Certificate Spends the customer's balance. The platform publishes no matching release route, so a capture cannot be handed back.
- Delete Gift Certificate Deletes a gift certificate and the balance a customer was holding.
Wishlists
4- Search Wishlists Queries customer wishlists, which is where intent sits before it becomes a cart.
- Save Wishlist Creates or updates a wishlist.
- Add Products To Wishlist Adds products to a customer's wishlist.
- Delete Products From Wishlist Removes products from a customer's wishlist.
Configuration
10- Get Website Retrieves one website configuration.
- Search Websites Lists the websites the tenant runs.
- Get Delivery Method Retrieves a delivery method definition.
- Search Entity Metadata Lists the entities that carry custom fields on this tenant.
- Search Property Metadata Lists the tenant's custom field definitions. The read that tells a flow what the custom filters are actually called.
- Save Property Metadata Creates or updates a custom field definition.
- Search Metadata Options Lists the allowed values on a custom field.
- Save Metadata Option Creates or updates an allowed value on a custom field.
- Get Marketplace Configurations Reads the marketplace settings for the tenant.
- Get Marketplace Seller 3P Status Reads a third party seller's status on the marketplace.
Multi Site
5- Get Location Seller Retrieves a selling location, which is a store acting as a fulfillment point.
- Save Location Seller Writes a selling location in full. Fields left empty are written as empty, so this is the wrong write for a partial change.
- Patch Location Seller Changes only the fields sent on a selling location. The safer route for editing one attribute of a live store.
- Get Pickup Point Retrieves a click and collect pickup point.
- Save Pickup Point Creates or updates a pickup point. A price of zero here means collection is free, not that no price was set.
Privacy
2- Enqueue Anonymize Customer Queues a customer for anonymization under Brazilian privacy law. It strips the personal data and leaves the order history reportable, and it cannot be undone. The operation this page's human gate exists for.
- Enqueue Customer Export Queues a data subject access export for a customer, which is the other half of a privacy request.
Advanced
1- Call Layer Method Calls any Layer method the connector does not name, in whichever body shape the route expects. The route shape is uniform across the platform, which is what makes this an escape hatch rather than a guess.
Frequently Asked Questions
What can FlowRunner do with Linx Commerce?
FlowRunner agents can run Check Credentials, Get Master Status, and Search Orders in Linx Commerce, plus 177 more actions.
Does connecting Linx Commerce to FlowRunner require OAuth?
No. Linx Commerce connects to FlowRunner with basic authentication (a username and password), no OAuth flow required.
Can Linx Commerce trigger a FlowRunner workflow automatically?
Linx Commerce doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Other E-commerce integrations
Start building with Linx Commerce
Free plan, no card required. Connect in minutes.