{"openapi":"3.0.0","paths":{"/business-partners":{"get":{"operationId":"findAll","parameters":[{"name":"role","required":false,"in":"query","schema":{"type":"string","enum":["SUPPLIER","MANUFACTURER"]}},{"name":"isActive","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["Active","Passive","Expired","Discontinued","Replaced","Deleted"]}},{"name":"gln","required":false,"in":"query","schema":{"pattern":"^\\d{13}$","type":"string"}},{"name":"pageSize","required":false,"in":"query","schema":{"minimum":1,"maximum":200,"default":50,"type":"number"}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListBusinessPartnersResponseDto"}}}},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"List business partners with optional filters.","tags":["BusinessPartners"],"x-permissions":["bpa.business-partner.read"]}},"/business-partners/{businessPartnerId}":{"get":{"operationId":"findById","parameters":[{"name":"businessPartnerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessPartnerResponseDto"}}}},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"404":{"description":""},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Get a business partner by ID.","tags":["BusinessPartners"],"x-permissions":["bpa.business-partner.read"]},"put":{"operationId":"upsert","parameters":[{"name":"businessPartnerId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessPartnerDto"}}}},"responses":{"202":{"description":""},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Create or replace a business partner.","tags":["BusinessPartners"],"x-permissions":["bpa.business-partner.write"]},"delete":{"operationId":"delete","parameters":[{"name":"businessPartnerId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"202":{"description":""},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"404":{"description":""},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Delete a business partner.","tags":["BusinessPartners"],"x-permissions":["bpa.business-partner.write"]}},"/warehouse-supply-terms/{businessUnitId}":{"get":{"operationId":"getWarehouseSupplyTerms","parameters":[{"name":"businessUnitId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseSupplyTermsResponseDto"}}}},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"404":{"description":""},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Get warehouse supply terms for a business unit.","tags":["WarehouseSupplyTerms"],"x-permissions":["bpa.business-partner.read"]},"put":{"operationId":"putWarehouseSupplyTerms","parameters":[{"name":"businessUnitId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WarehouseSupplyTermsDto"}}}},"responses":{"202":{"description":""},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"404":{"description":""},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Create or replace warehouse supply terms for a business unit.","tags":["WarehouseSupplyTerms"],"x-permissions":["bpa.business-partner.write"]},"delete":{"operationId":"deleteWarehouseSupplyTerms","parameters":[{"name":"businessUnitId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"202":{"description":""},"400":{"description":"Invalid params","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestDto"}}}},"403":{"description":"Unauthorized"},"404":{"description":""},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorDto"}}}}},"security":[{"access-token":[]}],"summary":"Delete warehouse supply terms for a business unit.","tags":["WarehouseSupplyTerms"],"x-permissions":["bpa.business-partner.write"]}}},"info":{"title":"Business partner API","description":"Business partner API docs <br><br> <a href=\"/schemas/v1/openapi.json\">OpenAPI Document (json)</a>","version":"1.0","contact":{},"license":{"name":"UNLICENSED","url":"UNLICENSED"}},"tags":[],"servers":[{"url":"https://business-partner-api.retailsvc.com/api/v1"}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"JWT Authorization header using the Bearer scheme."}},"schemas":{"BadRequestDto":{"type":"object","properties":{"statusCode":{"type":"number","enum":[400]},"message":{"type":"array","items":{"type":"string"}},"error":{"type":"string","enum":["Bad Request"]}},"required":["statusCode","message","error"]},"InternalServerErrorDto":{"type":"object","properties":{"statusCode":{"type":"number","enum":[500]},"message":{"type":"string","enum":["Internal Server Error"]}},"required":["statusCode","message"]},"RoleResponseDto":{"type":"object","properties":{"role":{"type":"string","enum":["SUPPLIER","MANUFACTURER"]},"isActive":{"type":"boolean"},"defaultLeadTimeHours":{"type":"number","nullable":true},"minimumOrderQuantity":{"type":"number","nullable":true},"reliabilityScore":{"type":"number","nullable":true}},"required":["role","isActive"]},"AddressResponseDto":{"type":"object","properties":{"addressType":{"type":"string","enum":["Visit","Postal","Delivery","Invoice"]},"careOf":{"type":"string","nullable":true},"street":{"type":"string","nullable":true},"zipCode":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"county":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"countryCode":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"mobile":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"contactPerson":{"type":"string","nullable":true}},"required":["addressType"]},"DataType":{"type":"string","enum":["BOOL","INT","LONG","DECIMAL","DOUBLE","STRING","DATE","DATETIME","CURRENCY","IMAGE","BINARY","LINK","ARRAY","JSON","XML","UNKNOWN"]},"AdditionalPropertyDto":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"dataType":{"allOf":[{"$ref":"#/components/schemas/DataType"}]},"value":{"type":"string","nullable":true}},"required":["id","name","dataType","value"]},"BusinessPartnerResponseDto":{"type":"object","properties":{"businessPartnerId":{"type":"string"},"displayId":{"type":"string","nullable":true},"status":{"type":"string","enum":["Active","Passive","Expired","Discontinued","Replaced","Deleted"]},"name":{"type":"string"},"description":{"type":"string","nullable":true},"legalName":{"type":"string","nullable":true},"vatNumber":{"type":"string","nullable":true},"gln":{"type":"string","nullable":true},"roles":{"type":"array","items":{"$ref":"#/components/schemas/RoleResponseDto"}},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/AddressResponseDto"}},"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/AdditionalPropertyDto"}},"modifiedDatetime":{"type":"string"}},"required":["businessPartnerId","status","name","roles","addresses","additionalProperties","modifiedDatetime"]},"ListBusinessPartnersResponseDto":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/BusinessPartnerResponseDto"}},"nextCursor":{"type":"string"}},"required":["items"]},"BusinessPartnerStatus":{"type":"string","enum":["Active","Passive","Expired","Discontinued","Replaced","Deleted"]},"BusinessPartnerRole":{"type":"string","enum":["SUPPLIER","MANUFACTURER"]},"RoleDto":{"type":"object","properties":{"role":{"allOf":[{"$ref":"#/components/schemas/BusinessPartnerRole"}]},"isActive":{"type":"boolean"},"defaultLeadTimeHours":{"type":"integer","minimum":0,"maximum":8760,"nullable":true},"minimumOrderQuantity":{"type":"number","minimum":0,"maximum":100000000000000000000,"nullable":true},"reliabilityScore":{"type":"number","minimum":0,"maximum":1,"nullable":true}},"required":["role","isActive"]},"AddressType":{"type":"string","enum":["Visit","Postal","Delivery","Invoice"]},"AddressDto":{"type":"object","properties":{"addressType":{"allOf":[{"$ref":"#/components/schemas/AddressType"}]},"careOf":{"type":"string","nullable":true},"street":{"type":"string","nullable":true},"zipCode":{"type":"string"},"city":{"type":"string"},"county":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"countryCode":{"type":"string","maxLength":2,"nullable":true},"phone":{"type":"string","nullable":true},"mobile":{"type":"string","nullable":true},"email":{"type":"string","nullable":true},"contactPerson":{"type":"string","nullable":true}},"required":["addressType","zipCode","city"]},"BusinessPartnerDto":{"type":"object","properties":{"displayId":{"type":"string","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/BusinessPartnerStatus"}]},"name":{"type":"string"},"description":{"type":"string","nullable":true},"legalName":{"type":"string","nullable":true},"vatNumber":{"type":"string","nullable":true},"gln":{"type":"string","nullable":true},"roles":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/RoleDto"}},"addresses":{"type":"array","items":{"$ref":"#/components/schemas/AddressDto"}},"additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/AdditionalPropertyDto"}}},"required":["status","name","roles","addresses","additionalProperties"]},"WarehouseSupplyTermsResponseDto":{"type":"object","properties":{"businessUnitId":{"type":"string"},"defaultLeadTimeHours":{"type":"number","nullable":true},"minimumOrderQuantity":{"type":"number","nullable":true}},"required":["businessUnitId","defaultLeadTimeHours","minimumOrderQuantity"]},"WarehouseSupplyTermsDto":{"type":"object","properties":{"defaultLeadTimeHours":{"type":"integer","minimum":0,"maximum":8760,"nullable":true},"minimumOrderQuantity":{"type":"number","minimum":0,"maximum":100000000000000000000,"nullable":true}}}}}}