@tillhub/schemas 6.207.0 → 6.209.0

package/CHANGELOG.md

@@ -1,3 +1,18 @@
+# [6.209.0](https://github.com/tillhub/schemas/compare/v6.208.0...v6.209.0) (2023-04-18)
+
+
+### Features
+
+* **pricelists:** schema for new pricelists endpoint ([7254752](https://github.com/tillhub/schemas/commit/7254752))
+
+# [6.208.0](https://github.com/tillhub/schemas/compare/v6.207.0...v6.208.0) (2023-04-18)
+
+
+### Features
+
+* **configurations:** tips ([15da363](https://github.com/tillhub/schemas/commit/15da363))
+* **configurations:** tips ([6a85257](https://github.com/tillhub/schemas/commit/6a85257))
+
 # [6.207.0](https://github.com/tillhub/schemas/compare/v6.206.0...v6.207.0) (2023-04-18)
 
 

package/lib/common/date_time_constraints.js

@@ -0,0 +1,113 @@
+const { oneOf } = require('../helpers/payload-or-null')
+const { timezone } = require('../common/timezones')
+
+const dateRange = {
+  type: 'object',
+  additionalProperties: false,
+  required: [
+    'enabled'
+  ],
+  properties: {
+    enabled: {
+      type: 'boolean',
+      description: 'disables or activates the date range',
+      default: true
+    },
+    tz: oneOf({
+      deprecated: true,
+      type: 'string',
+      description: 'specifies the timezone for a data range',
+      enum: timezone.iana,
+      default: null
+    }),
+    start: oneOf({
+      type: 'object',
+      additionalProperties: false,
+      required: [
+        'enabled'
+      ],
+      properties: {
+        enabled: {
+          type: 'boolean',
+          description: 'disables or activates the start of a date range',
+          default: true
+        },
+        value: oneOf({
+          type: 'string',
+          format: 'date-time',
+          description: 'starting time of a date range',
+          example: '2021-09-23T08:19:02.059Z',
+          default: null // == distant past
+        })
+      }
+    }),
+    end: oneOf({
+      type: 'object',
+      additionalProperties: false,
+      required: [
+        'enabled'
+      ],
+      properties: {
+        enabled: {
+          type: 'boolean',
+          description: 'disables or activates the end of a date range',
+          default: true
+        },
+        value: oneOf({
+          type: 'string',
+          format: 'date-time',
+          description: 'starting time of a date range',
+          example: '2021-10-03T14:20:31.011Z',
+          default: null // == distant future
+        })
+      }
+    })
+  }
+}
+
+const dayTimeSlot = {
+  type: 'object',
+  additionalProperties: false,
+  required: [
+    'enabled'
+  ],
+  properties: {
+    enabled: {
+      type: 'boolean',
+      description: 'disables or activates a set slot',
+      default: true
+    },
+    start: oneOf({
+      type: 'string',
+      pattern: '([0-1][0-9]|2[0-3]):[0-5][0-9]',
+      example: '08:30',
+      description: 'daytime for the start of an active time slot',
+      default: '00:00'
+    }),
+    end: oneOf({
+      type: 'string',
+      pattern: '([0-1][0-9]|2[0-3]):[0-5][0-9]',
+      example: '09:15',
+      description: 'daytime for the end of an active time slot',
+      default: '23:59'
+    })
+  }
+}
+
+const dayTimeSlots = oneOf({
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    slots: oneOf({
+      description: 'A number of timeslots for a specific day. Not enforced - but overlaps are not encouraged',
+      type: 'array',
+      items: dayTimeSlot
+    })
+  }
+})
+
+module.exports = {
+  dateRange,
+  dayTimeSlot,
+  dayTimeSlots
+}

package/lib/common/time_constraints.js

@@ -1,110 +1,5 @@
 const { oneOf } = require('../helpers/payload-or-null')
-const { timezone } = require('../common/timezones')
-
-const dateRange = {
-  type: 'object',
-  additionalProperties: false,
-  required: [
-    'enabled'
-  ],
-  properties: {
-    enabled: {
-      type: 'boolean',
-      description: 'disables or activates the date range',
-      default: true
-    },
-    tz: oneOf({
-      deprecated: true,
-      type: 'string',
-      description: 'specifies the timezone for a data range',
-      enum: timezone.iana,
-      default: null
-    }),
-    start: oneOf({
-      type: 'object',
-      additionalProperties: false,
-      required: [
-        'enabled'
-      ],
-      properties: {
-        enabled: {
-          type: 'boolean',
-          description: 'disables or activates the start of a date range',
-          default: true
-        },
-        value: oneOf({
-          type: 'string',
-          format: 'date-time',
-          description: 'starting time of a date range',
-          example: '2021-09-23T08:19:02.059Z',
-          default: null // == distant past
-        })
-      }
-    }),
-    end: oneOf({
-      type: 'object',
-      additionalProperties: false,
-      required: [
-        'enabled'
-      ],
-      properties: {
-        enabled: {
-          type: 'boolean',
-          description: 'disables or activates the end of a date range',
-          default: true
-        },
-        value: oneOf({
-          type: 'string',
-          format: 'date-time',
-          description: 'starting time of a date range',
-          example: '2021-10-03T14:20:31.011Z',
-          default: null // == distant future
-        })
-      }
-    })
-  }
-}
-
-const dayTimeSlot = {
-  type: 'object',
-  additionalProperties: false,
-  required: [
-    'enabled'
-  ],
-  properties: {
-    enabled: {
-      type: 'boolean',
-      description: 'disables or activates a set slot',
-      default: true
-    },
-    start: oneOf({
-      type: 'string',
-      pattern: '([0-1][0-9]|2[0-3]):[0-5][0-9]',
-      example: '08:30',
-      description: 'daytime for the start of an active time slot',
-      default: '00:00'
-    }),
-    end: oneOf({
-      type: 'string',
-      pattern: '([0-1][0-9]|2[0-3]):[0-5][0-9]',
-      example: '09:15',
-      description: 'daytime for the end of an active time slot',
-      default: '23:59'
-    })
-  }
-}
-
-const dayTimeSlots = oneOf({
-  type: 'object',
-  additionalProperties: false,
-  properties: {
-    slots: oneOf({
-      description: 'A number of timeslots for a specific day. Not enforced - but overlaps are not encouraged',
-      type: 'array',
-      items: dayTimeSlot
-    })
-  }
-})
+const { dateRange, dayTimeSlots } = require('./date_time_constraints')
 
 module.exports = {
   type: 'object',

package/lib/v1/configurations/items/tips.js

@@ -11,11 +11,8 @@ const tipsCartItemTemplate = {
       example: '43847a66-97dc-4ac2-8e8a-c44920e1f22f'
     },
     product_name: {
-      default: null,
-      ...oneOf({
-        type: 'string',
-        description: 'Name of the product, e.g. Shop-owner\'s Tip.'
-      })
+      type: 'string',
+      description: 'Name of the product, e.g. Shop-owner\'s Tip.'
     },
     product_number: {
       default: null,
@@ -54,10 +51,13 @@ const tipsCartItemTemplate = {
       example: 'a3847a66-97dc-4ac2-8e8a-c44920e1f22f'
     },
     tax: {
-      type: 'string',
-      format: 'uuid',
-      description: 'The Tillhub tax resource reference ID.',
-      example: '33847a66-97dc-4ac2-8e8a-c44920e1f22f'
+      default: null,
+      ...oneOf({
+        type: 'string',
+        format: 'uuid',
+        description: 'The Tillhub tax resource reference ID. If NULL, the source items are used to define tax rates',
+        example: '33847a66-97dc-4ac2-8e8a-c44920e1f22f'
+      })
     }
   }
 }

package/lib/v1/products/index.js

@@ -215,3 +215,5 @@ module.exports.bulk = {
     }
   }
 }
+
+module.exports.pricelist = require('./pricelist/index')

package/lib/v1/products/pricelist/index.js

@@ -0,0 +1,12 @@
+const commonResponse = require('../../../common/response')
+module.exports = {
+  get: {
+    all: {
+      response: {
+        $id: 'https://schemas.tillhub.com/v1/products.pricelist.get-all.response.schema.json',
+        $schema: 'http://json-schema.org/draft-07/schema#',
+        ...commonResponse({ resultItems: require('./response') }, { hasCursor: true })
+      }
+    }
+  }
+}

package/lib/v1/products/pricelist/response.js

@@ -0,0 +1,103 @@
+const { oneOf } = require('../../../helpers/payload-or-null')
+const { dateRange, dayTimeSlots } = require('../../../common/date_time_constraints')
+
+module.exports = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    product: {
+      description: 'The reference to the product',
+      type: 'string',
+      format: 'uuid'
+    },
+    type: {
+      description: 'Type of the product prices',
+      type: 'string',
+      enum: [
+        'scaled',
+        'branch',
+        'time-based'
+      ],
+      example: 'scaled'
+    },
+    created_at: {
+      type: 'string',
+      format: 'date-time',
+      example: '2018-11-04T23:18:43.075Z'
+    },
+    updated_at: {
+      type: 'string',
+      format: 'date-time',
+      example: '2018-11-04T23:18:43.075Z'
+    },
+    deleted: {
+      type: 'boolean',
+      default: false
+    },
+    net: {
+      ...oneOf({
+        description: 'The net sales price is the price without sales tax.',
+        example: '27633.02',
+        type: 'number',
+        minimum: 0,
+        maximum: 1000000,
+        multipleOf: 0.01
+      })
+    },
+    gross: {
+      ...oneOf({
+        description: 'The gross sales price is the price that the customer pays, including sales tax.',
+        example: '27633.02',
+        type: 'number',
+        minimum: 0,
+        maximum: 1000000,
+        multipleOf: 0.01
+      })
+    },
+    currency: {
+      ...oneOf({
+        type: 'string',
+        description: 'The three letter [ISO currency](https://en.wikipedia.org/wiki/ISO_4217) of this item.',
+        example: 'EUR',
+        minLength: 3,
+        maxLength: 3
+      })
+    },
+    price_book: oneOf({
+      description: 'The reference to the price book',
+      type: 'string',
+      format: 'uuid'
+    }),
+    quantity: oneOf({
+      description: 'The price is applied if quantity of items in cart is bigger or equal to this number. If 0, then it represents default pricing.',
+      type: 'number',
+      minimum: 0,
+      example: 0
+    }),
+    date_range: oneOf({
+      description: 'a single range with optional start and end date',
+      dateRange
+    }),
+    day_of_week: oneOf({
+      type: 'object',
+      description: 'specifies daytime slots based on weekdays',
+      additionalProperties: false,
+      required: [
+        'enabled'
+      ],
+      properties: {
+        enabled: {
+          type: 'boolean',
+          default: true
+        },
+        monday: dayTimeSlots,
+        tuesday: dayTimeSlots,
+        wednesday: dayTimeSlots,
+        thursday: dayTimeSlots,
+        friday: dayTimeSlots,
+        saturday: dayTimeSlots,
+        sunday: dayTimeSlots
+      }
+    })
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tillhub/schemas",
-  "version": "6.207.0",
+  "version": "6.209.0",
   "private": false,
   "description": "All Tillhub API OpenAPI 3 compatible JSON Schemas.",
   "main": "./lib/index.js",