> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# App Distribution Workflow

> The YiDA app distribution feature helps service providers deploy apps developed within their organization to customer organizations, and provides a dedicated channel for entering customer organizations to perform custom development and attribute configuration. This article covers the prerequisites, an overview of the workflow, and step-by-step instructions, including how service providers distribute apps, how customers purchase apps, and how apps are distributed from the order center.

This article walks through five steps: the service provider distributes the app, the customer purchases it, the app is sent from the order center, the customer enables the app, and the project is closed.

## Prerequisites

Before using the YiDA app distribution feature for sales, complete the following prerequisites:

* Become a DingTalk partner.
* Apply for app distribution permission.
* (Optional) Become a YiDA Premium partner.

## Workflow Overview

Service providers can distribute apps by following the steps below.

## Step 1: Service Provider Distributes the App

<Steps>
  <Step title="Step 1">
    Sign in to the [YiDA workbench](https://www.yidaapps.com/workPlatform) as an admin.
  </Step>

  <Step title="Step 2">
    Click the <Icon icon="gear" /> (**Platform management**) button in the upper-right corner to open the platform management page.
  </Step>

  <Step title="Step 3">
    Select **Service provider** > **Project management**, and then click **Create project**.
  </Step>
</Steps>

<Steps>
  <Step title="Fill in the Project information and Customer information, and then click Submit to initiate the project approval">
    <Note>
      * The **Project contract amount** must match the amount specified in the **Project contract** file. Otherwise, the approval will fail.
      * The customer organization CorpID must match the CorpID of the actual purchasing organization. Otherwise, the customer cannot complete the purchase.
      * The approval is completed within one business day. Please wait patiently.
    </Note>
  </Step>

  <Step title="After approval, click Get distribution link" />

  <Step title="In the dialog box, select the app to distribute and click Copy app distribution link" />
</Steps>

## Step 2: Customer Purchases the App

1. Send the app distribution link to your customer.
2. The customer opens the link in a browser and signs in to the organization that will purchase the app.
3. After confirming that the app is correct, the customer clicks **Purchase app** at the bottom.

<Note>
  If the customer is a regular employee of the organization, a **No permission** message appears when they open the link. The customer must be at least a platform admin in the DingTalk organization to complete the purchase.
</Note>

## Step 3: Distribute the App in the Order Center

After the customer completes the purchase, follow the steps below to send the app to the customer's organization.

<Steps>
  <Step title="Sign in to the YiDA workbench, and then click Platform management in the upper-right corner to open the platform management page" />

  <Step title="Click Service provider > Project management, select the corresponding project, and then click View order" />
</Steps>

3. In the order center, click **Send app**.
4. In the app distribution settings dialog box, choose whether to **include form sample data**, whether to **send the connector**, and whether to **grant full edit permission for the app**.

<Note>
  You can distribute all form pages, custom pages, portals, Tablers, data preparation resources, YiDA roles and contact information, integration & automation Automations, connectors, and more within the app. For more information, see [App distribution overview](/yida/app-admin/vswk6q9gukpikt0b).
</Note>

<Steps>
  <Step title="Click Send app">
    <Note>
      Before clicking Send app, read and review the [Service Provider Distribution Agreement](/yida/app-admin/rta1izrlucw1oslz). If you agree to the terms, select the checkbox. Otherwise, exit the workflow.
    </Note>
  </Step>

  <Step title="Check the app sending status. If the app is sent successfully, Success is displayed" />
</Steps>

Once the app is distributed successfully, you can manage the **Edit Permission**, **Remote maintenance**, **Send page**, or **Send custom component** for the customer's app on the order center page.

You can also view the **App sending status** and **Page sending status**. Click the **order number** to view the **order details**.

## Step 4: Customer Updates the App Status

After the app is distributed to the customer's organization, the customer can manage it on the [My apps](https://www.yidaapps.com/myApp) page.

As shown below, the status of a newly distributed app is **In development and maintenance**.

Once development is complete, the customer can follow these steps to enable the app.

1. Sign in to the YiDA workbench and go to the **My apps** page.
2. Locate the purchased app and start acceptance testing.
3. After acceptance, return to the **My apps** page, and click **···** > **Close development and maintenance**.

<Steps>
  <Step title="Click ··· > App settings to open the app settings page" />

  <Step title="At the top of the page, click App release, and then click Enable to start using the app" />
</Steps>

## Step 5: Close the Project

Once the project is completed, the service provider must return to the YiDA workbench to close it.

1. Sign in to the YiDA workbench and go to the platform management page.

2. Click **Service provider** > **Project management**, select the completed project, and then click **View details**.

3. On the form details page, fill in the project closure information, and then click **Confirm project closure**.

## Notes

When using app distribution to deploy apps to a customer's organization, note the following:

* App distribution helps YiDA partners quickly copy apps to a customer's organization. After distribution, the app's feature entitlements are verified against the entitlements of the target organization. We recommend that the source organization and the target organization use the same YiDA paid edition whenever possible, to avoid issues where advanced features cannot be enabled or used in the target organization.

## FAQ

* Q: After creating a project, I found that the project information was entered incorrectly. How do I modify it? Modification is not currently supported. Before the project is approved by YiDA, click **Undo** in the Actions column to cancel the initiated workflow.
* Q: Can an app be distributed multiple times for a single project?

For the same customer, you can obtain distribution links multiple times to distribute the same or different apps, from project approval until the project is closed.

* Q: Does "Project contract amount" refer to the total project amount or only the YiDA-related amount?

"Project contract amount" refers to the amount related to YiDA delivery. If the contract covers the entire project, enter the YiDA-related amount and provide additional context in "Project description".

* Q: What if I need to distribute an app to a customer in advance under special circumstances, but the contract has not been signed yet?

To protect your interests, this is not recommended. If special circumstances apply, provide a detailed explanation in "Project description". You can upload a quotation as the project contract, and the project amount must match the quotation.

* Q: Why is "View details" grayed out and unavailable?

By default, platform admins can view the list of projects created by all users and obtain distribution links, but they cannot view project details. To view details, contact the project creator.

* Q: Why does the message "This organization cannot make a purchase. Please contact the service provider" appear when a customer tries to purchase the app?

The customer organization CorpID in the project must match the CorpID of the actual purchasing organization. If they do not match, this message appears. Troubleshooting suggestions:

* Q: Why does the message "The selected app does not support distribution links" appear when I try to obtain a distribution link?