Get Affiliate with Refersion API on New Sales Order from Zoho Inventory API

Pipedream makes it easy to connect APIs for Refersion, Zoho Inventory and 2,500+ other apps remarkably fast.

Trigger workflow on

New Sales Order from the Zoho Inventory API

Next, do this

Get Affiliate with the Refersion API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Zoho Inventory trigger and Refersion action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Sales Order trigger
1. Connect your Zoho Inventory account
2. Configure Polling Interval
3. Select a Organization
4. Optional- Configure Maximum Results
Configure the Get Affiliate action
1. Connect your Refersion account
2. Select a Affiliate ID
3. Optional- Configure Affiliate Code
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Sales Order on Zoho Inventory

Description:Emit new event each time a new sales order is created in Zoho Inventory

Version:0.0.3

Key:zoho_inventory-new-order

View on GitHub

Zoho Inventory Overview#

Zoho Inventory API on Pipedream opens the door to smart inventory management by allowing you to integrate with a plethora of apps, automate inventory tracking, and streamline order processing. You can sync your inventory levels across multiple sales channels, automatically update stock quantities, process sales orders, manage returns, and generate detailed reports, all in real-time. With Pipedream's serverless platform, crafting workflows becomes a breeze, letting you focus on scaling your business while reducing manual overhead.

Trigger Code#

import common from "../common/base.mjs";

export default {
  ...common,
  key: "zoho_inventory-new-order",
  name: "New Sales Order",
  description: "Emit new event each time a new sales order is created in Zoho Inventory",
  version: "0.0.3",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    getResourceFn() {
      return this.zohoInventory.listSalesOrders.bind(this);
    },
    getResourceType() {
      return "salesorders";
    },
    generateMeta(order) {
      return {
        id: order.salesorder_id,
        summary: `New Sales Order ${order.salesorder_number}`,
        ts: Date.parse(order.created_time),
      };
    },
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Zoho Inventory	`zohoInventory`	`app`	This component uses the Zoho Inventory app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
Polling Interval	`timer`	`$.interface.timer`	Pipedream will poll the Zoho Inventory API on this schedule
Organization	`organization`	`string`	Select a value from the drop down menu.
Maximum Results	`maxResults`	`integer`	The maximum number of results to return at one time.

Trigger Authentication#

Zoho Inventory uses OAuth authentication. When you connect your Zoho Inventory account, Pipedream will open a popup window where you can sign into Zoho Inventory and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Zoho Inventory API.

Pipedream requests the following authorization scopes when you connect your account:

ZohoInventory.settings.READZohoinventory.FullAccess.all

About Zoho Inventory#

Inventory Management | Online Inventory Software

Action#

Get Affiliate on Refersion

Description:Get information about an affiliate. You can get an affiliate's information using their ID or code. [See the docs here](https://www.refersion.dev/reference/get_affiliate)

Version:0.0.1

Key:refersion-get-affiliate

View on GitHub

Refersion Overview#

Refersion is a powerful affiliate tracking platform that streamlines the process of managing, tracking, and growing your affiliate network. Through its API, you can automate affiliate registrations, commission tracking, and payout processes. Pipedream's serverless platform allows you to connect Refersion with hundreds of other apps to automate workflows, sync data across platforms, and respond to events in real time.

Action Code#

import app from "../../refersion.app.mjs";
import { ConfigurationError } from "@pipedream/platform";

export default {
  name: "Get Affiliate",
  description: "Get information about an affiliate. You can get an affiliate's information using their ID or code. [See the docs here](https://www.refersion.dev/reference/get_affiliate)",
  key: "refersion-get-affiliate",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    id: {
      propDefinition: [
        app,
        "affiliateId",
      ],
    },
    affiliateCode: {
      type: "string",
      label: "Affiliate Code",
      description: "The Refersion affiliate identifier. You would have captured this from the affiliate/new endpoint response.",
      optional: true,
    },
  },
  async run({ $ }) {
    if (!this.id && !this.affiliateCode) {
      throw new ConfigurationError("You must provide either an ID or an affiliate code");
    }

    if (this.id && this.affiliateCode) {
      throw new ConfigurationError("You must provide either an ID or an affiliate code, not both");
    }

    const data = {};
    if (this.id) {
      data.id = this.id;
    }

    if (this.affiliateCode) {
      data.affiliate_code = this.affiliateCode;
    }
    const res = await this.app.getAffiliate(data, $);
    if (res.error) {
      throw new ConfigurationError(res.error);
    }
    $.export("$summary", "Affiliate successfully fetched");
    return res;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
Refersion	`app`	`app`	This component uses the Refersion app.
Affiliate ID	`id`	`string`	Select a value from the drop down menu.
Affiliate Code	`affiliateCode`	`string`	The Refersion affiliate identifier. You would have captured this from the affiliate/new endpoint response.

Action Authentication#

Refersion uses API keys for authentication. When you connect your Refersion account, Pipedream securely stores the keys so you can easily authenticate to Refersion APIs in both code and no-code steps.

To retrieve your Refersion Public and Secret keys,