Shopify API — Tracking

naftiko: 1.0.0-alpha2
info:
  label: Shopify  API — Tracking
  description: 'Shopify  API — Tracking. 7 operations. Lead operation: Shopify Updates The Tracking Information For A Fulfillment.
    Self-contained Naftiko capability covering one Shopify business surface.'
  tags:
  - Shopify
  - Tracking
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SHOPIFY_API_KEY: SHOPIFY_API_KEY
capability:
  consumes:
  - type: http
    namespace: shopify-tracking
    baseUri: ''
    description: Shopify  API — Tracking business capability. Self-contained, no shared references.
    resources:
    - name: admin-api-2020-01-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/2020-01/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: deprecated202001createfulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-04-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/2020-04/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: deprecated202004createfulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-07-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/2020-07/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: deprecated202007createfulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-10-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/2020-10/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: createfulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2021-01-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/2021-01/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: deprecated202101createfulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-unstable-fulfillments-fulfillment_id-update_tracking.json
      path: /admin/api/unstable/fulfillments/{fulfillment_id}/update_tracking.json
      operations:
      - name: deprecatedunstablecreatefulfillmentsparamfulfillmentidupdatetracking
        method: POST
        description: Shopify Updates The Tracking Information For A Fulfillment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: fulfillment_id
          in: path
          type: string
          description: fulfillment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: fetch_tracking_numbers
      path: /fetch_tracking_numbers
      operations:
      - name: deprecatedunknownversiongetfetchtrackingnumbers
        method: GET
        description: Shopify Get Tracking Numbers For Orders
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: order_names
          in: query
          type: string
          description: 'The fulfillment names we require tracking numbers for (i.e. #1001.1)'
        - name: shop
          in: query
          type: string
          description: The shop's myshopify url
  exposes:
  - type: rest
    namespace: shopify-tracking-rest
    port: 8080
    description: REST adapter for Shopify  API — Tracking. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/admin/api/2020-01/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-2020-01-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-2020-01-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: deprecated202001createfulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.deprecated202001createfulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-2020-04-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-2020-04-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: deprecated202004createfulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.deprecated202004createfulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-2020-07-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-2020-07-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: deprecated202007createfulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.deprecated202007createfulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-10/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-2020-10-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-2020-10-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: createfulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.createfulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2021-01/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-2021-01-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-2021-01-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: deprecated202101createfulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.deprecated202101createfulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/unstable/fulfillments/{fulfillment-id}/update-tracking-json
      name: admin-api-unstable-fulfillments-fulfillment-id-update-tracking-json
      description: REST surface for admin-api-unstable-fulfillments-fulfillment_id-update_tracking.json.
      operations:
      - method: POST
        name: deprecatedunstablecreatefulfillmentsparamfulfillmentidupdatetracking
        description: Shopify Updates The Tracking Information For A Fulfillment
        call: shopify-tracking.deprecatedunstablecreatefulfillmentsparamfulfillmentidupdatetracking
        with:
          fulfillment_id: rest.fulfillment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fetch-tracking-numbers
      name: fetch-tracking-numbers
      description: REST surface for fetch_tracking_numbers.
      operations:
      - method: GET
        name: deprecatedunknownversiongetfetchtrackingnumbers
        description: Shopify Get Tracking Numbers For Orders
        call: shopify-tracking.deprecatedunknownversiongetfetchtrackingnumbers
        with:
          order_names: rest.order_names
          shop: rest.shop
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: shopify-tracking-mcp
    port: 9090
    transport: http
    description: MCP adapter for Shopify  API — Tracking. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: shopify-updates-tracking-information-fulfillment
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.deprecated202001createfulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-tracking-information-fulfillment-2
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.deprecated202004createfulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-tracking-information-fulfillment-3
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.deprecated202007createfulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-tracking-information-fulfillment-4
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.createfulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-tracking-information-fulfillment-5
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.deprecated202101createfulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-tracking-information-fulfillment-6
      description: Shopify Updates The Tracking Information For A Fulfillment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-tracking.deprecatedunstablecreatefulfillmentsparamfulfillmentidupdatetracking
      with:
        fulfillment_id: tools.fulfillment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-get-tracking-numbers-orders
      description: Shopify Get Tracking Numbers For Orders
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-tracking.deprecatedunknownversiongetfetchtrackingnumbers
      with:
        order_names: tools.order_names
        shop: tools.shop
      outputParameters:
      - type: object
        mapping: $.