Recuentos

Registrar lo contado

Registra lo contado de algunos artículos de un recuento en curso sin tocar el stock. Un artículo que no estaba en el recuento se agrega con su foto.

POST/api/v1/stock-movements/record-count

Permiso: stock-movements.count
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.

countIduuidrequerido
versionenterorequerido
mínimo 1
lineslista de objetorequerido
al menos 1, hasta 1000
Campos de cada elemento (2)
- itemIduuidrequerido
- countedQuantitycualquierarequerido

Respuesta

200 con este JSON.

iduuidrequerido
numbertextorequerido
statusopciónrequerido
Valores: in_progress review confirmed cancelled
warehouseobjetorequerido
Campos (4)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
- statusopciónrequerido
  Valores: active inactive
locationobjetorequeridoadmite null
Campos (3)
- iduuidrequerido
- codetextorequerido
- nametextorequerido
familyobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- nametextorequerido
blindsí o norequerido
notescualquierarequerido
countedLinesenterorequerido
mínimo 0
lineCountenterorequerido
mínimo 0
createdByobjetorequerido
Campos (2)
- idtextorequerido
- namecualquierarequerido
createdAtfecha y horarequerido
versionenterorequerido
mínimo 1
uncountedopciónrequeridoadmite null
Valores: keep zero
closingNotescualquierarequerido
closedAtfecha y horarequeridoadmite null
adjustmentobjetorequeridoadmite null
Campos (2)
- iduuidrequerido
- numbertextorequerido
lineslista de objetorequerido
Campos de cada elemento (9)
- itemobjetorequerido
  Campos (7)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
  - unitCodetextorequerido
  - unitNametextorequerido
  - allowsDecimalssí o norequerido
- countedcualquierarequerido
- snapshotnúmero
- movedcualquiera
- movedAfterPhotocualquiera
- systemcualquiera
- differencecualquiera
- unitCostcualquiera
- causeopciónrequeridoadmite null
  Valores: shrinkage breakage theft surplus

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 `stock-movements.count`.
`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/stock-movements/record-count" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "countId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "version": 1,
  "lines": [
    {
      "itemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
      "countedQuantity": null
    }
  ]
}'

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/stock-movements/record-count`, {
  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({
    "countId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "version": 1,
    "lines": [
      {
        "itemId": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "countedQuantity": null
      }
    ]
  }),
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
  "number": "texto",
  "status": "in_progress",
  "warehouse": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto",
    "status": "active"
  },
  "location": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "code": "texto",
    "name": "texto"
  },
  "family": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "name": "texto"
  },
  "blind": false,
  "notes": null,
  "countedLines": 1,
  "lineCount": 1,
  "createdBy": {
    "id": "texto",
    "name": null
  },
  "createdAt": "2026-10-23T14:30:00.000Z",
  "version": 1,
  "uncounted": "keep",
  "closingNotes": null,
  "closedAt": "2026-10-23T14:30:00.000Z",
  "adjustment": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "number": "texto"
  },
  "lines": [
    {
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active",
        "unitCode": "texto",
        "unitName": "texto",
        "allowsDecimals": false
      },
      "counted": null,
      "snapshot": 100,
      "moved": null,
      "movedAfterPhoto": null,
      "system": null,
      "difference": null,
      "unitCost": null,
      "cause": "shrinkage"
    }
  ]
}