Archivos
Sube conPOST /v1/supplier/file/upload: formulario multipart, una sola parte llamada file, máx. 512 MB.
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.
email(en minúsculas y sin espacios),nameGiven,nameFamilyy un arrayrolesno vacío son requeridos. Los nombres de rol se comparan sin distinguir mayúsculas y los roles admin o super-admin se rechazan con403.- Los roles
SUPPLIER_TECHobtienen además un registro de field-tech, que es lo que hace al usuario programable en llamadas de servicio y visible en WrenchMode. - El
facilityIdde destino toma por defecto la instalación de tu clave y debe pertenecer a la misma empresa proveedora (403en 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ñadepasswordResetRequiredpara forzar un cambio en el primer inicio de sesión. - Acceso por ubicación:
hasAccessToAllLocations, olocationIds/brandIdsexplícitos (ignorados cuando el flag de todas las ubicaciones es true). - Acceso a ubicaciones de stock:
hasAccessToAllStockLocationsycanManageAllStockLocationstoman por defecto false y se fuerzan a false cuandostockLocationIdsno está vacío; los ids explícitos ganan. - Credenciales EPA 608:
epaCertificationTypese valida contra las clases reconocidas;epaCertificationNumberes formato libre.