Depósitos

Crear un depósito

Crea un depósito con su primera ubicación. El primer depósito de la empresa es el general.

POST/api/v1/warehouses/create

Permiso: warehouses.create
Empresa: Opera sobre la empresa activa
Tipo: Escritura: pide Idempotency-Key
Respuesta: JSON

Encabezados

Cookietextorequerido
La cookie de sesión del usuario de la integración (__Secure-erp.session_token). Cuando esté la clave API, va en Authorization: Bearer. Ver Autenticación.
X-Expected-Companyuuidrequerido
La empresa sobre la que operás. Si no coincide con la de la credencial, responde 409. Ver Empresa activa.
Idempotency-Keytextorequerido
Una clave única por intento, de hasta 255 caracteres. Reintentar con la misma clave y los mismos datos devuelve el mismo resultado sin repetir la operación. Ver Idempotencia.

Cuerpo

JSON con Content-Type: application/json.

codetextorequerido
de 1 a 10 caracteres, formato `^[A-Z0-9-]+$`
nametextorequerido
de 1 a 80 caracteres
streettextoadmite null
hasta 200 caracteres
streetNumbertextoadmite null
hasta 20 caracteres
citytextoadmite null
hasta 120 caracteres
provinceIduuidadmite null
postalCodecualquiera
firstLocationNametextoadmite null
hasta 80 caracteres

Respuesta

200 con este JSON.

iduuidrequerido
codetextorequerido
nametextorequerido
streetcualquierarequerido
streetNumbercualquierarequerido
citycualquierarequerido
provinceIduuidrequeridoadmite null
postalCodecualquierarequerido
isGeneralsí o norequerido
statustextorequerido
versionenterorequerido
mínimo 1
createdAtfecha y horarequerido
locationslista de objetorequerido
Campos de cada elemento (8)
- iduuidrequerido
- warehouseIduuidrequerido
- codetextorequerido
- nametextorequerido
- isDefaultsí o norequerido
- statustextorequerido
- versionenterorequerido
  mínimo 1
- usualItemsentero
  mínimo 0

Errores

Un rechazo responde application/problem+json con un code estable. Los más comunes en esta operación:

`401`	Falta la credencial o venció.
`403`	La credencial no tiene el permiso `warehouses.create`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`409`	Otra persona cambió el registro desde que lo leíste (`record.stale`).
`422`	Datos inválidos o una regla de negocio rota, con el detalle por campo.
`503`	Sistema ocupado: reintentá después de `Retry-After` segundos.

La lista completa está en Errores.

curl
TypeScript

curl -X POST "$ERP_URL/api/v1/warehouses/create" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "ARS",
  "name": "texto"
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/warehouses/create`, {
  method: "POST",
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
    "Idempotency-Key": crypto.randomUUID(),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "code": "ARS",
    "name": "texto"
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "code": "texto",
  "name": "texto",
  "street": null,
  "streetNumber": null,
  "city": null,
  "provinceId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "postalCode": null,
  "isGeneral": false,
  "status": "texto",
  "version": 1,
  "createdAt": "2026-10-23T14:30:00.000Z",
  "locations": [
    {
      "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "warehouseId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "code": "texto",
      "name": "texto",
      "isDefault": false,
      "status": "texto",
      "version": 1,
      "usualItems": 1
    }
  ]
}