Ordoro Return Order Rate API

openapi: 3.2.0
info:
  title: Ordoro API Documentation Address Return Order Rate API
  description: "# Introduction\n\nThe Ordoro API can be used to access data or integrate to add functionality to Ordoro. The Ordoro API uses the application/json Content-Type. The Ordoro API documentation is in beta. [See our forum](https://forums.ordoro.com) for questions or comments to help us improve the docs or request features.\n#### Note: Any routes with a /v3 designation will not allow for trailing slashes while all other routes and endpoints will require a trailing slash.\n\n# Authentication\n\nThe Ordoro API uses [Basic HTTP Authentication](http://en.wikipedia.org/wiki/Basic_access_authentication). Please create API keys via Settings->Account Settings->API Keys in app and use those for basic auth in your API requests.\n\n# Additional Resources\n\nFor a look at some code examples on how to use the API check out our github repo https://github.com/ordoro/api-examples.\n\n# API Responses\n\nMost of our endpoints return either a list of objects or a single object instance. They share similar response shapes.\n\n## List endpoints\n\nList endpoints respond with the following parameters:\n\n| Name           | Type                     | Description |\n|----------------|--------------------------|-------------|\n| `count`        | int                      | The total number of objects returned by a query ( **not** necessarily the number of objects included in a response). |\n| `limit`        | int                      | The maximum number of objects returned per request. Defaults to 10. Maximum is 100. You can set this as a URL parameter. |\n| `offset`       | int                      | The number of objects being offset in the response. May be altered as a URL Parameter. |\n| `<model name>` | array | An array of objects. The name of the model should be singular. For example, the /v3/order endpoint will have an `order` parameter, as opposed to `orders`.|\n\nHere is an example response for the `/v3/order` list endpoint.\n\n```\n{\n    \"count\": 2,\n    \"limit\": 10,\n    \"offset\" 0,\n    \"order\": [\n        {\n            // an order object\n        },\n        {\n            // another order object\n        }\n    ]\n}\n```\n\n## Instance endpoints\n\nInstance endpoints return a single instance of a serialized model. `/v3/order/{order_number}` is an example of an instance endpoint.\n\n# Error Handling\n\nError responses contain the following parameters:\n\n| Name            | Type             | Description                                                          |\n|-----------------|------------------|----------------------------------------------------------------------|\n| `error_message` | string           | Some human-readable error message.                                   |\n| `param`         | string or `null` | The name of the corresponding parameter, or null for general errors. |\n\n# Rate Limiting\n\nAPI requests will be limited to 500 requests per minute. Any requests over this threshold will respond with a 429 status code."
  contact: {}
  version: '1.0'
servers:
- url: https://api.ordoro.com/
  variables: {}
tags:
- name: Return Order Rate
paths:
  /v3/return_order/rate/australia_post:
    post:
      summary: Get Australia Post Rate for Return Order
      operationId: ReturnOrderRateAustraliaPost_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_easypost_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "[\n  {\n    \"rate\": 16.98,\n    \"service_type\": \"TBD\",\n    \"estimated_delivery_date\": \"2019-11-18T10:30:00Z\",\n    \"box_type\": null,\n    \"carrier\": \"australia_post\"\n  },\n  {\n    \"rate\": 5.6,\n    \"service_type\": \"TBD\",\n    \"estimated_delivery_date\": \"2019-11-18T07:00:00Z\",\n    \"box_type\": null,\n    \"carrier\": \"australia_post\"\n  },\n    {\n    \"rate\": 7.28,\n    \"service_type\": \"TBD\",\n    \"estimated_delivery_date\": \"2019-11-18T06:00:00Z\",\n    \"box_type\": null,\n    \"carrier\": \"australia_post\"\n  }\n]\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
  /v3/return_order/rate/canada_post:
    post:
      summary: Get Canada Post Rate for Return Order
      operationId: ReturnOrderRateCanadaPost_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_canada_post_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "{\n    \"info\": [\n        {\n            \"service_type\": \"DOM.EP\",\n            \"delivery_day\": \"Tuesday\",\n            \"cost\": \"16.37\",\n            \"service\": \"Expedited Parcel\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"DOM.PC\",\n            \"delivery_day\": \"Thursday\",\n            \"cost\": \"46.79\",\n            \"service\": \"Priority\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"DOM.RP\",\n            \"delivery_day\": \"Friday\",\n            \"cost\": \"16.37\",\n            \"service\": \"Regular Parcel\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"DOM.XP\",\n            \"delivery_day\": \"Friday\",\n            \"cost\": \"29.18\",\n            \"service\": \"Xpresspost\",\n            \"package\": \"\"\n        }\n    ]\n}\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
  /v3/return_order/rate/dhl:
    post:
      summary: Get DHL Rate for Return Order
      operationId: ReturnOrderRateDHL_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_dhl_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "[\n  {\n    \"rate\": 16.98,\n    \"service_type\": \"P\",\n    \"estimated_delivery_date\": \"2016-06-12T10:30:00Z\",\n    \"box_type\": null,\n    \"carrier\": \"dhl\"\n  },\n  {\n    \"rate\": 5.6,\n    \"service_type\": \"0\",\n    \"estimated_delivery_date\": \"2016-06-10T07:00:00Z\",\n    \"box_type\": null,\n    \"carrier\": \"dhl\"\n  },\n]\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
  /v3/return_order/rate/endicia:
    post:
      summary: Get Endicia Rate for Return Order
      operationId: ReturnOrderRateEndicia_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_endicia_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "{\n    \"status\": \"0\",\n    \"info\": [\n        {\n            \"service_type\": \"PriorityExpress\",\n            \"delivery_day\": \"\",\n            \"cost\": 20.66,\n            \"service\": \"Priority Mail Express\",\n            \"package\": \"Parcel\"\n        },\n        {\n            \"service_type\": \"LibraryMail\",\n            \"delivery_day\": \"\",\n            \"cost\": 4.03,\n            \"service\": \"Library Mail\",\n            \"package\": \"Parcel\"\n        },\n        {\n            \"service_type\": \"MediaMail\",\n            \"delivery_day\": \"\",\n            \"cost\": 4.22,\n            \"service\": \"Media Mail\",\n            \"package\": \"Parcel\"\n        }\n    ]\n}\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
  /v3/return_order/rate/fedex:
    post:
      summary: Get Fedex Rate for Return Order
      operationId: ReturnOrderRateFedex_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_fedex_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "{\n    \"status\": \"WARNING\",\n    \"info\": [\n        {\n            \"service_type\": \"FIRST_OVERNIGHT\",\n            \"delivery_day\": \"Friday\",\n            \"cost\": 58.02,\n            \"service\": \"First Overnight\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"PRIORITY_OVERNIGHT\",\n            \"delivery_day\": \"Friday\",\n            \"cost\": 29.81,\n            \"service\": \"Priority Overnight\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"STANDARD_OVERNIGHT\",\n            \"delivery_day\": \"Friday\",\n            \"cost\": 27.57,\n            \"service\": \"Standard Overnight\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"FEDEX_2_DAY_AM\",\n            \"delivery_day\": \"Monday\",\n            \"cost\": 18.8,\n            \"service\": \"2 Day Am\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"FEDEX_2_DAY\",\n            \"delivery_day\": \"Monday\",\n            \"cost\": 16.35,\n            \"service\": \"2 Day\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"FEDEX_EXPRESS_SAVER\",\n            \"delivery_day\": \"Tuesday\",\n            \"cost\": 15.65,\n            \"service\": \"Express Saver\",\n            \"package\": \"Your Packaging\"\n        },\n        {\n            \"service_type\": \"FEDEX_GROUND\",\n            \"delivery_day\": \"Unknown\",\n            \"cost\": 8.07,\n            \"service\": \"Ground\",\n            \"package\": \"Your Packaging\"\n        }\n    ]\n}\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
  /v3/return_order/rate/pitney:
    post:
      summary: Get USPS Rate for Return Order
      operationId: ReturnOrderRateUSPS_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_pitney_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "{\n    \"status\": \"Success\",\n    \"info\": [\n        {\n            \"cost\": 5.75,\n            \"package\": \"PKG\",\n            \"service_type\": \"PM\",\n            \"service\": \"Priority Mail\",\n            \"delivery_day\": \"2016-04-99\"\n        }\n    ]\n}\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponseOfTheFuture'
      tags:
      - Return Order Rate
  /v3/return_order/rate/ups:
    post:
      summary: Get UPS Rate for Return Order
      operationId: ReturnOrderRateUPS_POST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_ups_rate'
      parameters:
      - $ref: '#/components/parameters/orderNumberPath'
        responses:
          '200':
            description: OK
            examples:
              application/json: "{\n    \"status\": \"Success\",\n    \"info\": [\n        {\n            \"service_type\": \"03\",\n            \"delivery_day\": \"\",\n            \"cost\": 9.29,\n            \"service\": \"Ground\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"12\",\n            \"delivery_day\": \"\",\n            \"cost\": 13.3,\n            \"service\": \"3-day Select\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"59\",\n            \"delivery_day\": \"\",\n            \"cost\": 20.2,\n            \"service\": \"2nd Day AM\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"02\",\n            \"delivery_day\": \"\",\n            \"cost\": 17.56,\n            \"service\": \"2nd Day\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"13\",\n            \"delivery_day\": \"\",\n            \"cost\": 30.75,\n            \"service\": \"Next Day Air Saver\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"14\",\n            \"delivery_day\": \"\",\n            \"cost\": 65.41,\n            \"service\": \"Next Day AM\",\n            \"package\": \"\"\n        },\n        {\n            \"service_type\": \"01\",\n            \"delivery_day\": \"\",\n            \"cost\": 34.51,\n            \"service\": \"Next Day\",\n            \"package\": \"\"\n        }\n    ]\n}\n"
            headers:
              Access-Control-Allow-Credentials:
                type: string
              Access-Control-Allow-Origin:
                type: string
              Vary:
                type: string
            schema:
              $ref: '#/components/schemas/RateResponse'
      tags:
      - Return Order Rate
components:
  schemas:
    address:
      title: Address Schema
      type: object
      additionalProperties: false
      properties:
        id:
          type: integer
        name:
          example: Jimmy McGill
          anyOf:
          - type: string
          - type: 'null'
        company:
          example: Hamlin, Hamlin & McGill
          anyOf:
          - type: string
          - type: 'null'
        street1:
          example: 100 Constitution Ave
          anyOf:
          - type: string
          - type: 'null'
        street2:
          anyOf:
          - type: string
          - type: 'null'
        city:
          example: Albuquerque
          anyOf:
          - type: string
          - type: 'null'
        state:
          example: NM
          anyOf:
          - type: string
          - type: 'null'
        zip:
          example: '87109'
          anyOf:
          - type: string
          - type: 'null'
        country:
          example: US
          anyOf:
          - type: string
          - type: 'null'
        email:
          example: slippin-jimmy@saul-good.man
          anyOf:
          - type: string
          - type: 'null'
        phone:
          example: 555-867-5309
          anyOf:
          - type: string
          - type: 'null'
        fax:
          anyOf:
          - type: string
          - type: 'null'
        cart_address_id:
          anyOf:
          - type: string
          - type: 'null'
        revision_locked_fields:
          type: array
        validation:
          title: Validation status of an Address
          properties:
            status:
              type: string
              enum:
              - unvalidated
              - validated
              - warning
              - error
            suggested:
              type: array
              items:
                title: Suggested Address
                type: object
                additionalProperties: false
                properties:
                  is_commercial:
                    default: false
                    anyOf:
                    - type: boolean
                    - type: 'null'
                  street1:
                    type: string
                  street2:
                    anyOf:
                    - type: string
                    - type: 'null'
                  city:
                    type: string
                  state:
                    type: string
                  zip:
                    type: string
                  country_code:
                    anyOf:
                    - type: string
                    - type: 'null'
                required:
                - city
                - state
                - zip
                - street1
            additional_text:
              anyOf:
              - type: string
              - type: 'null'
          required:
          - status
          - additional_text
          - suggested
          additionalProperties: false
          anyOf:
          - type: object
          - type: 'null'
      required:
      - name
      - company
      - street1
      - street2
      - city
      - state
      - zip
      - country
      - email
      - phone
    customs_line:
      title: Customs Line Schema
      type: object
      additionalProperties: false
      properties:
        country:
          type: string
        description:
          type: string
        quantity:
          type: integer
        value:
          description: Dollar value of customs line
          format: double
          type: number
        weight:
          description: Weight of customs line in ounces
          type: number
        harmonization_code:
          description: The 6 character international nomenclature for the classification of products
          type: string
        sku:
          type: string
        unit_of_measure:
          type: string
        url:
          type: string
        harmonization_code_country:
          description: The country of harmonization_code
          type: string
      required:
      - description
      - quantity
      - value
      - weight
      - country
    v1_rate:
      title: Rate Response Schema
      type: object
      properties:
        info:
          type: array
          items:
            type: object
            properties:
              service:
                type: string
              service_type:
                type: string
              package:
                type: string
              delivery_day:
                type: string
              cost:
                type: number
    rate:
      title: Rate Response schema
      type: array
      items:
        type: object
        properties:
          service_type:
            type: string
          rate:
            type: number
          transaction_fee:
            type: number
          box_type:
            anyOf:
            - type: string
            - type: 'null'
          carrier:
            type: string
          carrier_account_id:
            description: for shippo rate response and carrier matching
            type: string
          estimated_delivery_days:
            anyOf:
            - type: string
            - type: 'null'
          estimated_delivery_date:
            anyOf:
            - type: string
            - type: 'null'
          display:
            description: display name for the carrier rate
            type: string
          one_rate:
            description: indicator that rate is a FedEx One Rate
            type: boolean
          processing_category:
            description: returned from USPS rates for service type processing category distinction
            anyOf:
            - type: string
            - type: 'null'
          rate_id:
            description: returned by Shippo for rate selection along with shipment_id
            type: string
          rate_indicator:
            description: returned from USPS for additional rate distinction
            type: string
          saturday_delivery:
            type: boolean
          shipment_id:
            type: string
          service_token:
            type: string
          zone:
            anyOf:
            - type: string
            - type: 'null'
        required:
        - service_type
        - box_type
        - carrier
        - rate
        additionalProperties: false
    post_easypost_rate:
      additionalProperties: true
      properties:
        box_shape:
          type: string
        customs_info:
          items:
            $ref: '#/components/schemas/customs_line'
          type: array
        delivery_confirmation:
          type: string
        insurance_type:
          type: string
        insured_value:
          type: number
        notify_bill_to:
          default: false
          type: boolean
        notify_ship_to:
          default: false
          type: boolean
        packages:
          items:
            additionalProperties: false
            properties:
              additional_handling:
                type: boolean
              box_shape:
                type: string
              height:
                description: Height in inches
                type: number
              length:
                description: Length in inches
                type: number
              reference_number:
                description: Package level reference, not always necessarily a number
                type: string
              reference:
                description: Package level reference, not always necessarily a number
                type: string
              weight:
                description: weight of the package in ounces
                type: number
              width:
                description: Width in inches
                type: number
            type: object
          maxItems: 200
          type: array
        reason_for_export:
          type: string
        reference_number:
          description: Package level reference, not always necessarily a number
          type: string
        ship_date:
          type: string
        ship_from:
          description: The ship_from address is used as the originating address of the rate and label request.
          $ref: '#/components/schemas/v1_address'
        ship_to:
          description: The to address is used as the destination address of a return order rate and label request.
          $ref: '#/components/schemas/v1_address'
        shipper_id:
          type: integer
        reference_id:
          description: Identifier for a Return Order
          type: string
        shipping_method:
          description: ignored for rate requests
          type: string
      required:
      - shipper_id
      - packages
      title: Easypost POST Rate Request Schema
      type: object
    RateResponseOfTheFuture:
      $ref: '#/components/schemas/rate'
    post_dhl_rate:
      title: DHL Rate POST Request schema
      type: object
      additionalProperties: false
      properties:
        shipper_id:
          type: integer
        packages:
          maxItems: 1
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              weight:
                description: Weight in ounces
                type: number
              length:
                description: Length in inches
                type: number
              width:
                description: Width in inches
                type: number
              height:
                description: Height in inches
                type: number
              declared_value:
                description: Package Level Declared Value for Dutiable International Shipments
                type: number
              box_shape:
                description: optional box type [FLY=Flyer/Smalls - pieces that are too small, thin or light to be sorted on a standard conveyor, or for which it makes sense to group pieces into larger units for sort purposes. COY=Parcels/Conveyables - pieces that can be handled onto a system, less than 31.5 kg and up to 60*60*120cm. NCY=Non-conveyables - Pieces that cannot on their own be sorted on standard conveyor. PAL=Pallets - large, irregular or heavy pieces, Palletized with weight upto 1000 KG. DBL=Double Pallets - large, irregular or heavy pieces, Palletized with weight upto 1000 KG. BOX=Parcels that are conveyable have the shape of a box. Up to 70kg.]
                type: string
                enum:
                - FLY
                - COY
                - NCY
                - PAL
                - DBL
                - BOX
            required:
            - length
            - width
            - height
            - weight
        declared_value:
          description: Shipment Level Declared Value for Dutiable International Shipments
          type: number
        insured_value:
          type: number
        insurance_type:
          type: string
          enum:
          - dhl
        ship_date:
          type: string
          format: date-time
        reference_number:
          type: string
        pickup:
          description: pickup date time to schedule for the carrier
          type: string
          format: date-time
        signature_service:
          description: signature service option. Signature services are included in international shipments. Use `SX` for no signature required
          type: string
          enum:
          - SX
        nonstandard_day:
          description: options are [AA - Saturday Delivery, AB - Saturday Pickup, AC - Holiday Delivery, AD - Holiday Pickup, AG - Domestic Saturday Delivery]
          type: string
          enum:
          - AA
          - AB
          - AC
          - AD
          - AG
        nonstandard_contents:
          description: options are [HB - Lithium Ion PI965 Section II, HC - Dry Ice UN1845, HD - Lithium Ion PI965-966 Section II, HE - Dangerous Goods, HG - Perishable Cargo, HH - Excepted Quantity, HI - Spill Cleaning, HK - Consumer Commodities, HL - Limited Quantities ADR, HM - Lithium Metal PI969 Section II, HN - ADR Load Exemption, HV - Lithium Ion PI967-Section II, HW - Lithium Metal PI970-Section II, HY - Biological UN3373]
          type: string
          enum:
          - HB
          - HC
          - HD
          - HE
          - HG
          - HH
          - HI
          - HK
          - HL
          - HM
          - HN
          - HV
          - HW
          - HY
        is_dutiable:
          type: boolean
          default: true
        ship_from:
          description: The ship_from address is used as the originating address of the rate and label request.
          $ref: '#/components/schemas/v1_address'
        ship_to:
          description: The to address is used as the destination address of a return order rate and label request.
          $ref: '#/components/schemas/v1_address'
        reference_id:
          description: Identifier for a Return Order
          type: string
        return:
          description: For orders, determines whether the originating and destination addresses will be swapped for a return label request
          type: boolean
          default: false
        warehouse_id:
          description: 'DEPRECATED: ignored. Previously used for updating a warehouse for the ship_from address on an order.'
          type: integer
      required:
      - shipper_id
    post_pitney_rate:
      title: Pitney Rate POST Request Schema
      additionalProperties: false
      properties:
        delivery_confirmation:
          enum:
          - DelCon
          - Sig
          - ADSIG
          - ADSIGRD
          - SigRD
          type: string
        hazmat_type:
          description: USPS hazmat input type options
          type: string
        hazmat_electronics:
          description: ' USPS hazmat option for electronics'
          type: boolean
        insurance_type:
          enum:
          - discounted_insurance
          type: string
        insured_value:
          default: 0
          type: number
        mailing_zip_code:
          description: mailing post office zip code if different than from_address zip code, ignored in rate request
          type: string
        non_delivery:
          enum:
          - return
          - abandon
          - redirect
          type: string
        packages:
          description: This should always be an array of 1, as USPS does not allow for multiple package shipments at this time
          maxItems: 1
          items:
            additionalProperties: false
            properties:
              box_shape:
                type: string
              height:
                description: Height in inches
                type: number
              length:
                description: Length in inches
                type: number
              weight:
                description: Weight in ounces
                type: number
              width:
                description: Width in inches
                type: number
            required:
            - box_shape
            - weight
            type: object
          type: array
        parcel_characteristics:
          description: For nonstandard packages
          type: string
        pitney_rate_type:
          type: string
        reference_number:
          type: string
        return:
          description: For orders, determines whether the originating and destination addresses will be swapped for a return label request
          type: boolean
        ship_date:
          format: date-time
          type: string
        ship_from:
          description: The ship_from address is used as the originating address of the rate and label request.
          $ref: '#/components/schemas/v1_address'
        ship_to:
          description: The to address is used as the destination address of a return order rate and label request.
          $ref: '#/components/schemas/v1_address'
        reference_id:
          description: Identifier for a Return Order
          type: string
        shipper_id:
          type: integer
        shipping_method:
          type: string
        warehouse_id:
          description: Currently ignored. Previously used for updating a warehouse for the ship_from address on an order.
          type: integer
      required:
      - shipper_id
      - shipping_method
      type: object
    post_endicia_rate:
      title: Endicia Rate POST Request Schema
      type: object
      properties:
        packages:
          description: This should always be an array of 1, as USPS does not allow for multiple package shipments at this time
          type: array
          maxItems: 1
          items:
            additionalProperties: false
            type: object
            properties:
              box_shape:
                enum:
                - SmallFlatRateBox
                - MediumFlatRateBox
                - LargeFlatRateBox
                - Parcel
                - Softpack
                - Card
                - Flat
                - Letter
                - FlatRateEnvelope
                - FlatRateLegalEnvelope
                - FlatRatePaddedEnvelope
                - SmallFlatRateEnvelope
                - RegionalRateBoxA
                - RegionalRateBoxB
                type: string
              height:
                description: Height in inches
                type: number
              length:
                description: Length in inches
                type: number
              reference:
                description: package level customer reference value
                type: string
              weight:
                description: Currently not used, Order weight is used instead. Weight in ounces.
                type: number
              wid

# --- truncated at 32 KB (56 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ordoro/refs/heads/main/openapi/ordoro-return-order-rate-api-openapi.yml