> ## Documentation Index > Fetch the complete documentation index at: https://docs.lapyme.com.ar/llms.txt > Use this file to discover all available pages before exploring further. # Crear depósito > Crea un depósito para operar stock, puntos de venta y disponibilidad. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/warehouses openapi: 3.1.0 info: title: La Pyme API description: >- Resources and workflows for purchases, sales, inventory, contacts, products, reports, and settings. version: 1.0.0 contact: name: La Pyme Support email: hola@lapyme.com.ar license: name: Proprietary url: https://lapyme.com.ar/terminos servers: - url: https://api.lapyme.com.ar description: Servidor de producción security: - bearerAuth: [] tags: - name: API description: Public API operations for La Pyme integrations. paths: /api/v1/warehouses: post: tags: - API summary: Crear depósito description: Crea un depósito para operar stock, puntos de venta y disponibilidad. operationId: createApiWarehouse parameters: - name: Idempotency-Key in: header description: >- Clave única para evitar duplicados al reintentar la misma creación de depósito. required: true schema: type: string - name: X-Request-Id in: header description: >- ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno. required: false schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ApiWarehouseMutationRequest' responses: '200': description: Depósito creado exitosamente content: application/json: schema: $ref: '#/components/schemas/ApiWarehouseCreateResponse' '400': description: Solicitud inválida content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: INVALID_REQUEST value: request_id: req_warehouse_create_1 error: code: INVALID_REQUEST message: Invalid request for creating warehouses retryable: false type: invalid_request_error details: [] '401': description: API key faltante o inválida content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: AUTHENTICATION_REQUIRED value: request_id: req_warehouse_create_1 error: code: AUTHENTICATION_REQUIRED message: API key is required in the Authorization header retryable: false type: invalid_request_error details: [] '403': description: Scopes insuficientes content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: FORBIDDEN value: request_id: req_warehouse_create_1 error: code: FORBIDDEN message: Your API key does not have permission for this operation retryable: false type: invalid_request_error details: [] '409': description: Conflicto de negocio o idempotencia content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: CONFLICT value: request_id: req_warehouse_create_1 error: code: CONFLICT message: A warehouse with this name already exists retryable: false type: invalid_request_error details: [] '429': description: Límite de solicitudes excedido para la organización headers: Retry-After: description: Segundos a esperar antes de volver a intentar la solicitud. schema: type: string example: '30' X-RateLimit-Limit: description: Límite de la ventana activa. schema: type: string example: '5000' X-RateLimit-Remaining: description: Solicitudes restantes en la ventana activa. schema: type: string example: '0' X-RateLimit-Reset: description: Segundos restantes hasta el reset de la ventana activa. schema: type: string example: '30' RateLimit-Limit: description: Límite de la ventana activa en formato estándar. schema: type: string example: '5000' RateLimit-Remaining: description: Solicitudes restantes en la ventana activa en formato estándar. schema: type: string example: '0' RateLimit-Reset: description: >- Segundos hasta el reset de la ventana activa en formato estándar. schema: type: string example: '30' content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: RATE_LIMITED value: request_id: req_rate_limit_1 error: type: rate_limit_error code: RATE_LIMITED message: >- The organization request limit was reached. Try again later. retryable: true details: [] '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ApiErrorEnvelope' examples: default: summary: INTERNAL_ERROR value: request_id: req_warehouse_create_1 error: code: INTERNAL_ERROR message: Could not process the warehouse retryable: false type: invalid_request_error details: [] x-codeSamples: - lang: typescript label: La Pyme SDK source: | import { Lapyme } from "lapyme"; const lapyme = new Lapyme({ bearerAuth: process.env["LAPYME_API_KEY"] ?? "", }); const warehouse = await lapyme.warehouses.create({ idempotencyKey: crypto.randomUUID(), body: { name: "Deposito central", address: "Av. Corrientes 1234", }, }); components: schemas: ApiWarehouseMutationRequest: type: object properties: name: type: string address: anyOf: - type: string - type: 'null' is_default: default: false type: boolean required: - name additionalProperties: false ApiWarehouseCreateResponse: type: object properties: request_id: type: string data: type: object properties: warehouse: $ref: '#/components/schemas/ApiSharedObjectadcf6da6ce' idempotent_replay: type: boolean required: - warehouse - idempotent_replay additionalProperties: false warnings: type: array items: {} required: - request_id - data - warnings additionalProperties: false ApiErrorEnvelope: type: object properties: request_id: type: string error: type: object properties: type: type: string enum: - api_error - authentication_error - authorization_error - business_error - external_dependency_error - idempotency_error - invalid_request_error - rate_limit_error code: type: string message: type: string retryable: type: boolean details: type: array items: $ref: '#/components/schemas/ApiSharedObjectc671832641' required: - type - code - message - retryable - details additionalProperties: false required: - request_id - error additionalProperties: false ApiSharedObjectadcf6da6ce: type: object properties: object: type: string const: warehouse id: type: string format: uuid name: type: string address: anyOf: - type: string - type: 'null' is_default: type: boolean is_active: type: boolean required: - object - id - name - address - is_default - is_active additionalProperties: false ApiSharedObjectc671832641: type: object properties: code: type: string message: type: string field: type: string required: - code - message additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: Incluí tu API key en el header Authorization con el prefijo Bearer. ````