{ "openapi": "3.0.3", "info": { "title": "NEXX Proxy API", "version": "1.7.0", "description": "NEXX Release 1 backend API contract." }, "paths": { "/api/auth/login/": { "post": { "operationId": "auth_login_create", "tags": [ "auth" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" }, "examples": { "InvalidCredentials": { "value": { "code": "invalid_credentials", "detail": "Email or password is invalid." }, "summary": "Invalid credentials" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/LoginRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthSessionResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidCredentials": { "value": { "code": "invalid_credentials", "detail": "Email or password is invalid." }, "summary": "Invalid credentials" } } } }, "description": "" } } } }, "/api/auth/logout/": { "post": { "operationId": "auth_logout_create", "tags": [ "auth" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthSessionResponse" } } }, "description": "" } } } }, "/api/auth/session/": { "get": { "operationId": "auth_session_retrieve", "tags": [ "auth" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthSessionResponse" } } }, "description": "" } } } }, "/api/auth/token/": { "post": { "operationId": "auth_token_create", "tags": [ "auth" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" }, "examples": { "InvalidCredentials": { "value": { "code": "invalid_credentials", "detail": "Email or password is invalid." }, "summary": "Invalid credentials" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/LoginRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidCredentials": { "value": { "code": "invalid_credentials", "detail": "Email or password is invalid." }, "summary": "Invalid credentials" } } } }, "description": "" } } } }, "/api/auth/token/logout/": { "post": { "operationId": "auth_token_logout_create", "tags": [ "auth" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" }, "examples": { "InvalidRefreshToken": { "value": { "code": "invalid_refresh_token", "detail": "Refresh token is invalid or expired." }, "summary": "Invalid refresh token" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenLogoutResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidRefreshToken": { "value": { "code": "invalid_refresh_token", "detail": "Refresh token is invalid or expired." }, "summary": "Invalid refresh token" } } } }, "description": "" } } } }, "/api/auth/token/me/": { "get": { "operationId": "auth_token_me_retrieve", "tags": [ "auth" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthSessionResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidAccessToken": { "value": { "code": "invalid_access_token", "detail": "Access token is invalid or expired." }, "summary": "Invalid access token" } } } }, "description": "" } } } }, "/api/auth/token/refresh/": { "post": { "operationId": "auth_token_refresh_create", "tags": [ "auth" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" }, "examples": { "InvalidRefreshToken": { "value": { "code": "invalid_refresh_token", "detail": "Refresh token is invalid or expired." }, "summary": "Invalid refresh token" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/RefreshTokenRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "InvalidRefreshToken": { "value": { "code": "invalid_refresh_token", "detail": "Refresh token is invalid or expired." }, "summary": "Invalid refresh token" } } } }, "description": "" } } } }, "/api/cart/": { "get": { "operationId": "cart_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "cart" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CartResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/cart/lines/": { "post": { "operationId": "cart_line_upsert", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "cart" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CartLineCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/CartLineCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/CartLineCreateRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CartLineResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CartLineResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/cart/lines/{id}/": { "patch": { "operationId": "cart_line_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "cart" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedCartLineUpdateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedCartLineUpdateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedCartLineUpdateRequest" } } } }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CartLineResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } }, "delete": { "operationId": "cart_line_delete", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "cart" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "204": { "description": "No response body" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/catalog/items/": { "get": { "operationId": "catalog_item_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "query", "name": "category_id", "schema": { "type": "integer" } }, { "in": "query", "name": "q", "schema": { "type": "string" } }, { "in": "query", "name": "supplier_id", "schema": { "type": "integer" } } ], "tags": [ "catalog" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CatalogItemListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/catalog/suppliers/": { "get": { "operationId": "catalog_supplier_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "catalog" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CatalogSupplierListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/catalog/suppliers/{id}/": { "get": { "operationId": "catalog_supplier_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "catalog" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupplierCardResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/checkout/validate/": { "post": { "operationId": "checkout_validate", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "checkout" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutValidationResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/companies/active/": { "get": { "operationId": "companies_active_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "companies" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ActiveCompanyRequired": { "value": { "code": "active_company_required", "detail": "Active company context is required." }, "summary": "Active company required" } } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ActiveCompanyForbidden": { "value": { "code": "active_company_forbidden", "detail": "Active company context is not allowed." }, "summary": "Active company forbidden" } } } }, "description": "" } } }, "patch": { "operationId": "companies_active_partial_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "companies" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedCompanyPatch" }, "examples": { "ActiveCompanyRequired": { "value": { "code": "active_company_required", "detail": "Active company context is required." }, "summary": "Active company required" }, "ActiveCompanyForbidden": { "value": { "code": "active_company_forbidden", "detail": "Active company context is not allowed." }, "summary": "Active company forbidden" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedCompanyPatch" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedCompanyPatch" } } } }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompanyResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ActiveCompanyRequired": { "value": { "code": "active_company_required", "detail": "Active company context is required." }, "summary": "Active company required" } } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "ActiveCompanyForbidden": { "value": { "code": "active_company_forbidden", "detail": "Active company context is not allowed." }, "summary": "Active company forbidden" } } } }, "description": "" } } } }, "/api/companies/memberships/": { "get": { "operationId": "companies_memberships_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "companies" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } }, "post": { "operationId": "companies_memberships_create", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "companies" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/MembershipCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/MembershipCreateRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/companies/memberships/{id}/": { "patch": { "operationId": "companies_memberships_partial_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "companies" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedMembershipPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedMembershipPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedMembershipPatchRequest" } } } }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } }, "delete": { "operationId": "companies_memberships_destroy", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "companies" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MembershipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/companies/onboarding/manual/": { "post": { "operationId": "companies_onboarding_manual_create", "tags": [ "companies" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManualCompanyOnboardingRequest" }, "examples": { "CompanyAlreadyClaimed": { "value": { "code": "company_already_claimed", "detail": "Company with this registration_number is already claimed." }, "summary": "Company already claimed" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/ManualCompanyOnboardingRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/ManualCompanyOnboardingRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManualCompanyOnboardingResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManualCompanyOnboardingResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "CompanyAlreadyClaimed": { "value": { "code": "company_already_claimed", "detail": "Company with this registration_number is already claimed." }, "summary": "Company already claimed" } } } }, "description": "" } } } }, "/api/internal/v1/admin/logs/": { "get": { "operationId": "internal_v1_admin_logs_list", "parameters": [ { "in": "query", "name": "level", "schema": { "type": "string" } }, { "in": "query", "name": "limit", "schema": { "type": "integer" } }, { "in": "query", "name": "method", "schema": { "type": "string" } }, { "in": "query", "name": "offset", "schema": { "type": "integer" } }, { "in": "query", "name": "path", "schema": { "type": "string" } }, { "in": "query", "name": "since", "schema": { "type": "string" }, "description": "ISO 8601" }, { "in": "query", "name": "statusMax", "schema": { "type": "integer" } }, { "in": "query", "name": "statusMin", "schema": { "type": "integer" } } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RequestLogListResponse" } } }, "description": "" }, "401": { "description": "No response body" }, "403": { "description": "No response body" } } } }, "/api/internal/v1/auth/email/resend/": { "post": { "operationId": "internal_v1_auth_email_resend_create", "description": "Re-issue a verification email. Returns 204 regardless of whether the\nemail matches a real user, to avoid leaking account existence. Rate-limits\nrepeat requests per user.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1EmailResendRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1EmailResendRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1EmailResendRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "204": { "description": "No response body" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/auth/email/verify/": { "post": { "operationId": "internal_v1_auth_email_verify_create", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1EmailVerifyRequest" }, "examples": { "InvalidOrExpiredToken": { "value": { "error": { "code": "INVALID_OR_EXPIRED_TOKEN", "message": "Verification token is invalid, expired, or already used.", "details": {} } }, "summary": "Invalid or expired token" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1EmailVerifyRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1EmailVerifyRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TokenResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "InvalidOrExpiredToken": { "value": { "error": { "code": "INVALID_OR_EXPIRED_TOKEN", "message": "Verification token is invalid, expired, or already used.", "details": {} } }, "summary": "Invalid or expired token" } } } }, "description": "" } } } }, "/api/internal/v1/auth/invitations/{token}/": { "get": { "operationId": "internal_v1_auth_invitation_lookup", "description": "Public lookup for an outstanding MembershipInvitation. Frontend uses it\non the /auth/invite?token=... landing page to show \"you're being invited\nto Company X by Y as ROLE\" before the invitee registers.\n\nThe token itself is unguessable (32 bytes URL-safe), so making this\nendpoint AllowAny does not expose more information than the invitation\nemail already does. Returns 404 if the token is unknown, expired, or\nalready consumed.", "parameters": [ { "in": "path", "name": "token", "schema": { "type": "string" }, "required": true } ], "tags": [ "internal" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1InvitationLookupResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/auth/password/reset/confirm/": { "post": { "operationId": "internal_v1_auth_password_reset_confirm_create", "description": "Consumes a password-reset token, sets the new password, and revokes all\nactive refresh tokens for the user (forced re-login on every device).", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PasswordResetConfirmRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PasswordResetConfirmRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PasswordResetConfirmRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1AuthUserResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/auth/password/reset/request/": { "post": { "operationId": "internal_v1_auth_password_reset_request_create", "description": "Always 204 to avoid leaking account existence. If the email matches an\nactive user, a password-reset email is issued.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PasswordResetRequestRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PasswordResetRequestRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PasswordResetRequestRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "204": { "description": "No response body" } } } }, "/api/internal/v1/auth/register/": { "post": { "operationId": "internal_v1_auth_register_create", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RegisterRequest" }, "examples": { "DuplicateEmail": { "value": { "error": { "code": "USER_ALREADY_EXISTS", "message": "A user with this email already exists.", "details": {} } }, "summary": "Duplicate email" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RegisterRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RegisterRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1AuthUserResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "DuplicateEmail": { "value": { "error": { "code": "USER_ALREADY_EXISTS", "message": "A user with this email already exists.", "details": {} } }, "summary": "Duplicate email" } } } }, "description": "" } } } }, "/api/internal/v1/auth/token/": { "post": { "operationId": "internal_v1_auth_token_create", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginRequest" }, "examples": { "InvalidCredentials": { "value": { "error": { "code": "INVALID_CREDENTIALS", "message": "Email or password is invalid.", "details": {} } }, "summary": "Invalid credentials" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/LoginRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/LoginRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TokenResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "InvalidCredentials": { "value": { "error": { "code": "INVALID_CREDENTIALS", "message": "Email or password is invalid.", "details": {} } }, "summary": "Invalid credentials" } } } }, "description": "" } } } }, "/api/internal/v1/auth/token/logout/": { "post": { "operationId": "internal_v1_auth_token_logout", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" }, "examples": { "InvalidRefreshToken": { "value": { "error": { "code": "INVALID_REFRESH_TOKEN", "message": "Refresh token is invalid or expired.", "details": {} } }, "summary": "Invalid refresh token" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TokenLogoutResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "InvalidRefreshToken": { "value": { "error": { "code": "INVALID_REFRESH_TOKEN", "message": "Refresh token is invalid or expired.", "details": {} } }, "summary": "Invalid refresh token" } } } }, "description": "" } } } }, "/api/internal/v1/auth/token/me/": { "get": { "operationId": "internal_v1_auth_token_me", "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1AuthSessionResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "InvalidAccessToken": { "value": { "error": { "code": "INVALID_ACCESS_TOKEN", "message": "Access token is invalid or expired.", "details": {} } }, "summary": "Invalid access token" } } } }, "description": "" } } } }, "/api/internal/v1/auth/token/refresh/": { "post": { "operationId": "internal_v1_auth_token_refresh", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" }, "examples": { "InvalidRefreshToken": { "value": { "error": { "code": "INVALID_REFRESH_TOKEN", "message": "Refresh token is invalid or expired.", "details": {} } }, "summary": "Invalid refresh token" } } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RefreshTokenRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1TokenResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" }, "examples": { "InvalidRefreshToken": { "value": { "error": { "code": "INVALID_REFRESH_TOKEN", "message": "Refresh token is invalid or expired.", "details": {} } }, "summary": "Invalid refresh token" } } } }, "description": "" } } } }, "/api/internal/v1/cart/": { "get": { "operationId": "internal_v1_cart_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CartResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/cart/lines/": { "post": { "operationId": "internal_v1_cart_line_upsert", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CartLineCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1CartLineCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1CartLineCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CartLineResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CartLineResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/cart/lines/{id}/": { "patch": { "operationId": "internal_v1_cart_line_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1CartLineUpdateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1CartLineUpdateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1CartLineUpdateRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CartLineResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "delete": { "operationId": "internal_v1_cart_line_delete", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "204": { "description": "No response body" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/categories/": { "get": { "operationId": "internal_v1_catalog_categories_list", "description": "Per-supplier catalog category list + create.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CategoryListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_catalog_categories_create", "description": "Per-supplier catalog category list + create.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CategoryCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1CategoryCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1CategoryCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CategoryResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/categories/{id}/": { "patch": { "operationId": "internal_v1_catalog_categories_update", "description": "Per-supplier catalog category rename + delete.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1CategoryPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1CategoryPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1CategoryPatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CategoryResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "delete": { "operationId": "internal_v1_catalog_categories_delete", "description": "Per-supplier catalog category rename + delete.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "204": { "description": "No response body" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/items/": { "get": { "operationId": "internal_v1_catalog_item_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "query", "name": "area", "schema": { "type": "string" }, "description": "Filter by procurementArea key (BKG-009). Unknown key -> 400." }, { "in": "query", "name": "categoryId", "schema": { "type": "integer" } }, { "in": "query", "name": "limit", "schema": { "type": "integer" }, "description": "Page size (default 50, max 200)." }, { "in": "query", "name": "mine", "schema": { "type": "boolean" }, "description": "Supplier owner-listing (Company → My catalog): when true, lists the active supplier company's OWN catalog items including inactive ones, with prices always visible and no buyer context required. Requires supplier company context (buyer-only → 403 SUPPLIER_COMPANY_REQUIRED)." }, { "in": "query", "name": "offset", "schema": { "type": "integer" }, "description": "Page offset (default 0)." }, { "in": "query", "name": "q", "schema": { "type": "string" } }, { "in": "query", "name": "supplierId", "schema": { "type": "integer" } } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_catalog_item_create", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1CatalogItemCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1CatalogItemCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemMutationResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/items/{id}/": { "patch": { "operationId": "internal_v1_catalog_item_update", "description": "Supplier-scoped catalog item update.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1CatalogItemPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1CatalogItemPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1CatalogItemPatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemMutationResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/items/{id}/deactivate/": { "post": { "operationId": "internal_v1_catalog_item_deactivate", "description": "Supplier-scoped catalog item deactivate / reactivate (idempotent).", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemMutationResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/items/{id}/reactivate/": { "post": { "operationId": "internal_v1_catalog_item_reactivate", "description": "Supplier-scoped catalog item reactivate (idempotent).", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogItemMutationResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/procurement-areas/": { "get": { "operationId": "internal_v1_catalog_procurement_area_list", "description": "BKG-009 procurementArea reference dictionary (data-driven, read-only).", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ProcurementAreaListResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/suppliers/": { "get": { "operationId": "internal_v1_catalog_supplier_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "query", "name": "area", "schema": { "type": "string" }, "description": "Filter by procurementArea key (BKG-009). Unknown key -> 400." }, { "in": "query", "name": "limit", "schema": { "type": "integer" }, "description": "Page size (default 50, max 200)." }, { "in": "query", "name": "offset", "schema": { "type": "integer" }, "description": "Page offset (default 0)." }, { "in": "query", "name": "q", "schema": { "type": "string" }, "description": "Server-side search term." } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogSupplierListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/catalog/suppliers/{id}/": { "get": { "operationId": "internal_v1_catalog_supplier_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CatalogSupplierDetailResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/checkout/validate/": { "post": { "operationId": "internal_v1_checkout_validate", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CheckoutValidationResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/{id}/warehouses/": { "get": { "operationId": "internal_v1_company_warehouse_list", "description": "Company-structure warehouses (D2.5).\n\nThe path company `{id}` must equal the active company (X-NEXX-Company-ID),\nso a member can only manage their own company's structure. GET lists\nwarehouses; POST (COMPANY_ADMIN only) creates one and forwards it to mock\nBACKEND. PLATFORM holds structure only — no stock/accounting.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1WarehouseListResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_company_warehouse_create", "description": "Company-structure warehouses (D2.5).\n\nThe path company `{id}` must equal the active company (X-NEXX-Company-ID),\nso a member can only manage their own company's structure. GET lists\nwarehouses; POST (COMPANY_ADMIN only) creates one and forwards it to mock\nBACKEND. PLATFORM holds structure only — no stock/accounting.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1WarehouseCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1WarehouseCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1WarehouseCreateRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1WarehouseResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/active/": { "get": { "operationId": "internal_v1_active_company_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CompanyResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "patch": { "operationId": "internal_v1_active_company_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1CompanyPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1CompanyPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1CompanyPatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1CompanyResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/buyer-profile/": { "get": { "operationId": "internal_v1_companies_buyer_profile_read", "description": "Buyer profile read/edit for the active buyer (or both-role) company.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1BuyerProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "patch": { "operationId": "internal_v1_companies_buyer_profile_update", "description": "Buyer profile read/edit for the active buyer (or both-role) company.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1BuyerProfilePatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1BuyerProfilePatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1BuyerProfilePatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1BuyerProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/join-requests/": { "post": { "operationId": "internal_v1_companies_join_request_create", "description": "Create a request to join an already-claimed company (the reverse of an\ninvitation). The company admin approves later and assigns a role. Idempotent\nper (user, company): an existing pending request is returned as-is.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1JoinRequestCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1JoinRequestCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1JoinRequestCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1JoinRequest" } } }, "description": "" }, "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1JoinRequest" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/lursoft-lookup/": { "post": { "operationId": "internal_v1_companies_lursoft_lookup_create", "description": "Lursoft company lookup (LURSOFT-001 / D2.1; live adapter LURSOFT-002).\n\nEnv-gated: live Lursoft credentials are configured on staging and\nproduction, so real Latvian registration numbers resolve against the\nlive Lursoft registry (24h cache + audit on the live path). Demo\nfixture patterns — and environments without credentials — return\ndeterministic fixture data (mock, quota-safe). The request/response\ncontract is identical in both modes.\n\nAuthentication: Bearer JWT required. `email_verified` is NOT required\nbecause lookup creates no resource and a user mid-onboarding may need\nto type a registration number before they finish email verification.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1LursoftLookupRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1LursoftLookupRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1LursoftLookupRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1LursoftLookupResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/memberships/": { "get": { "operationId": "internal_v1_company_membership_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_company_membership_create", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1MembershipCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1MembershipCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipResponse" } } }, "description": "" }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1InvitationResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/memberships/{id}/": { "patch": { "operationId": "internal_v1_company_membership_update", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1MembershipPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1MembershipPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1MembershipPatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "delete": { "operationId": "internal_v1_company_membership_delete", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1MembershipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/onboarding/manual/": { "post": { "operationId": "internal_v1_company_onboarding_manual_create", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ManualCompanyOnboardingRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1ManualCompanyOnboardingRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1ManualCompanyOnboardingRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ManualCompanyOnboardingResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ManualCompanyOnboardingResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/companies/supplier-profile/": { "get": { "operationId": "internal_v1_companies_supplier_profile_read", "description": "Supplier profile read/edit for the active supplier (or both-role) company.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1SupplierProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "patch": { "operationId": "internal_v1_companies_supplier_profile_update", "description": "Supplier profile read/edit for the active supplier (or both-role) company.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1SupplierProfilePatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1SupplierProfilePatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1SupplierProfilePatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1SupplierProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/": { "get": { "operationId": "internal_v1_order_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "query", "name": "limit", "schema": { "type": "integer" }, "description": "Page size (default 50, max 200)." }, { "in": "query", "name": "offset", "schema": { "type": "integer" }, "description": "Page offset (default 0)." }, { "in": "query", "name": "status", "schema": { "type": "string" }, "description": "Filter by order status (created/confirmed/shipped/delivered/cancelled)." } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_order_submit", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderSubmitRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1OrderSubmitRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1OrderSubmitRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderSubmitResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/": { "get": { "operationId": "internal_v1_order_retrieve", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/accept/": { "post": { "operationId": "internal_v1_order_accept", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderAcceptanceRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1OrderAcceptanceRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1OrderAcceptanceRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/cancel/": { "post": { "operationId": "internal_v1_order_cancel", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/confirm/": { "post": { "operationId": "internal_v1_order_confirm", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/deliver/": { "post": { "operationId": "internal_v1_order_deliver", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/orders/{id}/ship/": { "post": { "operationId": "internal_v1_order_ship", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/": { "get": { "operationId": "internal_v1_price_list_list", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListCollectionResponse" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_price_list_create", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PriceListCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PriceListCreateRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/{id}/": { "get": { "operationId": "internal_v1_price_list_detail", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "patch": { "operationId": "internal_v1_price_list_patch", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1PriceListPatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1PriceListPatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1PriceListPatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "delete": { "operationId": "internal_v1_price_list_delete", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "204": { "description": "No response body" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/{id}/bulk-adjust/": { "post": { "operationId": "internal_v1_price_list_bulk_adjust", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1BulkAdjustRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1BulkAdjustRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1BulkAdjustRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/{id}/clone/": { "post": { "operationId": "internal_v1_price_list_clone", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListCloneRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PriceListCloneRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PriceListCloneRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/{id}/items/": { "put": { "operationId": "internal_v1_price_list_items_set", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListItemsPutRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PriceListItemsPutRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PriceListItemsPutRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/{id}/set-default/": { "post": { "operationId": "internal_v1_price_list_set_default", "description": "Shared supplier-context + role gate for the multi-price-list endpoints.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/price-lists/default/": { "get": { "operationId": "internal_v1_default_price_list_read", "description": "R1 default price list (Option B facade) for the active supplier/both company.\n\nOne default list per supplier (D2.8). Header is backed by SupplierProfile\ndefault fields; lines are backed by the supplier's CatalogItems with a\nbackend-computed gross. Buyers consume resulting prices through the existing\nbuyer catalog/supplier endpoints (CAT-004) — unchanged.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "put": { "operationId": "internal_v1_default_price_list_update", "description": "R1 default price list (Option B facade) for the active supplier/both company.\n\nOne default list per supplier (D2.8). Header is backed by SupplierProfile\ndefault fields; lines are backed by the supplier's CatalogItems with a\nbackend-computed gross. Buyers consume resulting prices through the existing\nbuyer catalog/supplier endpoints (CAT-004) — unchanged.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListUpdateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1PriceListUpdateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1PriceListUpdateRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1PriceListDetail" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/": { "get": { "operationId": "internal_v1_relationship_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "query", "name": "limit", "schema": { "type": "integer" }, "description": "Page size (default 50, max 200)." }, { "in": "query", "name": "offset", "schema": { "type": "integer" }, "description": "Page offset (default 0)." }, { "in": "query", "name": "q", "schema": { "type": "string" }, "description": "Server-side search term." }, { "in": "query", "name": "status", "schema": { "type": "string" }, "description": "Filter by relationship status (requested/active/suspended/terminated). Unknown key -> 400." } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "post": { "operationId": "internal_v1_relationship_create", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipCreateRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/": { "get": { "operationId": "internal_v1_relationship_detail", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/activate/": { "post": { "operationId": "internal_v1_relationship_activate", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/assign-price-list/": { "post": { "operationId": "internal_v1_relationship_assign_price_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1AssignPriceListRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1AssignPriceListRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1AssignPriceListRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/reject/": { "post": { "operationId": "internal_v1_relationship_reject", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/resume/": { "post": { "operationId": "internal_v1_relationship_resume", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/suspend/": { "post": { "operationId": "internal_v1_relationship_suspend", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/{id}/terminate/": { "post": { "operationId": "internal_v1_relationship_terminate", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipTransitionRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/confirm/": { "post": { "operationId": "internal_v1_relationship_confirm", "description": "D3.5 confirm (consume) — supplier-auth required; requested -> active.\nIdempotent: an already-used token whose relationship is active returns 200\nwith alreadyConfirmed=true.", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/relationships/confirm/validate/": { "post": { "operationId": "internal_v1_relationship_confirm_validate", "description": "D3.5 validate (no consume), PUBLIC — returns safe token state only; MUST\nNOT reveal the buyer legal block before supplier auth.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmRequest" } } }, "required": true }, "security": [ {} ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1RelationshipConfirmValidateResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/service/companies/": { "get": { "operationId": "internal_v1_service_companies_list", "description": "Platform-wide company enumeration for trusted partner service tokens\n(e.g. NEXX Engine). Read-only; requires a valid ``X-API-Key`` service token.\nLets the partner discover company ids to iterate and pull per-company data\nvia the existing GET endpoints. See SVC-AUTH-001.", "tags": [ "internal" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "description": "No response body" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/users/me/": { "delete": { "operationId": "internal_v1_users_me_delete", "description": "Self-service account deletion. A signed-in user deletes their own account,\nfreeing the e-mail for re-registration (testers re-running onboarding). A\ncompany the user solely owns is removed with them; a company shared with other\nmembers survives — only the user's own membership goes (via the user cascade).", "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "204": { "description": "No response body" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/users/me/consents/": { "post": { "operationId": "internal_v1_users_me_consents_create", "description": "ONB-PROFILE-CONSENTS: record onboarding consents (terms + data\nprocessing mandatory; marketing optional). Bearer JWT.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1UserConsentsRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/V1UserConsentsRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/V1UserConsentsRequest" } } }, "required": true }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1UserProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/internal/v1/users/me/profile/": { "get": { "operationId": "internal_v1_users_me_profile_retrieve", "description": "ONB-PROFILE-CONSENTS: user-level representative profile (firstName/\nlastName/phone). Bearer JWT; no active company required.", "tags": [ "internal" ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1UserProfileResponse" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } }, "patch": { "operationId": "internal_v1_users_me_profile_update", "description": "ONB-PROFILE-CONSENTS: user-level representative profile (firstName/\nlastName/phone). Bearer JWT; no active company required.", "tags": [ "internal" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchedV1UserProfilePatchRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/PatchedV1UserProfilePatchRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/PatchedV1UserProfilePatchRequest" } } } }, "security": [ { "bearerAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1UserProfileResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/V1ErrorEnvelope" } } }, "description": "" } } } }, "/api/orders/": { "get": { "operationId": "order_visibility_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } }, "post": { "operationId": "order_submit", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "orders" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderSubmitRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/OrderSubmitRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/OrderSubmitRequest" } } } }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderSubmitResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutBlockedResponse" } } }, "description": "" } } } }, "/api/orders/{id}/": { "get": { "operationId": "order_visibility_detail", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/orders/{id}/accept/": { "post": { "operationId": "order_accept", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderAcceptanceRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/OrderAcceptanceRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/OrderAcceptanceRequest" } } } }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/orders/{id}/cancel/": { "post": { "operationId": "order_cancel", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/orders/{id}/confirm/": { "post": { "operationId": "order_confirm", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/orders/{id}/deliver/": { "post": { "operationId": "order_deliver", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/orders/{id}/ship/": { "post": { "operationId": "order_ship", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "orders" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/relationships/": { "get": { "operationId": "relationship_list", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "relationships" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipListResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } }, "post": { "operationId": "relationship_request_create", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true } ], "tags": [ "relationships" ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipCreateRequest" } }, "application/x-www-form-urlencoded": { "schema": { "$ref": "#/components/schemas/RelationshipCreateRequest" } }, "multipart/form-data": { "schema": { "$ref": "#/components/schemas/RelationshipCreateRequest" } } }, "required": true }, "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipResponse" } } }, "description": "" }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/relationships/{id}/activate/": { "post": { "operationId": "relationship_activate", "parameters": [ { "in": "header", "name": "X-NEXX-Company-ID", "schema": { "type": "integer" }, "description": "Active company context. Must match an active user membership.", "required": true }, { "in": "path", "name": "id", "schema": { "type": "integer" }, "required": true } ], "tags": [ "relationships" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RelationshipResponse" } } }, "description": "" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "" } } } }, "/api/schema/": { "get": { "operationId": "schema_retrieve", "description": "OpenApi3 schema for this API. Format can be selected via content negotiation.\n\n- YAML: application/vnd.oai.openapi\n- JSON: application/vnd.oai.openapi+json", "parameters": [ { "in": "query", "name": "format", "schema": { "type": "string", "enum": [ "json", "yaml" ] } }, { "in": "query", "name": "lang", "schema": { "type": "string", "enum": [ "af", "ar", "ar-dz", "ast", "az", "be", "bg", "bn", "br", "bs", "ca", "ckb", "cs", "cy", "da", "de", "dsb", "el", "en", "en-au", "en-gb", "eo", "es", "es-ar", "es-co", "es-mx", "es-ni", "es-ve", "et", "eu", "fa", "fi", "fr", "fy", "ga", "gd", "gl", "he", "hi", "hr", "hsb", "hu", "hy", "ia", "id", "ig", "io", "is", "it", "ja", "ka", "kab", "kk", "km", "kn", "ko", "ky", "lb", "lt", "lv", "mk", "ml", "mn", "mr", "ms", "my", "nb", "ne", "nl", "nn", "os", "pa", "pl", "pt", "pt-br", "ro", "ru", "sk", "sl", "sq", "sr", "sr-latn", "sv", "sw", "ta", "te", "tg", "th", "tk", "tr", "tt", "udm", "ug", "uk", "ur", "uz", "vi", "zh-hans", "zh-hant" ] } } ], "tags": [ "schema" ], "security": [ { "cookieAuth": [] }, { "basicAuth": [] }, {} ], "responses": { "200": { "content": { "application/vnd.oai.openapi": { "schema": { "type": "object", "additionalProperties": {} } }, "application/yaml": { "schema": { "type": "object", "additionalProperties": {} } }, "application/vnd.oai.openapi+json": { "schema": { "type": "object", "additionalProperties": {} } }, "application/json": { "schema": { "type": "object", "additionalProperties": {} } } }, "description": "" } } } } }, "components": { "schemas": { "AuthSessionResponse": { "type": "object", "properties": { "authenticated": { "type": "boolean" }, "user": { "allOf": [ { "$ref": "#/components/schemas/SessionUser" } ], "nullable": true }, "memberships": { "type": "array", "items": { "$ref": "#/components/schemas/SessionMembership" } } }, "required": [ "authenticated", "memberships", "user" ] }, "BasisEnum": { "enum": [ "percent", "amount" ], "type": "string", "description": "* `percent` - percent\n* `amount` - amount" }, "CartBuyerCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "CartLineCatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "unit": { "type": "string" } }, "required": [ "id", "name", "sku", "unit" ] }, "CartLineCreateRequest": { "type": "object", "properties": { "catalog_item_id": { "type": "integer", "minimum": 1 }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "catalog_item_id", "quantity" ] }, "CartLineResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "catalog_item": { "$ref": "#/components/schemas/CartLineCatalogItem" }, "supplier": { "$ref": "#/components/schemas/CartLineSupplier" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "net_price": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat_rate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "line_net_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "line_vat_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "line_gross_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "catalog_item", "id", "line_gross_total", "line_net_total", "line_vat_total", "net_price", "quantity", "supplier", "vat_rate" ] }, "CartLineSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "CartPayload": { "type": "object", "properties": { "buyer_company": { "$ref": "#/components/schemas/CartBuyerCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/CartLineResponse" } } }, "required": [ "buyer_company", "lines" ] }, "CartResponse": { "type": "object", "properties": { "cart": { "$ref": "#/components/schemas/CartPayload" } }, "required": [ "cart" ] }, "CatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "unit": { "type": "string" }, "net_price": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat_rate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "supplier": { "$ref": "#/components/schemas/CatalogItemSupplier" }, "category": { "$ref": "#/components/schemas/CatalogItemCategory" } }, "required": [ "category", "description", "id", "name", "net_price", "sku", "supplier", "unit", "vat_rate" ] }, "CatalogItemCategory": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" } }, "required": [ "id", "name", "slug" ] }, "CatalogItemListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogItem" } } }, "required": [ "items" ] }, "CatalogItemSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "CatalogSupplierListResponse": { "type": "object", "properties": { "suppliers": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogSupplierSummary" } } }, "required": [ "suppliers" ] }, "CatalogSupplierSummary": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "market_role": { "$ref": "#/components/schemas/MarketRoleEnum" }, "registration_number": { "type": "string", "nullable": true }, "vat_number": { "type": "string" }, "catalog_item_count": { "type": "integer" } }, "required": [ "catalog_item_count", "id", "market_role", "name", "registration_number", "vat_number" ] }, "CheckoutBlockedResponse": { "type": "object", "properties": { "code": { "type": "string" }, "detail": { "type": "string" }, "checkout": { "$ref": "#/components/schemas/CheckoutValidationResponse" } }, "required": [ "checkout", "code", "detail" ] }, "CheckoutBlocker": { "type": "object", "properties": { "code": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "code", "detail" ] }, "CheckoutRelationship": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/StatusE34Enum" }, "order_eligible": { "type": "boolean" } }, "required": [ "order_eligible", "status" ] }, "CheckoutSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "CheckoutSupplierGroup": { "type": "object", "properties": { "supplier": { "$ref": "#/components/schemas/CheckoutSupplier" }, "relationship": { "$ref": "#/components/schemas/CheckoutRelationship" }, "can_checkout": { "type": "boolean" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutBlocker" } }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutSupplierLine" } } }, "required": [ "blockers", "can_checkout", "lines", "relationship", "supplier" ] }, "CheckoutSupplierLine": { "type": "object", "properties": { "id": { "type": "integer" }, "catalog_item_id": { "type": "integer" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "can_checkout": { "type": "boolean" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutBlocker" } } }, "required": [ "blockers", "can_checkout", "catalog_item_id", "id", "quantity" ] }, "CheckoutValidationResponse": { "type": "object", "properties": { "can_checkout": { "type": "boolean" }, "supplier_groups": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutSupplierGroup" } } }, "required": [ "can_checkout", "supplier_groups" ] }, "CompanyResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "market_role": { "$ref": "#/components/schemas/MarketRoleEnum" }, "registration_number": { "type": "string" }, "legal_address": { "type": "string" }, "vat_number": { "type": "string" } }, "required": [ "id", "market_role", "name" ] }, "CountryEnum": { "enum": [ "EE", "LT", "LV" ], "type": "string", "description": "* `EE` - EE\n* `LT` - LT\n* `LV` - LV" }, "ErrorResponse": { "type": "object", "properties": { "code": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "code", "detail" ] }, "LevelEnum": { "enum": [ "info", "warn", "error" ], "type": "string", "description": "* `info` - Info\n* `warn` - Warn\n* `error` - Error" }, "LoginRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string", "writeOnly": true } }, "required": [ "email", "password" ] }, "ManualCompanyOnboardingMembership": { "type": "object", "properties": { "id": { "type": "integer" }, "role": { "$ref": "#/components/schemas/RoleEnum" }, "is_active": { "type": "boolean" } }, "required": [ "id", "is_active", "role" ] }, "ManualCompanyOnboardingProfiles": { "type": "object", "properties": { "buyer": { "type": "boolean" }, "supplier": { "type": "boolean" } }, "required": [ "buyer", "supplier" ] }, "ManualCompanyOnboardingRequest": { "type": "object", "properties": { "registration_number": { "type": "string", "maxLength": 64 }, "name": { "type": "string", "maxLength": 255 }, "legal_address": { "type": "string" }, "vat_number": { "type": "string", "maxLength": 64 }, "market_role": { "$ref": "#/components/schemas/MarketRoleEnum" } }, "required": [ "legal_address", "market_role", "name", "registration_number" ] }, "ManualCompanyOnboardingResponse": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/ManualCompanyOnboardingResponseStatusEnum" }, "onboarding_source": { "type": "string" }, "company": { "$ref": "#/components/schemas/CompanyResponse" }, "membership": { "$ref": "#/components/schemas/ManualCompanyOnboardingMembership" }, "profiles": { "$ref": "#/components/schemas/ManualCompanyOnboardingProfiles" } }, "required": [ "company", "membership", "onboarding_source", "profiles", "status" ] }, "ManualCompanyOnboardingResponseStatusEnum": { "enum": [ "created", "claimed" ], "type": "string", "description": "* `created` - created\n* `claimed` - claimed" }, "MarketRoleEnum": { "enum": [ "buyer", "supplier", "both" ], "type": "string", "description": "* `buyer` - Buyer\n* `supplier` - Supplier\n* `both` - Both" }, "MembershipCreateRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "role": { "$ref": "#/components/schemas/RoleEnum" } }, "required": [ "email", "role" ] }, "MembershipListResponse": { "type": "object", "properties": { "memberships": { "type": "array", "items": { "$ref": "#/components/schemas/MembershipResponse" } } }, "required": [ "memberships" ] }, "MembershipResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "user": { "$ref": "#/components/schemas/MembershipUser" }, "role": { "$ref": "#/components/schemas/RoleEnum" }, "status": { "$ref": "#/components/schemas/Status765Enum" }, "is_active": { "type": "boolean" } }, "required": [ "id", "is_active", "role", "status", "user" ] }, "MembershipUser": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "username": { "type": "string" } }, "required": [ "email", "id", "username" ] }, "ModeEnum": { "enum": [ "increase", "decrease", "set" ], "type": "string", "description": "* `increase` - increase\n* `decrease` - decrease\n* `set` - set" }, "NullEnum": { "enum": [ null ] }, "OrderAcceptanceLineRequest": { "type": "object", "properties": { "id": { "type": "integer" }, "accepted_quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "accepted_quantity", "id" ] }, "OrderAcceptanceRequest": { "type": "object", "properties": { "lines": { "type": "array", "items": { "$ref": "#/components/schemas/OrderAcceptanceLineRequest" } }, "discrepancy_note": { "type": "string", "default": "" } } }, "OrderCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "OrderLineCatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "unit": { "type": "string" } }, "required": [ "id", "name", "sku", "unit" ] }, "OrderLineResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "catalog_item": { "$ref": "#/components/schemas/OrderLineCatalogItem" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "accepted_quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$", "nullable": true }, "net_price": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat_rate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "line_net_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "line_vat_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "line_gross_total": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "accepted_quantity", "catalog_item", "id", "line_gross_total", "line_net_total", "line_vat_total", "net_price", "quantity", "vat_rate" ] }, "OrderResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "buyer": { "$ref": "#/components/schemas/OrderCompany" }, "supplier": { "$ref": "#/components/schemas/OrderCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/OrderLineResponse" } }, "totals": { "$ref": "#/components/schemas/OrderTotals" }, "delivery_address": { "type": "string" }, "requested_delivery_date": { "type": "string", "format": "date", "nullable": true }, "buyer_comment": { "type": "string" }, "available_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "available_actions", "buyer", "buyer_comment", "delivery_address", "id", "lines", "requested_delivery_date", "status", "supplier", "totals" ] }, "OrderSubmitRequest": { "type": "object", "properties": { "delivery_address": { "type": "string", "default": "" }, "requested_delivery_date": { "type": "string", "format": "date", "nullable": true }, "buyer_comment": { "type": "string", "default": "" } } }, "OrderSubmitResponse": { "type": "object", "properties": { "orders": { "type": "array", "items": { "$ref": "#/components/schemas/OrderResponse" } } }, "required": [ "orders" ] }, "OrderTotals": { "type": "object", "properties": { "net": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "gross": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "gross", "net", "vat" ] }, "OrderVisibilityListResponse": { "type": "object", "properties": { "orders": { "type": "array", "items": { "$ref": "#/components/schemas/OrderVisibilityResponse" } } }, "required": [ "orders" ] }, "OrderVisibilityResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "viewer_role": { "$ref": "#/components/schemas/ViewerRoleEnum" }, "buyer": { "$ref": "#/components/schemas/OrderCompany" }, "supplier": { "$ref": "#/components/schemas/OrderCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/OrderLineResponse" } }, "totals": { "$ref": "#/components/schemas/OrderTotals" }, "discrepancy_note": { "type": "string" }, "delivery_address": { "type": "string" }, "requested_delivery_date": { "type": "string", "format": "date", "nullable": true }, "buyer_comment": { "type": "string" }, "available_actions": { "type": "array", "items": { "type": "string" } } }, "required": [ "available_actions", "buyer", "buyer_comment", "delivery_address", "discrepancy_note", "id", "lines", "requested_delivery_date", "status", "supplier", "totals", "viewer_role" ] }, "PatchedCartLineUpdateRequest": { "type": "object", "properties": { "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } } }, "PatchedCompanyPatch": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 } } }, "PatchedMembershipPatchRequest": { "type": "object", "properties": { "role": { "$ref": "#/components/schemas/RoleEnum" }, "status": { "$ref": "#/components/schemas/Status765Enum" } } }, "PatchedV1BuyerProfilePatchRequest": { "type": "object", "properties": { "contactPerson": { "type": "string", "maxLength": 255 }, "phone": { "type": "string", "maxLength": 64 }, "orderEmail": { "type": "string", "format": "email" }, "deliveryAddress": { "type": "string" }, "workingHours": { "type": "string", "maxLength": 255 }, "externalBuyerId": { "type": "string", "maxLength": 64 } } }, "PatchedV1CartLineUpdateRequest": { "type": "object", "properties": { "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } } }, "PatchedV1CatalogItemPatchRequest": { "type": "object", "properties": { "sku": { "type": "string" }, "name": { "type": "string", "maxLength": 255 }, "description": { "type": "string" }, "unit": { "type": "string", "maxLength": 32 }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "categoryId": { "type": "integer", "minimum": 1 }, "barcode": { "type": "string", "maxLength": 64 }, "externalItemId": { "type": "string", "maxLength": 64 } } }, "PatchedV1CategoryPatchRequest": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "parentId": { "type": "integer", "minimum": 1, "nullable": true }, "procurementArea": { "type": "string", "nullable": true, "maxLength": 64 } } }, "PatchedV1CompanyPatchRequest": { "type": "object", "description": "Editable company fields for the onboarding edit / company settings. All\noptional — only provided fields are updated.", "properties": { "name": { "type": "string", "maxLength": 255 }, "legalAddress": { "type": "string" }, "vatNumber": { "type": "string", "maxLength": 64 }, "registrationNumber": { "type": "string", "maxLength": 64 }, "marketRole": { "$ref": "#/components/schemas/MarketRoleEnum" }, "country": { "$ref": "#/components/schemas/CountryEnum" } } }, "PatchedV1MembershipPatchRequest": { "type": "object", "properties": { "role": { "type": "string" }, "status": { "type": "string" } } }, "PatchedV1PriceListPatchRequest": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "currency": { "type": "string", "maxLength": 3 }, "effectiveDate": { "type": "string", "format": "date", "nullable": true }, "isActive": { "type": "boolean" } } }, "PatchedV1SupplierProfilePatchRequest": { "type": "object", "properties": { "contactPerson": { "type": "string", "maxLength": 255 }, "phone": { "type": "string", "maxLength": 64 }, "orderEmail": { "type": "string", "format": "email" }, "warehouseAddress": { "type": "string" }, "workingHours": { "type": "string", "maxLength": 255 }, "minOrderAmount": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$", "nullable": true }, "deliveryTerms": { "type": "string" }, "externalSupplierId": { "type": "string", "maxLength": 64 }, "defaultCurrency": { "type": "string", "maxLength": 3 }, "defaultPriceListEffectiveDate": { "type": "string", "format": "date", "nullable": true }, "defaultPriceListActive": { "type": "boolean" } } }, "PatchedV1UserProfilePatchRequest": { "type": "object", "properties": { "firstName": { "type": "string", "maxLength": 150 }, "lastName": { "type": "string", "maxLength": 150 }, "phone": { "type": "string", "maxLength": 40 } } }, "RefreshTokenRequest": { "type": "object", "properties": { "refresh_token": { "type": "string", "writeOnly": true } }, "required": [ "refresh_token" ] }, "RelationshipCompanySummary": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "market_role": { "$ref": "#/components/schemas/MarketRoleEnum" } }, "required": [ "id", "market_role", "name" ] }, "RelationshipCreateRequest": { "type": "object", "properties": { "supplier_company_id": { "type": "integer", "minimum": 1 } }, "required": [ "supplier_company_id" ] }, "RelationshipListResponse": { "type": "object", "properties": { "relationships": { "type": "array", "items": { "$ref": "#/components/schemas/RelationshipResponse" } } }, "required": [ "relationships" ] }, "RelationshipResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "buyer": { "$ref": "#/components/schemas/RelationshipCompanySummary" }, "supplier": { "$ref": "#/components/schemas/RelationshipCompanySummary" }, "status": { "$ref": "#/components/schemas/RelationshipResponseStatusEnum" }, "order_eligible": { "type": "boolean" }, "viewer_role": { "$ref": "#/components/schemas/ViewerRoleEnum" } }, "required": [ "buyer", "id", "order_eligible", "status", "supplier", "viewer_role" ] }, "RelationshipResponseStatusEnum": { "enum": [ "requested", "confirmed", "active", "suspended", "terminated" ], "type": "string", "description": "* `requested` - Requested\n* `confirmed` - Confirmed\n* `active` - Active\n* `suspended` - Suspended\n* `terminated` - Terminated" }, "RoleEnum": { "enum": [ "COMPANY_ADMIN", "MANAGER", "USER" ], "type": "string", "description": "* `COMPANY_ADMIN` - Company admin\n* `MANAGER` - Manager\n* `USER` - User" }, "RoundingEnum": { "enum": [ "0.01", "0.10", "1.00" ], "type": "string", "description": "* `0.01` - 0.01\n* `0.10` - 0.10\n* `1.00` - 1.00" }, "SessionMembership": { "type": "object", "properties": { "company": { "$ref": "#/components/schemas/CompanyResponse" }, "role": { "type": "string" } }, "required": [ "company", "role" ] }, "SessionUser": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "username": { "type": "string" } }, "required": [ "email", "id", "username" ] }, "Status765Enum": { "enum": [ "active", "suspended" ], "type": "string", "description": "* `active` - active\n* `suspended` - suspended" }, "StatusE34Enum": { "enum": [ "requested", "confirmed", "active", "suspended", "terminated", "none" ], "type": "string", "description": "* `requested` - requested\n* `confirmed` - confirmed\n* `active` - active\n* `suspended` - suspended\n* `terminated` - terminated\n* `none` - none" }, "SupplierCardCatalogCategory": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" }, "item_count": { "type": "integer" } }, "required": [ "id", "item_count", "name", "slug" ] }, "SupplierCardCatalogSummary": { "type": "object", "properties": { "item_count": { "type": "integer" }, "items_url": { "type": "string" }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/SupplierCardCatalogCategory" } } }, "required": [ "categories", "item_count", "items_url" ] }, "SupplierCardRelationship": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "$ref": "#/components/schemas/StatusE34Enum" }, "order_eligible": { "type": "boolean" } }, "required": [ "order_eligible", "status" ] }, "SupplierCardResponse": { "type": "object", "properties": { "supplier": { "$ref": "#/components/schemas/CompanyResponse" }, "catalog": { "$ref": "#/components/schemas/SupplierCardCatalogSummary" }, "relationship": { "$ref": "#/components/schemas/SupplierCardRelationship" } }, "required": [ "catalog", "relationship", "supplier" ] }, "TokenLogoutResponse": { "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ] }, "TokenResponse": { "type": "object", "properties": { "token_type": { "type": "string" }, "access_token": { "type": "string" }, "access_expires_at": { "type": "string", "format": "date-time" }, "refresh_token": { "type": "string" }, "refresh_expires_at": { "type": "string", "format": "date-time" }, "session": { "$ref": "#/components/schemas/AuthSessionResponse" } }, "required": [ "access_expires_at", "access_token", "refresh_expires_at", "refresh_token", "session", "token_type" ] }, "TypeEnum": { "enum": [ "all", "category", "items" ], "type": "string", "description": "* `all` - all\n* `category` - category\n* `items` - items" }, "V1AssignPriceListRequest": { "type": "object", "properties": { "priceListId": { "type": "integer", "minimum": 1, "nullable": true } } }, "V1AuthSessionResponse": { "type": "object", "properties": { "authenticated": { "type": "boolean" }, "user": { "allOf": [ { "$ref": "#/components/schemas/V1SessionUser" } ], "nullable": true }, "memberships": { "type": "array", "items": { "$ref": "#/components/schemas/V1SessionMembership" } } }, "required": [ "authenticated", "memberships", "user" ] }, "V1AuthUser": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "emailVerified": { "type": "boolean" } }, "required": [ "email", "emailVerified", "id" ] }, "V1AuthUserResponse": { "type": "object", "properties": { "user": { "$ref": "#/components/schemas/V1AuthUser" } }, "required": [ "user" ] }, "V1BulkAdjustRequest": { "type": "object", "properties": { "mode": { "$ref": "#/components/schemas/ModeEnum" }, "basis": { "$ref": "#/components/schemas/BasisEnum" }, "value": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,8}(?:\\.\\d{0,4})?$" }, "rounding": { "nullable": true, "oneOf": [ { "$ref": "#/components/schemas/RoundingEnum" }, { "$ref": "#/components/schemas/NullEnum" } ] }, "scope": { "$ref": "#/components/schemas/V1PriceListScope" }, "preview": { "type": "boolean", "default": false } }, "required": [ "basis", "mode", "scope", "value" ] }, "V1BuyerProfileResponse": { "type": "object", "properties": { "companyId": { "type": "integer" }, "contactPerson": { "type": "string" }, "phone": { "type": "string" }, "orderEmail": { "type": "string" }, "deliveryAddress": { "type": "string" }, "workingHours": { "type": "string" }, "externalBuyerId": { "type": "string" } }, "required": [ "companyId", "contactPerson", "deliveryAddress", "externalBuyerId", "orderEmail", "phone", "workingHours" ] }, "V1CartBuyerCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1CartLineCatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "unit": { "type": "string" } }, "required": [ "id", "name", "sku", "unit" ] }, "V1CartLineCreateRequest": { "type": "object", "properties": { "catalogItemId": { "type": "integer", "minimum": 1 }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "catalogItemId", "quantity" ] }, "V1CartLineResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "catalogItem": { "$ref": "#/components/schemas/V1CartLineCatalogItem" }, "supplier": { "$ref": "#/components/schemas/V1CartLineSupplier" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "lineNetTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "lineVatTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "lineGrossTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "catalogItem", "id", "lineGrossTotal", "lineNetTotal", "lineVatTotal", "netPrice", "quantity", "supplier", "vatRate" ] }, "V1CartLineSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1CartPayload": { "type": "object", "properties": { "buyerCompany": { "$ref": "#/components/schemas/V1CartBuyerCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1CartLineResponse" } } }, "required": [ "buyerCompany", "lines" ] }, "V1CartResponse": { "type": "object", "properties": { "cart": { "$ref": "#/components/schemas/V1CartPayload" } }, "required": [ "cart" ] }, "V1CatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "unit": { "type": "string" }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$", "nullable": true }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$", "nullable": true }, "pricesVisible": { "type": "boolean" }, "isActive": { "type": "boolean" }, "supplier": { "$ref": "#/components/schemas/V1CatalogItemSupplier" }, "category": { "$ref": "#/components/schemas/V1CatalogItemCategory" } }, "required": [ "category", "description", "id", "isActive", "name", "netPrice", "pricesVisible", "sku", "supplier", "unit", "vatRate" ] }, "V1CatalogItemCategory": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" } }, "required": [ "id", "name", "slug" ] }, "V1CatalogItemCreateRequest": { "type": "object", "properties": { "sku": { "type": "string", "maxLength": 64 }, "name": { "type": "string", "maxLength": 255 }, "description": { "type": "string", "default": "" }, "unit": { "type": "string", "default": "pcs", "maxLength": 32 }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "categoryId": { "type": "integer", "minimum": 1 }, "barcode": { "type": "string", "default": "", "maxLength": 64 }, "externalItemId": { "type": "string", "default": "", "maxLength": 64 } }, "required": [ "categoryId", "name", "netPrice", "sku", "vatRate" ] }, "V1CatalogItemListResponse": { "type": "object", "description": "BKG-001: additive total/limit/offset alongside the domain list key.", "properties": { "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/V1CatalogItem" } } }, "required": [ "items", "limit", "offset", "total" ] }, "V1CatalogItemMutationResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "unit": { "type": "string" }, "netPrice": { "type": "string" }, "vatRate": { "type": "string" }, "barcode": { "type": "string" }, "externalItemId": { "type": "string" }, "isActive": { "type": "boolean" }, "supplier": { "$ref": "#/components/schemas/V1CatalogItemSupplier" }, "category": { "$ref": "#/components/schemas/V1CatalogItemCategory" } }, "required": [ "barcode", "category", "description", "externalItemId", "id", "isActive", "name", "netPrice", "sku", "supplier", "unit", "vatRate" ] }, "V1CatalogItemSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1CatalogSupplierDetailResponse": { "type": "object", "properties": { "supplier": { "$ref": "#/components/schemas/V1CompanyResponse" }, "profile": { "$ref": "#/components/schemas/V1SupplierCardProfile" }, "procurementAreas": { "type": "array", "items": { "type": "string" } }, "catalog": { "$ref": "#/components/schemas/V1SupplierCardCatalogSummary" }, "relationship": { "$ref": "#/components/schemas/V1SupplierCardRelationship" } }, "required": [ "catalog", "procurementAreas", "profile", "relationship", "supplier" ] }, "V1CatalogSupplierListResponse": { "type": "object", "description": "BKG-001: additive total/limit/offset alongside the domain list key.", "properties": { "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "suppliers": { "type": "array", "items": { "$ref": "#/components/schemas/V1CatalogSupplierSummary" } } }, "required": [ "limit", "offset", "suppliers", "total" ] }, "V1CatalogSupplierSummary": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "marketRole": { "type": "string" }, "registrationNumber": { "type": "string", "nullable": true }, "vatNumber": { "type": "string" }, "catalogItemCount": { "type": "integer" }, "procurementAreas": { "type": "array", "items": { "type": "string" } } }, "required": [ "catalogItemCount", "id", "marketRole", "name", "procurementAreas", "registrationNumber", "vatNumber" ] }, "V1CategoryCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 255 }, "parentId": { "type": "integer", "minimum": 1, "nullable": true }, "procurementArea": { "type": "string", "nullable": true, "maxLength": 64 } }, "required": [ "name" ] }, "V1CategoryListResponse": { "type": "object", "properties": { "categories": { "type": "array", "items": { "$ref": "#/components/schemas/V1CategoryResponse" } } }, "required": [ "categories" ] }, "V1CategoryResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" }, "parentId": { "type": "integer", "nullable": true }, "itemCount": { "type": "integer" }, "procurementArea": { "type": "string", "nullable": true } }, "required": [ "id", "itemCount", "name", "parentId", "procurementArea", "slug" ] }, "V1CheckoutBlocker": { "type": "object", "properties": { "code": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "code", "detail" ] }, "V1CheckoutDelivery": { "type": "object", "properties": { "resolved": { "type": "boolean" }, "source": { "type": "string", "nullable": true }, "address": { "type": "string", "nullable": true } }, "required": [ "address", "resolved", "source" ] }, "V1CheckoutRelationship": { "type": "object", "properties": { "status": { "type": "string" }, "orderEligible": { "type": "boolean" } }, "required": [ "orderEligible", "status" ] }, "V1CheckoutSupplier": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1CheckoutSupplierGroup": { "type": "object", "properties": { "supplier": { "$ref": "#/components/schemas/V1CheckoutSupplier" }, "supplierCompanyId": { "type": "integer" }, "relationship": { "$ref": "#/components/schemas/V1CheckoutRelationship" }, "canCheckout": { "type": "boolean" }, "canSubmit": { "type": "boolean" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/V1CheckoutBlocker" } }, "totals": { "$ref": "#/components/schemas/V1CheckoutTotals" }, "lineCount": { "type": "integer" }, "itemCount": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "currency": { "type": "string" }, "minOrderAmount": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$", "nullable": true }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1CheckoutSupplierLine" } } }, "required": [ "blockers", "canCheckout", "canSubmit", "currency", "itemCount", "lineCount", "lines", "minOrderAmount", "relationship", "supplier", "supplierCompanyId", "totals" ] }, "V1CheckoutSupplierLine": { "type": "object", "properties": { "id": { "type": "integer" }, "catalogItemId": { "type": "integer" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "canCheckout": { "type": "boolean" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/V1CheckoutBlocker" } } }, "required": [ "blockers", "canCheckout", "catalogItemId", "id", "quantity" ] }, "V1CheckoutTotals": { "type": "object", "properties": { "net": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "gross": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "gross", "net", "vat" ] }, "V1CheckoutValidationResponse": { "type": "object", "properties": { "canCheckout": { "type": "boolean" }, "canSubmit": { "type": "boolean" }, "blockers": { "type": "array", "items": { "$ref": "#/components/schemas/V1CheckoutBlocker" } }, "delivery": { "$ref": "#/components/schemas/V1CheckoutDelivery" }, "supplierGroups": { "type": "array", "items": { "$ref": "#/components/schemas/V1CheckoutSupplierGroup" } } }, "required": [ "blockers", "canCheckout", "canSubmit", "delivery", "supplierGroups" ] }, "V1CompanyResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "marketRole": { "type": "string" }, "registrationNumber": { "type": "string", "nullable": true }, "legalAddress": { "type": "string" }, "vatNumber": { "type": "string" }, "country": { "type": "string" }, "verificationMethod": { "type": "string" } }, "required": [ "id", "marketRole", "name" ] }, "V1EmailResendRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" } }, "required": [ "email" ] }, "V1EmailVerifyRequest": { "type": "object", "properties": { "token": { "type": "string", "writeOnly": true } }, "required": [ "token" ] }, "V1ErrorDetail": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "details": { "type": "object", "additionalProperties": {} } }, "required": [ "code", "details", "message" ] }, "V1ErrorEnvelope": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/V1ErrorDetail" } }, "required": [ "error" ] }, "V1Invitation": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "role": { "type": "string" }, "status": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "company": { "$ref": "#/components/schemas/V1InvitationCompany" } }, "required": [ "company", "email", "expiresAt", "id", "role", "status" ] }, "V1InvitationCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1InvitationLookup": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "role": { "type": "string" }, "status": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "company": { "$ref": "#/components/schemas/V1InvitationCompany" }, "inviter": { "type": "string", "nullable": true } }, "required": [ "company", "email", "expiresAt", "id", "inviter", "role", "status" ] }, "V1InvitationLookupResponse": { "type": "object", "properties": { "invitation": { "$ref": "#/components/schemas/V1InvitationLookup" } }, "required": [ "invitation" ] }, "V1InvitationResponse": { "type": "object", "properties": { "invitation": { "$ref": "#/components/schemas/V1Invitation" } }, "required": [ "invitation" ] }, "V1JoinRequest": { "type": "object", "properties": { "id": { "type": "integer" }, "companyId": { "type": "integer" }, "companyName": { "type": "string" }, "status": { "type": "string" }, "requestedRoles": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "companyId", "companyName", "createdAt", "id", "requestedRoles", "status" ] }, "V1JoinRequestCreateRequest": { "type": "object", "properties": { "companyId": { "type": "integer" }, "requestedRoles": { "type": "string", "default": "", "maxLength": 64 }, "message": { "type": "string", "default": "" } }, "required": [ "companyId" ] }, "V1LursoftLookupCompany": { "type": "object", "properties": { "registrationNumber": { "type": "string" }, "name": { "type": "string" }, "legalAddress": { "type": "string" }, "country": { "type": "string" }, "vatNumber": { "type": "string" }, "verificationMethod": { "type": "string" } }, "required": [ "country", "legalAddress", "name", "registrationNumber", "vatNumber", "verificationMethod" ] }, "V1LursoftLookupRequest": { "type": "object", "properties": { "registrationNumber": { "type": "string", "maxLength": 64 } }, "required": [ "registrationNumber" ] }, "V1LursoftLookupResponse": { "type": "object", "properties": { "found": { "type": "boolean" }, "company": { "allOf": [ { "$ref": "#/components/schemas/V1LursoftLookupCompany" } ], "nullable": true }, "platform": { "allOf": [ { "$ref": "#/components/schemas/V1PlatformLookupMatch" } ], "nullable": true } }, "required": [ "found" ] }, "V1ManualCompanyOnboardingRequest": { "type": "object", "properties": { "registrationNumber": { "type": "string", "maxLength": 64 }, "name": { "type": "string", "maxLength": 255 }, "legalAddress": { "type": "string" }, "vatNumber": { "type": "string", "maxLength": 64 }, "marketRole": { "$ref": "#/components/schemas/MarketRoleEnum" }, "country": { "type": "string", "description": "R1 allowlist (BKG-019): LV, LT, EE. Unknown -> 400 VALIDATION_ERROR with details.field=\"country\".", "maxLength": 2 }, "verificationMethod": { "allOf": [ { "$ref": "#/components/schemas/VerificationMethodEnum" } ], "default": "manual" } }, "required": [ "country", "legalAddress", "marketRole", "name", "registrationNumber" ] }, "V1ManualCompanyOnboardingResponse": { "type": "object", "properties": { "status": { "type": "string" }, "onboardingSource": { "type": "string" }, "company": { "$ref": "#/components/schemas/V1CompanyResponse" }, "membership": { "$ref": "#/components/schemas/V1OnboardingMembership" }, "profiles": { "$ref": "#/components/schemas/V1OnboardingProfiles" } }, "required": [ "company", "membership", "onboardingSource", "profiles", "status" ] }, "V1MembershipCreateRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "role": { "type": "string" } }, "required": [ "email", "role" ] }, "V1MembershipListResponse": { "type": "object", "properties": { "memberships": { "type": "array", "items": { "$ref": "#/components/schemas/V1MembershipResponse" } } }, "required": [ "memberships" ] }, "V1MembershipResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "user": { "$ref": "#/components/schemas/V1MembershipUser" }, "role": { "type": "string" }, "status": { "type": "string" }, "isActive": { "type": "boolean" } }, "required": [ "id", "isActive", "role", "status", "user" ] }, "V1MembershipUser": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "username": { "type": "string" } }, "required": [ "email", "id", "username" ] }, "V1OnboardingMembership": { "type": "object", "properties": { "id": { "type": "integer" }, "role": { "type": "string" }, "isActive": { "type": "boolean" } }, "required": [ "id", "isActive", "role" ] }, "V1OnboardingProfiles": { "type": "object", "properties": { "buyer": { "type": "boolean" }, "supplier": { "type": "boolean" } }, "required": [ "buyer", "supplier" ] }, "V1OrderAcceptanceLineRequest": { "type": "object", "properties": { "id": { "type": "integer" }, "acceptedQuantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "acceptedQuantity", "id" ] }, "V1OrderAcceptanceRequest": { "type": "object", "properties": { "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1OrderAcceptanceLineRequest" } }, "discrepancyNote": { "type": "string", "default": "" } } }, "V1OrderCompany": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1OrderExport": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/V1OrderExportStatusEnum" }, "externalOrderId": { "type": "string", "nullable": true }, "lastError": { "type": "string", "nullable": true }, "nextRetryAt": { "type": "string", "format": "date-time", "nullable": true }, "updatedAt": { "type": "string", "format": "date-time", "nullable": true } }, "required": [ "externalOrderId", "lastError", "nextRetryAt", "status", "updatedAt" ] }, "V1OrderExportStatusEnum": { "enum": [ "pending", "in_progress", "done", "failed", "failed_permanent" ], "type": "string", "description": "* `pending` - pending\n* `in_progress` - in_progress\n* `done` - done\n* `failed` - failed\n* `failed_permanent` - failed_permanent" }, "V1OrderLineCatalogItem": { "type": "object", "properties": { "id": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "unit": { "type": "string" } }, "required": [ "id", "name", "sku", "unit" ] }, "V1OrderLineResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "catalogItem": { "$ref": "#/components/schemas/V1OrderLineCatalogItem" }, "quantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "acceptedQuantity": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$", "nullable": true }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" }, "lineNetTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "lineVatTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "lineGrossTotal": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "acceptedQuantity", "catalogItem", "id", "lineGrossTotal", "lineNetTotal", "lineVatTotal", "netPrice", "quantity", "vatRate" ] }, "V1OrderResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "buyer": { "$ref": "#/components/schemas/V1OrderCompany" }, "supplier": { "$ref": "#/components/schemas/V1OrderCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1OrderLineResponse" } }, "totals": { "$ref": "#/components/schemas/V1OrderTotals" }, "deliveryAddress": { "type": "string" }, "requestedDeliveryDate": { "type": "string", "format": "date", "nullable": true }, "buyerComment": { "type": "string" }, "availableActions": { "type": "array", "items": { "type": "string" } }, "export": { "allOf": [ { "$ref": "#/components/schemas/V1OrderExport" } ], "nullable": true } }, "required": [ "availableActions", "buyer", "buyerComment", "deliveryAddress", "export", "id", "lines", "requestedDeliveryDate", "status", "supplier", "totals" ] }, "V1OrderSubmitRequest": { "type": "object", "properties": { "supplierCompanyIds": { "type": "array", "items": { "type": "integer", "minimum": 1 } }, "deliveryAddress": { "type": "string", "default": "" }, "requestedDeliveryDate": { "type": "string", "format": "date", "nullable": true }, "buyerComment": { "type": "string", "default": "" } } }, "V1OrderSubmitResponse": { "type": "object", "properties": { "orders": { "type": "array", "items": { "$ref": "#/components/schemas/V1OrderResponse" } }, "remainingCart": { "$ref": "#/components/schemas/V1CartPayload" } }, "required": [ "orders", "remainingCart" ] }, "V1OrderTotals": { "type": "object", "properties": { "net": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vat": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "gross": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" } }, "required": [ "gross", "net", "vat" ] }, "V1OrderVisibilityListResponse": { "type": "object", "description": "BKG-001: additive total/limit/offset alongside the domain list key.", "properties": { "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "orders": { "type": "array", "items": { "$ref": "#/components/schemas/V1OrderVisibilityResponse" } } }, "required": [ "limit", "offset", "orders", "total" ] }, "V1OrderVisibilityResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "viewerRole": { "type": "string" }, "buyer": { "$ref": "#/components/schemas/V1OrderCompany" }, "supplier": { "$ref": "#/components/schemas/V1OrderCompany" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1OrderLineResponse" } }, "totals": { "$ref": "#/components/schemas/V1OrderTotals" }, "discrepancyNote": { "type": "string" }, "deliveryAddress": { "type": "string" }, "requestedDeliveryDate": { "type": "string", "format": "date", "nullable": true }, "buyerComment": { "type": "string" }, "availableActions": { "type": "array", "items": { "type": "string" } }, "export": { "allOf": [ { "$ref": "#/components/schemas/V1OrderExport" } ], "nullable": true } }, "required": [ "availableActions", "buyer", "buyerComment", "deliveryAddress", "discrepancyNote", "export", "id", "lines", "requestedDeliveryDate", "status", "supplier", "totals", "viewerRole" ] }, "V1PasswordResetConfirmRequest": { "type": "object", "properties": { "token": { "type": "string", "writeOnly": true }, "password": { "type": "string", "writeOnly": true }, "passwordConfirm": { "type": "string", "writeOnly": true } }, "required": [ "password", "passwordConfirm", "token" ] }, "V1PasswordResetRequestRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" } }, "required": [ "email" ] }, "V1PlatformLookupMatch": { "type": "object", "properties": { "onPlatform": { "type": "boolean" }, "companyId": { "type": "integer" }, "name": { "type": "string" }, "legalAddress": { "type": "string" }, "adminEmailMasked": { "type": "string" } }, "required": [ "adminEmailMasked", "companyId", "legalAddress", "name", "onPlatform" ] }, "V1PriceListCloneAdjust": { "type": "object", "properties": { "mode": { "$ref": "#/components/schemas/ModeEnum" }, "basis": { "$ref": "#/components/schemas/BasisEnum" }, "value": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,8}(?:\\.\\d{0,4})?$" }, "rounding": { "nullable": true, "oneOf": [ { "$ref": "#/components/schemas/RoundingEnum" }, { "$ref": "#/components/schemas/NullEnum" } ] }, "scope": { "$ref": "#/components/schemas/V1PriceListScope" } }, "required": [ "basis", "mode", "scope", "value" ] }, "V1PriceListCloneRequest": { "type": "object", "properties": { "name": { "type": "string", "default": "", "maxLength": 255 }, "adjust": { "allOf": [ { "$ref": "#/components/schemas/V1PriceListCloneAdjust" } ], "nullable": true } } }, "V1PriceListCollectionResponse": { "type": "object", "properties": { "priceLists": { "type": "array", "items": { "$ref": "#/components/schemas/V1PriceListSummary" } } }, "required": [ "priceLists" ] }, "V1PriceListCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "default": "", "maxLength": 255 }, "currency": { "type": "string", "default": "EUR", "maxLength": 3 }, "effectiveDate": { "type": "string", "format": "date", "nullable": true }, "isActive": { "type": "boolean", "default": false } } }, "V1PriceListDetail": { "type": "object", "properties": { "id": { "type": "integer" }, "supplierCompanyId": { "type": "integer" }, "name": { "type": "string" }, "currency": { "type": "string" }, "effectiveDate": { "type": "string", "format": "date", "nullable": true }, "isDefault": { "type": "boolean" }, "isActive": { "type": "boolean" }, "rowCount": { "type": "integer" }, "pricedItemCount": { "type": "integer" }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1PriceListLine" } } }, "required": [ "currency", "effectiveDate", "id", "isActive", "isDefault", "lines", "name", "pricedItemCount", "rowCount", "supplierCompanyId" ] }, "V1PriceListItemsPutRequest": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/V1PriceListLineUpdate" } } }, "required": [ "items" ] }, "V1PriceListLine": { "type": "object", "properties": { "catalogItemId": { "type": "integer" }, "sku": { "type": "string" }, "name": { "type": "string" }, "unit": { "type": "string" }, "categoryName": { "type": "string", "nullable": true }, "itemActive": { "type": "boolean" }, "netPrice": { "type": "string" }, "vatRate": { "type": "string" }, "grossPrice": { "type": "string" } }, "required": [ "catalogItemId", "categoryName", "grossPrice", "itemActive", "name", "netPrice", "sku", "unit", "vatRate" ] }, "V1PriceListLineUpdate": { "type": "object", "properties": { "catalogItemId": { "type": "integer", "minimum": 1 }, "netPrice": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,10}(?:\\.\\d{0,2})?$" }, "vatRate": { "type": "string", "format": "decimal", "pattern": "^-?\\d{0,3}(?:\\.\\d{0,2})?$" } }, "required": [ "catalogItemId", "netPrice", "vatRate" ] }, "V1PriceListScope": { "type": "object", "properties": { "type": { "$ref": "#/components/schemas/TypeEnum" }, "categoryId": { "type": "integer", "minimum": 1, "nullable": true }, "catalogItemIds": { "type": "array", "items": { "type": "integer", "minimum": 1 } } }, "required": [ "type" ] }, "V1PriceListSummary": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "currency": { "type": "string" }, "effectiveDate": { "type": "string", "format": "date", "nullable": true }, "isDefault": { "type": "boolean" }, "isActive": { "type": "boolean" }, "rowCount": { "type": "integer" }, "pricedItemCount": { "type": "integer" } }, "required": [ "currency", "effectiveDate", "id", "isActive", "isDefault", "name", "pricedItemCount", "rowCount" ] }, "V1PriceListUpdateRequest": { "type": "object", "properties": { "name": { "type": "string", "default": "", "maxLength": 255 }, "currency": { "type": "string", "default": "EUR", "maxLength": 3 }, "effectiveDate": { "type": "string", "format": "date", "nullable": true }, "isActive": { "type": "boolean", "default": false }, "lines": { "type": "array", "items": { "$ref": "#/components/schemas/V1PriceListLineUpdate" } } } }, "V1ProcurementArea": { "type": "object", "properties": { "key": { "type": "string" }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "sortOrder": { "type": "integer" }, "selectable": { "type": "boolean" } }, "required": [ "key", "labels", "selectable", "sortOrder" ] }, "V1ProcurementAreaListResponse": { "type": "object", "properties": { "procurementAreas": { "type": "array", "items": { "$ref": "#/components/schemas/V1ProcurementArea" } } }, "required": [ "procurementAreas" ] }, "V1RefreshTokenRequest": { "type": "object", "properties": { "refreshToken": { "type": "string", "writeOnly": true } }, "required": [ "refreshToken" ] }, "V1RegisterRequest": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "password": { "type": "string", "writeOnly": true }, "passwordConfirm": { "type": "string", "writeOnly": true } }, "required": [ "email", "password", "passwordConfirm" ] }, "V1RelationshipCompanySummary": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "marketRole": { "type": "string" }, "registrationNumber": { "type": "string" }, "vatNumber": { "type": "string" }, "legalAddress": { "type": "string" }, "country": { "type": "string" }, "verificationMethod": { "type": "string" } }, "required": [ "country", "id", "legalAddress", "marketRole", "name", "registrationNumber", "vatNumber", "verificationMethod" ] }, "V1RelationshipConfirmRequest": { "type": "object", "properties": { "token": { "type": "string" } }, "required": [ "token" ] }, "V1RelationshipConfirmResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "buyer": { "$ref": "#/components/schemas/V1RelationshipCompanySummary" }, "supplier": { "$ref": "#/components/schemas/V1RelationshipCompanySummary" }, "status": { "type": "string" }, "orderEligible": { "type": "boolean" }, "viewerRole": { "type": "string" }, "requestedAt": { "type": "string", "format": "date-time", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "requestMessage": { "type": "string" }, "expectedVolume": { "type": "string" }, "requestedProcurementAreas": { "type": "array", "items": { "type": "string" } }, "requestedBy": { "allOf": [ { "$ref": "#/components/schemas/V1RelationshipRequestedBy" } ], "nullable": true }, "decisionReason": { "type": "string" }, "alreadyConfirmed": { "type": "boolean" } }, "required": [ "alreadyConfirmed", "buyer", "createdAt", "decisionReason", "expectedVolume", "id", "orderEligible", "requestMessage", "requestedAt", "requestedBy", "requestedProcurementAreas", "status", "supplier", "updatedAt", "viewerRole" ] }, "V1RelationshipConfirmValidateResponse": { "type": "object", "properties": { "tokenState": { "type": "string" }, "requiresAuth": { "type": "boolean" }, "expiresAt": { "type": "string", "format": "date-time", "nullable": true }, "relationshipStatus": { "type": "string", "nullable": true } }, "required": [ "expiresAt", "relationshipStatus", "requiresAuth", "tokenState" ] }, "V1RelationshipCreateRequest": { "type": "object", "properties": { "supplierCompanyId": { "type": "integer", "minimum": 1 }, "message": { "type": "string", "maxLength": 500 }, "procurementAreas": { "type": "array", "items": { "type": "string" } }, "expectedVolume": { "type": "string", "maxLength": 255 } }, "required": [ "supplierCompanyId" ] }, "V1RelationshipListResponse": { "type": "object", "description": "BKG-001: additive total/limit/offset alongside the domain list key.", "properties": { "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "relationships": { "type": "array", "items": { "$ref": "#/components/schemas/V1RelationshipResponse" } } }, "required": [ "limit", "offset", "relationships", "total" ] }, "V1RelationshipRequestedBy": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "V1RelationshipResponse": { "type": "object", "properties": { "id": { "type": "integer" }, "buyer": { "$ref": "#/components/schemas/V1RelationshipCompanySummary" }, "supplier": { "$ref": "#/components/schemas/V1RelationshipCompanySummary" }, "status": { "type": "string" }, "orderEligible": { "type": "boolean" }, "viewerRole": { "type": "string" }, "requestedAt": { "type": "string", "format": "date-time", "nullable": true }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "requestMessage": { "type": "string" }, "expectedVolume": { "type": "string" }, "requestedProcurementAreas": { "type": "array", "items": { "type": "string" } }, "requestedBy": { "allOf": [ { "$ref": "#/components/schemas/V1RelationshipRequestedBy" } ], "nullable": true }, "decisionReason": { "type": "string" } }, "required": [ "buyer", "createdAt", "decisionReason", "expectedVolume", "id", "orderEligible", "requestMessage", "requestedAt", "requestedBy", "requestedProcurementAreas", "status", "supplier", "updatedAt", "viewerRole" ] }, "V1RelationshipTransitionRequest": { "type": "object", "properties": { "reason": { "type": "string", "maxLength": 500 } } }, "V1RequestLog": { "type": "object", "properties": { "id": { "type": "integer", "readOnly": true }, "timestamp": { "type": "string", "format": "date-time" }, "level": { "$ref": "#/components/schemas/LevelEnum" }, "method": { "type": "string", "maxLength": 8 }, "path": { "type": "string", "maxLength": 512 }, "queryString": { "type": "string" }, "statusCode": { "type": "integer", "nullable": true }, "durationMs": { "type": "integer", "nullable": true }, "userId": { "type": "integer", "nullable": true }, "companyId": { "type": "integer", "nullable": true }, "clientIp": { "type": "string" }, "userAgent": { "type": "string" }, "requestBodyPreview": { "type": "string" }, "responseBodyPreview": { "type": "string" }, "exceptionType": { "type": "string" }, "exceptionMessage": { "type": "string" } }, "required": [ "clientIp", "companyId", "durationMs", "exceptionMessage", "exceptionType", "id", "method", "path", "queryString", "requestBodyPreview", "responseBodyPreview", "statusCode", "timestamp", "userAgent", "userId" ] }, "V1RequestLogListResponse": { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/V1RequestLog" } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "items", "limit", "offset", "total" ] }, "V1SessionMembership": { "type": "object", "properties": { "company": { "$ref": "#/components/schemas/V1CompanyResponse" }, "role": { "type": "string" } }, "required": [ "company", "role" ] }, "V1SessionUser": { "type": "object", "properties": { "id": { "type": "integer" }, "email": { "type": "string", "format": "email" }, "username": { "type": "string" }, "emailVerified": { "type": "boolean" } }, "required": [ "email", "id", "username" ] }, "V1SupplierCardCatalogCategory": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "slug": { "type": "string" }, "itemCount": { "type": "integer" } }, "required": [ "id", "itemCount", "name", "slug" ] }, "V1SupplierCardCatalogSummary": { "type": "object", "properties": { "itemCount": { "type": "integer" }, "itemsUrl": { "type": "string" }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/V1SupplierCardCatalogCategory" } } }, "required": [ "categories", "itemCount", "itemsUrl" ] }, "V1SupplierCardProfile": { "type": "object", "properties": { "contactPerson": { "type": "string" }, "phone": { "type": "string" }, "orderEmail": { "type": "string" }, "warehouseAddress": { "type": "string" }, "workingHours": { "type": "string" }, "minOrderAmount": { "type": "string", "nullable": true }, "deliveryTerms": { "type": "string" }, "defaultCurrency": { "type": "string" }, "defaultPriceListEffectiveDate": { "type": "string", "format": "date", "nullable": true }, "defaultPriceListActive": { "type": "boolean" } }, "required": [ "contactPerson", "defaultCurrency", "defaultPriceListActive", "defaultPriceListEffectiveDate", "deliveryTerms", "minOrderAmount", "orderEmail", "phone", "warehouseAddress", "workingHours" ] }, "V1SupplierCardRelationship": { "type": "object", "properties": { "id": { "type": "integer" }, "status": { "type": "string" }, "orderEligible": { "type": "boolean" } }, "required": [ "orderEligible", "status" ] }, "V1SupplierProfileResponse": { "type": "object", "properties": { "companyId": { "type": "integer" }, "contactPerson": { "type": "string" }, "phone": { "type": "string" }, "orderEmail": { "type": "string" }, "warehouseAddress": { "type": "string" }, "workingHours": { "type": "string" }, "minOrderAmount": { "type": "string", "nullable": true }, "deliveryTerms": { "type": "string" }, "externalSupplierId": { "type": "string" }, "defaultCurrency": { "type": "string" }, "defaultPriceListEffectiveDate": { "type": "string", "format": "date", "nullable": true }, "defaultPriceListActive": { "type": "boolean" } }, "required": [ "companyId", "contactPerson", "defaultCurrency", "defaultPriceListActive", "defaultPriceListEffectiveDate", "deliveryTerms", "externalSupplierId", "minOrderAmount", "orderEmail", "phone", "warehouseAddress", "workingHours" ] }, "V1TokenLogoutResponse": { "type": "object", "properties": { "revoked": { "type": "boolean" } }, "required": [ "revoked" ] }, "V1TokenResponse": { "type": "object", "properties": { "tokenType": { "type": "string" }, "accessToken": { "type": "string" }, "accessExpiresAt": { "type": "string", "format": "date-time" }, "refreshToken": { "type": "string" }, "refreshExpiresAt": { "type": "string", "format": "date-time" }, "session": { "$ref": "#/components/schemas/V1AuthSessionResponse" } }, "required": [ "accessExpiresAt", "accessToken", "refreshExpiresAt", "refreshToken", "session", "tokenType" ] }, "V1UserConsentsRequest": { "type": "object", "properties": { "terms": { "type": "boolean" }, "dataProcessing": { "type": "boolean" }, "marketing": { "type": "boolean", "default": false }, "version": { "type": "string", "default": "", "maxLength": 40 } }, "required": [ "dataProcessing", "terms" ] }, "V1UserConsentsResponse": { "type": "object", "properties": { "termsAcceptedAt": { "type": "string", "format": "date-time", "nullable": true }, "dataProcessingAcceptedAt": { "type": "string", "format": "date-time", "nullable": true }, "marketingOptIn": { "type": "boolean" }, "version": { "type": "string" } }, "required": [ "dataProcessingAcceptedAt", "marketingOptIn", "termsAcceptedAt", "version" ] }, "V1UserProfileResponse": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "phone": { "type": "string" }, "consents": { "$ref": "#/components/schemas/V1UserConsentsResponse" } }, "required": [ "consents", "firstName", "lastName", "phone" ] }, "V1Warehouse": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "code": { "type": "string" }, "address": { "type": "string" }, "isDefault": { "type": "boolean" } }, "required": [ "address", "code", "id", "isDefault", "name" ] }, "V1WarehouseCreateRequest": { "type": "object", "properties": { "name": { "type": "string", "default": "", "maxLength": 255 }, "code": { "type": "string", "default": "", "maxLength": 64 }, "address": { "type": "string", "default": "" } } }, "V1WarehouseListResponse": { "type": "object", "properties": { "warehouses": { "type": "array", "items": { "$ref": "#/components/schemas/V1Warehouse" } } }, "required": [ "warehouses" ] }, "V1WarehouseResponse": { "type": "object", "properties": { "warehouse": { "$ref": "#/components/schemas/V1Warehouse" } }, "required": [ "warehouse" ] }, "VerificationMethodEnum": { "enum": [ "manual", "lursoft" ], "type": "string", "description": "* `manual` - manual\n* `lursoft` - lursoft" }, "ViewerRoleEnum": { "enum": [ "buyer", "supplier" ], "type": "string", "description": "* `buyer` - buyer\n* `supplier` - supplier" } }, "securitySchemes": { "basicAuth": { "type": "http", "scheme": "basic" }, "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }, "cookieAuth": { "type": "apiKey", "in": "cookie", "name": "sessionid" } } } }