OdooWiki OCA HUB

CRM Team ZIP Assignment

crm_team_zip_assign folder_open OCA/crm open_in_new
Sin categoría Licencia: AGPL-3

Asigna automáticamente equipos de CRM a los partners según patrones de código postal utilizando expresiones regulares.

Características

  • Asignación automática de equipos de CRM a los partners según patrones de código postal
  • Compatibilidad con expresiones regulares de Python con restricciones de validación
  • Compatibilidad con múltiples compañías
  • Filtrado geográfico por países y provincias/estados
  • Asignación basada en prioridad cuando coinciden varios equipos
  • Indicador de exclusión para los partners que no deben recibir asignación automática
  • La validación en tiempo real del patrón regex evita patrones no válidos
  • Acción contextual para la asignación manual desde las vistas de partner
  • Asignación condicional mediante condiciones previas al código postal: los equipos pueden especificar una expresión de dominio (sintaxis de dominio de Odoo) que el partner debe cumplir antes de realizar la coincidencia con el regex del código postal. Esto permite filtrados avanzados; por ejemplo, asignar solo si el partner es una empresa o cumple otros criterios.

Lógica de asignación

La asignación se activa al crear/modificar un partner cuando cambian el código postal, la compañía, el país, la provincia/estado o el indicador de exclusión. También hay disponible una acción contextual desde las vistas de partner para la asignación manual. El sistema:

  • Busca todos los equipos activos con la asignación por código postal habilitada en la compañía del partner
  • Filtra los equipos por países y provincias/estados coincidentes (si se especifican)
  • Para cada equipo elegible, evalúa la condición previa al código postal opcional (expresión de dominio de Odoo). Si el partner no cumple la condición, se omite el equipo.
  • Comprueba los patrones regex de cada equipo restante contra el código postal del partner
  • Selecciona el equipo con mayor prioridad si existen varias coincidencias
  • Registra la actividad de asignación con fines de auditoría

Reglas de asignación

  • Solo se consideran los equipos activos con "Active ZIP Assignment" habilitado
  • Solo se consideran los equipos de la misma compañía que el partner
  • Los equipos deben tener países coincidentes (el país del partner debe estar entre los países del equipo)
  • Los equipos deben tener provincias/estados coincidentes (la provincia/estado del partner debe estar entre las provincias/estados del equipo, si el equipo tiene provincias/estados definidos)
  • Si un equipo tiene una condición previa al código postal, el partner debe cumplir la condición (dominio de Odoo) antes de realizar la coincidencia con el regex del código postal. Si no se establece, se consideran todos los partners.
  • Los partners sin compañía, código postal, país o provincia/estado no reciben asignación
  • Los partners con "Exclude from ZIP Assignment" marcado no reciben asignación
  • Cuando coinciden varios equipos, se selecciona el equipo con mayor prioridad
  • Los patrones regex no válidos se evitan mediante restricciones de validación en el momento de la introducción

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 16.0

Asigna automáticamente equipos de ventas de CRM a los contactos según su código postal, país y estado. Los equipos se configuran con patrones de código postal, prioridad y condiciones adicionales opcionales, y los partners pueden excluirse de la asignación automática.

Este módulo permite enrutar contactos al equipo de CRM correcto automáticamente usando su código postal. En cada equipo de CRM puede marcar 'Enable Auto ZIP Assignment' y luego definir los países y estados que cubre el equipo, uno o más patrones de ZIP (expresiones regulares como '^1[0-5].*'), una prioridad de asignación y una condición extra opcional sobre el contacto.

  • Cuando se crea un contacto o cuando se cambia su ZIP, su compañía o su indicador de exclusión, Odoo busca equipos que estén habilitados, que cubran el país y el estado del contacto y que pertenezcan a la misma compañía. Los equipos cuya condición extra no se cumpla se omiten, y el ZIP del contacto debe coincidir con uno de los patrones del equipo.
  • Si varios equipos coinciden, gana el de mayor prioridad (número más alto = mayor prioridad); los empates se resuelven por el orden del equipo.
  • Un contacto solo se procesa si tiene un ZIP, una compañía, un país, un estado y es de tipo 'contact'. Los contactos marcados con 'Exclude from ZIP Assignment' nunca se asignan automáticamente.
  • Una acción manual 'Assign CRM Team By Zip' está disponible en los contactos en las vistas de formulario y de lista para ejecutar la asignación bajo demanda.

La configuración aparece en el formulario del equipo de CRM bajo 'ZIP Auto Assignment Settings' y una pestaña 'ZIP Patterns', y en el formulario del contacto junto a las etiquetas. Los patrones se validan como expresiones regulares reales y no pueden duplicarse para el mismo equipo. Se requiere una compañía cuando la asignación automática está habilitada.

Depende de

crm
Modelos y campos (3)
  • crm.team · amplía un modelo existentestate_ids (States), country_ids (Countries), zip_regex_ids (ZIP Regex), pre_zip_match_condition (Pre-Zip Match Condition), zip_assignment_priority (Assignment Priority), enable_zip_auto_assignment (Enable Auto ZIP Assignment)
  • res.partner · amplía un modelo existenteexclude_from_zip_assign (Exclude from ZIP Assignment)
  • crm.team.zip.pattern · modelo nuevoname, pattern (ZIP Pattern), team_id (CRM Team)

Texto generado por IA (DeepSeek) al leer el código de la versión 16.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 16.0

Uso

Fuente · Odoo 16.0

Configuración de equipos CRM

  • Vaya a CRM → Configuración → Equipos de ventas
  • Edite o cree un equipo CRM
  • Active la casilla "Asignación activa por ZIP"
  • Establezca la "Prioridad de asignación por ZIP" (número más alto = mayor prioridad)
  • Configure la cobertura geográfica:
  • Seleccione los "Países" donde opera este equipo (obligatorio)
  • Seleccione los "Estados" dentro de esos países (obligatorio)
  • Añada patrones ZIP en la pestaña "Patrones ZIP"
  • (Opcional) Establezca una "Condición previa a la coincidencia por ZIP" usando la sintaxis de dominio de Odoo para restringir la asignación a contactos que cumplan criterios específicos (p. ej., solo empresas, solo ciertos tipos, etc.)

Cobertura geográfica

- **Countries**: Teams will only be considered for partners located in the selected countries
- **States**: Teams will only be considered for partners in the selected states
- **Domain Filtering**: State selection is automatically filtered based on selected countries

Pre-Zip Match Condition

Puede restringir aún más la asignación de equipos especificando una condición de dominio en el campo "Condición previa a la coincidencia por ZIP". Esta utiliza la sintaxis de dominio de Odoo (p. ej., [('is_company', '=', True)]). Solo los contactos que cumplan esta condición se tendrán en cuenta para la coincidencia de patrones ZIP de este equipo.

Ejemplos de condición previa a la coincidencia por ZIP

Some example domain conditions:

- `[('is_company', '=', True)]` — Only assign to partners that are companies
- `[('type', '=', 'contact')]` — Only assign to contacts
- `[('industry_id', '!=', False)]` — Only assign to partners with an industry set

You can combine multiple conditions, e.g. `[('is_company', '=', True), ('country_id', '=', ref('base.us'))]`

ZIP Pattern Examples

Todos los patrones se validan en tiempo real para garantizar que sean expresiones regulares de Python válidas:

  • ^1[0-5].* - Códigos ZIP que empiezan por 10-15
  • ^2[0-9].* - Códigos ZIP que empiezan por 20-29
  • ^751.* - Códigos ZIP que empiezan por 751
  • .*123$ - Códigos ZIP que terminan en 123
  • ^[1-3].* - Códigos ZIP que empiezan por 1, 2 o 3
  • ^(10|20|30).* - Códigos ZIP que empiezan por 10, 20 o 30

Validación de patrones

The system validates regex patterns when they are entered:

- Invalid patterns will show an error message immediately
- Error messages include the specific regex error for debugging
- Only valid patterns can be saved to the database

Partner Configuration
---------------------

Partners have an "Exclude from ZIP Assignment" checkbox to prevent automatic assignment.

Teams can have a "Pre-Zip Match Condition" to restrict assignment to partners matching specific criteria before ZIP pattern matching is performed.

Usage
-----

Automatic Assignment

Los contactos se asignan automáticamente a los equipos CRM cuando:

  • Se crea un contacto con información geográfica completa (ZIP, país, estado)
  • Se modifica el código ZIP de un contacto
  • Se cambia el país o el estado de un contacto
  • Se cambia la empresa de un contacto
  • Se modifica la marca de exclusión

Para cada equipo, si se establece una "Condición previa a la coincidencia por ZIP", el contacto debe cumplir esta condición antes de que se realice la coincidencia de patrones ZIP. Si no se establece, todos los contactos se tienen en cuenta para la coincidencia ZIP.

Asignación manual

You can also trigger assignment manually:

- Use the contextual action available in partner views
- This is useful for reassigning existing partners after updating team configurations or after addon installation

Assignment Requirements

Para que funcione la asignación automática, los contactos deben tener:

  • Un código ZIP
  • Un país
  • Un estado
  • Una empresa
  • "Excluir de la asignación por ZIP" debe estar desmarcado

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.