Support / Soporte
English version
1. How to contact us
Our primary support channel is WhatsApp Business — it is the fastest and most direct way to reach us. We reply within 24 hours on business days, in Spanish or English.
For specific scenarios, use these pre-filled WhatsApp templates:
- Report a bug (pre-filled template) — please include: store domain, checkout URL, browser, steps to reproduce, screenshot.
- Request a feature
Formal / legal contact: for legal matters or formal correspondence you can also write to support@forasterodev.com. Note: response is slower than WhatsApp — please use WhatsApp for day-to-day app support.
2. Installation and setup
- Install the App from the Shopify App Store into your store.
- Open Apps → Validador Ciudades Colombia from your Shopify admin to access the configuration panel.
- Configure which validations to enable (city, coverage, national ID) and the custom messages the buyer will see. Click Save.
- Open Settings → Checkout → Customize in your Shopify admin.
- In the Delivery address section, click Add block and select Validador Ciudades Colombia.
- Place the block after the shipping address form, then click Save.
- Test the validation by starting a checkout with a Colombian address.
3. Frequently asked questions
What Shopify plans does the App work on?
The App requires Shopify Plus. This is due to a Shopify restriction: checkout UI extensions at the information step (where the buyer enters address, city, and ID) are only available to stores on a Shopify Plus plan. On lower-tier plans the extension does not render, so city, coverage and cédula / NIT validation will not be active. The block_progress capability used by the App is also Plus-only.
Does the App work on all Shopify checkouts?
The App uses a Shopify Checkout UI extension, which is available on checkouts powered by Checkout Extensibility. Legacy checkout.liquid checkouts are not supported — Shopify has deprecated them.
Which data does the App read at checkout?
Only three fields: the city, the province / department, and the "Company" field (commonly used in Colombia for the national ID or NIT). Nothing else. No buyer data is stored, logged, or transmitted. See the Privacy Policy for full details.
How do I configure the cities I deliver to?
In the admin panel, open the Coverage tab. You will see all Colombian cities grouped by department, each with a checkbox. Check only the cities where you deliver, then click Save. At checkout, buyers in cities you did not select will see a "no coverage" message.
Does the App validate the NIT check digit?
Yes. The App validates both the format (6 to 10 digits for a cédula, longer for a NIT with verification digit) and, for NIT, the check digit according to the DIAN algorithm. A special exception is supported for the sequence of 2's (9 to 12 digits) used by DIAN for individuals without a national ID.
Can I customize the messages the buyer sees?
Yes. From the admin panel you can edit every message shown in the checkout banner: empty city, invalid city, no coverage, pending department, pending ID, invalid ID.
In what languages does the App work?
The admin panel and the messages shown to buyers are in Spanish. Custom messages can be written in any language you prefer.
Does the App store data about my buyers?
No. The validation runs entirely in the buyer's browser. Nothing is sent to our servers. Only merchant-level configuration is stored in our database. See the Privacy Policy.
How do I uninstall the App?
From your Shopify admin, open Apps, find Validador Ciudades Colombia and click Uninstall. All merchant data is deleted immediately, and any residual data is deleted 48 hours later via Shopify's shop/redact webhook.
4. Useful links
Versión en español
1. Cómo contactarnos
Nuestro canal principal de soporte es WhatsApp Business — es la forma más rápida y directa de comunicarte con nosotros. Respondemos en 24 horas hábiles, en español o inglés.
Para escenarios específicos, usa estas plantillas pre-llenadas en WhatsApp:
- Reportar un bug (plantilla pre-llenada) — por favor incluye: dominio de la tienda, URL del checkout, navegador, pasos para reproducir, captura de pantalla.
- Solicitar una funcionalidad
Contacto formal / legal: para asuntos legales o correspondencia formal también puedes escribirnos a support@forasterodev.com. Nota: la respuesta es más lenta que por WhatsApp — usa WhatsApp para soporte del día a día.
2. Instalación y configuración
- Instala la Aplicación desde el Shopify App Store en tu tienda.
- Abre Apps → Validador Ciudades Colombia desde el admin de Shopify para acceder al panel de configuración.
- Configura qué validaciones activar (ciudad, cobertura, documento) y los mensajes personalizados que verá el comprador. Haz clic en Guardar.
- Abre Configuración → Checkout → Personalizar en tu admin de Shopify.
- En la sección Dirección de entrega, haz clic en Agregar bloque y selecciona Validador Ciudades Colombia.
- Posiciona el bloque después del formulario de dirección, y haz clic en Guardar.
- Prueba la validación iniciando un checkout con una dirección colombiana.
3. Preguntas frecuentes
¿En qué planes de Shopify funciona la Aplicación?
La Aplicación requiere Shopify Plus. Esto se debe a una restricción de Shopify: las extensiones de Checkout UI en el paso de información (donde el comprador ingresa dirección, ciudad y datos de identificación) están disponibles únicamente para tiendas con plan Plus. En planes inferiores la extensión no se renderiza, por lo que la validación de ciudad, cobertura y cédula / NIT no estará activa. La capacidad block_progress que usa la Aplicación también es exclusiva de Plus.
¿La Aplicación funciona en todos los checkouts de Shopify?
La Aplicación usa una extensión de Checkout UI, que está disponible en checkouts con Checkout Extensibility. Los checkouts antiguos basados en checkout.liquid no son soportados — Shopify los ha descontinuado.
¿Qué datos lee la Aplicación en el checkout?
Solo tres campos: la ciudad, el departamento y el campo "Empresa" (usado en Colombia para la cédula o NIT). Nada más. No se almacenan, registran ni transmiten datos del comprador. Consulta la Política de Privacidad para los detalles.
¿Cómo configuro las ciudades a las que hago entregas?
En el panel admin, abre la pestaña Cobertura. Verás todas las ciudades de Colombia agrupadas por departamento, cada una con un checkbox. Marca solo las ciudades donde realizas entregas y haz clic en Guardar. En el checkout, los compradores en ciudades no seleccionadas verán un mensaje de "sin cobertura".
¿La Aplicación valida el dígito verificador del NIT?
Sí. La Aplicación valida tanto el formato (6 a 10 dígitos para cédula, más largos para NIT con dígito de verificación) como, en el caso del NIT, el dígito verificador según el algoritmo de la DIAN. Se soporta la excepción para la secuencia de doses (9 a 12 dígitos) que usa la DIAN para personas sin identificación.
¿Puedo personalizar los mensajes que ve el comprador?
Sí. Desde el panel admin puedes editar cada mensaje mostrado en el banner del checkout: ciudad vacía, ciudad inválida, sin cobertura, departamento pendiente, documento pendiente, documento inválido.
¿En qué idiomas funciona la Aplicación?
El panel admin y los mensajes por defecto están en español. Los mensajes personalizados pueden escribirse en el idioma que prefieras.
¿La Aplicación guarda datos de mis compradores?
No. La validación corre completamente en el navegador del comprador. Nada se envía a nuestros servidores. Solo se almacena la configuración a nivel del comerciante en nuestra base de datos. Consulta la Política de Privacidad.
¿Cómo desinstalo la Aplicación?
Desde el admin de Shopify, abre Apps, busca Validador Ciudades Colombia y haz clic en Desinstalar. Todos los datos del comerciante se eliminan de inmediato, y cualquier dato residual se elimina 48 horas después mediante el webhook shop/redact de Shopify.