Ordoro Manufacturing Order API

openapi: 3.2.0
info:
  title: Ordoro API Documentation Manufacturing Order API
  description: '# Introduction


    The Ordoro API can be used to access data or integrate to add functionality to Ordoro.'
  contact: {}
  version: '1.0'
servers:
- url: https://api.ordoro.com/
  variables: {}
tags:
- name: Manufacturing Order
  description: Manufacturing Orders are used for creating and tracking Bill of Material orders. A Manufacturing Order is assigned to a warehouse and may have multiple lines and tags.
paths:
  /v3/manufacturing_order:
    get:
      tags:
      - Manufacturing Order
      summary: List Manufacturing Orders
      description: ''
      operationId: ManufacturingOrder_GET
      parameters:
      - $ref: '#/components/parameters/offsetParam'
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/searchParam'
      - name: sort
        in: query
        description: ''
        style: form
        explode: true
        schema:
          $ref: '#/components/schemas/ManufacturingOrderSort'
      - name: status
        in: query
        description: ''
        style: form
        explode: true
        schema:
          $ref: '#/components/schemas/ManufacturingOrderStatus'
      - name: tag
        in: query
        description: 'Filter by tag name. Can be repeated for multiple tags.


          Note: Cannot be included if `untagged` is also passed.

          '
        style: form
        schema:
          type: array
          items:
            type: string
      - name: tag_filter_by
        in: query
        description: 'Tag filtering logic:

          * `or` [default] return manufacturing orders that contain any of the supplied tags

          * `and` returns manufacturing orders containing ALL of the supplied tags

          * `only` returns manufacturing orders containing ONLY the supplied tags

          * `not` returns manufacturing orders that do not contain one or more of the supplied tags

          '
        style: form
        explode: true
        schema:
          type: string
      - name: untagged
        in: query
        description: 'Filter untagged manufacturing orders


          Note: Cannot be included if `tags` are also passed.

          '
        style: form
        explode: true
        schema:
          type: boolean
      - name: reference_id
        in: query
        description: ''
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - name: warehouse_id
        in: query
        description: ''
        style: form
        explode: true
        schema:
          type: array
          items:
            type: integer
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order_list'
        deprecated: false
    post:
      tags:
      - Manufacturing Order
      summary: Create a Manufacturing Order
      description: ''
      operationId: ManufacturingOrder_POST
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_manufacturing_order'
      responses:
        '201':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      deprecated: false
  /v3/manufacturing_order/{reference_id}:
    get:
      tags:
      - Manufacturing Order
      summary: Get Manufacturing Order by ID
      description: ''
      operationId: ManufacturingOrderByRefId_GET
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
        deprecated: false
    put:
      tags:
      - Manufacturing Order
      summary: Update Manufacturing Order by ID
      description: ''
      operationId: ManufacturingOrderByRefId_PUT
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/put_manufacturing_order'
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
        deprecated: false
  /v3/manufacturing_order/counts:
    get:
      tags:
      - Manufacturing Order
      summary: Get Manufacturing Order Counts
      description: ''
      operationId: ManufacturingOrderCounts_GET
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/get_manufacturing_order_count'
      responses:
        '200':
          description: ''
          headers: {}
        deprecated: false
  /v3/manufacturing_order/tag:
    post:
      tags:
      - Manufacturing Order
      summary: Create a Manufacturing Order Tag
      description: ''
      operationId: ManufacturingOrderTags_POST
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_v3_tag'
      responses:
        '201':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3_tag'
    get:
      tags:
      - Manufacturing Order
      summary: Get Manufacturing Order Tags
      description: ''
      operationId: ManufacturingOrderTags_GET
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3_tag_list'
      deprecated: false
  /v3/manufacturing_order/tag/{name}:
    get:
      tags:
      - Manufacturing Order
      summary: Get Manufacturing Order Tag by Name
      description: ''
      operationId: ManufacturingOrderTag_GET
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3_tag'
      deprecated: false
    put:
      tags:
      - Manufacturing Order
      summary: Update a Manufacturing Order Tag by Name
      description: ''
      operationId: ManufacturingOrderTags_PUT
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/put_v3_tag'
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v3_tag'
    delete:
      tags:
      - Manufacturing Order
      summary: Delete a Manufacturing Order Tag by Name
      description: ''
      operationId: ManufacturingOrderTags_DELETE
      parameters: []
      responses:
        '200':
          description: response OK
  /v3/manufacturing_order/{reference_id}/tag/{tag_name}:
    post:
      tags:
      - Manufacturing Order
      summary: Apply a Manufacturing Order Tag to Manufacturing Order
      description: ''
      operationId: ManufacturingOrderTagPO_POST
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
    delete:
      tags:
      - Manufacturing Order
      summary: Remove a Manufacturing Order Tag from a Manufacturing Order
      description: ''
      operationId: ManufacturingOrderTagPO_DELETE
      parameters: []
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
  /v3/manufacturing_order/{reference_id}/comment:
    post:
      tags:
      - Manufacturing Order
      summary: Create a Manufacturing Order Comment by MO ID
      description: ''
      operationId: ManufacturingOrderCommentByMoId_POST
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/comment'
      deprecated: false
    get:
      summary: Retrieve Comments
      operationId: ManufacturingOrderCommentByMoId_GET
      description: ''
      tags:
      - Manufacturing Order
      parameters:
      - $ref: '#/components/parameters/goodsReceiptIDPath'
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                limit: 10
                offset: 0
                count: 1
                comment:
                - user: user@ordoro.com
                  date: '2026-03-05T21:10:26.911724+00:00'
                  text: This is a very important comment
              schema:
                $ref: '#/components/schemas/comment'
  /v3/manufacturing_order/{reference_id}/line:
    post:
      tags:
      - Manufacturing Order
      summary: Create a Manufacturing Order line
      description: ''
      operationId: ManufacturingOrderLine_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_manufacturing_order_line'
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      deprecated: false
  /v3/manufacturing_order/{reference_id}/line/{manufacturing_order_line_id}:
    put:
      tags:
      - Manufacturing Order
      summary: Update a Manufacturing Order line
      description: ''
      operationId: ManufacturingOrderLine_PUT
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/put_manufacturing_order_line'
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      deprecated: false
    delete:
      tags:
      - Manufacturing Order
      summary: Remove a Manufacturing Order line from Manufacturing Order
      description: ''
      operationId: ManufacturingOrderLine_DELETE
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      deprecated: false
  /v3/manufacturing_order/{reference_id}/line/{manufacturing_order_line_id}/finish:
    post:
      tags:
      - Manufacturing Order
      summary: Mark a Manufacturing Order line as finished
      description: ''
      operationId: ManufacturingOrderLineFinished_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_manufacturing_order_line_finish'
      responses:
        '200':
          description: ''
          headers: {}
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/manufacturing_order'
      deprecated: false
components:
  schemas:
    post_v3_tag:
      title: Create a Tag
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
        color:
          type: string
      required:
      - name
      - color
    post_manufacturing_order_line_finish:
      title: Finish a quantity of a Manufacturing Order Line
      type: object
      additionalProperties: false
      properties:
        amount:
          type: integer
      required:
      - amount
    comment:
      title: Comment Schema
      type: object
      additionalProperties: false
      properties:
        user:
          type: string
        date:
          type: string
          format: date-time
        text:
          type: string
    ManufacturingOrderStatus:
      title: manufacturing_order_status
      enum:
      - cancelled
      - initiated
      - active
      - finished
      type: string
    manufacturing_order_list:
      type: object
      properties:
        limit:
          type: integer
        offset:
          type: integer
        count:
          type: integer
        manufacturing_order:
          type: array
          items:
            $ref: '#/components/schemas/manufacturing_order'
      required:
      - limit
      - offset
      - count
      - manufacturing_order
    manufacturing_order:
      title: Manufacturing Order Schema
      type: object
      properties:
        reference_id:
          type: string
        status:
          type: string
        warehouse_id:
          type: integer
        manufacturer_notes:
          anyOf:
          - type: string
          - type: 'null'
        internal_notes:
          anyOf:
          - type: string
          - type: 'null'
        lines:
          type: array
          items:
            type: object
            properties:
              _link:
                type: string
              id:
                type: integer
              sku:
                type: string
              bom_sku:
                type: string
              manufacturer_notes:
                anyOf:
                - type: string
                - type: 'null'
              internal_notes:
                anyOf:
                - type: string
                - type: 'null'
              requested_quantity:
                type: number
              finished_quantity:
                type: number
              created_date:
                type: string
              updated_date:
                type: string
            required:
            - id
            - sku
            - bom_sku
            - manufacturer_notes
            - internal_notes
            - requested_quantity
            - finished_quantity
            - created_date
            - updated_date
        comments:
          type: array
          items:
            $ref: '#/components/schemas/comment'
        tags:
          type: array
          items:
            $ref: '#/components/schemas/v3_tag'
        created_date:
          type: string
        updated_date:
          type: string
      required:
      - reference_id
      - status
      - warehouse_id
      - manufacturer_notes
      - internal_notes
      - lines
      - tags
      - created_date
      - updated_date
    put_manufacturing_order_line:
      title: Update a Manufacturing Order Line
      type: object
      additionalProperties: false
      properties:
        requested_quantity:
          type: number
        finished_quantity:
          type: number
        manufacturer_notes:
          anyOf:
          - type: string
          - type: 'null'
        internal_notes:
          anyOf:
          - type: string
          - type: 'null'
    post_manufacturing_order:
      title: Create a Manufacturing Order
      type: object
      additionalProperties: false
      properties:
        reference_id:
          type: string
        warehouse_id:
          type: integer
        manufacturer_notes:
          anyOf:
          - type: string
          - type: 'null'
        internal_notes:
          anyOf:
          - type: string
          - type: 'null'
        lines:
          type: array
          items:
            type: object
            properties:
              sku:
                type: string
              requested_quantity:
                type: number
              manufacturer_notes:
                anyOf:
                - type: string
                - type: 'null'
              internal_notes:
                anyOf:
                - type: string
                - type: 'null'
            required:
            - sku
      required:
      - reference_id
    get_manufacturing_order_count:
      type: object
      additionalProperties: false
      properties:
        group_by:
          type: array
          items:
            type: string
            enum:
            - warehouse_id
            - status
    put_manufacturing_order:
      title: Update a Manufacturing Order
      type: object
      additionalProperties: false
      properties:
        status:
          type: string
          enum:
          - initiated
          - active
          - finished
          - cancelled
        manufacturer_notes:
          type: string
        internal_notes:
          type: string
        warehouse_id:
          type: integer
    v3_tag_list:
      title: Tag List Schema
      type: object
      properties:
        count:
          type: integer
        tag:
          type: array
          items:
            $ref: '#/components/schemas/v3_tag'
        limit:
          type: integer
          default: 10
        offset:
          type: integer
          default: 0
      required:
      - count
      - tag
      - limit
      - offset
    post_manufacturing_order_line:
      title: Add a Manufacturing Order Line
      type: object
      additionalProperties: false
      properties:
        sku:
          type: string
        requested_quantity:
          type: number
        manufacturer_notes:
          anyOf:
          - type: string
          - type: 'null'
        internal_notes:
          anyOf:
          - type: string
          - type: 'null'
      required:
      - sku
    v3_tag:
      title: V3 Tag Schema
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        color:
          type: string
      required:
      - id
      - name
      - color
    ManufacturingOrderSort:
      title: manufacturing_order_sort
      enum:
      - reference_id
      - -reference_id
      - status
      - -status
      - warehouse_name
      - -warehouse_name
      - created_date
      - -created_date
      - updated_date
      - -updated_date
    put_v3_tag:
      title: Update a Tag
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
        color:
          type: string
  parameters:
    searchParam:
      name: search
      in: query
      description: ''
      schema:
        type: string
    goodsReceiptIDPath:
      name: goods_receipt_id
      in: path
      description: ''
      required: true
      style: simple
      schema:
        type: string
    limitParam:
      in: query
      name: limit
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 10
    offsetParam:
      in: query
      name: offset
      required: false
      description: ''
      schema:
        type: integer
        default: 0
        minimum: 0