Countries API - CountriesDB

Campos de país y provincia para formularios de dirección y compra

Configura campos de país y región para direcciones internacionales y comprueba qué valores recibe tu tienda antes de calcular el envío.

Campos de país y provincia para formularios de dirección y compra

Un cliente cambia el destino del pedido de Estados Unidos a Canadá. Si California sigue seleccionada o el formulario sigue pidiendo un código postal estadounidense, el cliente tendrá que corregirlo. Usa el país para determinar las opciones de región y las reglas que se aplican al resto de la dirección.

La guía para formularios web explica el fragmento común, la clave pública y los dominios permitidos.


Qué necesitas

Usa un formulario de dirección o de compra cuyos campos y envíos puedas controlar. Crea un proyecto de CountriesDB con una clave pública y autoriza el host del formulario. Define los países a los que envías pedidos y cuáles requieren una región.


Cómo preparar los campos de dirección

1. Pide el país primero

Coloca el país antes de la región, la localidad y el código postal. Usa nombres e identificadores propios para los campos de envío si también recoges una dirección de facturación. Deja la región como opcional en el HTML y aplica la obligatoriedad que corresponda a cada destino.

<script src="https://unpkg.com/@countriesdb/widget@latest/dist/index.js?public_key=YOUR_PUBLIC_KEY"></script>

<label for="shipping-country">País</label>
<select id="shipping-country" name="shipping_country" class="country-selection"
        data-name="shipping-country" data-label="Selecciona un país" data-preselected="" required></select>

<label for="shipping-region">Estado / provincia / región</label>
<select id="shipping-region" name="shipping_region" class="subdivision-selection"
        data-country="shipping-country" data-label="Selecciona una región" data-prefer-official></select>

2. Vuelve a calcular cuando cambie el destino

Borra la región anterior al cambiar de país y actualiza las opciones de envío, los costes o los impuestos que dependan del destino. Ajusta los países disponibles con las opciones de filtrado del widget y aplica las restricciones de envío también en el servidor.

3. Revisa lo que recibe el servidor

Envía dos pedidos de prueba con distintos países y regiones. Comprueba que el servidor recibe los códigos previstos, como US y US-CA en una configuración ISO, y rechaza una región de otro país. Prueba también un país en el que la región pueda quedar vacía. Consulta la guía de validación para decidir si también necesitas verificar la dirección postal.


Preguntas frecuentes

¿Necesito ayuda de desarrollo?
En la mayoría de las tiendas, alguien debe conectar los campos con las direcciones guardadas, las opciones de envío y las reglas del servidor.

¿La provincia debe ser siempre obligatoria?
Depende del destino. Un campo obligatorio para todos los países puede impedir el uso de direcciones válidas.

¿Puedo reutilizar los identificadores para facturación?
Usa otros identificadores y nombres de campo. Si ambos pares aparecen en una misma página, configura y prueba varias instancias con ayuda de la documentación del widget.

¿Un país y una región válidos garantizan la entrega?
Confirman la relación geográfica. La comprobación de la dirección postal y las restricciones del transportista se aplican por separado.


Enlaces


Guías relacionadas