get delivery options

This block is part of the shipping group and was last modified in core v13.0.9.

get delivery options v13.0.9

This block is used to request the delivery options for a delivery.

In pins 10 + flow
  • flow
    flow
  • Connection required
    postnlconnection

    The PostNL connection.

  • Sender Address required
    object

    The address of the sender of this shipment. Object should contain the following fields: city, country_code (ISO2), house_number, street, zip_code, house_number_ext.

  • Receiver Address required
    object

    The address of the receiver of this shipment. Object should contain the following fields: city, country_code (ISO2), house_number, street, zip_code, house_number_ext.

  • Order Date required
    date

    The order date used to request the delivery options.

  • Preparing Duration (days) required
    number

    The number of days it takes to send the shipment to PostNL (from your magazine). 1: same day, 2: next day, etc.

  • Handle in holidays
    condition

    Boolean indicates if you handle orders in holidays. If false PostNL uses this to define delivery options.

    Default false

  • Days in future
    number

    How much days you want to look in the future for delivery options can 1-9.

    Default 5

  • Locations Quantity
    number

    How much locations you want returned can be 1-3.

    Default 3

  • Blocked Delivery Options
    array

    Blocked delivery options that you want to block. Default every option is available, with this array you can remove options from that list. Check the documentation for the available options you can block.

  • Cutoff options
    array

    Array containing options for cutoff. For each day that has other cutoff settings make a object in the array with the day field (e.g. sunday) or you can set that field to all (so you can use that as default for all days). The object should also contain the following fields: cutoff_time (value HH:mm:ss), is_available (condition that indicates if you ship on that date) and type. See serivce documentation for the available types.

Out pins 5 + flow
  • flow
    flow
  • Connection
    postnlconnection

    The PostNL connection

  • Success
    condition

    If successful, return true.

  • Delivery options
    array

    The delivery options for this delivery.

  • Pickup options
    array

    The pickup options for this delivery.

  • Error
    value

    Error message if the delivery options could not be requested.

bezorging
bezorgopties

A typical wiring for get delivery options: a function trigger starts the flow; open connection feeds the connection pin; new object feeds the sender_address pin; new object feeds the receiver_address pin; date now feeds the order_date pin; number feeds the preparing_duration_days pin; the flow out pin feeds debug.

Studio canvas example for the get delivery options block: typical wiring for get delivery options.

Version history

Introduced in v13.0.9.


Back to shipping Return to the main group to view all sub-groups Back to PostNL Return to the group to view all blocks within this group