Validar un código postal

El problema de que 'se vea bien'

Los sistemas postales no están estandarizados. Un ZIP de Estados Unidos tiene cinco dígitos, a veces nueve con un guion. Un código canadiense alterna letras y números. Un código postal del Reino Unido tiene una longitud que varía por región y un formato que confunde incluso a quienes lo usan a diario. Cuando un formulario de pago o de registro acepta cualquier texto sin validar, una parte considerable de las direcciones terminan siendo imposibles de enrutar, y alguien tiene que corregirlas a mano después. Este endpoint existe para detectar ese error antes de que se convierta en un ticket de soporte.

Qué revisa realmente el endpoint

Se envía un código postal y un identificador de país a POST /verify/postal-code. La tarea valida el texto contra el patrón estructural que usa la autoridad postal de ese país: cantidad de dígitos, posición de letras, separadores y rangos reservados conocidos cuando aplica. Confirma que el código tiene el formato correcto para ese país; no confirma que corresponda a una zona de entrega real y actualmente asignada, porque los límites postales cambian y esos datos no son algo que inventemos o adivinemos.

Un poco de historia que casi nadie recuerda

Los códigos postales son más recientes de lo que la mayoría piensa. Alemania introdujo un sistema numérico en los años cuarenta, Estados Unidos lanzó los ZIP codes en 1963, y los códigos alfanuméricos del Reino Unido se implementaron gradualmente durante los años setenta y ochenta. Como cada país construyó su sistema de forma independiente, para resolver problemas locales de clasificación con infraestructura local, no existe un patrón universal. Por eso mismo, validar el formato requiere un conjunto de reglas mantenido país por país, y no una única expresión regular escrita una vez y olvidada.

Dónde encaja en su flujo de trabajo

Puede invocarlo en línea durante el checkout o el registro para recibir retroalimentación inmediata, o correrlo en lote contra una base de datos existente de clientes o envíos para marcar los registros que merecen una segunda revisión. Como cada tarea es asíncrona, encola la solicitud, mantiene su formulario ágil, y recibe el resultado mediante un webhook firmado o un enlace firmado válido por 24 horas. Nada aquí le obliga a añadir geocodificación o autocompletado de direcciones a un simple paso de validación.

Lo que no es

Esto es un verificador de formato, no una suite completa de verificación de direcciones. No le dirá si una calle existe ni si un mensajero entrega ahí. Usado para lo que es, es un filtro barato, rápido y preciso que elimina una gran parte de los registros claramente rotos antes de que le cuesten una entrega fallida o una factura rebotada.