Ir al contenido
Inventario

FISCALISTO / API / REFERENCIA

Ver un movimiento

GET
/v1/stock_movements/{id}

Una entrada o salida de existencias, con lo que la causó (source).

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Una entrada o salida de existencias (el kárdex): una venta, una compra, un ajuste, un traspaso…

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor.

product*string

El producto (prd_…).

warehouse*string

El almacén (whs_…).

type*string

sale (una factura), purchase (una compra), customer_return, supplier_return, adjustment, count (conteo físico), transfer_out, transfer_in, initial, cost (un ajuste de costo) o reversal (deshace otro, como una factura cancelada).

Uno de"sale""purchase""customer_return""supplier_return""adjustment""count""transfer_out""transfer_in""initial""cost""reversal"
quantity*number

Cuánto entró (positivo) o salió (negativo).

unit_cost*number

El costo por unidad con que entró o salió, en pesos sin IVA.

value*number

quantity × unit_cost: lo que cambió el valor del inventario.

lot*|

El lote o número de serie, o null.

source*

Lo que lo causó: type invoice (id es el UUID del CFDI), adjustment (adj_…), receipt, transfer, count o ticket.

reason*|

El motivo de un ajuste, o null.

date*|

Cuándo pasó, hora de la Ciudad de México (la Fecha del CFDI en una venta).

reversed*boolean

true si un movimiento posterior lo deshizo.

created_at*|

Cuándo se registró.

curl -X GET 'https://api.fiscalisto.com/v1/stock_movements/string' \  -H 'Authorization: Bearer fk_test_…'
{  "id": "stm_OufpKqnrvx9p7",  "object": "stock_movement",  "livemode": false,  "issuer": "iss_OufpKqnrvx9p",  "product": "prd_OufpKqnrvx9p2",  "warehouse": "whs_OufpKqnrvx9p1",  "type": "sale",  "quantity": -2,  "unit_cost": 90,  "value": -180,  "lot": null,  "source": {    "type": "invoice",    "id": "5F1E8C2A-3B7D-4C9E-A1B2-C3D4E5F60718"  },  "reason": null,  "date": "2026-10-27T10:15:42",  "reversed": false,  "created_at": "2026-10-27T10:15:43-06:00"}