Configuración técnica e integraciones

Referencia breve para administradores, integradores y equipos de TI. Describe ámbitos y comportamientos de configuración sin incluir secretos ni credenciales.

1. Tres ámbitos que conviene distinguir

• Sistema global: configuración y soporte de la plataforma, planes, funciones globales y administración de la instancia.
• Empresa: datos fiscales, reglas de alta, unidades NTS, opciones de notificación, aislamiento y, para el plan A medida, marca corporativa.
• Usuario: permisos de acceso a DeCA y catálogos, valores predeterminados, columnas del listado, preferencia de alta rápida y opciones personales autorizadas.

Un ajuste global o de empresa no debe confundirse con el permiso de acceso de un usuario. Las limitaciones por empresa y transportista son independientes; la restricción de “solo propios” añade un filtro por autoría.

2. Precedencia y alta de DeCA

Para el cargador y el transportista efectivo, la empresa puede controlar si se muestra el panel de selección y si se propone la propia empresa. El usuario puede tener valores predeterminados propios; cuando los tiene, prevalecen sobre los de empresa. Si se oculta un panel sin un valor asignado, se debe probar el alta para confirmar que existe un valor suficiente para el escenario de uso.

La empresa también configura si se solicita conductor, opciones del formulario (cuando estén habilitadas), y si los viajes pasados se marcan como terminados. La configuración individual del formulario depende de que el administrador habilite esa posibilidad.

3. Usuarios, autorización y datos compartidos

Las empresas nuevas arrancan con aislamiento de DeCA y catálogos. Los usuarios nuevos ven inicialmente solo sus propios DeCA y fichas, sin acceso a catálogos ajenos. El administrador puede conceder por separado acceso a cargadores y transportistas, vehículos, chóferes, lugares y mercancías. La migración no modifica los permisos guardados de cuentas existentes.

Las columnas visibles son preferencias de presentación; no sustituyen controles de autorización. En CSV y API, un usuario nuevo queda en “solo propios” salvo que se indiquen otros permisos. Al actualizar un usuario por API, omitir esos campos conserva sus permisos actuales. Las API individuales actúan con los permisos del usuario; la clave general de empresa tiene ámbito de administrador y no debe entregarse a usuarios aislados.

4. API NTS y automatización

Las unidades de medida pueden configurarse por empresa, incluyendo equivalencias a kg cuando corresponda. El administrador decide si la API NTS valida las unidades recibidas. La API debe seguir recibiendo las propiedades y formatos documentados en la documentación técnica vigente; las reglas de negocio nuevas no deben romper clientes existentes.

Para Excel, Power Automate u otra integración, guarda la clave API como secreto del conector y envía JSON válido con los nombres de campo y tipos documentados. No incluyas delimitadores de Markdown como ```json dentro del cuerpo HTTP. Comprueba respuestas de error y usa un identificador externo estable, respetando su longitud máxima documentada.

5. Entrada por correo

La entrada por correo requiere configurar un identificador único de empresa/usuario y utilizar la plantilla de correo documentada. Se analizan los mensajes relacionados con altas, se notifica el resultado y se aplica la política de procesado de correo configurada. No se deben reenviar automáticamente las notificaciones a la propia dirección de entrada, para evitar bucles.

Al enviar un DeCA por correo pueden participar el remitente, el correo adicional indicado para notificación y el correo del chófer, si existe y está habilitado. Las notificaciones de éxito pueden incluir QR; evita respuestas automáticas innecesarias y protege la reputación del dominio remitente.

6. Firma de recepción

Hay que separar dos funciones: las zonas de firma que se imprimen en el PDF y el enlace electrónico para firmar la recepción. La empresa puede activar el segundo enlace para todos; solo si permite configuración individual puede activarlo un usuario para sí mismo. No representa permisos de edición del DeCA.

7. Personalización y planes

El plan A medida incluye controles para logotipo, nombre del producto, colores, fondos, textos, información de soporte, ocultación de textos en el acceso y la fuente Montserrat. No equivale a publicar el sistema en un dominio del cliente ni a entregar una instancia o código independiente; esos alcances se deben acordar aparte.

Los límites de usuarios y módulos se rigen por el plan y por el límite asignado a la empresa. Antes de una puesta en producción, revisa la licencia y los módulos efectivamente habilitados para esa cuenta.

Los nombres de las opciones pueden variar ligeramente según el idioma o la versión. La documentación API publicada para la cuenta es la referencia para esquemas y contratos de integración.