Saltar al contenido
Address Validation iO

Esta documentación solo está disponible en inglés.

App de Shopify

Address rules and delivery points

Your own rules that block, flag, rewrite or skip addresses, and per-country settings for PO boxes, parcel lockers and pickup points.

Address rules are your own rules about what an address may contain, for example blocking US military addresses, shortening "Straße" to "Str." for a carrier, or refusing emojis. Delivery point settings decide per country whether you accept PO boxes, parcel lockers and pickup points. Both run before every address check, in checkout and on orders.

Address rules

Open Settings → Address rules. A new shop has no rules.

What a rule looks at

A rule looks at one field: "Street and house number", "Apartment, suite", "City", "Postal code", "State or province" or "Any address field". Choose countries to limit it to them; with none selected, it applies to all countries.

Match Matches when
Contains The text appears anywhere, so "box" also matches "Boxberg"
Contains the word The text appears as a whole word
Is exactly The whole field equals the text
Contains an emoji The field has an emoji or flag
Has non-Latin letters The field has letters such as Cyrillic, Greek, Chinese or Arabic
Has letters of these scripts The field has a letter of any script you pick, for example Chinese and Japanese while Cyrillic stays allowed
Is longer than The field has more characters than the number given
Military address (APO/FPO/DPO) A US address has the city APO, FPO or DPO, or the state AA, AE or AP

Texts are not case-sensitive. The military match looks at the whole address, so its field must be "Any address field".

What a rule does

Action What it does
Block The address is Invalid, without asking a provider
Flag for review An address that would be Valid becomes Needs checking
Replace silently AVIO checks the rewritten text and writes it into the shipping address of new orders. It keeps the capital letter of the match: "Straße" → "Str." turns "Hauptstraße 5" into "Hauptstr. 5". Leave "Replace with" empty to remove the match
Skip validation AVIO doesn't check the address, not even with the pre-check. The order gets the unsupported tag

"Is longer than" can only flag or block. Military, non-Latin and script matches can't replace.

Order of evaluation

Block rules look at the address as entered. Replace rules then rewrite it, top to bottom. Flag and Skip rules look at the result. A Block rule wins over Skip validation. Rules judge a billing address only when it is the same as the shipping address.

What customers and you see

  • In checkout: a Block rule stops checkout only while the checkout rules are active. The customer sees "We can't deliver to this address as entered. Please check it." (editable under Design & language → Edit texts). Replace rules leave the checkout form as the customer typed it.
  • On the order: a Block rule makes the order Invalid, with the tag, the correction request and, if holds are on, a fulfillment hold. A Replace rule rewrites new orders only; Logs show the change. Re-checks never rewrite an order.

A Block or Skip rule makes the address check free, because no provider is asked. Flagged and replaced addresses are billed as usual.

Limits

Up to 20 rules per shop, each limited to up to 20 countries. A rule's text has at most 40 characters. Add rule saves the new rule at once, together with your unsaved changes to the rules above it.

The page can also suggest rules for your carriers under "Recommended for your carriers", based on your recent shipments.

Note: Try an address with "Test an address" on the Providers page. It applies your address rules too.

Delivery points

Not every carrier delivers to PO boxes, parcel lockers or pickup points. AVIO recognises these addresses by keywords in the street and apartment lines, and you decide per country what to accept.

Under Settings → Delivery points, set "PO boxes" and "Parcel lockers & pickup points" to Accept or Block:

  • once for "All other countries", and
  • per country under "Country rules" (up to 60 countries).

Everything is accepted by default. A new country row starts with AVIO's recommended choice for the countries it has its own keywords for: Germany blocks PO boxes and accepts lockers, the others accept both. Any other country starts with the "All other countries" setting. The page lists each country's keywords under "What Address Validation iO recognises".

Country Examples of what AVIO recognises
Germany Packstation, Postfiliale, Paketshop, Postfach
Austria Abholstation, Empfangsbox, Post Partner, Paketshop, Postfach
Switzerland PickPost, My Post 24, postlagernd, Postfach, case postale
Netherlands Pakketpunt, pakketautomaat, PostNL-punt, Postbus, Antwoordnummer
France Point Relais, Relais Colis, Mondial Relay, consigne, BP, CS
United Kingdom Parcel locker, Amazon Locker, InPost, PO Box
United States PO Box, PMB, APO/FPO/DPO, Amazon Locker
Other countries PO Box, Packstation, parcel locker, pickup point

Belgium, Poland, Italy, Spain, Canada and Australia have their own keyword lists too.

What happens to a blocked kind

  • In checkout, once the checkout rules are active, the customer sees "We can't ship to PO boxes. Please enter a street address." or "We can't ship to parcel lockers or pickup points. Please enter a street address."
  • On orders, the address is Invalid, so the customer is asked for a street address and, with fulfillment holds on, the order is held.

A blocked kind settles the check without a provider, so it is instant and free. An accepted PO box or locker goes to the provider as usual. A PO box the provider spots follows your PO box setting too.

The order also gets the tag address-validation|shipping|post-box (default wording) when a provider flags a PO box, for every German Packstation, and for blocked PO boxes and lockers.

German Packstation and the Postnummer

A German Packstation, Postfiliale or Paketshop only takes parcels for a customer who gives their DHL customer number, the Postnummer (6 to 10 digits), in the street or apartment line.

  • Without it the address is Invalid in every mode. In checkout, with the checkout rules active, the customer sees "For a Packstation or post office, please add your DHL Postnummer."
  • With it AVIO accepts the address without asking a provider, which wouldn't know these points. If you block parcel lockers for Germany, it is Invalid instead.

House numbers

In 14 countries an address without a house number fails the free pre-check and is Invalid in every mode; see How a check works. In checkout, the rule "Require a house number in" (Settings → Checkout) applies the same test to the countries you pick, by default Germany, Austria, Switzerland and the Netherlands.

For US military addresses and anything else, use address rules.

Troubleshooting

A Block rule didn't stop checkout. The checkout rules probably aren't active. The order is still marked Invalid.

A correct address was flagged by a rule. "Contains" matches text anywhere in the field. Use "Contains the word" or "Is exactly" instead. Logs say when an address matches one of your address rules.

A Packstation address was refused. Check that the street or apartment line has the Postnummer as 6 to 10 digits, and that parcel lockers aren't blocked for Germany.