Skip to main content
POST
/
api
/
v1
/
stock-transfers
Crear transferencia de stock
curl --request POST \
  --url https://api.lapyme.com.ar/api/v1/stock-transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "target_warehouse_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "transfer_date": "2023-11-07T05:31:56Z",
  "items": [
    {
      "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": 4503599627370496
    }
  ],
  "notes": "<string>",
  "save_as_draft": true,
  "mark_as_received": true
}
'
{
  "request_id": "req_transfer_commit_1",
  "data": {
    "transfer": {
      "id": "cf19b3ae-4c08-48be-b9d7-e6f2f5baf609",
      "organization_id": "550e8400-e29b-41d4-a716-446655440001",
      "source_warehouse_id": "550e8400-e29b-41d4-a716-446655440010",
      "target_warehouse_id": "550e8400-e29b-41d4-a716-446655440011",
      "transfer_date": "2026-04-18T13:00:00.000Z",
      "notes": "Storefront replenishment",
      "status": "in_transit",
      "created_at": "2026-04-18T13:00:00.000Z",
      "updated_at": "2026-04-18T13:05:00.000Z",
      "created_by": "550e8400-e29b-41d4-a716-446655440020",
      "updated_by": "550e8400-e29b-41d4-a716-446655440020",
      "source_warehouse": {
        "id": "550e8400-e29b-41d4-a716-446655440010",
        "name": "Central warehouse"
      },
      "target_warehouse": {
        "id": "550e8400-e29b-41d4-a716-446655440011",
        "name": "Showroom"
      },
      "items": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440030",
          "product_id": "550e8400-e29b-41d4-a716-446655440040",
          "quantity": 5,
          "received_quantity": 0,
          "product": {
            "id": "550e8400-e29b-41d4-a716-446655440040",
            "name": "Cable HDMI 2m",
            "sku": "HDMI-2M",
            "variant_options": null,
            "option_names": []
          }
        }
      ]
    },
    "idempotent_replay": false
  },
  "warnings": []
}

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.

Authorizations

Authorization
string
header
required

Incluí tu API key en el header Authorization con el prefijo Bearer.

Headers

Idempotency-Key
string

Clave opcional para deduplicar reintentos de la misma creación de transferencia. Si se omite, no hay protección automática contra repeticiones.

Required string length: 1 - 255
X-Request-Id
string

ID opcional de la solicitud para trazabilidad. Si se omite, el servidor genera uno.

Required string length: 1 - 255

Body

application/json
source_warehouse_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
target_warehouse_id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
transfer_date
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
items
object[]
required
Required array length: 1 - 500 elements
notes
string
save_as_draft
boolean
mark_as_received
boolean

Response

Transferencia creada exitosamente

request_id
string
required
data
object
required
warnings
object[]
required