Документация / Как начать / Работа с MCP / Идентификаторы и страницы результатов / REST: sales / createManualSale Для AI-агентов: markdown этой страницы — /docs/api-op-createmanualsale.md · индекс документации — /llms.txt
createManualSale Обновлено 4 октября 2026 г.
POST /api/v1/tools/sales/manual-sales
createManualSale
# Авторизация и праваScopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
Поле Значение security.0.hubApiKey [] security.1.hubBearer [] securitySchemes.hubApiKey.in "header" securitySchemes.hubApiKey.name "X-Api-Key" securitySchemes.hubApiKey.type "apiKey" securitySchemes.hubBearer.scheme "bearer" securitySchemes.hubBearer.type "http" x-required-scopes ["orders:write"]
# Параметры запросаПоле Значение 0.description "Required durable money receipt key; replay is retained for 30 days." 0.in "header" 0.name "Idempotency-Key" 0.required true 0.schema 0.schema
# Тело запроса# ОтветыПоле Значение 201.content.application/json.schema ManualSaleResponse 201.description "Durable money result, including completed replay"
# ОшибкиПоле Значение 400.content.application/problem+json.schema ProblemDetails 400.description "Invalid strict body or path (VALIDATION_ERROR/INVALID_REQUEST), missing/blank Idempotency-Key (IDEMPOTENCY_KEY_REQUIRED), or missing credential provenance (INVALID_REQUEST)" 401.content.application/problem+json.schema ProblemDetails 401.description "Missing or invalid API key; a surface-session JWT is not accepted" 403.content.application/problem+json.schema ProblemDetails 403.description "Missing orders:write scope (INSUFFICIENT_SCOPE) or a credential not admitted to this tenant (FORBIDDEN)" 404.content.application/problem+json.schema ProblemDetails 404.description "The tenant-local buyer, catalogue, registration or order was not found" 409.content.application/problem+json.schema ProblemDetails 409.description "The durable receipt is pending and its effect cannot be recovered (IDEMPOTENCY_KEY_IN_FLIGHT)" 413.content.application/problem+json.schema ProblemDetails 413.description "The per-tool resource policy rejects the request size" 422.content.application/problem+json.schema ProblemDetails 422.description "Divergent receipt-key reuse (IDEMPOTENCY_KEY_MISMATCH) or invalid current money preconditions" 429.content.application/problem+json.schema ProblemDetails 429.description "The per-tool rate limit is exceeded or its subsystem is unavailable" 429.headers.Retry-After.description "Retry delay in seconds when supplied by the resource limiter" 429.headers.Retry-After.required false 429.headers.Retry-After.schema 429.headers.Retry-After.schema 500.content.application/problem+json.schema ProblemDetails 500.description "Unexpected money failure"
# Дополнительные условияПоле Значение description "Create a manual sale from either buyer/catalogue sequences or one registration sequence. REST retains catalogue pricing; it does not accept MCP price overrides. Idempotency-Key must contain a non-whitespace character. The durable 30-day receipt is keyed by client, operation and key; replay rechecks actor admission and returns the stored result with replayed=true." operationId "createManualSale" tags ["sales"]