eBay Fulfillment API — Shipping_fulfillment

naftiko: 1.0.0-alpha2
info:
  label: eBay Fulfillment API — Shipping_fulfillment
  description: 'eBay Fulfillment API — Shipping_fulfillment. 3 operations. Lead operation: Shipping_fulfillment. Self-contained
    Naftiko capability covering one Ebay business surface.'
  tags:
  - Ebay
  - Shipping_fulfillment
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: fulfillment-shipping-fulfillment
    baseUri: https://api.ebay.com{basePath}
    description: eBay Fulfillment API — Shipping_fulfillment business capability. Self-contained, no shared references.
    resources:
    - name: order-orderId-shipping_fulfillment
      path: /order/{orderId}/shipping_fulfillment
      operations:
      - name: getshippingfulfillments
        method: GET
        description: Use this call to retrieve the contents of all fulfillments currently defined for a specified order based
          on the order's unique identifier, <b>orderId</b>. This value is returned in the <b>getOrders</b> call's <b>members.orderId</b>
          field wh
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orderId
          in: path
          type: string
          description: This path parameter is used to specify the unique identifier of the order associated with the shipping
            fulfillments being retrieved.<br><br>Use the <a href="/ap
          required: true
      - name: createshippingfulfillment
        method: POST
        description: When you group an order's line items into one or more packages, each package requires a corresponding
          plan for handling, addressing, and shipping; this is a <i>shipping fulfillment</i>. For each package, execute this
          call once to generate a
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: orderId
          in: path
          type: string
          description: This path parameter is used to specify the unique identifier of the order associated with the shipping
            fulfillment being created.<br><br> Use the <a href="/api-
          required: true
        - name: Content-Type
          in: header
          type: string
          description: 'This header indicates the format of the request body provided by the client. Its value should be set
            to <b>application/json</b>. <br><br> For more information, '
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: order-orderId-shipping_fulfillment-fulfillmentId
      path: /order/{orderId}/shipping_fulfillment/{fulfillmentId}
      operations:
      - name: getshippingfulfillment
        method: GET
        description: Use this call to retrieve the contents of a fulfillment based on its unique identifier, <b>fulfillmentId</b>
          (combined with the associated order's <b>orderId</b>). The <b>fulfillmentId</b> value was originally generated by
          the <b>createShip
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillmentId
          in: path
          type: string
          description: This path parameter is used to specify the unique identifier of the shipping fulfillment being retrieved.<br><br>Use
            the <a href="/api-docs/sell/fulfillment/res
          required: true
        - name: orderId
          in: path
          type: string
          description: This path parameter is used to specify the unique identifier of the order associated with the shipping
            fulfillment being retrieved.<br><br> Use the <a href="/ap
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: fulfillment-shipping-fulfillment-rest
    port: 8080
    description: REST adapter for eBay Fulfillment API — Shipping_fulfillment. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/order/{orderid}/shipping-fulfillment
      name: order-orderid-shipping-fulfillment
      description: REST surface for order-orderId-shipping_fulfillment.
      operations:
      - method: GET
        name: getshippingfulfillments
        description: Use this call to retrieve the contents of all fulfillments currently defined for a specified order based
          on the order's unique identifier, <b>orderId</b>. This value is returned in the <b>getOrders</b> call's <b>members.orderId</b>
          field wh
        call: fulfillment-shipping-fulfillment.getshippingfulfillments
        with:
          orderId: rest.orderId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createshippingfulfillment
        description: When you group an order's line items into one or more packages, each package requires a corresponding
          plan for handling, addressing, and shipping; this is a <i>shipping fulfillment</i>. For each package, execute this
          call once to generate a
        call: fulfillment-shipping-fulfillment.createshippingfulfillment
        with:
          orderId: rest.orderId
          Content-Type: rest.Content-Type
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/order/{orderid}/shipping-fulfillment/{fulfillmentid}
      name: order-orderid-shipping-fulfillment-fulfillmentid
      description: REST surface for order-orderId-shipping_fulfillment-fulfillmentId.
      operations:
      - method: GET
        name: getshippingfulfillment
        description: Use this call to retrieve the contents of a fulfillment based on its unique identifier, <b>fulfillmentId</b>
          (combined with the associated order's <b>orderId</b>). The <b>fulfillmentId</b> value was originally generated by
          the <b>createShip
        call: fulfillment-shipping-fulfillment.getshippingfulfillment
        with:
          fulfillmentId: rest.fulfillmentId
          orderId: rest.orderId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: fulfillment-shipping-fulfillment-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Fulfillment API — Shipping_fulfillment. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: use-this-call-retrieve-contents
      description: Use this call to retrieve the contents of all fulfillments currently defined for a specified order based
        on the order's unique identifier, <b>orderId</b>. This value is returned in the <b>getOrders</b> call's <b>members.orderId</b>
        field wh
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: fulfillment-shipping-fulfillment.getshippingfulfillments
      with:
        orderId: tools.orderId
      outputParameters:
      - type: object
        mapping: $.
    - name: when-you-group-order-s-line
      description: When you group an order's line items into one or more packages, each package requires a corresponding plan
        for handling, addressing, and shipping; this is a <i>shipping fulfillment</i>. For each package, execute this call
        once to generate a
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: fulfillment-shipping-fulfillment.createshippingfulfillment
      with:
        orderId: tools.orderId
        Content-Type: tools.Content-Type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: use-this-call-retrieve-contents-2
      description: Use this call to retrieve the contents of a fulfillment based on its unique identifier, <b>fulfillmentId</b>
        (combined with the associated order's <b>orderId</b>). The <b>fulfillmentId</b> value was originally generated by
        the <b>createShip
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: fulfillment-shipping-fulfillment.getshippingfulfillment
      with:
        fulfillmentId: tools.fulfillmentId
        orderId: tools.orderId
      outputParameters:
      - type: object
        mapping: $.