Stock

Valuar el stock

Valúa el stock a costo promedio o a los precios sin IVA de una lista, por fila y en total, con los mismos filtros de los saldos.

GET/api/v1/stock/get-valuation

Permiso: stock.view-valuation
Empresa: Opera sobre la empresa activa
Tipo: Lectura: no cambia nada
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.

Parámetros de la consulta

searchtextoadmite null
hasta 100 caracteres
warehouseIduuidadmite null
familyIduuidadmite null
brandIduuidadmite null
balanceopción
Valores: with-stock without-stock allPor defecto: with-stock
sortopción
Valores: code item warehouse physical available cost valuePor defecto: code
directionopción
Valores: asc descPor defecto: asc
baseopción
Valores: book commercialPor defecto: book
priceListIduuidadmite null
groupByopción
Valores: warehouse itemPor defecto: warehouse
itemIdsuno deadmite null
Una de 2 formas
Forma 1
- valortextorequerido
Forma 2
- valorlista de textorequerido
pageentero
Por defecto: 1mínimo 1
pageSizeentero
Por defecto: 50mínimo 1, máximo 100

Respuesta

200 con este JSON.

baseopciónrequerido
Valores: book commercial
labeltextorequerido
priceListobjetorequeridoadmite null
Campos (3)
- iduuidrequerido
- nametextorequerido
- currencyCodetextorequerido
currencyCodetextorequerido
priceDatecualquierarequerido
rowslista de objetorequerido
Campos de cada elemento (9)
- itemobjetorequerido
  Campos (7)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
  - unitCodetextorequerido
  - unitNametextorequerido
  - allowsDecimalssí o norequerido
- warehouseobjetorequerido
  Campos (4)
  - iduuidrequerido
  - codetextorequerido
  - nametextorequerido
  - statusopciónrequerido
    Valores: active inactive
- physicalnúmerorequerido
- unavailablenúmerorequerido
- reservednúmerorequerido
- availablenúmerorequerido
- averageCostcualquiera
- bookValuecualquiera
- valuecualquierarequerido
totalenterorequerido
mínimo 0
totalValuetextorequerido
rowsWithoutValueenterorequerido
mínimo 0
itemsWithoutValueenterorequerido
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 `stock.view-valuation`.
`409`	La empresa activa no es la de `X-Expected-Company`.
`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 "$ERP_URL/api/v1/stock/get-valuation" \
  -b sesion.txt \
  -H "X-Expected-Company: $ERP_EMPRESA"

const respuesta = await fetch(`${process.env.ERP_URL}/api/v1/stock/get-valuation`, {
  headers: {
    Cookie: process.env.ERP_SESION!,
    "X-Expected-Company": process.env.ERP_EMPRESA!,
  },
});
if (!respuesta.ok) throw new Error((await respuesta.json()).title);
const datos = await respuesta.json();

{
  "base": "book",
  "label": "texto",
  "priceList": {
    "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
    "name": "texto",
    "currencyCode": "texto"
  },
  "currencyCode": "texto",
  "priceDate": null,
  "rows": [
    {
      "item": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active",
        "unitCode": "texto",
        "unitName": "texto",
        "allowsDecimals": false
      },
      "warehouse": {
        "id": "3f2a9c1e-5b7d-4e8a-9c21-7d4e5f6a8b90",
        "code": "texto",
        "name": "texto",
        "status": "active"
      },
      "physical": 100,
      "unavailable": 100,
      "reserved": 100,
      "available": 100,
      "averageCost": null,
      "bookValue": null,
      "value": null
    }
  ],
  "total": 1,
  "totalValue": "texto",
  "rowsWithoutValue": 1,
  "itemsWithoutValue": 1
}