Skip to main content

Fluent Commerce Component

Manage orders within Fluent Commerce

Component key: fluent-commerce

Description#

Fluent Commerce is an order management system that allows you to track customers, orders and inventory.

Fluent Commerce offers a GraphQL-based API. This gives you flexibility and control over what data you send to Fluent, and what data you request back.

While this component offers some actions that wrap common GraphQL queries and mutations, there are many more queries and mutations for which there aren't dedicated actions. If you'd like to run a query or mutation that is not represented by an action, please use the Generic Request action.

Fluent Commerce Connections#

Fluent Commerce OAuth 2.0 Password Grant#

InputNotesExample
Input
OAuth 2.0 Client ID
string
/ Required
clientId
Notes
A client ID obtained from Fluent support
Example
 
Input
OAuth 2.0 Client Secret
password
/ Required
clientSecret
Notes
A client secret obtained from Fluent support
Example
 
Input
Fluent Host
string
/ Required
host
Notes
The retailer's Fluent API endpoint
Example
https://REPLACE-ME.api.fluentretail.com
Input
Retailer Password
password
/ Required
password
Notes
The retailer's password
Example
 
Input
Retailer Username
string
/ Required
username
Notes
The retailer's username
Example
john_doe

Actions#

Create Customer#

Create a new customer | key: createCustomer

InputDefaultNotesExample
Input
Attributes
string
Key Value List
attributes
Default
Notes
Custom attributes you would like to apply to the customer
Example
 
Input
Connection
connection
/ Required
connection
Default
 
Notes
An OAuth 2.0 password grant type connection
Example
 
Input
Country
string
country
Default
Notes
The customer's country
Example
Australia
Input
Customer Email
string
/ Required
customerEmail
Default
Notes
The email address of the customer
Example
test@example.com
Input
First Name
string
/ Required
firstName
Default
Notes
The first name of the customer (required)
Example
John
Input
Last Name
string
lastName
Default
Notes
The last name of the customer
Example
Doe
Input
Phone Number
string
phoneNumber
Default
Notes
The customer's phone number
Example
Doe
Input
Promotion Opt In
boolean
/ Required
promotionOptIn
Default
false
Notes
 
Example
 
Input
Retailer ID
string
/ Required
retailerId
Default
Notes
The ID of the retailer (a number)
Example
34
Input
Time Zone
string
timezone
Default
Notes
The customer's time zone
Example
UTC+5

Create Product#

Create a new standard product | key: createProduct

InputDefaultNotesExample
Input
Connection
connection
/ Required
connection
Default
 
Notes
An OAuth 2.0 password grant type connection
Example
 
Input
Global Trade Item Number (GTIN)
string
/ Required
gtin
Default
Notes
The global trade number of the product
Example
012345678905
Input
Price Currency
string
/ Required
priceCurrency
Default
Notes
Type of currency the price is in (USD, YEN, GBP, etc)
Example
USD
Input
Price Value
string
/ Required
priceValue
Default
Notes
The price of the product (must be a floating-point number)
Example
1300
Input
Product Catalogue Ref (ID)
string
/ Required
productCatalogueRef
Default
Notes
The reference ID (ref) of an existing product catalog
Example
FCRG:PC:MASTER
Input
Product Name
string
/ Required
productName
Default
Notes
The name of the product (not required to be unique)
Example
Widget
Input
Product Ref ID
string
/ Required
productRef
Default
Notes
The reference ID (ref) of the new product (must be unique)
Example
TESTPRD
Input
Product Summary / Description
string
/ Required
productSummary
Default
Notes
 
Example
Widgets: the new whatsits
Input
Product Type
string
/ Required
productType
Default
STANDARD
Notes
The type of the product
Example
STANDARD

Output Example Payload#

{  "data": {    "createStandardProduct": {      "id": "03440122-ea39-499b-83aa-f08b2614daf3",      "ref": "TESTPRD3"    }  }}

Generic GraphQL Request#

Issue any GraphQL query or mutation with variables | key: genericRequest

InputDefaultNotes
Input
Connection
connection
/ Required
connection
Default
 
Notes
An OAuth 2.0 password grant type connection
Input
Query or Mutation
code
/ Required
query
Default
{  me {    id    username    primaryEmail  }}
Notes
 
Input
Variables
string
Key Value List
variables
Default
Notes
 
Input
Variables Object
code
variablesObject
Default
Notes
 

Get Current User#

Get information about the currently authenticated user | key: getCurrentUser

InputNotes
Input
Connection
connection
/ Required
connection
Notes
An OAuth 2.0 password grant type connection

Get Customer by Email#

Find a customer by their email address | key: getCustomerByEmailAddress

InputNotes
Input
Connection
connection
/ Required
connection
Notes
An OAuth 2.0 password grant type connection
Input
Customer Email Address
string
/ Required
emailAddress
Notes
The customer's email address