# createManualSale

Source: <https://telegafirst.com/docs/api-op-createmanualsale>
Locale: ru
releaseGitSha: ea133cd4ad87fe549ef000b139be145be9bd1717
sourceContentDigest: 0f481744ec04564b003effc84bbee9645cade20e77bbb504cfb4ddc757e69471
Version: 2

# createManualSale

`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](https://telegafirst.com/docs/schema-732d4da9452dac626ee371bd2da5e5cf994197cbe0f78202075a88db6652ccf0) |

## Тело запроса

| Поле | Значение |
| - | - |
| content.application/json.schema | [ManualSaleRequest](https://telegafirst.com/docs/schema-2ff38a3539d1982df337a241dec2320421a8b83879c91e4cc7e9ea7ba9153399) |
| required | true |

## Ответы

| Поле | Значение |
| - | - |
| 201.content.application/json.schema | [ManualSaleResponse](https://telegafirst.com/docs/schema-9c36c68bdfb84d0a9476d9a1e0cc5e16229791731e4ffbc061fb81f0eb77b197) |
| 201.description | "Durable money result, including completed replay" |

## Ошибки

| Поле | Значение |
| - | - |
| 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 401.description | "Missing or invalid API key; a surface-session JWT is not accepted" |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 403.description | "Missing orders:write scope (INSUFFICIENT\_SCOPE) or a credential not admitted to this tenant (FORBIDDEN)" |
| 404.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 404.description | "The tenant-local buyer, catalogue, registration or order was not found" |
| 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 409.description | "The durable receipt is pending and its effect cannot be recovered (IDEMPOTENCY\_KEY\_IN\_FLIGHT)" |
| 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 413.description | "The per-tool resource policy rejects the request size" |
| 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 422.description | "Divergent receipt-key reuse (IDEMPOTENCY\_KEY\_MISMATCH) or invalid current money preconditions" |
| 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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](https://telegafirst.com/docs/schema-f0765dbf409c74f001806c446f2cf171d8c46b5b15779d54423dde921a4b0670) |
| 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 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"] |