PD- (Partial delivery) - WEBSALE Dokumentation

If part of the order is in stock and another part is not, there are two sensible options. Either the shop immediately ships what is available and the rest later. Or it waits until everything is together and delivers once. Only the buyer knows which option they prefer. The PD- tags ask them this question in the order process. They first check whether the question makes sense at all, then build the selection, and finally return the decision for display. Guide: Offering partial delivery

When the selection is offered

The question only makes sense if the basket is actually mixed. If it contains only products that are available immediately, there is nothing to decide, and the same applies if everything has to be waited for. This is exactly what PD-Available checks. The range tag applies if both conditions are met: partial delivery is set up in the shop, and the basket contains products with different delivery statuses.

{PD-Available}
   <p>Ein Teil Ihrer Bestellung ist sofort lieferbar. Wie sollen wir vorgehen?</p>
{/PD-Available}

{!PD-Available}
   <p>Ihre Bestellung geht in einer Sendung an Sie heraus.</p>
{/!PD-Available}

The decisive factor is the delivery status, i.e. the traffic light of green, yellow, and red. If the basket contains at least two different status groups, the range tag applies. In the shop configuration, statuses can be combined into groups, and then they count as one. If, for example, yellow and green are combined, the question only appears if there is also something red in the basket.

PD-Available is exclusively a range tag. As a single tag, it outputs nothing.

Offering the selection

Four tags build the two radio buttons. The field name is the same for both; the values distinguish them.

Tag	Returns
`PD-Selection_radioname`	the shared field name of the group
`PD-Selection_radiovalue_complete`	the value for complete delivery
`PD-Selection_radiovalue_partial`	the value for partial delivery
`PD-Selection_radioselected_complete`	the marking of complete delivery
`PD-Selection_radioselected_partial`	the marking of partial delivery

{PD-Available}
   <fieldset>
      <legend>Lieferung</legend>

      <label>
         <input type="radio" name="~PD-Selection_radioname~"
                value="~PD-Selection_radiovalue_complete~"
                ~PD-Selection_radioselected_complete~>
         Alles zusammen liefern, sobald die Bestellung vollständig ist
      </label>

      <label>
         <input type="radio" name="~PD-Selection_radioname~"
                value="~PD-Selection_radiovalue_partial~"
                ~PD-Selection_radioselected_partial~>
         Lieferbare Artikel sofort schicken, den Rest nachliefern
      </label>
   </fieldset>
{/PD-Available}

The selection must be placed in a form that is submitted to the payment and shipping method page or to the order overview. Only these two targets accept the decision. If the group is in a different form, it appears, but the buyer’s choice never reaches the shop system.

The field name and values are fixed in the shop system. Always take both from the tags and do not write them by hand.

As a single tag, the two radioselected tags output checked with a leading space. You can therefore place them directly after the preceding attribute.

The preselection

If the buyer has not clicked anything yet, the shop configuration determines which of the two radio buttons appears selected. There, you can store complete delivery or partial delivery as the default, or leave both open.

If you leave the default open, no radio button appears selected initially. This forces the buyer to make a conscious decision, but also means that they may be able to proceed without having made one. In this case, check how your order process behaves.

Evaluating the selection made

On the order overview, you want to show what the buyer has decided on. There are two more range tags for this.

Tag	Applies if
`PD-Selected_complete`	the buyer has chosen complete delivery
`PD-Selected_partial`	the buyer has chosen partial delivery

{PD-Selected_complete}
   <p>Wir liefern Ihre Bestellung in einer Sendung, sobald sie vollständig ist.</p>
{/PD-Selected_complete}

{PD-Selected_partial}
   <p>Wir schicken Ihnen die lieferbaren Artikel sofort und liefern den Rest nach.</p>
{/PD-Selected_partial}

The two PD-Selected_ tags only apply if the buyer clicked themselves. A preselection from the shop configuration does not count. It is therefore possible for a radio button to appear selected and yet neither of the two range tags applies. If you want to catch this state, nest the negative range tags.

{!PD-Selected_complete}
   {!PD-Selected_partial}
      <p>Bitte wählen Sie noch, wie wir liefern sollen.</p>
   {/!PD-Selected_partial}
{/!PD-Selected_complete}

In addition, the two tags hide themselves automatically if the selection is not offered at all. You therefore do not need to wrap them again with PD-Available.

Both are exclusively range tags. As a single tag, they output nothing.

Excluding products from the decision

Some products should not influence whether the question is asked at all. A download, for example, is always available immediately and would make every basket appear mixed. Such products can be excluded from the check in the product data. Whether this applies to a product is shown by two range tags, which are described under their respective prefix.

in the basket: BASKET-PR-IgnoreForPartialDelivery is described under BASKET- (Items in the basket)
in the product view: PR-IgnoreForPartialDelivery is described under PR- (Product data)

Both apply if the product is excluded from the check. This is rarely of interest to the buyer. They are mainly useful during setup, when you want to understand why the selection appears in a particular basket or why it does not.

The tags at a glance

Tag	Single tag	Range tag	Negative range tag	Loop tag
`PD-Available`	–	yes	yes	–
`PD-Selection_radioname`	yes	–	–	–
`PD-Selection_radiovalue_complete`	yes	–	–	–
`PD-Selection_radiovalue_partial`	yes	–	–	–
`PD-Selection_radioselected_complete`	yes	yes	yes	–
`PD-Selection_radioselected_partial`	yes	yes	yes	–
`PD-Selected_complete`	–	yes	yes	–
`PD-Selected_partial`	–	yes	yes	–

All tags are permitted on all templates. The radio button group belongs in a form that leads to the payment and shipping method page or to the order overview.

Guide: Offering partial delivery
Guide: Displaying the delivery status
Reference: BASKET- (Items in the basket)
Reference: PR- (Product data)

​When the selection is offered

​Offering the selection

​The preselection

​Evaluating the selection made

​Excluding products from the decision

​The tags at a glance

​Related topics

When the selection is offered

Offering the selection

The preselection

Evaluating the selection made

Excluding products from the decision

The tags at a glance

Related topics