eventId: la clave para detectar duplicados. Trátela como un texto opaco; no la analice.

sequence: un número que siempre aumenta por artículo y almacén. Es igual a lastSequence de GET /api/v1/stock/levels justo después del movimiento.

movementId, occurredAt: el movimiento de stock más reciente del evento y su hora (UTC).

ownerCustomerId: el comercio para el que se guarda el stock; null para su propio stock. partnerCustomerId: null, salvo en la copia del propietario que se describe más abajo.

fromLocationCode, toLocationCode: la ubicación de la que salieron las unidades y a la que entraron. Null significa fuera del stock (proveedor, cliente, corrección) o varias ubicaciones en un mismo evento.

reason: por ejemplo received, putaway, moved, adjusted, shipped, returned, scrapped, blocked, unblocked. Trate un valor que no conozca como un movimiento genérico.

documentType, documentId, movementCount: el documento de stock detrás del cambio y cuántos movimientos suma el evento.

quantity: unidades movidas. delta: cambio del stock físico en este almacén; 0 en un movimiento, una preparación o una ubicación dentro del almacén.

onHand, sellable, available: el nivel del artículo en este almacén justo después del movimiento.

ruleId: la alerta. crossing: cuenta las alertas de esta regla (1, 2, 3, etcétera).

warehouseId, warehouseCode: null cuando la alerta cuenta todos los almacenes juntos.

threshold: el nivel de alerta. available: las unidades disponibles cuando saltó la alerta.

transactionId, transactionKey, orderId: el pedido, como en fulfilment/packed.

picklistId: la lista de preparación. Null cuando un socio de fulfillment preparó el pedido por usted.

pickedAt: cuándo se completó la lista de preparación. hasShorts: true cuando al menos una línea de este pedido se preparó con faltante.

pickedByUserId: el preparador. Este campo está desactivado por defecto; actívelo con Customize payload. Null cuando preparó un socio de fulfillment.

sessionId: siempre null en este evento.

Recepciones: receipt/created, receipt/line_received (un evento por recepción registrada, con las líneas recibidas) y receipt/completed. Los campos incluyen receiptId, receiptNumber, state, warehouseCode, purchaseOrderId, reference, supplierName y totals.

Pedidos de compra: purchase_order/created, purchase_order/sent, purchase_order/received (también cuando se liquida un pedido de dropship) y purchase_order/closed (con reason). Los campos incluyen purchaseOrderId, purchaseOrderNumber, state, supplierName, expectedOn y las cantidades en totals.

Recuentos: count/completed (el recuento se ha enviado) y count/approved, con countId, kind, state y totals como líneas contadas y líneas con diferencia.

Contenedores: container/created, container/moved (con la ubicación anterior) y container/emptied (con la ubicación de destino, las líneas y la cantidad).

Tareas de equipo: task/created y task/completed, con taskId, title, status, dueAt y el objeto al que se refiere la tarea.

Preparación: picklist/assigned (una lista de preparación se asignó a un preparador), picklist/cancelled, picklist/batch_created (un lote creó varias listas de preparación; incluye sus ids) y fulfilment/snoozed (un pedido se pospuso o se quitó su aplazamiento; snoozed indica cuál).

Traslados: transfer/sent, transfer/received (un evento por recepción en el destino, con documentId y las lines recibidas), transfer/completed y transfer/cancelled. Los campos incluyen transferId, transferNumber, state, el almacén de origen y de destino, reference, expectedOn, sentAt, completedAt, shipping (transportista, número y enlace de seguimiento, bultos, peso) y las cantidades en totals. No pertenecen a ningún canal de venta.

Los eventos de recepciones ahora llevan supplierId cuando la recepción está vinculada a un proveedor. Los eventos de pedidos de compra añaden reference, supplierReference, supplierConfirmedAt y partialDeliveryAllowed, todavía sin precios.

Cada evento se entrega al menos una vez, así que el mismo evento puede llegar dos veces. Guarde los valores de eventId que ya procesó y omita el que ya ha visto.

Los eventos pueden llegar desordenados. Para stock/adjusted, guarde la última sequence por artículo de stock y almacén e ignore un evento con un número menor.

Para empezar, o para recuperarse después de una caída de su endpoint, lea los niveles con GET /api/v1/stock/levels y compare lastSequence. Tras una interrupción larga, los cambios de stock de más de 6 horas ya no se anuncian como stock/adjusted.

Un evento de stock no pertenece a ningún canal de venta. stock/adjusted y stock/low van a cada webhook activo de su cuenta que haya marcado el evento, también a un webhook configurado para un solo canal.

fulfilment/picked sigue el canal de venta del pedido, igual que fulfilment/packed, y necesita la estación de embalaje en su cuenta.

Una gran oleada de eventos de stock, por ejemplo tras una importación o un inventario completo, se reparte en los minutos siguientes. Nunca retrasa sus eventos de pedidos y de fulfilment.

Un webhook en pausa omite los eventos; no se ponen en cola.

Los eventos de recepciones, pedidos de compra, recuentos, contenedores, tareas de equipo, fulfilment/snoozed y los eventos de entradas tampoco pertenecen a ningún canal de venta. Cada webhook activo de su cuenta que los haya marcado los recibe, también un webhook configurado para un solo canal, y también cuando la estación de embalaje está desactivada. El destinatario es la cuenta a la que pertenece el documento del almacén.

Los eventos de listas de preparación siguen el canal de venta de la lista, como picklist/created.

Un webhook guardado hace menos de 15 segundos puede perder un evento de ese momento.

partnerCustomerId es el almacén del socio y ownerCustomerId es su propia cuenta.

fromLocationCode, toLocationCode, documentType y documentId son siempre null. Nunca recibe ubicaciones.

El eventId es distinto del que recibe su socio.

stock/low solo procede de sus propias alertas de stock bajo, nunca de las alertas de su socio.