Zoho crm Logo

转换库存记录

目的

要转换库存记录。您可以执行以下转换:

  • 报价 转换为 Sales Orders 或 Invoices
  • Sales Orders 到 Invoices

端点

  • POST /Quotes/{record_ID}/actions/convert
  • POST /Sales_Orders/{record_ID}/actions/convert

请求详情

请求URL列表

将报价模块记录转换为SalesOrder或Invoice记录:

{api-domain}/crm/{version}/Quotes/{record_id}/actions/convert

将Sales Orders模块记录转换为Invoice记录:

{api-domain}/crm/{version}/Sales_Orders/{record_id}/actions/convert

标题

授权: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

范围

scope= ZohoCRM.mass_convert.{module_api_name}.CREATE
注意:指定要转换记录的父模块的 API 名称。

可能的模块名称

报价和SalesOrders
 

示例请求

Copiedcurl "https://www.zohoapis.com/crm/v8/Quotes/3652397000007566544/actions/convert"
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
-d "@input.json"
-X POST

输入 JSON 键

  • convert_toJSON array,mandatory

    表示要转换记录的模块的详细信息。

    • moduleJSON object,mandatory

      要转换记录的模块的 API 名称和唯一 ID。使用 GET - Modules API 来检索模块的 API 名称和 ID。 

注意事项

  • 转换后,标签将被保留到转换后的记录中。
  • 被转换的记录被视为父记录,而转换后的记录被视为子记录。
  • 要执行库存记录转换,必须在组织模块和安全控制中启用库存模块权限。如果这些权限未启用,系统将给出NO_PERMISSION错误。请注意,只有具有管理员访问权限的用户才能访问这些设置。
    • 要启用组织模块权限,请转到设置 > 自定义 > 模块和字段 > 组织模块选项卡。选择要启用的模块并授予权限。
    • 要启用安全控制权限,请转到设置 > 安全控制 > 配置文件。选择需要访问模块的所需配置文件(仅自定义配置文件,对于系统定义的配置文件,已启用),从导入/导出权限部分的转换和批量转换选项中选择要启用的模块(报价和SalesOrders),并授予权限。

示例输入

Copied{
    "data": [
        {
            "convert_to": [
                {
                    "module": {
                        "id": "2423488000000000171",
                        "api_name": "Sales_Orders"
                    }
                }
            ]
        }
    ]
}

可能的错误

  • MANDATORY_NOT_FOUNDHTTP 400

    必填字段未找到

    解决方法:您的输入主体中缺少 'convert_to' 字段。请指定必填字段。

  • AMBIGUITY_DURING_PROCESSINGHTTP 400

    请求正文中提供的ID不属于您尝试转换的相应模块

    解决方案:使用有效的模块API名称和ID指定所需字段。

  • EXPECTED_FIELD_MISSINGHTTP 400

    'convert_to' JSON 数组缺失或为空

    解决方法: 在输入主体中指定必需的 'convert_to' 键。

  • INVALID_DATAHTTP 400
    • 'convert_to' 数据类型似乎无效
    • 给定的 'module' 数据类型似乎无效
    • 给定的 'id' 似乎无效
    • 模块 ID 的数据类型无效
    • API 名称的数据类型无效
    • 给定的请求 ID 似乎无效
    • 给定的请求模块名称似乎无效
    • 请求正文中使用了多个模块进行转换

    解决方案:

    • 'convert_to' 必须是一个 JSON 数组。请指定有效的数据类型。
    • 'module' 必须是一个 JSON 对象。请指定有效的数据类型。
    • 请指定有效的模块 ID。
    • 为模块 ID 指定有效的数据类型。接受的数据类型是 'string'。
    • API 名称的数据类型应为字符串。
    • 在请求中指定有效的记录 ID。
    • 在请求中指定有效的 模块 API 名称。
    • 每个操作只允许一个模块进行转换。
  • ID_ALREADY_CONVERTEDHTTP 400

    ID 已经转换

    解决方案: 您指定的记录已经被转换。请指定另一个唯一的记录 ID。

  • NOT_APPROVEDHTTP 400

    指定的父记录尚未批准

    解决方法:您不能转换仍在审批过程中的记录。

  • NOT_REVIEWEDHTTP 400

    指定的父记录尚未审核

    解决方案:您不能转换仍在审核过程中的记录。

  • INVALID_REQUEST_METHODHTTP 400

    HTTP 请求方法类型无效
    解决方法:您指定了一个无效的 HTTP 方法来访问 API URL。请指定一个有效的请求方法。请参阅上面的端点部分。

  • DUPLICATE_DATAHTTP 401

    发现重复的唯一值 
    解决方案: 如果目标模块中的唯一字段已经有一个与正在转换的记录具有相同值的记录,则转换将不会继续。确保正在转换的记录的唯一字段值与目标模块中现有记录不同。

  • OAUTH_SCOPE_MISMATCHHTTP 401

    未经授权 
    解决方案: 客户端没有 ZohoCRM.modules.Quotes.CREATE (或) ZohoCRM.modules.SalesOrders.CREATE 范围。
    创建一个具有有效范围的新令牌。请参阅上面的范围部分。

  • Authentication_FAILUREHTTP 401

    Authentication 失败
    解决方法: 在API调用的请求头中传递访问令牌。

  • NO_PERMISSIONHTTP 403
    • 父模块或子模块的权限被拒绝
    • 在组织模块中父模块或子模块被禁用

    解决方案:

    • 启用父模块或子模块的权限。有关详细信息,请参阅下面的注释部分。
    • 在组织模块部分启用父模块或子模块的权限。有关更多详细信息,请参阅下面的注释部分。
  • INVALID_URL_PATTERNHTTP 404

    请检查尝试访问的URL是否正确
    解决方案: 请求的URL不正确。请指定一个有效的请求URL。请参阅上面的请求URL部分。

  • INTERNAL_ERRORHTTP 500

    内部服务器错误
    解决方法:服务器中出现了意外且未处理的异常。请联系支持团队。

示例响应

Copied{
    "data": [
        {
            "code": "SUCCESS",
            "details": {
                "Sales_Orders": {
                    "name": "Patricia",
                    "id": "2423488000000619001"
                }
            },
            "message": "The record has been converted successfully",
            "status": "success"
        }
    ]
}