NSWBuy Catalogue Style Guide - ProcurePoint

Transcription

NSWBuy Catalogue Style Guide - ProcurePoint
NSWBuy Catalogue Style Guide
A supplier’s guide to the preparation and submission of
information into the NSWBuy Suppler Data Portal
Version 1.12.1
27 February 2013
NSW Procurement
NSW Department of Finance & Services
NSW Procurement Client Support Centre
Phone: 1800 679 289
Email: [email protected]
NSWBuy Catalogue Style Guide
Table of Contents
1. INTRODUCTION
3
1.1.
PURPOSE
3
1.2.
INTENDED AUDIENCE
3
1.3.
TRAINING AND ASSISTANCE
3
2. QUICK START SUMMARY
4
3. OVERVIEW
6
3.1.
CONTEXT
6
3.2.
PROCESS
6
3.3.
GENERAL DATA REQUIREMENTS - MANDATORY FIELDS
7
3.4.
GENERAL DATA REQUIREMENTS - NON-MANDATORY FIELDS
7
3.5.
DATA CHECKING AND VALIDATION
7
3.6.
SUPPLIER RESPONSIBILITY FOR DATA
8
3.7.
COMMERCIALLY SENSITIVE INFORMATION
8
3.8.
TIMELINES
8
3.9.
CLARIFICATIONS AND / OR FURTHER ENQUIRIES
9
4. UPDATING A CATALOGUE
10
4.1.
PRICE UPDATES
10
4.2.
ADD A NEW PRODUCT
10
4.3.
REMOVAL OF A PRODUCT
10
5. PSX TOOLSET – CHECK DATA
11
5.1.
PSX TOOLSET VALIDATION
11
5.2.
REPORTS TAB
11
5.2.1. CELL FORMATTING
12
5.2.2. ATTRIBUTE VALUE
12
5.3.
12
REVALIDATION OF THE CATALOGUE DATA
6. FREQUENTLY ASKED QUESTIONS
13
7. APPENDIX A – PSX TOOLSET DATA
14
A division of the Department of Finance & Services
i
NSWBuy Catalogue Style Guide
7.1.
PSX TOOLSET BMECAT HEADER DATA
15
7.2.
PSX TOOLSET ITEM DATA
15
7.3.
ATTRIBUTE FORMATTING RULES
27
8. APPENDIX B – ATTRIBUTE EXAMPLES
29
A division of the Department of Finance & Services
ii
NSWBuy Catalogue Style Guide
1. Introduction
1.1. Purpose
The purpose of this document is to provide guidance to suppliers to assist in the
presentation of high quality information about goods and services to make it easy for NSW
Government staff, and in particular purchasers, to browse, find and view the product details
and subsequently purchase the desired items. The key tools to maintain data in the
NSWBuy eCatalogues are the PSX Toolset and the NSWBuy Supplier Data Portal. This
guide explains how to optimise the use of each of these tools, noting that training guides
are also available for guidance on basic processes.
1.2. Intended Audience
This document is intended for suppliers to NSW Government who wish to update or create
a catalogue hosted on NSWBuy, it is particularly well suited to supplier organisational staff
responsible for:







Tender bids
Business development
Account/Brand/Marketing/Sales
Product Management
Inventory and warehouse data
Online and offline catalogue production
Anyone asked to fill in a NSWBuy PSX Toolset
1.3. Training and Assistance
This document has been produced by NSW Procurement (NSWP) which is a division of the
Department of Finance and Services.
To request training for the NSWBuy Supplier Data Portal, including the PSX Toolset, or for
any other assistance with NSWBuy eCatalogues, please contact the NSWP Client Support
Centre.
Phone: 1800 679 289
Email: [email protected]
NSW Procurement - A division of the Department of Finance & Services
3
NSWBuy Catalogue Style Guide
2. Quick Start Summary

The NSWBuy PSX Toolset collects catalogue information for the display in the
NSWBuy eCatalogues (https://catalogues.buy.nsw.gov.au/), the online purchasing
platform used by NSW Government buyers to find goods and services

The PSX Toolset is a spreadsheet with a built-in data checking process that ensures
the information is provided in the correct format for uploading to NSWBuy
eCatalogues.

If you are being invited to supply to NSW Government, then you should seek to have
the goods/services that you offer listed on the NSWBuy eCatalogues platform. NSW
Government spends approximately $13 billion annually on goods and services, so this
is a significant sales channel for any market or category.

The NSWBuy Supplier Data Portal system is the online system into which the
completed NSWBuy PSX Toolset is uploaded. The NSWBuy Supplier Data Portal will
alert suppliers via email when updates are expected; suppliers are then able to access
the NSWBuy Supplier Data Portal to retrieve their latest version of the PSX Toolset.

The PSX Toolset supports the loading of descriptive product information into the
NSWBuy catalogue solution. A number of fields are mandatory, these must be filled in
– the rest of the fields in each row are offered to provide:
o
An enhanced buyer experience by making it easy to find items (e.g. by adding
keywords that buyers might use to search for products or services).
o
Richer product information for buyers (e.g. a detailed description of
products/services, additional attributes of the item such as size, colour, etc.).
o
A clear understanding of pricing and methods of delivery and storage for the
goods/services (Note: these will have to be in accordance with any agreement
with the NSW Government).

Inside the PSX Toolset there is supporting information, including instructions for using
the PSX Toolset and pop-up help boxes that provide more information about
populating the various columns, rows and cells. For further information refer to this
document the NSWBuy Catalogue Style Guide or contact the NSWP Client Support
Centre.

Once data entry into the PSX Toolset is completed, an automated data checking
process can be initiated to verify items such as the completeness of mandatory fields.

On completion of the data checking process, the data should be ready to be converted
into a special format file (known as BMEcat) and then compressed into a zipped
BMEcat file which is ready for uploading into the NSWBuy Supplier Data Portal.

The next step is to log into the NSWBuy Supplier Data Portal at
https://supplierdata.buy.nsw.gov.au/ and upload the zipped BMEcat file along with any
media files, such as your image files (which must be contained within a zipped file).
NSW Procurement - A division of the Department of Finance & Services
4
NSWBuy Catalogue Style Guide
The following diagram is a simple representation of the process showing the PSX data
flowing from NSW Government suppliers into NSWBuy and then on to NSW
Government buyers, who may then select and purchase items:
NSW Procurement - A division of the Department of Finance & Services
5
NSWBuy Catalogue Style Guide
3. Overview
3.1. Context
NSWBuy is the NSW Government’s next generation electronic procurement platform.
This document addresses on two key components of the NSWBuy platform, they are:
NSWBuy eCatalogues – an online catalogue for NSW Government agencies and
other eligible jurisdictions and customers to seek out and purchase goods and
services
NSWBuy Supplier Data Portal – an online facility for businesses engaged to
supply to the NSW Government to introduce their catalogue data for review and
approval prior to being loaded onto NSWBuy eCatalogues.
3.2. Process
Existing suppliers whose products/services are currently available on NSWBuy
eCatalogues will receive a full copy of their existing catalogue whereas new suppliers
whose goods/services are not yet available on NSWBuy eCatalogues will need to populate
the PSX Toolset with their product data.
The steps for this process are as follows:
1. An email from NSWP will notify suppliers that an update to the catalogue is
expected.
2. Supplier logs on to the NSWBuy Supplier Data Portal and downloads the PSX
Toolset with current catalogue data.
3. Modify the PSX Toolset as required. Use standard Microsoft Excel functionality to
assist this process (e.g copy and paste, bulk find and replace for standard
information that changes in all fields, spell check, etc.)
4. Run the automated data checks within the PSX Toolset.
5. Generate the BMEcat file from the PSX Toolset.
6. Compress the BMEcat file into a .zip format.
7. Access the NSWBuy Supplier Data Portal and upload the zipped BMEcat file and
any media or image zip files.
8. Check the validation report and conduct any further supplier review.
9. When all required updates have been made, release the catalogue to catalogue
reviewers.
NSW Procurement - A division of the Department of Finance & Services
6
NSWBuy Catalogue Style Guide
3.3. General Data Requirements - Mandatory Fields
As a minimum the following data must be provided for each product / service item
submitted. (i.e. these are mandatory fields):
1.
2.
3.
4.
5.
6.
7.
8.
9.
Product ID
Supplier’s Short Description
Contract Identifier
Contract Name
Price Amount
Order Unit
Image Name
Image Type
GST_Flag
Regarding images, it is known from past experience that supplier organisations do not
always have suitable images on hand for all the products in their catalogue. Accordingly,
where suitable images are not available it is requested that a company logo is provided
instead. Please note that regular on-line buyers expect to see images of the products they
are considering for purchase and where that is not available they will be less likely to make
the purchase – especially when an equivalent product is available with a relevant product
image. For services (as distinct from tangible goods) this is less of an issue, therefore
service suppliers are asked to consider what ‘visual cues’ they might wish to provide to
potential buyers to enhance the selection and buying process.
3.4. General Data Requirements - Non-Mandatory Fields
The PSX Toolset also contains a number of non-mandatory fields. The non-mandatory data
fields can be used by suppliers to increase a product’s profile and/or assist buyers to refine
the catalogue search.
3.5. Data Checking and Validation
New or updated catalogue data submitted via the NSWBuy Supplier Data Portal will be
subject to a number of system validation checks and quality reviews prior to publishing in
NSWBuy eCatalogues.
The data checking and validation occurs at several points in the process:
1. The PSX Toolset has built in data checks for issues such as failure to provide data
in a mandatory field.
When the zipped BMEcat file is uploaded and transferred into the NSWBuy Supplier
Data Portal, an automatic validation process occurs to check for appropriate data
fields and to compare the new data against what is currently in the NSWBuy
catalogue. Any differences between the current catalogue and the uploaded zipped
BMEcat file are identified in the validation report.
When the zipped BMEcat file is received by NSWP further checks of the data are
undertaken to confirm consistency with contractual requirements as well as ensuring
NSW Procurement - A division of the Department of Finance & Services
7
NSWBuy Catalogue Style Guide
the data can be merged into the Master Catalogue and subsequently uploaded to
NSWBuy eCatalogues.
Should the updated data fail any of the checks and validation processes, the catalogue will
not progress any further until issues identified have been resolved. At the PSX Toolset
stage, and at the Supplier Review stage, the supplier can still make changes to the PSX
Toolset and re-import the zipped BMEcat file into the NSWBuy Supplier Data Portal.
3.6. Supplier Responsibility for Data
Please note that suppliers will be responsible for the quality of their catalogue data
submitted to NSWP via the NSWBuy Supplier Data Portal. It will be assumed by NSWP that
suppliers have completed any internal quality checks and/or obtained any necessary
management approvals to release details of products and their associated pricing.
3.7. Commercially Sensitive Information
The NSWBuy eCatalogues currently presents all of the material provided by suppliers,
including media files with the exception of the price field to anyone that visits
https://catalogues.buy.nsw.gov.au as a Guest user. Suppliers therefore need to ensure that
pricing is not displayed in fields other than the price field, e.g. attached media files or
description fields.
3.8. Timelines
It is generally expected that a supplier should not take more than two (2) weeks to complete
and submit a catalogue update for processing and publishing in NSWBuy eCatalogues.
If a supplier anticipates it might take longer to complete the catalogue update process, they
should contact their Category Manager and negotiate an appropriate time extension.
Should problems be experienced accessing the NSWBuy Supplier Data Portal or in
submitting a catalogue update, you should contact the NSWP Client Support Centre.
3.9. Recommended Operating System and Application
The PSX file is an excel spreadsheet with specialised validation formula and macros that
are run during the “Check Data” and “Generate BMEcat file" process. To edit a PSX file
and successfully run the "Check Data" and the "Generate BMEcat file" steps the
following operating system and applications are recommended;


3.10.
Microsoft Windows Operating Systems that support Microsoft Excel 2003 or
higher
Microsoft Excel 2003 and above
Naming the BMEcat file
The BMEcat file must not contain a / (forward slash). If your file name does contain a
forward slash this needs to be replaced; for example:


Company P/L.xml changed to Company Pty Ltd.xml
Compnay P/L.zip changed to Company Pty Ltd.zip
NSW Procurement - A division of the Department of Finance & Services
8
NSWBuy Catalogue Style Guide
3.11.
Compressing the BMEcat file
The BMEcat file must be compressed before loading into the Supplier Data Portal. The file
compression must be in .zip format. Files can be created in the .zip format in some
versions of Microsoft Windows using 'Compressed (zipped) Folders', ensure that the name
of the file created has a .zip extension. If you cannot see the "Compressed (zipped)
Folders" option refer to you IT support or you can use a standalone file compression
application.
3.12.
Clarifications and / or further enquiries
For further information regarding the PSX Toolset, data checks and validations, uploading
the zipped BMEcat file, and catalogue reviews, please contact the NSWP Client Support
Centre.
NSW Procurement - A division of the Department of Finance & Services
9
NSWBuy Catalogue Style Guide
4. Updating a Catalogue
Catalogue updates are completed by contacting the NSWP Client Support Centre and
requesting a catalogue be released for updating in the NSWBuy Supplier Data Portal.
It is vital that supplier catalogues contain accurate and up to date information, particularly
around the pricing and availability of products. Suppliers will also recognise the importance
of populating as many of the other 'attribute' fields for the respective contract.
Large catalogues may represent a significant work effort to populate all desired fields.
Accordingly, in such circumstances suppliers may elect to adopt a staged approach to
refreshing their catalogue i.e. submit two or three PSX Toolset updates before the
catalogue is considered to be full or complete for all product / service items. It is also
expected that suppliers will want to submit fresh images and other media attachments.
4.1. Price Updates
1. To update a price, open the PSX Toolset, locate the item that needs to have the
price change in the Item Data worksheet.
2. Insert the date your item/s price becomes effective in the column headed ‘Price Eff
from’. Format: dd/mm/yyyy.
The effective date should be current (i.e. the date the updated catalogue is loaded
to NSWBuy Supplier Data Portal). With the exception of items that will go on
special, then a future date should be provided. The system is unable to apply
retrospective back dates due to the adverse effect on purchase orders.
It is recommended that your nominated ‘price effective from date’ should be the
same as the date the zipped BMEcat file loaded into the NSWBuy Supplier Data
Portal. This will minimise any potential adverse impacts on accuracy and
understanding when buyers place orders..
3. Insert the new prices for the item(s) in the Price Amount (ex GST) column.
Format: e.g. 27.49
Note: - $ symbol is not required.
4.2. Add a New Product
To add a new product select the next empty row and enter ‘ADD’ in the column ‘Article
Action’. If there is a similar item already in the PSX Toolset you can copy across the values
for that item and then modify the response/s to suit the new item.
If the new item does not fit any of the existing items, populate the columns as needed, and
nominate the attributes/values that apply to that new item. Utilise the pre-existing ‘Attribute
Names’ as examples for similar items.
4.3. Removal of a product
To remove an item from your catalogue simply delete the row from your PSX Toolset and
the item will be flagged for deletion in the system or change the “ExpireDate” value to a
date when the product should lapse.
NSW Procurement - A division of the Department of Finance & Services
10
NSWBuy Catalogue Style Guide
5. PSX Toolset – Check Data
After entering your catalogue data in the ‘Item Data’ tab, it needs to be validated to ensure
the data has been entered correctly. Files with validation errors cannot be uploaded. Inputs
can be checked at any time during your product data entry, allowing you to check your work
in blocks, rather than waiting until the entire task is completed.
5.1. PSX Toolset Validation
Click on ‘Add-Ins’ menu of the workbook and select the ‘Check Data’ macro from the PSX
Toolset Menu Bar.
Click ‘OK’ to commence test. Click on OK button once again, and the test results are
displayed in the ‘Report’ tab.
5.2. Reports Tab
The reports tab displays any errors that have been identified by the PSX Toolset. These
errors need to be corrected.
Errors need to be addressed and can be actioned by clicking on the Cell Reference
hyperlink in Column A which directs you to the relevant cell in ‘Item Data’ tab for correction.
NSW Procurement - A division of the Department of Finance & Services
11
NSWBuy Catalogue Style Guide
Warnings can be safely ignored, however these will be monitored and may need to be
addressed in the longer term to ensure all required data sets have been provided and of an
appropriate standard.
5.2.1. Cell Formatting
Formatting issues e.g. “Value 402.10’ of ‘Price Amount’ is not a number” can be resolved by
reformatting the ‘Price Amount’ column via Format Cells  Number Decimal places:
Two decimal place pricing is customary. A maximum of 3 decimal places can be entered.
Click on the ‘OK’ button.
5.2.2. Attribute Value
Attribute value errors e.g. values that exceed the character limit. These descriptors need
amending to bring the field length equal to or below the character limit, including spacing
and commas.
5.3. Revalidation of the Catalogue Data
The amended PSX Toolset should be revalidated by re-running the ‘Check Data’ macro
until all errors have been resolved.
For further information regarding the validation of the PSX Toolset, please contact the
NSWP Client Support Centre.
NSW Procurement - A division of the Department of Finance & Services
12
NSWBuy Catalogue Style Guide
6. Frequently Asked Questions
NSWP has compiled a list of frequently asked questions (FAQs). The list is available on
the Internet at https://www.procurepoint.nsw.gov.au/support-and-self-help/training/supplier-dataportal-training-0
NSW Procurement - A division of the Department of Finance & Services
13
NSWBuy Catalogue Style Guide
7. Appendix A – PSX Toolset Data
NSWBuy eCatalogues displays products and services as individual items in the catalogue.
In other words, product and service information is displayed in NSWBuy eCatalogues on an
item name basis.
Notes:
1. PSX Toolset must be maintained on whole of catalogue basis i.e. it is not possible to
just submit updates for new items and/or remove items from existing catalogues as
all fresh PSX Toolset loads will overwrite the pre-existing catalogue data set and
any product items not found from the previous version will be flagged for deletion.
2. The PSX Toolset contains an Instruction tab which provides information about the
headings and data requirements and a Definition tab that provides details about the
data requirements for specific fields.
3. Each line item has specific attributes associated with it. The values of these
attributes are used in NSWBuy eCatalogues to help buyers find your products and
make comparisons between products. It is highly recommended that you fill in as
many of the attributes as possible to ensure that buyers have the maximum amount
of information about your products. If preferred, a staged approach can be adopted
to populating these non-mandatory fields.
4. In NSWBuy eCatalogues accessories are now maintained either as individual items,
bundled items, or in a separate Smartform that will be linked to the parent item as
an option which can be mandatory or non-mandatory. Smartforms allow buyers to
dynamically select and deselect aspects of a good or service that are optional, so in
effect they allow catalogue items to become configurable by the buyer. To obtain
more information about Smartforms, please contact the NSWP Client Support
Centre.
NSW Procurement - A division of the Department of Finance & Services
14
NSWBuy Catalogue Style Guide
7.1. PSX Toolset BMEcat Header Data
All PSX Toolset files issued to suppliers will include system generated text in the BMEcat
Heater Data worksheet. Some of the fields include:
SupplierName - This field is used by the system to identify the name of the supplier.
SupplierID - The ID number issued by the system to uniquely identify each supplier in
NSWBuy eCatalogues.
CatalogID - The catalogue ID is used by the system to differentiate each supplier’s
catalogue per contract.
CatalogName - The Catalogue Name identifies the supplier catalogue.
Row
There are two fields in the BMEcat Header Data worksheet that must be filled in and they
are:
Field Name
Description
13
Email Order Address
Enter the organisation’s email address where purchase orders
should be sent to.
Fax Order Address
Enter the organisation’s fax number where purchase orders
should be sent to, if the organisation does not have a fax
number enter the default value “email” * **
14
*If
you have both an email and fax for receiving orders but prefer to receive orders via email
then enter the default value “email” in the Fax Order Address field.
**If
you are an integrated supplier, the existing trading channel will be utilised.
7.2. PSX Toolset Item Data
The following section describes the use of all the columns in the PSX Toolset ‘Item Data’
worksheet. The Item Data worksheet lists all fields that can be completed for each item.
There are over 100 fields for each item. This section provides further details on the
information that can be entered for each of these fields.
Column
Field
Length
Wider explanatory notes are provided for some items where it was considered additional
information would be helpful based on our experience in working with suppliers to date.
A
3
Action
The value for this field is always ‘ADD’.
B
32
Product ID
Enter the product code that uniquely identifies the item.
Field Name
Description
NSW Procurement - A division of the Department of Finance & Services
15
C
D
E
Field
Length
Column
NSWBuy Catalogue Style Guide
250
64,000
50
Field Name
Description
Suppliers Short
description
Enter a short description of the item. The value of this field
should not be more than 250 characters, including spaces.
This field should only be a brief description of the item as
opposed to the ‘Suppliers Long Description’ where further
information can be provided to assist buyers make their
purchase decision. Marketing information is not permitted
in either the Short or Long description fields. Opportunity
exists to provide URL links or provide product/service
specific marketing information as a media attachment i.e.
pdf files.
Suppliers Long
Description
The long description is what buyers will see when they
view the product list in NSWBuy eCatalogues and buyer
searches will also be compared against this description.
This field must only include item descriptors. The inclusion
of marketing material is not permitted.
Contract Identifier
Enter the contract number this item relates to, if not prepopulated. If the item supplied is not on a Whole of
Government contract i.e. item supplied on a Government
Agency specific contract, please leave field blank and
correspondingly the ‘Contract used’ flag should be filled
with an ‘N’.
If unsure as to what contract number to enter, contact the
NSWP Client Support Centre to obtain details.
F
G
H
60
50
1
ContractSub Identifier
Enter the contract number sub group this item relates to, if
it has not pre-populated by NSWP e.g Lot 9
Contract Name
The name of the contract this item relates to. Usually prepopulated, if it has not been populated contact the NSWP
Client Support Centre to obtain details of what should be
entered.
Contract used
For all Whole of Government contracts insert the value ‘Y’.
For Government Agency specific contracts insert the value
‘N’. Should you be unsure of what to enter seek advice
from the NSWP Category Manager.
NSW Procurement - A division of the Department of Finance & Services
16
I
Field
Length
Column
NSWBuy Catalogue Style Guide
1
Field Name
Description
Info item
This field is used to indicate to buyers whether the product
item is purchasable or not i.e. a purchase order can be
raised via NSWBuy eCatalogues or other supported ERP
systems. However, many of the products published in
NSWBuy eCatalogues relate to the provision of services
and/or goods for which it is necessary to seek and approve
a quote from suppliers before a purchase order can be
raised. Where the latter situation applies the value 'I'
should be inserted in the PSX Toolset so that buyers are
aware of such arrangements.
As NSWBuy eCatalogues requires that the Price Amount
field be populated in the PSX Toolset, suppliers should
also enter a zero '0' value in the Price Amount field for all
items considered to be non-purchasable where a price is
not available for this Info Item.
If the item can be purchased through NSWBuy
eCatalogues without the need for a quote, suppliers should
leave the Info Item field blank.
The unit price of the item must not include GST. The price
amount can be any positive number to a maximum of 3
decimal places. Do not include dollar symbols in this field.
J
-
Price Amount
If the item is free of charge or can be described as
non-purchasable (as described in Info Item above)
enter 0 in this column.
If the item is price on application, enter a ‘0’ in this
field and the text ‘Price on Application’ should be
inserted under the column ‘AdditionalPriceDisplay’
(located in the column AE).
K
L
3
-
Order Unit
The unit of measure (UOM) that the item of supply is to be
ordered in. Enter a case-sensitive “Order Unit code” found
in the PSX Toolset ‘Definitions’ worksheet in column A.
Min Order Qty
Enter the lowest purchase order quantity accepted for this
item. Can be any positive number. Decimal places are
allowed. If blank the system defaults to 1.
NSW Procurement - A division of the Department of Finance & Services
17
Field
Length
Column
NSWBuy Catalogue Style Guide
M
N
2
Field Name
Description
Step Qty
Enter the next largest amount of the item that can be
purchased. For example, if the minimum order quantity of
an item is 10 and only multiples of 10 can be ordered then
the Step Qty would be 10. However, if the minimum order
quantity is 10 but any amount of the item over 10 can be
ordered then the Step Qty would be 1.
GST_Flag
Used to indicate if the item attracts GST. Select ‘10’ for
yes (attracts GST) or ‘0’ for no (does not attract GST). It is
essential that a selection of 0 or 10 is entered in the PSX
Toolset.
P
dd/mm/yyyy
O
dd/mm/yyyy
If the price of the item has a defined validity period (less
than the contract duration), specify the start date of the
price here.
Price Eff from
This would be the date from which the price of the item
becomes effective. Leave blank if this item will be
available for the duration of the contract.
When updating pricing, insert the new date your item/s
price becomes effective from. While the system does not
permit the application of retrospective back dates it can be
refreshed with the date of the data load or a future date,
where nominated.
If the price of the item has a defined validity period (less
than the contract duration), specify the end date of the
price here.
ExpireDate
This would be the date when the item price ceases to be
effective. Leave blank if this item will be available for the
duration of the contract.
NSW Procurement - A division of the Department of Finance & Services
18
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
This field is used to create volume price discounts. The
Price Lower Bound field sets the lowest order quantity
required for this price to apply.
The ‘Price Lower Bound’ column records the lower
boundary price line and is valid for the nominated order
quantity. The corresponding price is recorded in the ‘Price
Amount’ column. For multiple volumes add the same item
line directly below the original line and change the lower
bound / price amount, only positive numbers and decimal
places are allowed.
Q
Price Lower Bound
For each volume price-break you wish to offer, you will
need to use a separate row in the PSX Toolset. For
example to offer discounts for bulk purchases:
1-99 items is $10 per item,
100 – 199 items is $9 per item,
200 or more items is $8 per item.
You would need to have three rows in the PSX Toolset
(with the same ProductID):
1st row: Price Amount = $10, Price Lower Bound = 1
2nd row: Price Amount = $9, Price Lower Bound = 100
3rd row: Price Amount = $8, Price Lower Bound = 200
The ‘Price Lower Bound’ field can be any positive number,
decimal places are allowed. If blank, the default value of 1
is applied.
Insert the name of the basic item image. Enter the name of
the item image in the following convention: “Product Code”
followed by stop character and file extension type e.g.
“HQVRTMK.jpeg”. Will be shown as a thumbnail and in the
item details on NSWBuy eCatalogues.
R
40
Image Name
The use of clear and representative product images is
strongly recommended as it greatly enhances a product
profile to buyers. Where suitable product images are not
available we request company logos are provided and
replaced when product images become available.
The image files need to be collated into one zip file and
uploaded into the NSWBuy Supplier Data Portal. Note: all
images need to be clearly linked to the product or service
item to which they apply.
NSW Procurement - A division of the Department of Finance & Services
19
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
Select the file type of the media asset / image from the
dropdown list. Allowed values are:
• application/pdf
• image/jpeg
• image/gif
• text/html
• url
Note: following image and logo specification requirements
• Images will only be accepted in pdf (Portable
Document Format), jpeg (image), gif (image), html
and url formats. The maximum image size is 325 X
325 pixels.
S
30
Image Type
• Should it be considered necessary to add an
appropriate disclaimer text to the image, it is
recommended that before adding the 9-point Arial
Black text you reduce the image size. This will
enable the text to remain legible.
Some examples of acceptable wording of
disclaimer text are:
o
o
o
o
o
o
Item displayed with accessories
Image represents product style
Image represents product class
Items does not include accessories
Set up for illustration purposes only
Set up for illustration purposes, does not
include accessories
Select the region of your organisation’s primary
geographical location in this field.
T
50
Primary Supplier
Location
The NSW regions are detailed further on the ProcurePoint
website:
https://www.procurepoint.nsw.gov.au/nswbuy_regions
NSW Procurement - A division of the Department of Finance & Services
20
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
Enter NSW regions that you are contracted to service.
Where services are provided across multiple regions they
should be separated by a comma e.g. if your organisation
services the whole of NSW, the string would appear as
follows:
CU,NP,NS,IW,SE,SW,CC,HU,CW,OR,RI,FN,MN,NE,IL,S
H
U
50
Regions Serviced
Region
Internal Region code
Cumberland / Prospect
CU
Nepean
NP
Northern Sydney
NS
Inner West
IW
South East Sydney
SE
South West Sydney
SW
Central Coast
CC
Hunter
HU
Central West
CW
Orana / Far West
OR
Riverina / Murray
RI
Far North Coast
FN
Mid North Coast
MN
New England
NE
Illawarra
IL
Southern Highlands
SH
The NSW regions are detailed further on the ProcurePoint
website:
https://www.procurepoint.nsw.gov.au/nswbuy_regions
V
250
SupplierContactURL
Enter your organisation’s website address (only the URL
needs to be entered).
W
50
Manufacturer
Enter the name of a person, business or organisation that
manufactured the item.
NSW Procurement - A division of the Department of Finance & Services
21
Column
Field
Length
NSWBuy Catalogue Style Guide
X
50
Field Name
Description
Manufacturer ID
Enter the unique product code used by the manufacturer
to identify this item.
Y
60
Brand Identifier
Enter the Brand Identifier for the item. This field is usually
only used if the Brand name is different to either the
Supplier or manufacturer’s name.
Z
60
Model Identifier
If required, enter the Model identifier for the item.
A
A
Enter the ‘Measurement Unit’ of the ‘Measurement Data’
(in field AB).
60
Measurement Unit
Example: The Item is 200mm width x 100mm depth x
300mm height so you would enter in this field ‘millimetre’.
Please insert corresponding value/s to measurement unit
data above.
A
B
A
C
A
D
A
E
60
Measurement Data
Example: The Item is 200mm width x 100mm depth x
300mm height so you would enter in this field ‘200w x
100d x 300h’.
60
Package Unit
Enter Package Unit information for the item.
60
Package Qty
Enter Package Quantity information for the item.
AdditionalPriceDisplay
Enter a line of text to be displayed below the item price.
Optional field that allows suppliers to insert additional price
text i.e. price on application or call XX XXXX XXXX for
more details. Maximum of 50 characters. Note: This
information is not passed on to approvers or included in
the Purchase Order.
50
NSW Procurement - A division of the Department of Finance & Services
22
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
Enter the UNSPSC code for the item. Note UNSPSC
codes can be selected from the list in the ‘Definitions’ Tab.
UNSPSC stands for United Nations Standard Products
and Services Code. The code provides an open, global
multi-sector standard for efficient, accurate classification of
products and services. It is also supports the application of
taxonomy for more technical searches and also an
increasing need for spend analysis and invoice matching
in client ERP systems.
A
F
8
UNSPSC
The UNSPSC has a number of classification levels, down
to the narrowest level, called the Commodity level. Where
possible, products and services provided in the NSWBuy
eCatalogues should be classified to the Commodity level
per v14.0801 of the UNSPSC table file. If the item cannot
be classified down to the Commodity level, it should be
codified to the next most appropriate level. Details of the
table file can also be found in the PSX Toolset ‘Definitions’
worksheet
To understand the different classification levels, including
more information about the UNSPSC codes, refer to the
website: http://www.unspsc.org/
A
G
A
H
A
I
A
J
250
MSDS
Enter the file name of the Material Safety Data Sheet
(MSDS). Copies of the relevant PDFs should be zipped
and uploaded to the NSWBuy Supplier Data portal.
Enter a keyword / synonym that describes the item.
Keywords are referenced when a buyer searches the
NSWBuy eCatalogues.
50
50
50
Keyword 1
3 additional keyword fields are provided enabling suppliers
to include up to a total of 4 search terms to assist buyers
with their item search.
Keyword 2
Enter an additional keyword / synonym that describes the
item. Keywords are referenced when a buyer searches the
NSWBuy eCatalogues. There are 3 other keyword fields
provided.
Keyword 3
Enter an additional keyword / synonym that describes the
item. Keywords are referenced when a buyer searches the
NSWBuy eCatalogues. There are 3 other keyword fields
provided.
NSW Procurement - A division of the Department of Finance & Services
23
A
K
A
L
Field
Length
Column
NSWBuy Catalogue Style Guide
50
250
Field Name
Description
Keyword 4
Enter an additional keyword / synonym that describes the
item. Keywords are referenced when a buyer searches the
NSWBuy eCatalogues. There are 3 other keyword fields
provided.
Attachment Purpose 1
Select from the dropdown list, the purpose of the additional
media asset / image being supplied. Allowed values are:
• normal = picture will be shown directly
• detail = picture will be shown as a clickable link
• data_sheet = pdf / html pages
• others = attachment will be shown as a clickable
link
A further four attachment fields groups are provided at the
end of the PSX Toolset from column CQ to DF to load
additional attachments.
A
M
60
Attachment File 1
Enter the image file name or file names of additional media
asset / image being supplied.
A
N
250
Attachment
Description 1
The entry in this field will form the hyperlink to your image
or document in the item details page.
A
O
30
Attachment Type 1
Select the file type of the media asset / image. Allowed
values are:
• application/pdf
• image/jpeg
• image/gif
• text/html
• url
A
P
60
Environmentally
Positive Attributes
Select from the dropdown list, the 'Environmentally
Positive Attributes' value for this item.
A
Q
60
Green Power
Select the 'green power' value for this item from the
available options.
A
R
60
Energy Allstars
Select the 'energy star rating' value for this item from the
available options.
A
S
60
Energy Star Rating
Select the 'energy star rating' value for this item from the
available options.
A
T
60
Energy Star Rating
Cooling
Select the 'energy star rating cooling' value for this item
from the available options.
NSW Procurement - A division of the Department of Finance & Services
24
Column
Field
Length
NSWBuy Catalogue Style Guide
A
U
60
Energy Star Rating
Heating
Select the 'energy star rating heating' value for this item
from the available options.
A
V
60
Energy Efficient Light
Bulbs
Select the 'energy efficient light bulbs' value for this item
from the available options.
A
W
60
Recycled Content
(percentage)
Enter the 'recycled content (percentage)' value for this item
as a number between 5 and 100.
A
X
60
Water Efficiency Star
Rating (WELS)
Select the ‘Water Efficiency Star Rating (WELS) ' value for
this item from the available options.
Field Name
Description
A
Y
14
GTIN
Enter the Global Trade Item Number (GTIN) for the item
which is a unique 14 digit identification of products
worldwide within the EAN.UCC System. For more
information on GTINs go to http://www.gtin.info/.
A
Z
60
Service Item
Enter ’Y’ if item being supplied is a service. Otherwise
leave blank.
B
A
1000
Mandatory Reference
Product ID
The Product IDs listed here will be a mandatory reference
(accessories) to the corresponding parent item, meaning
that when a customer buys the parent item all items listed
here will have to be purchased as well.
If there are multiple mandatory referenced items, separate
the Product IDs with "|" (pipe symbol).
B
B
1000
Optional Reference
Product ID
The Product IDs listed here will be optional references
(accessories) to the corresponding parent item, meaning
that when a customer buys the parent item, they can
select optional items listed here to purchase.
If there are multiple optional referenced items, separate
the Product IDs with "|" (pipe symbol).
NSW Procurement - A division of the Department of Finance & Services
25
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
Item Attributes allow suppliers to add further classification
to their items which provide a greater level of detail about
the item to the buyer. To create an attribute, two fields
must be entered, the name field describing the attribute
and the corresponding value field with the attribute value
(see below).
The PSX Toolset provides for up to 20 additional data
fields via the attribute columns (BC to CP.
B
C
t
o
C
P
60
Attribute Name 1- 20
Each line item has specific attributes associated with it.
The values of these attributes are used in NSWBuy
eCatalogues to help buyers find your products and make
comparisons between products. It is highly recommended
that you fill in as many of the attributes as possible to
ensure that buyers have the maximum amount of
information about your products. If preferred, a staged
approach can be adopted.
Attribute Values must be entered in standard casing
beginning with an uppercase letter followed by lowercase
letters. See also section 7.3 Attributes Formatting Rules
and Appendix B for examples of Attributes.
B
D
t
o
C
P
C
Q
t
o
D
F
60
20
Attribute Value 1- 20
Attachment Purpose n
(n = 2 to 5)
Insert your value of the item attribute for the Attribute
Name entered in the PSX Toolset. If the Attribute Value
cell is left blank, attribute details will not be loaded into
NSWBuy. See also section 7.3 Attributes Formatting Rules
and Appendix B for examples of Attributes.
Select the purpose of the additional media asset / image
being supplied. Allowed values are:
• normal = picture will be shown directly
• detail = picture will be shown as a clickable link
• data_sheet = pdf / html pages
• others = attachment will be shown as a clickable
link
A further four attachment fields groups are provided at the
end of the PSX Toolset from column CQ to DF should it be
desired to load additional attachments.
NSW Procurement - A division of the Department of Finance & Services
26
C
Q
t
o
D
F
C
Q
t
o
D
F
C
Q
t
o
D
F
Field
Length
Column
NSWBuy Catalogue Style Guide
Field Name
Description
250
Attachment File n
(n = 2 to 5)
Enter the image file name or file names of additional media
asset / image being supplied.
250
Attachment
Description n
(n = 2 to 5)
Enter the description of additional media asset / image
being supplied. Additional media asset/image - purpose of
attached file.
Attachment Type n
(n = 2 to 5)
Select the file type of the media asset / image. Allowed
values are:
• application/pdf
• image/jpeg
• image/gif
• text/html
• url
250
7.3. Attribute Formatting Rules
The following rules apply when entering data in the PSX Toolset and populating the fields
and attributes for each item:





The maximum length of the attribute value is 60 characters, including spaces.
Attribute values are to be written in standard casing, i.e. they begin with an upper
case letter then lower case follows. The exception is where ‘Measurement Units’
are recorded, which are all in lower case.
Where an attribute value is hyphenated, the first letter after the hyphen is to be in
lower case.
Where an attribute value contains a ‘slash‘ (/ or \), the first letter after the ‘slash‘ is to
be in upper case.
The following characters MUST NOT be entered in any of the attribute cells:
o
o
o
o
o
o
o
o
o
Asterisk
Question mark
Left parenthesis
Right parenthesis
Single quote
Double quote
Copyright symbol
Registered symbol
Trade Mark symbol
*
?
(
)
‘
“
©
®
™
NSW Procurement - A division of the Department of Finance & Services
27
NSWBuy Catalogue Style Guide
o Underscore












_
There is to be a space after a comma.
Where an attribute value has multiple weights and/or measures, a space is to be
inserted between the two with the second being in standard casing. For example,
100mm Diameter
Weights and measures are to be written in full. For example, centimetre for cm etc.
When you have values for multiple dimensions for the ‘Dimension’ attribute (such as
Length x Width x Height), it is to be shown in upper case. For example 1000L x
700W x 800H
Use a lower case ‘x’ to express ‘by’ in dimensions. Leave a space on each side of
the ‘x’. Imperial dimensions, where possible, should be converted to metric,
providing all dimensions can be successfully converted.
Imperial measurements should only be used when unavoidable. Where deemed
necessary please use full spelling i.e. inch and not the “ [Attribute Field Metadata
double quote character] abbreviation. Similarly, the ‘ [single quote character]
abbreviation should not be used for feet.
If all of the attribute values to be presented are whole numbers then there is no
need for a decimal point followed by a zero. If there is a mixture of whole numbers
and fractions then all of the values for that attribute are to contain the same number
of decimal places.
When presenting numbers less than one, use a leading zero before the decimal
point. (e.g. 0.03 not .03).
All tolerances for units of measure shall include the following special characters:
o Plus
+
o Minus
o Plus or minus
+ or –
o When a range tolerance is to be expressed, the following format shall apply,
for example:
-100 to +50 degree Celsius
The plus and minus signs are only to be used in a numerical context. In other
contexts you must use the whole word i.e. plus, minus.
When using compliance data such as Australian Standards, do not include the year
or version of the standard. You only need to enter the standard.
All values are to be written in the singular (e.g. page not pages).
NSW Procurement - A division of the Department of Finance & Services
28
NSWBuy Catalogue Style Guide
8. Appendix B – Attribute Examples
The following table shows examples of attribute fields that could be added in the optional
Attribute fields in the PSX Toolset. Any Attribute can be added to the PSX Toolset as long
as it has an accompanying Attribute Value.
Attribute Name
Licence data
Compliance data
Safety data
Fire data
Colour data
Flavour data
Fragrance data
Attribute Metadata
Where an item has restricted usage conditions (computer
software).
Where the item conforms to a national/international standard,
industry convention or a known specification.
Safety characteristics, features or information for the item.
The items fire rating characteristic such as fire retardant
information (flammable or non-flammable) fire class information
(Class A - wood, paper, plastic).
The standard colour descriptive name, also use for finishes such
as "chrome", may also include opacity data.
The characteristics of the items taste.
Warranty type
The characteristics of the items smell.
Information about the service provision, delivery, time and other
service details.
The type of energy used to operate the device. Can include fuel
type or energy source.
Input a value to indicate if the item is "rechargeable" or "single
use".
Description of the warning type also includes Dangerous Goods
Data.
The type of guarantee provided.
Warranty data
The number of time units representing the period of guarantee.
Warranty unit
The measurement of time units the warranty data represents.
Specification data
The primary / significant performance measurement of the item.
The unit used to describe the items specification measurement
i.e. "volt".
The price of the product per kilo, litre, or piece (relating to food).
The unit relating to the comparison price kilo, litre, piece,
(relating to food).
The measureable service/s provided to a client within a given
time period.
Period in which the service is provided.
Service data
Energy data
Rechargeable data
Warning data
Specification unit
Comparison price
Comparison unit
Service level
Service period
Service provider
Form data
Function data
Absorbency data
Name of service provider/third party.
The type / style / shape of an item as in important sub
descriptors (not as in material).
What the item is expected to do especially where it is not
obvious or is a sub function / can also include usage data e.g.
Single Patient Use, Reusable, Disposable etc.
The amount of liquid an item will soak up.
NSW Procurement - A division of the Department of Finance & Services
29
NSWBuy Catalogue Style Guide
Attribute Name
Capacity data
Composition data
Concentration data
Condition data
Content data
Operating data
Size code
Storage data
Inscription data
Pattern data
Lens data
Attribute Metadata
The volume that this item can store or process (does not
substitute for measurement data).
The primary / significant material this item is made from (more
detail can be consigned to specification reference).
The amount of primary / significant component dilution (more
detail can be consigned to specification reference).
Where the item cannot be assumed to be new i.e
Remanufactured".
The primary / significant contents of an assembly / kit / set and
includes the number of form copies in a book and similar details.
The method, type or detail for utilising an item.
The standardised size i.e. "small" (can be independent of or
supplement measurement data).
Information about the item's storage capabilities.
The characteristics that forms words / letters / symbols that
distinguish the item.
The characteristics that do not form words / letters / symbols that
distinguish the item. Can also include a range, set or series of
products such as clothing, flooring, footwear, luggage and
manchester etc., by which manufacturer's name the collection.
The characteristic of a lens (eyewear, camera equipment).
NSW Procurement - A division of the Department of Finance & Services
30
NSW Department of Finance & Services
NSW Procurement
McKell Building
2-24 Rawson Place
Sydney NSW 2000
T:
1300 683 289
TTY: 1300 301 181