Depósitos

Modificar un depósito

Edita el código, el nombre y el domicilio de un depósito.

POST/api/v1/warehouses/update

Permiso: warehouses.update
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.

warehouseIduuidrequerido
versionenterorequerido
mínimo 1
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

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

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.update`.
`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/update" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouseId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "version": 1,
  "code": "ARS",
  "name": "texto"
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/warehouses/update`, {
  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({
    "warehouseId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "version": 1,
    "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"
}