Offers/Requests Examples

Proposals to sell and give away

A simple proposal with reciprocity expected, then another one to give the item away.

# Example: Simple proposals based on one intent

'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - alice: https://alice.example/
    map: https://mapping.service/

'@graph':

  # One offer with expected reciprocity

  - '@id': alice:8791913c-0152-4c32-bb3f-f25d61df736c
    '@type': Proposal
    purpose: offer
    name: Used bike
    hasBeginning: 2019-03-01T00:00:00-5:00
    hasEnd: 2019-03-31T00:00:00-5:00
    eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
    publishes:

    - '@id': alice:02b39a30-3e04-4305-9656-7f261aa63c84
      '@type': Intent
      name: Old adult Schwinn one speed bike
      note: Pedals fine, not good for hills, has basket, brakes are a bit dodgy
      action: transfer
      provider: https://alice.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q11442 # bicycle

    reciprocal:

    - '@id': alice:e72f7d1d-4f0a-4518-a44c-96658cafda95
      '@type': Intent
      name: Payment
      action: transfer
      receiver: https://alice.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q4917 # US Dollar
      resourceQuantity:
        hasUnit: one
        hasNumericalValue: 15

  # Alice did not get any responses to her proposal above, so decided to offer the bike for free

  - '@id': alice:8e5fe80d-a769-4bd5-89e5-2136d33eab9f
    '@type': Proposal
    purpose: offer
    name: Free used bike
    hasBeginning: 2019-04-01T00:00:00-5:00
    hasEnd: 2019-05-01T00:00:00-5:00
    eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
    publishes:

    - '@id': alice:02b39a30-3e04-4305-9656-7f261aa63c84 # the intent (this is the same intent alice originally published)

Proposal in timebank

A simple proposal for a timebank. The reciprocity is assumed based on the timebank policies.

# Example: Simple proposal in a timebank

'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - bob: https://bob.example/
    timebank: https://timebank.example/

'@graph':

  # Timebank request, reciprocity defined in the timebank agreement (hour credits)

  - '@id': bob:23799c14-c368-4653-a584-83bf9ae8b82a
    '@type': Proposal
    purpose: request
    name: Seeking plumbing help
    hasBeginning: 2019-04-01T00:00:00-5:00
    hasEnd: 2019-04-05T00:00:00-5:00
    inScopeOf: https://timebank.example/
    publishes:

    - '@id': bob:e18c808c-929a-450d-9d0d-3b3f531bc126
      '@type': Intent
      name: Plumbing help please
      note: Need someone with plumbing skills to fix leaky faucet and plugged drain asap
      action: work
      receiver: https://bob.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q252924 # plumber

Proposal for barter

A simple proposal for barter.

# Example: Simple proposal for barter
'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - carol: https://carol.example/
    map: https://mapping.service/

'@graph':

  - '@id': carol:6405b8ad-0ac2-4d58-abdb-0808903c78ad
    '@type': Proposal
    purpose: request
    name: Cider press for cider
    hasBeginning: 2018-10-01T00:00:00-5:00
    hasEnd: 2018-10-15T00:00:00-5:00
    eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
    publishes:

    - '@id': carol:e02e3f6b-420a-4ba8-89b0-909d7363ce07
      '@type': Intent
      name: Cider press
      note: I can pick up or come to your place, will clean up.
      action: use
      receiver: https://carol.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q1111 # cider press (fictional)
      effortQuantity:
        hasUnit: hour
        hasNumericalValue: 6

    reciprocal:

    - '@id': carol:b52a5815-fae9-43bf-be95-833b95dc0adb
      '@type': Intent
      name: Cider
      note: Fresh cider from the pressing
      action: transfer
      provider: https://carol.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q5977438 # apple cider
      resourceQuantity:
        hasUnit: gallon-US
        hasNumericalValue: 3

Proposal for work commitment

A simple proposal requesting help for work on a planned production process. The reciprocal intent (payment) is based on the actual hours that will be worked.

# Example: Simple proposal for commitment to an intent on a planned process

'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - fablab: https://fablab.example/
    map: https://mapping.service/

'@graph':

  # Plan a process, publish request for worker with certain skills to collaborate

  - '@id': fablab:ad56a7ed-be3c-4937-a3fb-0f156bcd2c47
    '@type': Process
    name: Develop soil moisture sensor
    inScopeOf: https://fablab.example/
    hasInput:

    - '@id': fablab:60f4204e-b8d2-4026-8577-102c3f82c0af
      '@type': Intent
      inputOf: fablab:ad56a7ed-be3c-4937-a3fb-0f156bcd2c47
      name: Help with R&D for the sensor
      note: Will need to be at the lab all day both days. It possibly could extend to a third day.
      action: work
      receiver: https://fablab.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q2474620 # electrochemical engineering
      effortQuantity:
        hasUnit: hour
        hasNumericalValue: 1
      minimumQuantity:
        hasUnit: hour
        hasNumericalValue: 16
      hasBeginning: 2019-04-12T08:00:00-5:00
      hasEnd: 2019-04-13T17:00:00-5:00

  # Proposal to find worker

  - '@id': fablab:33e8933b-ff73-4a01-964a-ca7a98893083
    '@type': Proposal
    name: Electrochemical engineering skills
    hasBeginning: 2019-04-01T08:00:00-5:00
    hasEnd: 2019-04-11T17:00:00-5:00
    eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
    unitBased: true
    publishes:

    - '@id': fablab:60f4204e-b8d2-4026-8577-102c3f82c0af # the Intent that was planned

    reciprocal:

    - '@id': fablab:583e83d9-a46d-44ff-bd71-88513a1d83c0
      '@type': Intent
      name: Payment
      note: Payment when the unit is manufactured and sold
      action: transfer
      provider: https://fablab.example/
      resourceConformsTo: http://www.wikidata.org/entity/Q4917 # US Dollar
      resourceQuantity:
        hasUnit: one
        hasNumericalValue: 30

Proposals for price list

A simple set of proposals that make up a price list.

# Example: Simple price list

'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - farm: https://farm.example/
    map: https://mapping.service/

'@graph':

  # Price list
  - '@id': farm:da7bfa38-a1b2-4f6f-a896-b9bf1ec88dr9
    '@type': ProposalList
    name: Price List for Week of March 1
    lists:

    - '@id': farm:da7bfa38-a1b2-4f6f-a896-b9bf1ec8807a
      '@type': Proposal
      hasBeginning: 2019-03-01T00:00:00-5:00
      hasEnd: 2019-03-31T00:00:00-5:00
      eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
      unitBased: true # often currently called 'unit pricing'
      publishes:

      - '@id': farm:c7897c39-7f05-4a5d-a487-80e130a24345
        '@type': Intent
        name: Carrots case 25#
        action: transfer
        provider: https://farm.example/
        resourceClassifiedAs: http://www.wikidata.org/entity/Q81 # carrot
        resourceSpecifiedAs: farm:2402b57c-1c45-423a-acb2-f50961c97d65 # 25 pound case organic carrots seconds
        resourceQuantity:
          hasUnit: one
          hasNumericalValue: 1

      reciprocal:

      - '@id': farm:0f563083-7f05-4a5d-a487-80e130a24345
        '@type': Intent
        name: Payment
        action: transfer
        receiver: https://farm.example/
        resourceConformsTo: http://www.wikidata.org/entity/Q4917 # US Dollar
        resourceQuantity:
          hasUnit: one
          hasNumericalValue: 18

    - '@id': farm:f47064eb-7120-4b31-b882-770165901fe6
      '@type': Proposal
      hasBeginning: 2019-03-01T00:00:00-5:00
      hasEnd: 2019-03-31T00:00:00-5:00
      eligibleLocation: map:566a2c01-96f8-4b3c-adcf-f197eced3092 # Madison, WI
      unitBased: true
      publishes:

      - '@id': farm:54b814ee-62dc-40c1-bb96-f8582aa4f771
        '@type': Intent
        name: Beets case 25#
        action: transfer
        provider: https://farm.example/
        resourceClassifiedAs: http://www.wikidata.org/entity/Q165437 # beet root
        resourceConformsTo: farm:8baa8ff7-9c1e-4586-ae7b-79d620a3cac9 # 25 pound case organic beets
        resourceQuantity:
          hasUnit: one
          hasNumericalValue: 1

      reciprocal:

      - '@id': farm:21f361a6-2375-46bb-b192-c21b5ba833bf
        '@type': Intent
        name: Payment
        action: transfer
        receiver: https://farm.example/
        resourceConformsTo: https://www.wikidata.org/wiki/Q4917 # US Dollar
        resourceQuantity:
          hasUnit: one
          hasNumericalValue: 32

Fulfillment and satisfaction

Commitments satisfying intents, and economic events fulfilling commitments. (Note that economic events can also satisfy intents if there is no commitment, although it is not shown in this example.)

# Example: Intent - satisfied by - Commitment - fulfilled by - EconomicEvent

'@context':
  - '@vocab': http://w3id.org/valueflows/ont/vf#
  - bob: https://bob.example/
    mfg: https://manufacturer.example/

'@graph':

  # A manufacturer makes a plan that includes an intent for some work which
  # they want someone in their network to commit to doing on Oct. 14 - 15

  - '@id': mfg:e1721a61-cd47-4556-84b9-8b1b81da15bf
    '@type': Intent
    action: work
    receiver: https://manufacturing.example/
    resourceConformsTo: http://www.wikidata.org/entity//Q192047 # machining
    effortQuantity:
      hasUnit: hour
      hasNumericalValue: 8
    hasBeginning: 2018-10-14T8:00:00-0:00
    hasEnd: 2018-10-15T18:00:00-0:00

  # Bob commits to doing the work on Oct. 14

  - '@id': mfg:02b39a30-3e04-4305-9656-7f261aa63c84
    '@type': Commitment
    action: work
    provider: https://bob.example/
    receiver: https://manufacturing.example/
    resourceConformsTo: http://www.wikidata.org/entity/Q192047 # machining
    effortQuantity:
      hasUnit: hour
      hasNumericalValue: 8
    hasBeginning: 2018-10-14T8:00:00-0:00
    hasEnd: 2018-10-14T17:00:00-0:00
    satisfies: mfg:e1721a61-cd47-4556-84b9-8b1b81da15bf # the intent

  # Bob does the work in two 4-hour shifts on Oct. 14

  - '@id': mfg:d4d2fd71-34f2-41c3-b1c5-19ad5ed2da59
    '@type': EconomicEvent
    action: work
    provider: https://bob.example/
    receiver: https://manufacturing.example/
    resourceConforms: http://www.wikidata.org/entity/Q192047 # machining
    effortQuantity:
      hasUnit: hour
      hasNumericalValue: 4
    hasBeginning: 2018-10-14T8:00:00-0:00
    hasEnd: 2018-10-14T12:00:00-0:00
    fulfills: mfg:02b39a30-3e04-4305-9656-7f261aa63c84 # the commitment

  - '@id': mfg:c7897c39-7f05-4a5d-a487-80e130a2414b
    '@type': EconomicEvent
    action: work
    provider: https://bob.example/
    receiver: https://manufacturing.example/
    resourceConformsTo: http://www.wikidata.org/entity/Q192047 # machining
    effortQuantity:
      hasUnit: hour
      hasNumericalValue: 4
    hasBeginning: 2018-10-14T13:00:00-0:00
    hasEnd: 2018-10-14T17:00:00-0:00
    fulfills: mfg:02b39a30-3e04-4305-9656-7f261aa63c84 # the commitment