Shared reference: This page is the single source of truth for Conditions, Operators, and Wildcards. It is used by both Shipping Rules and Checkout Delivery Options as both features run on the same underlying condition/allocation engine. For any future updates: Update it here once - do not duplicate this content into feature-specific pages.
Conditions are the "if" statements used to build logic across Scurri's automation features. They evaluate shipment and order data - such as delivery timeframe, destination, order value, or package weight - and, combined with an operator, determine whether a rule or delivery option should apply to a specific shipment.
Condition types
The conditions you can choose from cover a wide range of shipment and order data. Below is a comprehensive table of all available condition types:
Condition Name | Notes |
|---|---|
Brand | The name of the customer's brand associated with the shipment. Useful for merchants managing multiple brands under one account. |
Custom Field 1-5 | Flexible custom fields that can be mapped to your own data from orders or shipments (via API or integration). Useful for business-specific conditions like loyalty tier, sales channel, or order source. |
Days to delivery date | Uses the expected delivery date field. |
IOSS number | The Import One-Stop Shop (IOSS) number for EU cross-border shipments. Useful for routing VAT-exempt shipments differently. |
Item Commodity Description | A free-text description of an item's commodity, supplied via API or integration. Useful for customs compliance and regulatory rules. |
Item Country of Origin | The country where an item was manufactured or sourced. Useful for compliance rules or routing items with specific origins. |
Item Harmonisation Code | The international customs classification code (HS code) for an item. Useful for regulatory compliance or restricted item handling. |
Item name | The name of any item in the consignment. |
Item Value | The monetary unit value of an individual item in the consignment. Useful for routing high-value items to insured or premium carriers. |
Order item count | Total number of items across all packages in the consignment. |
Order number | Can be used to separate orders from different marketplaces like eBay and Amazon. |
Order value | The total value across all packages in the consignment. |
Package Count | Total number of packages in the consignment. |
Package Item SKU | The SKU of any item in the consignment. |
Package Length + Girth | The combined length and girth dimensions of a package. Used by carriers with dimensional weight limits. |
Package weight | The total weight of individual packages (Measured in kg). |
Recipient Company Name | The name of a business receiving the shipment. Often empty for B2C orders. Useful for B2B-specific routing rules. |
Recipient email | The email address of the shipment recipient. Optional field; can be empty for some orders. Useful for carriers offering SMS/email notifications. |
Recipient name | Combines first and last name fields (e.g., "John Smith"). |
Recipient phone | The phone number of the shipment recipient. Optional field; can be empty for some orders. Required by some carriers for delivery notifications. |
Recipient Type | Identifies whether the recipient is a business or consumer (e.g. B2B or B2C). Useful for routing shipments differently based on customer type. |
Sender Name | The name of the shipment sender. Can be your company name, warehouse name, or a custom override depending on account configuration. Useful for differentiating multi-warehouse or multi-brand shipments. |
Ship to Address line 1, 2, 3 | The destination address fields. |
Ship to City | The destination city. |
Ship to Country | The destination country. You can use full names or 2-letter ISO codes (e.g., GB, IE, US). |
Ship to State | The destination state (can also be County or Region). |
Ship to ZIP/Postcode | The destination ZIP / Postcode. |
Shipment currency | The currency code (e.g., GBP, EUR, USD) in which the shipment value is denominated. |
Shipment girth | Calculated by adding the package width and height together and multiplying by 2 (measured in cm). |
Shipment height | Measured in cm. |
Shipment import day | The day the consignment is imported to Scurri. |
Shipment import time | The time the consignment is imported to Scurri (24hr format). |
Shipment length | Measured in cm. |
Shipment package type | Not the package type set by the rule. |
Shipment volume | Calculated by multiplying the shipment length by width by height (Measured in cm3). |
Shipment weight | The total weight across all packages in the Consignment (Measured in kg). |
Shipment width | Measured in cm. |
Shipping Cost | The shipping cost supplied for a shipment. |
Shipping Method | Usually the shipping method selected at checkout; via the API, this can also be used as a custom field. |
Warehouse Name | The name of the warehouse from which the shipment originates. |
Important: Numerical values. For conditions using measurements (weight, length, girth, volume, etc.), you must input only the numerical figure in the value field. Do not include units of measurement. For example, enter "3", not "3 kg", and enter "25", not "25 cm".
Tip: Condition reuse. A single condition type can be used twice, but only with opposite logic on the second use. For example, if your first condition is "order value is greater than 100", you can use "order value" again only with "is lower than" as the operator. This same principle applies to list-based conditions: if the first use is "is in", the second use must be "is not in". This ensures your conditions create a logical and non-redundant ruleset.
Operators
Operators specify how your condition values are evaluated. Below is a comprehensive table of all available operators:
Operator | Field Format | How it works | Example |
|---|---|---|---|
equals to | Numeric or Text | The value matches the exact inputted value exactly. | Order value equals to 50 or Shipping method equals to Express. |
is not equal to | Numeric or Text | The value does not match the exact inputted value. | Shipping method is not equal to Standard. |
greater than | Numeric | The value is greater than the inputted value. | Shipment weight is greater than 2. |
greater than or equal to | Numeric | The value is greater than or equal to the inputted value. | Order item count is greater than or equal to 5. |
lower than | Numeric | The value is lower than the inputted value. | Shipment length is lower than 30. |
lower than or equal to | Numeric | The value is lower than or equal to the inputted value. | Package count is lower than or equal to 3. |
is in | Text | The value matches one of several inputted list items. | Ship to country is in GB, IE, FR, ES, PT, DE. |
is not in | Text | The value does not match any of the inputted list items. | Ship to country is not in US, CA. |
contains | Text | The inputted value is found anywhere within the field data. | Item name contains "Fragile" or Shipping method contains "Express". |
does not contain | Text | The inputted value is not found anywhere within the field data. | Item name does not contain "Fragile" or Shipping method does not contain "Express". |
is empty | Any | The field contains no value. Applies to optional fields without default values. | Recipient type is empty. |
is not empty | Any | The field contains a value. Applies to optional fields without default values. | Recipient phone is not empty. |
Tip: "Contains" vs. "is in". "Contains" and "does not contain" check for a single text value within a single field - for example, whether Item name contains the word "Fragile" anywhere in it. This is different from "is in" / "is not in", which check whether a field's value matches one of several list items you provide. If you need to match against a list of possible values, use "is in" or "is not in" instead.
For conditions that contain long lists, an expand button will appear on the right side of the input field if the text exceeds the field's width. Clicking this button opens a pop-up window showing the full list. From there, you can easily edit the values and click Apply changes to save your changes.
Wildcards / Grouping Values
You can use an asterisk (*) as a wildcard to match patterns and group values with common characteristics. This is particularly useful for postcode ranges, SKU prefixes, or any text-based field where you want to match multiple values with a common prefix or suffix.
Pattern matching examples:
Postcode starts with "BT" (for Northern Ireland)
Condition: Ship to ZIP/Postcode | Operator: is in | Value: BT*
SKU ends with "6000"
Condition: Package Item SKU | Operator: is in | Value: *6000
Commonly Used Conditions
Below are some commonly used lists of areas and countries names and their corresponding 2-letter ISO codes for your reference and use.
Scottish Highlands & Islands postcodes:
HS1*, HS2*, HS3*, HS4*, HS5*, HS6*, HS7*, HS8*, HS9*, IV1*, IV2*, IV3*, IV10*, IV11*, IV12*, IV13*, IV14*, IV15*, IV16*, IV17*, IV18*, IV19*, IV20*, IV21*, IV22*, IV23*, IV24*, IV25*, IV26*, IV27*, IV28*, IV29*, IV30*, IV31*, IV32*, IV36*, IV40*, IV41*, IV42*, IV43*, IV44*, IV45*, IV46*, IV47*, IV48*, IV49*, IV50*, IV51*, IV52*, IV53*, IV54*, IV55*, IV56*, KA27*, KA28*, KW1*, KW2*, KW3*, KW5*, KW6*, KW7*, KW8*, KW9*, KW10*, KW11*, KW12*, KW13*, KW14*, KW15*, KW16*, KW17*, PA20*, PA21*, PA22*, PA23*, PA24*, PA25*, PA26*, PA27*, PA28*, PA29*, PA30*, PA31*, PA32*, PA33*, PA34*, PA35*, PA36*, PA37*, PA38*, PA39*, PA40*, PA41*, PA42*, PA43*, PA44*, PA45*, PA46*, PA47*, PA48*, PA49*, PA60*, PA61*, PA62*, PA63*, PA64*, PA65*, PA66*, PA67*, PA68*, PA69*, PA70*, PA71*, PA72*, PA73*, PA74*, PA75*, PA76*, PA77*, PA78*, PH17*, PH18*, PH19*, PH20*, PH21*, PH22*, PH23*, PH24*, PH25*, PH26*, PH30*, PH31*, PH32*, PH33*, PH34*, PH35*, PH36*, PH37*, PH38*, PH39*, PH40*, PH41*, PH42*, PH43*, PH44*, PH49*, PH50*, ZE1*, ZE2*, ZE3*
Northern Ireland, Isle of Man & Isles of Scilly:
BT*, IM*, TR21*, TR22*, TR23*, TR24*, TR25*
EEA Countries:
Austria | AT | Italy | IT |
Belgium | BE | Latvia | LV |
Bulgaria | BG | Liechtenstein | LI |
Croatia | HR | Lithuania | LT |
Cyprus | CY | Luxembourg | LU |
Czech Republic | CZ | Malta | MT |
Denmark | DK | Netherlands | NL |
Estonia | EE | Norway | NO |
Finland | FI | Poland | PL |
France | FR | Portugal | PT |
Germany | DE | Romania | RO |
Greece | GR | Slovakia | SK |
Hungary | HU | Slovenia | SI |
Iceland | IS | Spain | ES |
Ireland | IE | Sweden | SE |
List for use in rules:
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
All countries and their associated 2-letter ISO codes:
Afghanistan | AF | Liberia | LR |
Albania | AL | Libya | LY |
Algeria | DZ | Liechtenstein | LI |
American Samoa | AS | Lithuania | LT |
Andorra | AD | Luxembourg | LU |
Angola | AO | Macao | MO |
Anguilla | AI | Macedonia | MK |
Antarctica | AQ | Madagascar | MG |
Antigua and Barbuda | AG | Malawi | MW |
Argentina | AR | Malaysia | MY |
Armenia | AM | Maldives | MV |
Aruba | AW | Mali | ML |
Australia | AU | Malta | MT |
Austria | AT | Marshall Islands (the) | MH |
Azerbaijan | AZ | Martinique | MQ |
Bahamas | BS | Mauritania | MR |
Bahrain | BH | Mauritius | MU |
Bangladesh | BD | Mayotte | YT |
Barbados | BB | Mexico | MX |
Belarus | BY | Micronesia | FM |
Belgium | BE | Moldova | MD |
Belize | BZ | Monaco | MC |
Benin | BJ | Mongolia | MN |
Bermuda | BM | Montenegro | ME |
Bhutan | BT | Montserrat | MS |
Bolivia (Plurinational State of) | BO | Morocco | MA |
Bonaire, Sint Eustatius and Saba | BQ | Mozambique | MZ |
Bosnia and Herzegovina | BA | Myanmar | MM |
Botswana | BW | Namibia | NA |
Bouvet Island | BV | Nauru | NR |
Brazil | BR | Nepal | NP |
British Indian Ocean Territory | IO | Netherlands | NL |
Brunei Darussalam | BN | New Caledonia | NC |
Bulgaria | BG | New Zealand | NZ |
Burkina Faso | BF | Nicaragua | NI |
Burundi | BI | Niger | NE |
Cabo Verde | CV | Nigeria | NG |
Cambodia | KH | Niue | NU |
Cameroon | CM | Norfolk Island | NF |
Canada | CA | Northern Mariana Islands | MP |
Cayman Islands | KY | Norway | NO |
Central African Republic | CF | Oman | OM |
Chad | TD | Pakistan | PK |
Chile | CL | Palau | PW |
China | CN | Palestine, State of | PS |
Christmas Island | CX | Panama | PA |
Cocos (Keeling) Islands | CC | Papua New Guinea | PG |
Colombia | CO | Paraguay | PY |
Comoros | KM | Peru | PE |
Congo (the Democratic Republic of the) | CD | Philippines | PH |
Congo | CG | Pitcairn | PN |
Cook Islands | CK | Poland | PL |
Costa Rica | CR | Portugal | PT |
Croatia | HR | Puerto Rico | PR |
Cuba | CU | Qatar | QA |
Curaçao | CW | Romania | RO |
Cyprus | CY | Russian Federation | RU |
Czechia | CZ | Rwanda | RW |
Côte d'Ivoire | CI | Réunion | RE |
Denmark | DK | Saint Barthélemy | BL |
Djibouti | DJ | Saint Helena, Ascension and Tristan da Cunha | SH |
Dominica | DM | Saint Kitts | KN |
Dominican Republic | DO | Saint Lucia | LC |
Ecuador | EC | Saint Martin (French part) | MF |
Egypt | EG | Saint Pierre and Miquelon | PM |
El Salvador | SV | Saint Vincent and the Grenadines | VC |
Equatorial Guinea | GQ | Samoa | WS |
Eritrea | ER | San Marino | SM |
Estonia | EE | Sao Tome and Principe | ST |
Eswatini | SZ | Saudi Arabia | SA |
Ethiopia | ET | Senegal | SN |
Falkland Islands | FK | Serbia | RS |
Faroe Islands | FO | Seychelles | SC |
Fiji | FJ | Sierra Leone | SL |
Finland | FI | Singapore | SG |
France | FR | Sint Maarten (Dutch part) | SX |
French Guiana | GF | Slovakia | SK |
French Polynesia | PF | Slovenia | SI |
French Southern Territories | TF | Solomon Islands | SB |
Gabon | GA | Somalia | SO |
Gambia | GM | South Africa | ZA |
Georgia | GE | South Georgia and the South Sandwich Islands | GS |
Germany | DE | South Sudan | SS |
Ghana | GH | Spain | ES |
Gibraltar | GI | Sri Lanka | LK |
Greece | GR | Sudan | SD |
Greenland | GL | Suriname | SR |
Grenada | GD | Svalbard and Jan Mayen | SJ |
Guadeloupe | GP | Sweden | SE |
Guam | GU | Switzerland | CH |
Guatemala | GT | Syrian Arab Republic | SY |
Guernsey | GG | Taiwan | TW |
Guinea | GN | Tajikistan | TJ |
Guinea-Bissau | GW | Tanzania, United Republic of | TZ |
Guyana | GY | Thailand | TH |
Haiti | HT | Timor-Leste | TL |
Heard Island and McDonald Islands | HM | Togo | TG |
Holy See | VA | Tokelau | TK |
Honduras | HN | Tonga | TO |
Hong Kong | HK | Trinidad and Tobago | TT |
Hungary | HU | Tunisia | TN |
Iceland | IS | Turkey | TR |
India | IN | Turkmenistan | TM |
Indonesia | ID | Turks and Caicos Islands | TC |
Iran (Islamic Republic of) | IR | Tuvalu | TV |
Iraq | IQ | Uganda | UG |
Ireland | IE | Ukraine | UA |
Isle of Man | IM | United Arab Emirates | AE |
Israel | IL | United Kingdom | GB |
Italy | IT | United States Minor Outlying Islands | UM |
Jamaica | JM | USA | US |
Japan | JP | Uruguay | UY |
Jersey | JE | Uzbekistan | UZ |
Jordan | JO | Vanuatu | VU |
Kazakhstan | KZ | Venezuela | VE |
Kenya | KE | Viet Nam | VN |
Kiribati | KI | Virgin Islands (British) | VG |
Korea (the Democratic People's Republic of) | KP | Virgin Islands (U.S.) | VI |
Korea (the Republic of) | KR | Wallis and Futuna | WF |
Kuwait | KW | Western Sahara | EH |
Kyrgyzstan | KG | Yemen | YE |
Lao People's Democratic Republic | LA | Zambia | ZM |
Latvia | LV | Zimbabwe | ZW |
Lebanon | LB | Åland Islands | AX |
Lesotho | LS |
|
|
Days to Delivery:
The Days to Delivery condition lets you create rules based on the expected_delivery_date provided in your API request. This is highly useful for reducing shipping costs, as it allows the system to select a more economical carrier when there is plenty of time before the promised delivery date.
Important: By default, the calculation includes Saturdays and Sundays.
You can exclude weekends directly in the input field by adding modifiers.
Examples (using 5 days):
5: Includes both Saturday and Sunday (Default).5 exclude_saturday: Removes Saturday as a delivery day.5 exclude_sunday: Removes Sunday as a delivery day.5 exclude_saturday exclude_sunday: Removes both weekend days.