Validar país y región o verificar una dirección postal
Un formulario de compra puede recibir CA y US-CA, o un país y una región válidos junto con un error en el nombre de la calle. Son problemas distintos. Antes de elegir un servicio, decide si necesitas comprobar la relación geográfica, buscar la dirección postal en datos de referencia o hacer ambas cosas.
Para recoger el país y la región, empieza por la guía para formularios web.
Qué necesitas
Esta guía ayuda a equipos que recogen códigos para asignar contactos, elaborar informes o preparar envíos. Para usar el widget, necesitas un proyecto de CountriesDB, una clave pública y un host permitido. Guarda la clave privada en el servidor y consulta el acceso de tu plan en la documentación de la API de validación.
Cómo elegir la comprobación
1. Recoge valores que el servidor pueda comprobar
Etiqueta los selectores y guarda los códigos por separado de los nombres visibles. Así puedes comprobar una combinación como US y US-CA y transferirla a otros sistemas.
<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>
<label for="country">País</label>
<select id="country" name="country" class="country-selection"
data-name="country" data-label="Selecciona un país" data-preselected="" required></select>
<label for="region">Estado / provincia / región</label>
<select id="region" name="region" class="subdivision-selection"
data-country="country" data-label="Selecciona una región" data-prefer-official></select>
2. Comprueba que la región pertenece al país
Valida el código de país y comprueba la región si es obligatoria o se ha incluido. Usa el endpoint de validación de subdivisiones. Indica qué campo se debe corregir y trata los fallos del servicio por separado. Esta comprobación sirve incluso sin dirección postal, por ejemplo para asignar contactos a territorios comerciales.
3. Verifica la dirección postal si hace falta
Si envías productos físicos y necesitas cotejar calle, localidad y código postal con datos de referencia, usa un servicio de verificación postal como Loqate. Decide cómo resolver resultados ambiguos o sin coincidencia y aplica también las reglas del transportista. La guía para formularios de compra explica cómo recoger los datos.
Preguntas frecuentes
¿Necesito ayuda de desarrollo?
Alguien debe conectar la validación con el procesamiento del formulario y configurar la clave privada en el servidor.
¿Y si la dirección no tiene una región aplicable?
Permite dejar el campo vacío si tus reglas lo admiten. Comprueba el valor cuando se indique y exígelo solo cuando sea necesario.
¿Basta con la comprobación en el navegador?
Comprueba los valores recibidos en el servidor antes de usarlos para asignaciones, envíos o informes.
¿Una coincidencia postal garantiza la entrega?
Indica una coincidencia con los datos de referencia del proveedor. Las restricciones del transportista y las circunstancias de la entrega siguen influyendo.