3vjia Technology DMS API

DMS系统

Operations 32

POST /api/v1/dms/customer/createCustomer 创建客户接口 #
POST /api/v1/dms/customer/deleteCustomer 删除客户接口 #
POST /api/v1/dms/customer/editCustomer 编辑客户接口 #
POST /api/v1/dms/customer/getCustomerList 查询客户列表接口 #
POST /api/v1/dms/customer/getCustomerPage 分页获取客户数据接口 #
POST /api/v1/dms/order/createProduceOrder 创建生产单接口 #
POST /api/v1/dms/order/deleteProduceOrder 删除生产单接口 #
POST /api/v1/dms/order/editProduceOrder 编辑生产单接口 #
POST /api/v1/dms/order/getBreakFileList 查询拆单文件接口 #
POST /api/v1/dms/order/getBreakFileMaterial 查询拆单物料接口 #
POST /api/v1/dms/order/getMetalPage 分页查询五金列表接口 #
POST /api/v1/dms/order/getPackagePage 分页查询包装列表接口 #
POST /api/v1/dms/order/getPanelPage 分页查询板件列表接口 #
POST /api/v1/dms/order/getProduceOrderList 查询生产单列表接口 #
POST /api/v1/dms/order/getProduceOrderPage 分页查询生产单接口【旧】 #
POST /api/v1/dms/order/pageProduceOrder 分页查询生产单【新】 #
POST /api/v1/dms/order/updateProduceOrderState 更新生产单状态接口 #
POST /api/v1/dms/saleBill/createSaleBill 创建销售单接口 #
POST /api/v1/dms/saleBill/deleteSaleBill 删除销售单接口 #
POST /api/v1/dms/saleBill/editSaleBill 编辑销售单接口 #
POST /api/v1/dms/saleBill/getQuoteItemList 查询报价的明细数据接口 #
POST /api/v1/dms/saleBill/getQuoteSchemeList 查询销售单最新报价接口 #
POST /api/v1/dms/saleBill/getSaleBillFileList 查询销售单附件列表接口 #
POST /api/v1/dms/saleBill/getSaleBillNestingPage 查询销售单大板预排接口 #
POST /api/v1/dms/saleBill/getSaleBillPage 分页查询销售单接口 #
POST /api/v1/dms/saleBill/getSchemeList 查询销售单设计方案接口 #
POST /api/v1/dms/saleBill/updateSaleBillState 更新销售单状态接口 #
POST /api/v1/dms/shop/createChannel 创建门店接口 #
POST /api/v1/dms/shop/deleteChannel 删除门店接口 #
POST /api/v1/dms/shop/editChannel 编辑门店接口 #
POST /api/v1/dms/shop/getChannelList 查询门店列表接口 #
POST /api/v1/dms/shop/getChannelPage 分页查询门店接口 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/3vjia-technology-dms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

3vjia-technology-dms-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: 3vjia Open Platform DMS API
  version: '2026-09-05'
  summary: Home-furnishing 3D cloud design, quotation, order, manufacturing (AIMES/MOS/DMS) and AI operations exposed by the 3vjia (三维家) Open Platform.
  description: Machine-readable description of the 3vjia (三维家 / AiHouse) Open Platform, DERIVED — not published by the provider in this form.
  contact:
    name: 3vjia Open Platform
    url: https://dev.3vjia.com/
servers:
- url: https://open-gateway.3vjia.com
  description: 3vjia Open Platform gateway (current)
- url: https://open.3vjia.com
  description: Legacy open gateway — takes ?sysCode=external&access_token=
security:
- oauth2ClientCredentials: []
tags:
- name: DMS
  description: DMS系统
paths:
  /api/v1/dms/customer/createCustomer:
    post:
      operationId: apiV1DmsCustomerCreateCustomer
      summary: 创建客户接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547427056774889540
      x-documentation-category: DMS系统 / 客户数据
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                channelID:
                  type: string
                  description: 门店ID
                consigneeAddr:
                  type: string
                  description: 收货人地址
                consigneeName:
                  type: string
                  description: 收货人名称
                consigneePhone:
                  type: string
                  description: 收货人电话
                customerAddr:
                  type: string
                  description: 客户地址
                customerName:
                  type: string
                  description: 客户名称
                customerPhone:
                  type: string
                  description: 客户电话
                remark:
                  type: string
                  description: 备注
            example:
              consigneeAddr: ''
              remark: ''
              customerAddr: ''
              customerName: ''
              consigneeName: ''
              customerPhone: ''
              consigneePhone: ''
              channelID: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                data: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/customer/deleteCustomer:
    post:
      operationId: apiV1DmsCustomerDeleteCustomer
      summary: 删除客户接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547427056774889543
      x-documentation-category: DMS系统 / 客户数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items: {}
                  description: 客户唯一id列表
              required:
              - ids
            example:
              ids: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/customer/editCustomer:
    post:
      operationId: apiV1DmsCustomerEditCustomer
      summary: 编辑客户接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547427056774889545
      x-documentation-category: DMS系统 / 客户数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelID:
                  type: string
                  description: 门店编码
                consigneeAddr:
                  type: string
                  description: 收货人地址
                consigneeName:
                  type: string
                  description: 收货人名称
                consigneePhone:
                  type: string
                  description: 收货人电话
                customerAddr:
                  type: string
                  description: 客户地址
                customerID:
                  type: string
                  description: 客户编码
                customerName:
                  type: string
                  description: 客户名称
                customerPhone:
                  type: string
                  description: 客户电话
                id:
                  type: integer
                  format: int64
                  description: 客户唯一id
                remark:
                  type: string
                  description: 备注
              required:
              - customerName
              - id
            example:
              consigneeAddr: ''
              remark: ''
              customerAddr: ''
              customerName: ''
              consigneeName: ''
              customerPhone: ''
              customerID: ''
              consigneePhone: ''
              id: 0
              channelID: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/customer/getCustomerList:
    post:
      operationId: apiV1DmsCustomerGetCustomerList
      summary: 查询客户列表接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547428398327218179
      x-documentation-category: DMS系统 / 客户数据
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                customerIDs:
                  type: array
                  items: {}
                  description: 客户编码数组
                channelCode:
                  type: string
                  description: 门店编码
                customerID:
                  type: string
                  description: 客户编码
                customerName:
                  type: string
                  description: 客户姓名
                customerPhone:
                  type: string
                  description: 客户手机号
                id:
                  type: integer
                  format: int64
                  description: 客户唯一id
                ids:
                  type: array
                  items: {}
                  description: 客户唯一id数组
            example:
              customerName: ''
              customerPhone: ''
              customerID: ''
              ids: []
              customerIDs: []
              id: 0
              channelCode: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      consigneeAddr:
                        type: string
                        description: 收货人地址
                      consigneeName:
                        type: string
                        description: 收货人名称
                      consigneePhone:
                        type: string
                        description: 收货人电话
                      createDate:
                        type: string
                        format: date-time
                        description: 创建日期
                      createUserName:
                        type: string
                        description: 创建用户名称
                      customerAddr:
                        type: string
                        description: 客户地址
                      customerID:
                        type: string
                        description: 客户编码
                      customerName:
                        type: string
                        description: 客户名称
                      customerPhone:
                        type: string
                        description: 客户电话
                      modifyDate:
                        type: string
                        format: date-time
                        description: 最后修改时间
                      modifyUserName:
                        type: string
                        description: 最后修改用户名称
                      channelID:
                        type: string
                        description: 门店编码
                      createUserCode:
                        type: string
                        description: 创建用户编码
                      id:
                        type: integer
                        format: int64
                        description: 客户唯一id
                      modifyUserCode:
                        type: string
                        description: 最后修改用户编码
                      remark:
                        type: string
                        description: 备注
                    required:
                    - createDate
                    - createUserName
                    - customerID
                    - customerName
                    - modifyDate
                    - modifyUserName
                    - id
              example:
                msg: ''
                code: 0
                data:
                - consigneeAddr: ''
                  modifyDate: ''
                  createUserCode: ''
                  createUserName: ''
                  remark: ''
                  customerAddr: ''
                  customerName: ''
                  modifyUserCode: ''
                  consigneeName: ''
                  modifyUserName: ''
                  customerPhone: ''
                  customerID: ''
                  consigneePhone: ''
                  id: 0
                  channelID: ''
                  createDate: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/customer/getCustomerPage:
    post:
      operationId: apiV1DmsCustomerGetCustomerPage
      summary: 分页获取客户数据接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547425365350498337
      x-documentation-category: DMS系统 / 客户数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customerName:
                  type: string
                  description: 客户名称
                customerPhone:
                  type: string
                  description: 客户电话
                isDelete:
                  type: integer
                  format: int32
                  description: 是否删除
                  examples:
                  - '0'
                beginDate:
                  type: string
                  format: date-time
                  description: 创建时间-开始时间
                channelCode:
                  type: string
                  description: 门店编码
                createUserCode:
                  type: string
                  description: 创建人编码
                current:
                  type: integer
                  format: int64
                  description: 当前查询第几页
                  examples:
                  - '1'
                customerMatch:
                  type: string
                  description: 客户模糊匹配 [客户名称,客户电话]
                endDate:
                  type: string
                  format: date-time
                  description: 创建时间-结束时间
                size:
                  type: integer
                  format: int64
                  description: 当前查询页记录数
                  examples:
                  - '10'
              required:
              - current
              - size
            example:
              endDate: ''
              beginModifyDate: ''
              isDelete: 0
              createUserCode: ''
              pageSize: 0
              customerName: ''
              beginDate: ''
              customerPhone: ''
              current: 1
              customerMatch: ''
              size: 10
              pageIndex: 0
              endModifyDate: ''
              channelID: ''
              channelCode: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      records:
                        type: array
                        items:
                          type: object
                          properties:
                            channelID:
                              type: string
                              description: 门店编码
                            channelName:
                              type: string
                              description: 门店名称
                            consigneeAddr:
                              type: string
                              description: 收货人地址
                            consigneeName:
                              type: string
                              description: 收货人名称
                            consigneePhone:
                              type: string
                              description: 收货人电话
                            createDate:
                              type: string
                              format: date-time
                              description: 创建日期
                            createUserName:
                              type: string
                              description: 创建用户名称
                            customerAddr:
                              type: string
                              description: 客户地址
                            customerID:
                              type: string
                              description: 客户编码
                            customerName:
                              type: string
                              description: 客户名称
                            customerPhone:
                              type: string
                              description: 客户电话
                            id:
                              type: integer
                              format: int64
                              description: 唯一id
                            modifyDate:
                              type: string
                              format: date-time
                              description: 最后修改时间
                            modifyUserName:
                              type: string
                              description: 最后修改用户名称
                          required:
                          - customerID
                          - id
                        description: 客户信息
                      size:
                        type: integer
                        format: int64
                        description: 当前查询页记录数
                      total:
                        type: integer
                        format: int64
                        description: 总数
                    required:
                    - size
                    - total
              example:
                msg: ''
                code: 0
                data:
                  records:
                  - consigneeAddr: ''
                    modifyDate: ''
                    createUserName: ''
                    customerAddr: ''
                    customerName: ''
                    consigneeName: ''
                    modifyUserName: ''
                    customerPhone: ''
                    customerID: ''
                    consigneePhone: ''
                    channelName: ''
                    id: 0
                    channelID: ''
                    createDate: ''
                  total: 0
                  size: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/order/createProduceOrder:
    post:
      operationId: apiV1DmsOrderCreateProduceOrder2
      summary: 创建生产单接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547478474080776292
      x-documentation-category: DMS系统 / 生产单数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                diyOrderNo:
                  type: string
                  description: 自定义订单号
                orderDesc:
                  type: string
                  description: 订单备注
                orderName:
                  type: string
                  description: 订单名称
                orderRoom:
                  type: integer
                  format: int32
                  description: 所属空间 0-未填写 1-主卧 2-客卧 3-厨房 4-客厅 5-餐厅 6-主卫 7-次卫 8-阳台
                  examples:
                  - '0'
                  default: '0'
                saleBillNo:
                  type: string
                  description: 销售单号
                urgent:
                  type: integer
                  format: int32
                  description: 加急等级 0-普通 1-加急
                  examples:
                  - '0'
                  default: '0'
                orderState:
                  type: integer
                  format: int32
                  description: 订单状态
                orderType:
                  type: integer
                  format: int32
                  description: 订单类型
                patchReason:
                  type: integer
                  format: int32
                  description: 补单原因
              required:
              - orderName
              - saleBillNo
            example:
              orderRoom: 0
              orderType: 0
              patchReason: 0
              diyOrderNo: ''
              orderState: 0
              saleBillNo: ''
              urgent: 0
              orderDesc: ''
              orderName: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      diyOrderNo:
                        type: string
                        description: 自定义订单号
                      orderDesc:
                        type: string
                        description: 订单备注
                      orderName:
                        type: string
                        description: 订单名称
                      orderNo:
                        type: string
                        description: 生产订单号
                      orderRoom:
                        type: integer
                        format: int32
                        description: 所属空间 0未填写 1主卧 2客卧 3厨房 4客厅 5餐厅 6主卫 7次卫 8阳台
                      orderState:
                        type: integer
                        format: int32
                        description: 生产单状态 0-已创建 1-已分配 2-已拆单 3-生产中 9-已包装 4-已入库 5-已发货 6-已安装 7-已完成 8-已关闭
                      orderType:
                        type: integer
                        format: int32
                        description: 订单类型 0生产订单 1生产补单
                      patchReason:
                        type: integer
                        format: int32
                        description: 补单原因 0未填写 1设计错误 2审核错误 3生产错误 4运输损坏 5安装损坏 6客户新增
                      saleBillNo:
                        type: string
                        description: 销售单号
                      submitDate:
                        type: string
                        format: date-time
                        description: 创建时间
                      breakUserName:
                        type: string
                        description: 拆单人员
                      channelID:
                        type: string
                        description: 门店编码
                      createDate:
                        type: string
                        format: date-time
                        description: 创建时间
                      mainMaterial:
                        type: string
                        description: 材质颜色
                      urgent:
                        type: integer
                        format: int32
                        description: 订单标签
                      id:
                        type: integer
                        format: int64
                        description: 生产单唯一id
                    required:
                    - orderName
                    - orderNo
                    - orderRoom
                    - orderState
                    - orderType
                    - patchReason
                    - saleBillNo
                    - submitDate
                    - channelID
                    - id
              example:
                msg: ''
                code: 0
                data:
                  mainMaterial: ''
                  orderRoom: 0
                  orderType: 0
                  orderNo: ''
                  patchReason: 0
                  submitDate: ''
                  diyOrderNo: ''
                  orderState: 0
                  saleBillNo: ''
                  breakUserName: ''
                  id: 0
                  urgent: 0
                  orderDesc: ''
                  channelID: ''
                  orderName: ''
                  createDate: ''
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/order/deleteProduceOrder:
    post:
      operationId: apiV1DmsOrderDeleteProduceOrder
      summary: 删除生产单接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547479887989043268
      x-documentation-category: DMS系统 / 生产单数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items: {}
                  description: 生产单唯一id数组
              required:
              - ids
            example:
              ids: []
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/order/editProduceOrder:
    post:
      operationId: apiV1DmsOrderEditProduceOrder
      summary: 编辑生产单接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547479887989043266
      x-documentation-category: DMS系统 / 生产单数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                diyOrderNo:
                  type: string
                  description: 自定义订单号
                orderDesc:
                  type: string
                  description: 订单备注
                orderName:
                  type: string
                  description: 订单名称
                orderNo:
                  type: string
                  description: 生产单号
                orderRoom:
                  type: integer
                  format: int32
                  description: 所属空间 0-未填写 1-主卧 2-客卧 3-厨房 4-客厅 5-餐厅 6-主卫 7-次卫 8-阳台
                saleBillNo:
                  type: string
                  description: 销售单号
                urgent:
                  type: integer
                  format: int32
                  description: 加急等级 0-普通 1-加急
              required:
              - orderName
              - orderNo
              - saleBillNo
            example:
              orderRoom: 0
              orderNo: ''
              diyOrderNo: ''
              saleBillNo: ''
              urgent: 0
              orderDesc: ''
              orderName: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
              example:
                msg: ''
                code: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/order/getBreakFileList:
    post:
      operationId: apiV1DmsOrderGetBreakFileList
      summary: 查询拆单文件接口
      tags:
      - DMS
      x-source-documentation: https://dev.3vjia.com/document?apiId=547481265901789238
      x-documentation-category: DMS系统 / 生产单数据
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                orderNo:
                  type: string
                  description: 生产单号
              required:
              - orderNo
            example:
              orderNo: ''
      responses:
        '200':
          description: 成功 / OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 请求是否成功 / whether the call succeeded
                  code:
                    type: integer
                    description: 结果码 / result code (0 = success)
                  msg:
                    type: string
                    description: 提示信息 / message
                  data:
                    type: object
                    properties:
                      fileName:
                        type: string
                        description: 文件名称
                      fileType:
                        type: integer
                        format: int32
                        description: 文件类型 2-拆单附件
                      fileUrl:
                        type: string
                        description: 文件Url
                      picName:
                        type: string
                        description: 图片名称
                      picUrl:
                        type: string
                        description: 图片Url
                    required:
                    - fileName
                    - fileType
                    - fileUrl
              example:
                msg: ''
                code: 0
                data:
                - fileName: ''
                  picName: ''
                  picUrl: ''
                  fileUrl: ''
                  fileType: 0
                success: false
        '401':
          description: access_token 缺失或已过期 / missing or expired access_token
  /api/v1/dms/order/getBreakFileMaterial:
    post:
      operationId: apiV1DmsOrderGetBreakFileMaterial
      summary: 查询拆单物料接口
      tags:
      - DMS
      x-source-document

# --- truncated at 32 KB (167 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/3vjia-technology/refs/heads/main/openapi/3vjia-technology-dms-api-openapi.yml