WebConnect for Suppliers - Options

Introduction

The following list outlines the options available in the WebConnect for Suppliers service that can be defined by the customer.

During the onboarding process, these options are configured by the Retarus implementation team.

Header fields (global or order settings)

📌 The mandatory options that must be completed in all cases are marked with an asterisk (*).

Field / Parameter	Data Type	Sample	Description
Supplier sender email supplier.mail.from*	Email	`from@retar.us`	Email address to use as the From address when sending emails to a supplier. Must be supported by the Retarus E-Mail Service
Supplier recipient email supplier.mail.to*	List <Email>	`to1@retarus.us`	Email address to which emails are sent to inform the supplier about our customer. At least one recipient must be specified.
Supplier CC email supplier.mail.cc	List <Email>	`ccto1@retarus.us`	Email address to be used in the CC field when sending emails to inform the supplier about our customer.
Customer recipient email customer.mail.to*	List <Email>	`to1@retarus.us`	Email address to be used in the To field when sending notifications to the Retarus customer. At least one recipient must be specified.
Customer CC email customer.mail.cc	List <Email>	`ccto1@retarus.us`	Email address to be used in the CC field when sending notifications to the Retarus customer.
Bounce notification email customer.mail. returnPath	List <Email>	`to1@retarus.us`	Email address to which bounce notifications are sent if an email (order) to `supplier.mail.to` cannot be delivered. If not specified, `customer.mail.to` is used.
Report recipient email report.mail.to	List <Email>	`to1@retar.us`	Email recipient list for reports, usually the same as `customer.mail.to`. Examples include pending orders and similar reports.
Pending from date report.pending.at		`5 days after the order date or 5 days before the delivery date`	Date on which this order is added to the list of delayed orders and will be reported via email.
Order page language language	Enum [de, en, it, th, fr, es]	`de`	Two-letter lowercase language code (ISO 639-1) used for the language setting of the order webpage and the email template. If not specified, the default is `en`. The language code can be defined dynamically through order EDI data.
Logo link logo.href	Link	`internal link`	The logo displayed in the upper-left corner. The logo will be stored within the Retarus system as *.png with dimensions of 160 px x 60 px.
Show zero allowances and charges allowances_and_ charges.show_ zero_values	Boolean	`false`	Shows allowance and charge values on the sheet even if they are `0%` or `0€`.
Item number source in the user interface gui.col.item_ number.source	ENUM	_{BUYER_PID}	Specifies which item number is used in the user interface to populate the item number column. Possible values: BUYER_PID INTERNATIONAL_PID MANUFACTURER_PID SUPPLIER_PID
Allow delivery date changes deliverydate. change	Boolean	`true`	Allows the supplier (`supplier.mail.to`) to change the delivery date. Only future dates can be entered.
Allow file upload upload.allowed	Boolean	`true`	If set to `true`, the supplier (`supplier.mail.to`) is allowed to upload files that will be included in the ORDRSP. The file(s) will be scanned automatically for viruses.
Allowed upload file types upload.extensions	String	`pdf,docx`	If uploads are allowed, this parameter defines which file types the supplier (`supplier.mail.to`) can attach.
Data purge date purgeTs*		`90 days`	Retention period after which the data is purged. Minimum retention is 30 days; maximum retention is 395 days.
Maximum number of responses responses.max	Integer	`1`	Multi confirm. Maximum number of order responses the supplier is allowed to generate.
Supplier order number required supplier.order_ number.mandatory	Boolean	`true`	Specifies whether the supplier must enter a supplier order number when submitting the order response.
Maximum price decimal places price.max_fraction	Integer	`4`	Maximum number of decimal places allowed if a calculated price results in a fraction smaller than the smallest currency unit (for example, a cent), e.g., `2.4525 €`. Allowed values range from `0` to `6`.
Minimum price decimal places price.min_fraction	Integer	`2`	Minimum number of decimal places always shown for a price. For example, `2 €` would be displayed as `2.00 €`. Allowed values range from `0` to `6`.
Maximum amount decimal places amount.max_ fraction	Integer	`2`	Maximum number of decimal places allowed if a calculated amount results in a fraction smaller than the smallest currency unit (for example, a cent), e.g., `2.45 €`. Allowed values range from `0` to `6`.
Maximum amount decimal places amount.min_ fraction	Integer	`2`	Minimum number of decimal places always shown for an amount. For example, `2 €` would be displayed as `2.00 €`. Allowed values range from `0` to `6`.
Allow editing of allowances and charges allowances_and_ charges.allowed	Boolean	`true`	Specifies whether the supplier is allowed to add, remove, and edit allowances and charges.

Item fields (item settings)

📌 The mandatory options that must be completed in all cases are marked with an asterisk (*).

Field / Parameter	Data Type	Sample	Description
Allow editing of allowances and charges allowances_and_ charges.allowed	Boolean	`true`	Specifies whether the link recipient is allowed to add, remove, and edit allowances and charges.
Allow item delivery date changes deliverydate. change.allowed	Boolean	`true`	Specifies whether the delivery date can be changed at item level.
Show international PID barcode international_pid. show_image	Boolean	`true`	Specifies whether the barcode image of the `<InternationalPid>` element is shown on the page.
Allow partial shipments partial.shipment. allowed	Boolean	`true`	Specifies whether the link recipient is allowed to create partial shipment entries.
Allow price changes price.change. allowed	Boolean	`true`	Specifies whether the link recipient is allowed to change the price.
Allow quantity reduction quantity.change. allowed	Boolean	`true`	Specifies whether the link recipient is allowed to reduce the quantity.
Allow tax changes tax.change. allowed	Boolean	`true`	Specifies whether the link recipient is allowed to change the tax percentage.