Thermo Fisher SampleManager LIMS REST API — Entities

naftiko: 1.0.0-alpha2
info:
  label: Thermo Fisher SampleManager LIMS REST API — Entities
  description: 'Thermo Fisher SampleManager LIMS REST API — Entities. 2 operations. Lead operation: Browse Entity. Self-contained
    Naftiko capability covering one Thermo Fisher Scientific business surface.'
  tags:
  - Thermo Fisher Scientific
  - Entities
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    THERMO_FISHER_SCIENTIFIC_API_KEY: THERMO_FISHER_SCIENTIFIC_API_KEY
capability:
  consumes:
  - type: http
    namespace: thermo-fisher-samplemanager-entities
    baseUri: https://{server}:{port}/smpwcfrestvgsm
    description: Thermo Fisher SampleManager LIMS REST API — Entities business capability. Self-contained, no shared references.
    resources:
    - name: mobile-browses-entity
      path: /mobile/browses/{entity}
      operations:
      - name: browseentity
        method: GET
        description: Browse Entity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entity
          in: path
          type: string
          description: The SampleManager entity name (e.g., SAMPLE, TEST, RESULT, CUSTOMER, BATCH_HEADER, ANALYSIS).
          required: true
        - name: criteria
          in: query
          type: string
          description: Filter criteria using SampleManager query syntax (e.g., STATUS='A' AND SAMPLED_DATE > '2026-01-01').
        - name: orderby
          in: query
          type: string
          description: Field name to sort results by.
        - name: ascending
          in: query
          type: boolean
          description: Sort direction.
        - name: pagesize
          in: query
          type: integer
          description: Number of records per page.
        - name: page
          in: query
          type: integer
          description: Page number (1-based).
    - name: mobile-browses-entity-id
      path: /mobile/browses/{entity}/{id}
      operations:
      - name: getentitybyid
        method: GET
        description: Get Entity By ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entity
          in: path
          type: string
          description: The SampleManager entity name.
          required: true
        - name: id
          in: path
          type: string
          description: The record identity (primary key value).
          required: true
    authentication:
      type: bearer
      token: '{{env.THERMO_FISHER_SCIENTIFIC_API_KEY}}'
  exposes:
  - type: rest
    namespace: thermo-fisher-samplemanager-entities-rest
    port: 8080
    description: REST adapter for Thermo Fisher SampleManager LIMS REST API — Entities. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/mobile/browses/{entity}
      name: mobile-browses-entity
      description: REST surface for mobile-browses-entity.
      operations:
      - method: GET
        name: browseentity
        description: Browse Entity
        call: thermo-fisher-samplemanager-entities.browseentity
        with:
          entity: rest.entity
          criteria: rest.criteria
          orderby: rest.orderby
          ascending: rest.ascending
          pagesize: rest.pagesize
          page: rest.page
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/mobile/browses/{entity}/{id}
      name: mobile-browses-entity-id
      description: REST surface for mobile-browses-entity-id.
      operations:
      - method: GET
        name: getentitybyid
        description: Get Entity By ID
        call: thermo-fisher-samplemanager-entities.getentitybyid
        with:
          entity: rest.entity
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: thermo-fisher-samplemanager-entities-mcp
    port: 9090
    transport: http
    description: MCP adapter for Thermo Fisher SampleManager LIMS REST API — Entities. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: browse-entity
      description: Browse Entity
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: thermo-fisher-samplemanager-entities.browseentity
      with:
        entity: tools.entity
        criteria: tools.criteria
        orderby: tools.orderby
        ascending: tools.ascending
        pagesize: tools.pagesize
        page: tools.page
      outputParameters:
      - type: object
        mapping: $.
    - name: get-entity-id
      description: Get Entity By ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: thermo-fisher-samplemanager-entities.getentitybyid
      with:
        entity: tools.entity
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.