Saltar al contenido principal
Dos superficies de apoyo que la mayoría de las integraciones de proveedor necesita: el almacén de archivos detrás de cada campo de adjuntos, y el aprovisionamiento programático de usuarios para dar de alta a técnicos. Todos los ejemplos asumen:

Archivos

Sube con POST /v1/supplier/file/upload: formulario multipart, una sola parte llamada file, máx. 512 MB.
La respuesta (envoltura tipo FileManager) es un registro FileDetails: { "fileName": "before.jpg", "fileId": "a1b2c3d4e5" }. Los caracteres no ASCII se eliminan del nombre de archivo; un fallo de almacenamiento devuelve 500. Usa el objeto devuelto tal cual en los campos de adjuntos: adjuntos del proveedor en órdenes de trabajo, attachments de propuestas y facturas, e imágenes de check-in/check-out. Los PDFs de factura tienen su propio endpoint de subir-y-publicar. Descarga con GET /v1/supplier/file/download/{id}/{name}, que transmite los bytes almacenados como adjunto. {id} es el fileId; {name} es el nombre de archivo con el que se sirve. Úsalo para extraer documentos proporcionados por el comprador desde buyerAttachments. Los fallos de descarga devuelven 400.

Aprovisionamiento de usuarios de proveedor

POST /v1/supplier/user/provision crea un contacto de proveedor bajo tu empresa, opcionalmente con un login activo. Uso típico: dar de alta técnicos desde tu sistema de RRHH.
Reglas aplicadas por el endpoint:
  • email (en minúsculas y sin espacios), nameGiven, nameFamily y un array roles no vacío son requeridos. Los nombres de rol se comparan sin distinguir mayúsculas y los roles admin o super-admin se rechazan con 403.
  • Los roles SUPPLIER_TECH obtienen además un registro de field-tech, que es lo que hace al usuario programable en llamadas de servicio y visible en WrenchMode.
  • El facilityId de destino toma por defecto la instalación de tu clave y debe pertenecer a la misma empresa proveedora (403 en caso contrario).
  • Una cuenta o contacto existente para ese correo es un conflicto 400.
  • Creación del login. Sin password, el usuario recibe un correo de invitación de registro. Con uno, la cuenta se crea activa de inmediato; añade passwordResetRequired para forzar un cambio en el primer inicio de sesión.
  • Acceso por ubicación: hasAccessToAllLocations, o locationIds/brandIds explícitos (ignorados cuando el flag de todas las ubicaciones es true).
  • Acceso a ubicaciones de stock: hasAccessToAllStockLocations y canManageAllStockLocations toman por defecto false y se fuerzan a false cuando stockLocationIds no está vacío; los ids explícitos ganan.
  • Credenciales EPA 608: epaCertificationType se valida contra las clases reconocidas; epaCertificationNumber es formato libre.
El contacto creado se devuelve en la envoltura estándar.