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, catálogos compartidos y, para el plan A medida, marca corporativa.
- Usuario: permisos de acceso a DeCA, valores predeterminados, columnas del listado, preferencia de alta rápida, ámbito de chóferes y opciones personales de firma.
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
La administración de usuarios define acceso a todos los DeCA o a un conjunto permitido de empresas y transportistas, y permite limitar la consulta a los propios. Las columnas visibles son preferencias de presentación; no sustituyen controles de autorización. Un filtro visual nunca debe considerarse una barrera de seguridad.
El ajuste de compartir chóferes determina el ámbito de las fichas que puede usar el usuario. Las API individuales siguen siendo compatibles con el modelo vigente: cada integración debe operar con las credenciales y permisos del usuario al que corresponde, y no debe suponer acceso automático a datos de otras cuentas.
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. El segundo enlace se añade al compartir solo si la empresa permite la función y el usuario la activa. 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.