Ordoro Shipper API

A shipper or carrier account can be created and used to get quotes and generate labels for orders.

OpenAPI Specification

ordoro-shipper-api-openapi.yml Raw ↑
openapi: 3.0.0
info:
  title: Ordoro API Documentation Address Shipper 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: Shipper
  description: A shipper or carrier account can be created and used to get quotes and generate labels for orders.
paths:
  /shipper/:
    get:
      tags:
      - Shipper
      summary: Get a list of Shippers
      description: ''
      operationId: Shipper_GET
      parameters:
      - $ref: '#/components/parameters/offsetParam'
      - $ref: '#/components/parameters/limitParam'
      - $ref: '#/components/parameters/searchParam'
      - name: sort
        in: query
        description: ''
        style: form
        explode: true
        schema:
          type: string
      - name: all
        in: query
        description: Allows for retrieval of archived shippers as well
        style: form
        explode: true
        schema:
          type: boolean
      responses:
        '200':
          description: Successfully retrieved list of shippers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/shipper_list'
      deprecated: false
    post:
      tags:
      - Shipper
      summary: Create a Shipper
      description: Each shipper has unique authentication requirements, so the schema depends on the value of the `vendor` parameter.
      operationId: Shipper_POST
      requestBody:
        content:
          application/json:
            schema:
              discriminator:
                propertyName: vendor
                mapping:
                  amazon: '#/components/schemas/post_shipper_amazon'
                  australia_post: '#/components/schemas/post_shipper_australia_post'
                  canada_post: '#/components/schemas/post_shipper_canada_post'
                  dhl: '#/components/schemas/post_shipper_dhl'
                  endicia: '#/components/schemas/post_shipper_endicia'
                  fedex: '#/components/schemas/post_shipper_fedex'
                  pitney: '#/components/schemas/post_shipper_pitney'
                  pitney_merchant: '#/components/schemas/post_shipper_pitney'
                  pitney_presort: '#/components/schemas/post_shipper_pitney'
                  ups: '#/components/schemas/post_shipper_ups'
              oneOf:
              - $ref: '#/components/schemas/post_shipper_amazon'
              - $ref: '#/components/schemas/post_shipper_australia_post'
              - $ref: '#/components/schemas/post_shipper_canada_post'
              - $ref: '#/components/schemas/post_shipper_dhl'
              - $ref: '#/components/schemas/post_shipper_endicia'
              - $ref: '#/components/schemas/post_shipper_fedex'
              - $ref: '#/components/schemas/post_shipper_pitney'
              - $ref: '#/components/schemas/post_shipper_ups'
      responses:
        '201':
          description: Shipper successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/one_of_shipper_type'
      deprecated: false
  /shipper/{shipper_id}/:
    delete:
      tags:
      - Shipper
      summary: Archive a Shipper
      description: Set an archive date on a Shipper and hide it from responses
      operationId: ShipperByShipperId_DELETE
      parameters:
      - '200':
          description: Shipper successfully archived
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShipperResponse'
        '404':
          description: No shipper found
        name: shipper_id
        in: path
        description: ''
        required: true
        style: simple
        schema:
          type: string
      deprecated: false
    get:
      tags:
      - Shipper
      summary: Get a Shipper by Id
      description: ''
      operationId: ShipperByShipperId_GET
      parameters:
      - name: shipper_id
        in: path
        description: ''
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: Shipper successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/one_of_shipper_type'
        '404':
          description: Could not find this Shipper
      deprecated: false
    put:
      tags:
      - Shipper
      summary: Update Shipper
      description: Each shipper has unique authentication requirements, so the schema depends on the value of the `vendor` parameter.
      operationId: ShipperByShipperId_PUT
      parameters:
      - name: shipper_id
        in: path
        description: ''
        required: true
        style: simple
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              oneOf:
              - $ref: '#/components/schemas/put_shipper_amazon'
              - $ref: '#/components/schemas/put_shipper_australia_post'
              - $ref: '#/components/schemas/put_shipper_canada_post'
              - $ref: '#/components/schemas/put_shipper_dhl'
              - $ref: '#/components/schemas/put_shipper_endicia'
              - $ref: '#/components/schemas/put_shipper_fedex'
              - $ref: '#/components/schemas/put_shipper_newgistics'
              - $ref: '#/components/schemas/put_shipper_pitney'
              - $ref: '#/components/schemas/put_shipper_ups'
              - $ref: '#/components/schemas/put_shipper_xdelivery'
      responses:
        '200':
          description: Shipper successfully updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/one_of_shipper_type'
      deprecated: false
  /v3/shipper/{shipper_id}/balance:
    get:
      summary: Get balance for shipper's postage
      description: A single USPS Pitney Bowes shipper may have a balance
      operationId: V3ShipperByIDBalance_GET
      tags:
      - Shipper
      parameters:
      - name: shipper_id
        type: string
        in: path
        required: true
      responses:
        '200':
          description: 200 response OK
          content:
            application/json:
              example:
                postage_balance: 888
              schema:
                $ref: '#/components/schemas/endicia_account_balance'
    post:
      description: Add balance for shipper's postage
      tags:
      - Shipper
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_shipper_balance'
      parameters:
      - name: shipper_id
        type: string
        in: path
        required: true
      responses:
        '200':
          description: 200 response OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/endicia_account_balance'
  /v3/pickup/ups:
    post:
      summary: Schedule a UPS pickup
      operationId: PickupUPS_POST
      tags:
      - Shipper
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_ups_schedule_pickup'
      parameters: []
      responses:
        '200':
          description: Pickup schedule success
          content:
            application/json:
              example:
                pickup_number: '1234'
                carrier: ups
              schema:
                $ref: '#/components/schemas/pickup'
  /v3/pickup/fedex:
    post:
      summary: Schedule a FedEx pickup
      description: ''
      operationId: PickupUPS_POST
      tags:
      - Shipper
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/post_fedex_schedule_pickup'
      parameters: []
      responses:
        '200':
          description: Pickup schedule success
          content:
            application/json:
              example:
                pickup_number: '1234'
                carrier: fedex
              schema:
                $ref: '#/components/schemas/pickup'
components:
  parameters:
    searchParam:
      name: search
      in: query
      description: ''
      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
  schemas:
    shipper_canada_post-2:
      title: Canada Post Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_canada_post'
      - $ref: '#/components/schemas/shipper_canada_post_definitions-required_in_response'
    any_of_shipper_type:
      anyOf:
      - $ref: '#/components/schemas/shipper_amazon-2'
      - $ref: '#/components/schemas/shipper_australia_post-2'
      - $ref: '#/components/schemas/shipper_canada_post-2'
      - $ref: '#/components/schemas/shipper_dhl-2'
      - $ref: '#/components/schemas/shipper_endicia-2'
      - $ref: '#/components/schemas/shipper_fedex-2'
      - $ref: '#/components/schemas/shipper_pitney-2'
      - $ref: '#/components/schemas/shipper_pitney_merchant-2'
      - $ref: '#/components/schemas/shipper_pitney_presort-2'
      - $ref: '#/components/schemas/shipper_sendle-2'
      - $ref: '#/components/schemas/shipper_ups-2'
    pickup:
      title: Pickup Response
      type: object
      additionalProperties: false
      properties:
        pickup_address:
          $ref: '#/components/schemas/update_address'
        pickup_address_same_as_account:
          type: boolean
        pickup_datetime:
          type: string
          format: date-time
        close_time:
          type: string
          format: date-time
        location:
          type: string
        pickup_number:
          type: string
        cost:
          anyOf:
          - type: string
          - type: number
          - type: 'null'
        carrier:
          type: string
          enum:
          - ups
          - fedex
        carrier_options:
          anyOf:
          - type: object
          - type: 'null'
      required:
      - pickup_number
      - carrier
    post_shipper_pitney:
      title: Pitney Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/post_shipper_base'
      - $ref: '#/components/schemas/shipper_pitney_vendor_config'
      - $ref: '#/components/schemas/shipper_pitney_vendor_config_definitions-required_to_create'
    shipper_base_definitions-required_in_response:
      required:
      - _link
      - archive_date
      - created
      - hidden_shipping_methods
      - id
      - name
      - updated
      - vendor
      - vendor_config
    shipper_fedex_vendor_config_definitions-required_in_response:
      required:
      - account_number
      - child_key
      - child_secret
      - smart_post_hub
      - use_metric_units
    shipper_dhl-2:
      title: DHL Express Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_dhl'
      - $ref: '#/components/schemas/shipper_dhl_definitions-required_in_response'
    put_shipper_endicia:
      title: Endicia Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_endicia_vendor_config'
    shipper_canada_post_vendor_config_definitions-required_to_create:
      required:
      - customer_number
      - username
      - password
    put_shipper_xdelivery:
      title: X Delivery Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_xdelivery_vendor_config'
    shipper_australia_post:
      title: Australia Post Shipper Schema
      type: object
      definitions:
        required_in_response:
          allOf:
          - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
          - properties:
              vendor_config:
                $ref: '#/components/schemas/shipper_australia_post_vendor_config_definitions-required_in_response'
      allOf:
      - properties:
          vendor:
            type: string
            enum:
            - australia_post
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_australia_post_vendor_config'
      - $ref: '#/components/schemas/shipper_base'
    shipper_ups:
      title: UPS Shipper Schema
      type: object
      definitions:
        required_in_response:
          allOf:
          - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
          - properties:
              vendor_config:
                $ref: '#/components/schemas/shipper_ups_vendor_config_definitions-required_in_response'
      allOf:
      - properties:
          vendor:
            type: string
            enum:
            - ups
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_ups_vendor_config'
      - $ref: '#/components/schemas/shipper_base'
    put_shipper_pitney:
      title: Pitney Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_pitney_vendor_config'
    shipper_canada_post:
      title: Canada Post Shipper Schema
      type: object
      definitions:
        required_in_response:
          allOf:
          - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
          - properties:
              vendor_config:
                $ref: '#/components/schemas/shipper_canada_post_vendor_config_definitions-required_in_response'
      allOf:
      - properties:
          vendor:
            type: string
            enum:
            - canada_post
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_canada_post_vendor_config'
      - $ref: '#/components/schemas/shipper_base'
    shipper_ups-2:
      title: UPS Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_ups'
      - $ref: '#/components/schemas/shipper_ups_definitions-required_in_response'
    shipper_base:
      title: Shipper Base Schema
      type: object
      definitions:
        required_in_response:
          required:
          - _link
          - archive_date
          - created
          - hidden_shipping_methods
          - id
          - name
          - updated
          - vendor
          - vendor_config
      properties:
        _link:
          type: string
          description: A relative link to this shipper
        name:
          type: string
          description: The name of the shipper
        vendor:
          type: string
          description: Short name of the vendor.
          enum:
          - amazon
          - australia_post
          - canada_post
          - dhl
          - endicia
          - fedex
          - pitney
          - pitney_merchant
          - pitney_presort
          - sendle
          - ups
        hidden_shipping_methods:
          description: A list of shipping methods per shipper type that can be excluded from retrieved rates
          items: {}
          type: array
        id:
          type: integer
          description: The identifier used as the main reference to this shipper.
          default: 1
        archive_date:
          description: If this shipper has been archived, this will contain the datetime that the shipper was archived. Otherwise it will be null.
          anyOf:
          - type: string
          - type: 'null'
        vendor_config:
          type: object
          description: Vendor-specific configuration information.
    shipper_pitney_presort_definitions-required_in_response:
      allOf:
      - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_pitney_presort_vendor_config_definitions-required_in_response'
    shipper_dhl:
      title: DHL Shipper Schema
      type: object
      definitions:
        required_in_response:
          allOf:
          - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
          - properties:
              vendor_config:
                $ref: '#/components/schemas/shipper_dhl_vendor_config_definitions-required_in_response'
      allOf:
      - properties:
          vendor:
            type: string
            enum:
            - dhl
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_dhl_vendor_config'
      - $ref: '#/components/schemas/shipper_base'
    shipper_canada_post_vendor_config_definitions-required_in_response:
      required:
      - customer_number
      - username
      - password
      - contract_id
      - payment_method
    shipper_amazon_vendor_config_definitions-required_to_create:
      required: []
    update_address:
      title: Update Address Schema
      type: object
      additionalProperties: false
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
        company:
          anyOf:
          - type: string
          - type: 'null'
        street1:
          anyOf:
          - type: string
          - type: 'null'
        street2:
          anyOf:
          - type: string
          - type: 'null'
        city:
          anyOf:
          - type: string
          - type: 'null'
        state:
          anyOf:
          - type: string
          - type: 'null'
        zip:
          anyOf:
          - type: string
          - type: 'null'
        country:
          anyOf:
          - type: string
          - type: 'null'
        email:
          anyOf:
          - type: string
          - type: 'null'
        phone:
          anyOf:
          - type: string
          - type: 'null'
        validate:
          type: boolean
        set_revision_lock:
          type: boolean
        validation:
          title: Validation status of an Address
          type: object
          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:
                    type: string
                required:
                - city
                - state
                - zip
                - street1
            additional_text:
              anyOf:
              - type: string
              - type: 'null'
            is_error:
              type: boolean
          required:
          - additional_text
          - suggested
          additionalProperties: false
    shipper_dhl_vendor_config:
      type: object
      definitions:
        required_to_create:
          required:
          - payment_account_number
          - payment_country_code
        required_in_response:
          required:
          - payment_account_number
          - payment_country_code
      description: DHL Shipper configuration information
      properties:
        payment_account_number:
          type: string
        payment_country_code:
          type: string
    shipper_fedex_definitions-required_in_response:
      allOf:
      - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_fedex_vendor_config_definitions-required_in_response'
    shipper_australia_post_vendor_config_definitions-required_in_response:
      required:
      - account_number
      - api_key
      - api_secret
      - print_as_you_go
      - easypost_carrier_id
    shipper_pitney_merchant-2:
      title: Pitney Bowes USPS Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_pitney_merchant'
      - $ref: '#/components/schemas/shipper_pitney_merchant_definitions-required_in_response'
    shipper_list:
      type: object
      properties:
        limit:
          type: integer
        offset:
          type: integer
        count:
          type: integer
        shipper:
          type: array
          items:
            $ref: '#/components/schemas/any_of_shipper_type'
      required:
      - limit
      - offset
      - count
      - shipper
    post_shipper_balance:
      title: Add shipper balance schema
      type: object
      additionalProperties: false
      properties:
        amount:
          type: number
          format: double
          minimum: 10
      required:
      - amount
    post_fedex_schedule_pickup:
      title: Fedex Pickup Request Schema
      type: object
      additionalProperties: false
      properties:
        close_time:
          type: string
        pickup_address_same_as_account:
          description: 'Deprecated: Indicates whether to use the address associated with the Fedex account, or a different address'
          type: boolean
        oversize_package_count:
          type: integer
          default: 0
        package_location:
          type: string
          enum:
          - FRONT
          - NONE
          - REAR
          - SIDE
        pickup_datetime:
          type: string
        pickup_date_type:
          type: string
          enum:
          - SAME_DAY
          - FUTURE_DAY
        quantity:
          type: integer
        total_weight:
          description: total weight of packages in pounds (LB)
          type: number
        service_category:
          type: string
          enum:
          - SAME_DAY
          - SAME_DAY_CITY
          - FEDEX_DISTANCE_DEFERRED
          - FEDEX_NEXT_DAY_EARLY_MORNING
          - FEDEX_NEXT_DAY_MID_MORNING
          - FEDEX_NEXT_DAY_AFTERNOON
          - FEDEX_NEXT_DAY_END_OF_DAY
          - FEDEX_NEXT_DAY_FREIGHT
        carrier_code:
          description: 'Describes the fedex carrier for the pickup: [''FDXG'' - Fedex Ground, ''FDXE'' - Fedex Express]'
          type: string
          enum:
          - FDXG
          - FDXE
        remarks:
          description: Identifies comments the customer wants to convey to the FedEx courier regarding the package pickup.
          type: string
        shipper_id:
          type: integer
        warehouse_id:
          description: warehouse for the pickup address
          type: integer
        commodity_description:
          description: Provides area for any additional commodity description
          type: string
        domestic_or_international:
          description: Describes the country relationship (domestic and/or international) among the shipments being picked up
          type: string
          default: DOMESTIC
          enum:
          - DOMESTIC
          - INTERNATIONAL
      required:
      - close_time
      - pickup_datetime
      - quantity
      - shipper_id
      - total_weight
    post_shipper_australia_post:
      title: Australia Post Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/post_shipper_base'
      - $ref: '#/components/schemas/shipper_australia_post_vendor_config'
      - $ref: '#/components/schemas/shipper_australia_post_vendor_config_definitions-required_to_create'
    shipper_pitney_presort-2:
      title: Pitney Bowes USPS Presort Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_pitney_presort'
      - $ref: '#/components/schemas/shipper_pitney_presort_definitions-required_in_response'
    shipper_canada_post_definitions-required_in_response:
      allOf:
      - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_canada_post_vendor_config_definitions-required_in_response'
    post_shipper_ups:
      title: UPS Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/post_shipper_base'
      - $ref: '#/components/schemas/shipper_ups_vendor_config'
      - $ref: '#/components/schemas/shipper_ups_vendor_config_definitions-required_to_create'
    shipper_australia_post-2:
      title: Australia Post via easypost Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_australia_post'
      - $ref: '#/components/schemas/shipper_australia_post_definitions-required_in_response'
    shipper_endicia_definitions-required_in_response:
      allOf:
      - $ref: '#/components/schemas/shipper_base_definitions-required_in_response'
      - properties:
          vendor_config:
            $ref: '#/components/schemas/shipper_endicia_vendor_config_definitions-required_in_response'
    post_shipper_base:
      type: object
      additionalProperties: false
      properties:
        vendor:
          description: The vendor of shipper.
          type: string
          enum:
          - amazon
          - australia_post
        hidden_shipping_methods:
          description: A list of shipping methods per shipper type that can be excluded from retrieved rates
          items: {}
          type: array
        name:
          description: The display name of this shipper.
          type: string
      required:
      - vendor
    put_shipper_australia_post:
      title: Australia Post Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_australia_post_vendor_config'
    post_shipper_fedex:
      title: Fedex Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/post_shipper_base'
      - $ref: '#/components/schemas/shipper_fedex_vendor_config'
      - $ref: '#/components/schemas/shipper_fedex_vendor_config_definitions-required_to_create'
    shipper_australia_post_vendor_config:
      type: object
      definitions:
        required_to_create:
          required:
          - account_number
          - api_key
          - api_secret
        required_in_response:
          required:
          - account_number
          - api_key
          - api_secret
          - print_as_you_go
          - easypost_carrier_id
      description: Australia Post Shipper configuration information
      properties:
        account_number:
          type: string
        api_key:
          type: string
        api_secret:
          type: string
        print_as_you_go:
          type: boolean
        easypost_carrier_id:
          description: Australia Post is served via easypost, this is the internal identifier within the easypost system
          type: string
    shipper_endicia_vendor_config_definitions-required_in_response:
      required:
      - account_id
      - web_password
      - passphrase
      - is_free
      - challenge_question
      - challenge_answer
    put_shipper_base:
      type: object
      additionalProperties: false
      properties:
        hidden_shipping_methods:
          description: A list of shipping methods per shipper type that can be excluded from retrieved rates
          items: {}
          type: array
        name:
          description: The display name of this shipper.
          type: string
    shipper_pitney_merchant_vendor_config:
      type: object
      definitions:
        required_to_create:
          required: []
        required_in_response:
          required: []
      properties: {}
    put_shipper_ups:
      title: UPS Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_ups_vendor_config'
    shipper_pitney_vendor_config_definitions-required_to_create:
      required:
      - postal_reporting_number
    put_shipper_canada_post:
      title: Canada Post Shipper
      type: object
      additionalProperties: false
      allOf:
      - $ref: '#/components/schemas/put_shipper_base'
      - $ref: '#/components/schemas/shipper_canada_post_vendor_config'
    shipper_pitney-2:
      title: Pitney Bowes USPS Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_pitney'
      - $ref: '#/components/schemas/shipper_pitney_definitions-required_in_response'
    shipper_ups_vendor_config_definitions-required_in_response:
      required:
      - access_token
      - token_type
      - expires
      - refresh_token
      - refresh_token_expires
      - shipper_number
      - access_license_key
      - use_metric_units
      - cost_center
      - billing_email
      - uses_discounted_rates
    shipper_endicia-2:
      title: Endicia USPS Shipper
      allOf:
      - $ref: '#/components/schemas/shipper_endicia'
      - $ref: '#/components/schemas/shipper_endicia_definitions-required_in_response'
    shipper_amazo

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