{"openapi":"3.0.0","info":{"title":"Buildum Suppliers API","version":"1.0.0","description":"API for managing vendors, contracts, ratings, and workforce requests"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Vendor":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Unique identifier for the vendor"},"organizationUuid":{"type":"string","format":"uuid","description":"UUID of the organization that owns this vendor"},"name":{"type":"string","description":"Name of the vendor company"},"code":{"type":"string","description":"Optional vendor code or identifier"},"description":{"type":"string","description":"Description of the vendor"},"businessType":{"type":"string","enum":["individual","company"],"description":"Type of business entity"},"registeredAddress":{"type":"string","description":"Registered address of the vendor"},"registeredCity":{"type":"string","description":"City of the registered address"},"registeredPostalCode":{"type":"string","description":"Postal code of the registered address"},"registeredCountry":{"type":"string","description":"Country of the registered address"},"registeredLatitude":{"type":"number","format":"float","description":"Latitude of the registered address"},"registeredLongitude":{"type":"number","format":"float","description":"Longitude of the registered address"},"contactEmail":{"type":"string","format":"email","description":"Primary contact email"},"contactPhone":{"type":"string","description":"Primary contact phone number"},"website":{"type":"string","format":"uri","description":"Vendor website URL"},"taxId":{"type":"string","description":"Tax identification number"},"registrationNumber":{"type":"string","description":"Company registration number"},"status":{"type":"string","enum":["active","inactive","suspended","blacklisted"],"description":"Current status of the vendor"},"notes":{"type":"string","description":"Additional notes about the vendor"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the vendor was created"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the vendor was last updated"}},"required":["id","organizationUuid","name","businessType","status"]},"VendorCreate":{"type":"object","properties":{"organizationUuid":{"type":"string","format":"uuid","description":"UUID of the organization that owns this vendor"},"name":{"type":"string","description":"Name of the vendor company"},"code":{"type":"string","description":"Optional vendor code or identifier"},"description":{"type":"string","description":"Description of the vendor"},"businessType":{"type":"string","enum":["individual","company"],"description":"Type of business entity"},"registeredAddress":{"type":"string","description":"Registered address of the vendor"},"registeredCity":{"type":"string","description":"City of the registered address"},"registeredPostalCode":{"type":"string","description":"Postal code of the registered address"},"registeredCountry":{"type":"string","description":"Country of the registered address"},"registeredLatitude":{"type":"number","format":"float","description":"Latitude of the registered address"},"registeredLongitude":{"type":"number","format":"float","description":"Longitude of the registered address"},"contactEmail":{"type":"string","format":"email","description":"Primary contact email"},"contactPhone":{"type":"string","description":"Primary contact phone number"},"website":{"type":"string","format":"uri","description":"Vendor website URL"},"taxId":{"type":"string","description":"Tax identification number"},"registrationNumber":{"type":"string","description":"Company registration number"},"status":{"type":"string","enum":["active","inactive","suspended","blacklisted"],"description":"Current status of the vendor"},"notes":{"type":"string","description":"Additional notes about the vendor"}},"required":["organizationUuid","name","businessType"]},"Error":{"type":"object","properties":{"error":{"type":"string","description":"Error message"}}}}},"paths":{},"tags":[],"servers":[{"url":"https://flowos.scrumdesk.com/api/suppliers","description":"Production (third parties — use in Postman)"},{"url":"http://localhost:3004/api/suppliers","description":"Local module backend (direct on module port)"}]}