Title: Postali — Códigos postales de México Author: gomflo Published: Ọwẹ́wẹ̀ 28, 2026 Last modified: Ọwẹ́wẹ̀ 28, 2026 --- Ṣàwárí àwọn plugin ![](https://ps.w.org/postali-codigos-postales/assets/banner-772x250.png?rev=3717472) ![](https://ps.w.org/postali-codigos-postales/assets/icon-256x256.png?rev=3717472) # Postali — Códigos postales de México Láti ọwọ́ [gomflo](https://profiles.wordpress.org/gomflo/) [Ṣe ìgbàsílẹ̀](https://downloads.wordpress.org/plugin/postali-codigos-postales.1.0.0.zip) * [Àwọn àlàyé](https://yor.wordpress.org/plugins/postali-codigos-postales/#description) * [Àwọn àgbéyẹ̀wò](https://yor.wordpress.org/plugins/postali-codigos-postales/#reviews) * [Ìgbéwọlẹ̀](https://yor.wordpress.org/plugins/postali-codigos-postales/#installation) * [Ìdàgbàsókè](https://yor.wordpress.org/plugins/postali-codigos-postales/#developers) [Ìrànlọ́wọ́](https://wordpress.org/support/plugin/postali-codigos-postales/) ## Àpèjúwe Your customers type their **postal code (código postal)** and the WooCommerce checkout fills in the **state**, the **city or municipality**, and shows a **dropdown with every colonia (neighborhood)** for that postal code. Fewer typos, fewer parcels returned for incomplete addresses. The data comes from the official SEPOMEX catalog (Correos de México), served by the free public [Postali API](https://postali.app/api): no signup, no API key, no quotas. The plugin interface is in Spanish, since it is built for stores that sell in Mexico. #### Features * When the country is **Mexico** and the customer types a 5-digit postal code, it fills the state (using WooCommerceÌtumọ̀ Yorùbá: ’s state codes), the city( municipality or alcaldía) and turns the colonia field into a dropdown. * If the postal code has a single colonia, it is selected automatically. * An **“Otra (escribirla a mano)”** option lets customers type a colonia that is not in SEPOMEX yet. Every field can still be edited by hand. * Works for billing and shipping, and on **My Account > Addresses**. * If the API is unreachable or the postal code does not exist, the customer sees a short message and fills the address manually. **A network failure never blocks checkout.** * Per-session browser cache, so the same postal code is not requested twice. * **Optional server-side validation**: when the order is placed, reject postal codes that do not exist or that do not match the selected state. Results are cached for a week. If the API does not answer, the order goes through. * Optionally moves the postal code field before the street fields for Mexico, so customers type it first. * Compatible with HPOS (High-Performance Order Storage). #### Where the colonia is stored By default, in **Address line 2** (`address_2`), relabeled “Colonia” for Mexico. This is the most common convention in Mexican stores: line 1 holds street and number, line 2 holds the colonia. The colonia then shows up with no extra setup in emails, invoices, shipping labels, exports and any integration that reads the standard WooCommerce address. If you prefer a separate field, choose **“Campo propio Colonia”** in the settings. It is stored as an additional order field (`_wc_billing/postali/colonia` and `_wc_shipping/ postali/colonia`, the same format the block checkout uses), and it is added to the formatted Mexican address in the order screen, emails and the thank-you page. Keep in mind that many shipping integrations only read `address_2`. #### Classic checkout and block checkout * **Classic checkout** (`[woocommerce_checkout]` shortcode): fully supported. * **Block checkout**: supported. State, city and colonia are written to the checkout data store (`wc/store/cart`), so the React form and the server see the same values. The colonia dropdown appears right below the postal code field, using the same markup as WooCommerceÌtumọ̀ Yorùbá: ’s own selects. Because the block checkout does not allow replacing its fields, the dropdown is the pluginÌtumọ̀ Yorùbá:’ s own element and writes into Address line 2 (or into the separate “Colonia” field, registered through WooCommerceÌtumọ̀ Yorùbá: ’s additional checkout fields API and shown only for Mexico on WooCommerce 9.9+). If a theme or plugin heavily customizes the block form, state and city autocompletion keep working even if the dropdown cannot be inserted. #### Settings Under **WooCommerce > Settings > Postali**: * Turn autocompletion on or off. * Which fields to fill: state, city, colonia. * What goes into “City”: municipality/alcaldía (recommended for carriers) or the SEPOMEX city. * Where to store the colonia: Address line 2 or a separate field. * Show the postal code before the street (Mexico). * Server-side validation. * “Datos: Postali” credit link (off by default). #### Optional credit link The plugin can show a small “Datos: Postali” link below the colonia field. **It is off by default** and only appears if you turn it on in the settings. The plugin works exactly the same without it. ### External services This plugin connects to the **Postali API** (https://postali.app), an external service, to look up the state, municipality and colonias of a Mexican postal code. Without this lookup the plugin cannot autocomplete the address. **What is sent, and when** * **From the customerÌtumọ̀ Yorùbá: ’s browser**, on the checkout page and on My Account > Addresses: when the country is Mexico and the customer types a 5-digit postal code, the browser requests `https://postali.app/api/v1/mx/cp/{postal code}`. Only the postal code is sent, as part of the URL. As with any web request, the service also receives the customerÌtumọ̀ Yorùbá: ’s IP address and browser user agent. No name, street, email, phone or order data is sent. The request is made without cookies. * **From the storeÌtumọ̀ Yorùbá: ’s server**, only if “Validación en el servidor” is enabled: when an order with a Mexican address is placed, WordPress requests the same URL with that addressÌtumọ̀ Yorùbá: ’s postal code. Only the postal code is sent; the response is cached for one week. The service is provided by Postali. Terms of use: https://postali.app/terminos — Privacy policy: https://postali.app/privacidad — Documentation: https://postali. app/api/docs Postal code data comes from SEPOMEX (Servicio Postal Mexicano). ## Àwọn àwòrán ìbòjú [⌊Block checkout: typing the postal code fills the state and city, and the colonia becomes a dropdown with every colonia for that postal code.⌉⌊Block checkout: typing the postal code fills the state and city, and the colonia becomes a dropdown with every colonia for that postal code.⌉[ Block checkout: typing the postal code fills the state and city, and the colonia becomes a dropdown with every colonia for that postal code. [⌊Classic checkout: a postal code with a single colonia selects it automatically. The postal code field is shown before the street for Mexico.⌉⌊Classic checkout: a postal code with a single colonia selects it automatically. The postal code field is shown before the street for Mexico.⌉[ Classic checkout: a postal code with a single colonia selects it automatically. The postal code field is shown before the street for Mexico. [⌊Settings under WooCommerce > Settings > Postali.⌉⌊Settings under WooCommerce > Settings > Postali.⌉[ Settings under WooCommerce > Settings > Postali. ## Ìgbéwọlẹ̀ 1. Install and activate WooCommerce. 2. Upload the `postali-codigos-postales` folder to `/wp-content/plugins/`, or install it from **Plugins > Add New**. 3. Activate the plugin. 4. Review **WooCommerce > Settings > Postali**. It works out of the box: it fills state, city and colonia, and stores the colonia in Address line 2. ## FAQ ### Do I need an API key or an account? No. The Postali API is public and free. ### What happens if the API does not respond? The customer sees a notice and fills the address manually. Checkout is never blocked by a network failure, not even with server-side validation enabled. ### Why is Ciudad de México stored with the code “DF”? That is the code WooCommerce uses internally for Ciudad de México (“MX” is Estado de México). The plugin maps SEPOMEX state names to those codes; customers only see the name. ### A colonia is missing from the list Choose “Otra (escribirla a mano)” and type it. SEPOMEX takes a while to register new developments. ### Does it work for Colombia or Spain? The Postali API also has data for Colombia and Spain, but this version of the plugin only autocompletes Mexican addresses. ### Can I point it at my own copy of the API? Yes. The `postali_cp_api_base` PHP filter changes the base URL for both the browser lookups and the server-side validation. ## Àwọn àgbéyẹ̀wò Kò sí àwọn àgbéyẹ̀wò fún plugin yìí. ## Àwọn Olùkópa & Olùgbéejáde “Postali — Códigos postales de México” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí. Àwọn Olùkópa * [ gomflo ](https://profiles.wordpress.org/gomflo/) [Túmọ̀ “Postali — Códigos postales de México” sí èdè rẹ.](https://translate.wordpress.org/projects/wp-plugins/postali-codigos-postales) ### Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè? [Ṣàwárí koodu](https://plugins.trac.wordpress.org/browser/postali-codigos-postales/), ṣàyẹ̀wò [ibi ìpamọ́ SVN](https://plugins.svn.wordpress.org/postali-codigos-postales/), tàbí ṣe àgbékalẹ̀ sí [àkọsílẹ̀ ìdàgbàsókè](https://plugins.trac.wordpress.org/log/postali-codigos-postales/) nípasẹ̀ [RSS](https://plugins.trac.wordpress.org/log/postali-codigos-postales/?limit=100&mode=stop_on_copy&format=rss). ## Àkọsílẹ̀ àwọn àyípadà #### 1.0.0 * First release: state, city and colonia autocompletion from the postal code in the classic checkout, the block checkout and My Account; optional server-side validation; optional credit link, off by default. ## Àkójọpọ̀ Meta * Ẹ̀yà **1.0.0** * Ìgbàgbọ́hùn tó kẹ́yìn **ọ̀sẹ̀ 1 sẹ́yìn** * Àwọn ìgbéwọlẹ̀ tó ṣiṣẹ́ **Tó kéré sí 10** * Ẹ̀yà WordPress ** 6.5 tàbí ju bẹ́ẹ̀ lọ ** * Dánwò dé **7.1.3** * Ẹ̀yà PHP ** 7.4 tàbí ju bẹ́ẹ̀ lọ ** * Èdè * [English (US)](https://wordpress.org/plugins/postali-codigos-postales/) * Àwọn àmì * [Address AutoComplete](https://yor.wordpress.org/plugins/tags/address-autocomplete/) [checkout](https://yor.wordpress.org/plugins/tags/checkout/)[mexico](https://yor.wordpress.org/plugins/tags/mexico/) [postal code](https://yor.wordpress.org/plugins/tags/postal-code/)[woocommerce](https://yor.wordpress.org/plugins/tags/woocommerce/) * [Ìwòye Tó Péye](https://yor.wordpress.org/plugins/postali-codigos-postales/advanced/) ## Àwọn ìbò Kò sí ìwádìí tí a tíì fi ránṣẹ́. [Your review](https://wordpress.org/support/plugin/postali-codigos-postales/reviews/#new-post) [Wo gbogbo àwọn àgbéyẹ̀wò](https://wordpress.org/support/plugin/postali-codigos-postales/reviews/) ## Àwọn Olùkópa * [ gomflo ](https://profiles.wordpress.org/gomflo/) ## Ìrànlọ́wọ́ Nǹkan wà tí o fẹ́ sọ? Ṣé o nílò ìrànlọ́wọ́? [Wo àpéjọ ìrànlọ́wọ́](https://wordpress.org/support/plugin/postali-codigos-postales/)