Ubicaciones DIAN¶
Ruta: Nómina BPS → Configuración → Catálogos → Maestros DIAN → Ubicaciones DIAN.
Para qué sirve: guardar una dirección de compañía o trabajador con los datos geográficos que necesita el documento electrónico. La ubicación combina país, departamento y municipio con sus códigos oficiales; según el uso, también requiere dirección física o idioma. Una ubicación incompleta no se puede elegir para ese propósito y el aviso Qué falta identifica el dato pendiente.
Ejemplo explicado: Prepara la ubicación de trabajo de la compañía sintética con país, departamento, municipio y dirección coherentes. Si aparece incompleta, corrige la ubicación antes de elegirla en el trabajador.
Entrada y pasos:
- Abra Nómina BPS → Configuración → Catálogos → Maestros DIAN → Ubicaciones DIAN y confirme la compañía seleccionada.
- Cree o abra una ubicación con un nombre identificable y único dentro de esa compañía. Elija país, departamento y municipio en ese orden; los selectores restringen las opciones a una geografía coherente.
- Complete Dirección DIAN para domicilio del empleador o lugar de trabajo. Complete Idioma (ISO 639-1) para el lugar de generación del XML. Añada la fuente y su fecha de verificación y guarde.
- Revise Apta como lugar de generación, Apta como domicilio o lugar de trabajo y Qué falta. Use cada ubicación solo para el propósito cuya aptitud aparece verdadera.
- Seleccione la ubicación apta en el dato de compañía o trabajador que la requiere. Si no aparece, regrese aquí, corrija los faltantes y vuelva a comprobar la aptitud; no elija una ubicación de otra compañía.
Datos que se rellenan o se revisan
| Campo | Cómo se trata | Qué comprobar |
|---|---|---|
| Nombre | Obligatorio | Etiqueta administrativa del punto (p. ej. «Sede principal» o «Planta norte»). No viaja al documento electrónico: solo sirve para elegirlo sin equivocarse. |
| Municipio / Ciudad | Obligatorio | Seleccionar la referencia correcta, no escribir un identificador inventado. |
| Departamento / Estado | Obligatorio | Seleccionar la referencia correcta, no escribir un identificador inventado. |
| Código DANE municipio | Calculado automáticamente; solo consulta | Contrastar con la fuente; no sobrescribir. |
| Apta como lugar de generación | Calculado automáticamente; solo consulta | Verdadero solo si están el país, el departamento con su código DANE, el municipio con su código DANE y el idioma. |
| Apta como domicilio o lugar de trabajo | Calculado automáticamente; solo consulta | Verdadero solo si están el país, el departamento con su código DANE, el municipio con su código DANE y la dirección física. |
| Compañía | Obligatorio | Nombre de la compañía activa; confirme que sea la compañía correcta antes de continuar. |
| Activo | Opcional; confirme si aplica | No marcar la casilla sin cumplir y demostrar su condición. |
| País | Obligatorio | País del punto. El documento lleva su código ISO 3166-1 alfa-2 (numeral 5.4.1 del anexo), que es el campo oficial de Odoo. |
| Dirección DIAN | Según el uso | Dirección física del punto. Es necesaria para que la ubicación sea apta como domicilio del empleador o lugar de trabajo; no se requiere para una ubicación usada solo para generar el XML. |
| Idioma (ISO 639-1) | Según el uso | Código ISO 639-1 de dos letras minúsculas. Es necesario para que la ubicación sea apta como lugar de generación del XML. No se completa automáticamente. |
| Código país | Calculado automáticamente; solo consulta | Código ISO 3166-1 alfa-2 del campo oficial de Odoo. |
| Código DANE departamento | Calculado automáticamente; solo consulta | Contrastar con la fuente; no sobrescribir. |
| Qué falta | Calculado automáticamente; solo consulta | Lista exacta de los atributos que faltan y dónde cargarlos. |
| Fuente verificada el | Obligatorio | Fecha coherente con el hecho o vigencia del registro. |
| Fuente | Obligatorio | Referencia verificable del dato (certificado de existencia, acta, contrato, comunicación oficial). No es la fuente del código DANE: esa vive en el departamento y el municipio. |
Acciones disponibles: el Administrador de Nómina puede crear y editar ubicaciones; Operador y Auditor pueden consultarlas. No se permite eliminar una ubicación: si deja de usarse, desactívela para conservar la trazabilidad de los documentos que ya la referencian.
Si algo se bloquea:
- Qué falta muestra datos geográficos → complete país, departamento y municipio coherentes, y verifique que ambos tengan código DANE.
- Departamento o municipio no corresponde → revise país y departamento primero; vuelva a seleccionar la localidad dependiente.
- Ubicación no apta para generación → complete el idioma de dos letras minúsculas y revise Apta como lugar de generación.
- Ubicación no apta como domicilio o lugar de trabajo → complete la dirección física y revise Apta como domicilio o lugar de trabajo.
- El sistema informa que el país está fuera de Colombia → detenga la selección y solicite definición al administrador del producto; el catálogo DANE de departamentos y municipios solo está definido para Colombia.
- Nombre duplicado en la compañía → use o renombre la ubicación existente tras verificar sus referencias; el nombre debe ser único por compañía.
- Ya no se utiliza → desactive el registro; no intente borrarlo.
Acceso: el menú aparece para Administrador de Nómina, Operador de nómina y Auditor de nómina. El Administrador puede crear y editar; Operador y Auditor solo consultan. Otros perfiles no deben asumir que podrán abrir esta opción por tener acceso a datos de compañía en otra pantalla. La compañía activa limita los registros disponibles.
Pantallas observadas con una compañía ficticia: la lista está vacía y Nuevo abre el formulario. El aviso inicial explica por qué una ubicación sin país, departamento, municipio, dirección e idioma todavía no sirve para los usos indicados. No se guardó una dirección de demostración ni se presentó como fuente verificada.



