Documentación de la API v4.12

Conecta tus sistemas con el piso del almacén.

La API REST y los webhooks firmados de InventoryHero conectan tu ERP, tu middleware SAP, tu comercio electrónico y tus herramientas de reportes. Consulta artículos, inventario y el libro de movimientos, registra recepciones y traslados, y entérate de cada movimiento en el momento en que ocurre.

Referencia del API Leer la guía

El documento OpenAPI para generadores de código y clientes de API está en inventory.klovio.app/api/v4/openapi.json

Solicitud

GET /api/v4/items?externalRef=100042
Host: inventory.klovio.app
Authorization: Bearer ihk_…

200 OK
{
  "data": {
    "items": [{
      "sku": "SKU-000214",
      "name": "Guantes de nitrilo, caja de 100",
      "externalRef": "100042",
      "uom": "box",
      "status": "active"
    }]
  }
}

Endpoints

Qué cubre la API

39 endpoints en diez grupos. Las listas se paginan con un cursor, y cada llamada sigue los mismos roles y reglas que la app.

Artículos

Tu catálogo. Crea y actualiza artículos, búscalos por referencia ERP y exporta todo a CSV.

GET/itemsPOST/itemsGET/items/{id}PATCH/items/{id}GET/items/export

Proveedores

Proveedores con referencia ERP. Eliminar uno conserva su historial.

GET/vendorsPOST/vendorsGET/vendors/{id}PATCH/vendors/{id}DELETE/vendors/{id}

Órdenes de compra

Crea órdenes desde tu ERP al liberarlas y recibe contra ellas.

GET/purchase-ordersPOST/purchase-ordersGET/purchase-orders/{id}PATCH/purchase-orders/{id}POST/purchase-orders/{id}/receive

Inventario

Saldos, el libro de movimientos, y recibir, dar salida, ajustar y trasladar inventario.

GET/stockGET/stock/ledgerPOST/stock/receivePOST/stock/issuePOST/stock/adjustPOST/stock/transferGET/adjustment-reasons

Lotes

Libera, retén, pon en cuarentena o rechaza un lote.

GET/lotsPATCH/lots/{id}/status

Sitios y ubicaciones

Tus almacenes y cada ubicación dentro de ellos.

GET/sitesGET/sites/{id}/locations

Escaneo

Resuelve cualquier código: una etiqueta GS1, un código de artículo, un SKU, un serial o EPC, o una ubicación.

GET/scan/{code}

Reportes

Cualquier reporte en JSON, o en Excel o PDF con ?format=.

GET/reports/{report}

Webhooks

Crea, actualiza, prueba, rota el secreto y reintenta entregas desde código.

GET/org/webhooksPOST/org/webhooksPATCH/org/webhooks/{id}DELETE/org/webhooks/{id}POST/org/webhooks/{id}/rotate-secretPOST/org/webhooks/{id}/testGET/org/webhooks/{id}/deliveriesPOST/org/webhooks/{id}/deliveries/{deliveryId}/retry

Tokens de API

Lista, crea y revoca tokens.

GET/org/api-tokensPOST/org/api-tokensDELETE/org/api-tokens/{id}

Hecha para integraciones que corren sin supervisión

Segura desde el inicio

Tokens con alcances

Dale a cada integración su propio token con el rol más bajo que haga el trabajo y limítalo con alcances. Los tokens pueden vencer en 30, 90 o 365 días y se revocan al instante.

Reintentos sin registros dobles

Envía un X-Request-Id con recepciones y traslados. Si una llamada expira y la reintentas, se repite la primera respuesta en lugar de recibir el inventario dos veces.

Referencias ERP

Guarda la clave de tu ERP en artículos, proveedores y órdenes de compra, búscalos con ?externalRef= y recíbela en cada lista, reporte, fila del libro de movimientos y webhook.

Solo lo que cambió

Consulta los cambios desde tu última corrida con updatedSince e includeDeleted. Las filas del libro de movimientos nunca cambian, así que un periodo que ya leíste es definitivo.

Reportes en cualquier formato

Cada reporte llega en JSON, o agrega ?format=xlsx o ?format=pdf para descargarlo.

Auditada como la app

Cada cambio hecho por la API queda en el registro de auditoría con el nombre del token, y la API nunca puede hacer más de lo que el rol del token podría hacer en la app.

Tokens y solicitudes

Los administradores crean tokens en Configuración → Tokens de API. Elige un rol (Administrador, Gerente u Observador), desmarca los alcances que la integración no necesita y copia el token: se muestra una sola vez y funciona para un solo espacio de trabajo.

Alcance→Permite

Lectura readTodas las listas, detalles y reportes, el libro de movimientos, la agenda de camiones

Registrar inventario stock:writeRecibir, dar salida, ajustar, trasladar, recibir contra orden de compra, registros en caseta

Liberar y retener lotes quality:writeCambios de estado de lote

Editar catálogo catalog:writeArtículos, proveedores, categorías, sitios y ubicaciones, importaciones, impresión de etiquetas

Gestionar órdenes orders:writeÓrdenes de compra y de surtido

Administración adminConfiguración de la organización, usuarios, tokens de API, webhooks

Convenciones

URL basehttps://inventory.klovio.app/api/v4

AutenticaciónAuthorization: Bearer ihk_…

Respuestas{ "data": … } si todo sale bien, { "error": { "code", "message", "field" } } si falla

PaginaciónEnvía el cursor de vuelta como ?cursor=. ?limit= es 50 por defecto, máximo 200

Horas y fechasISO 8601 en UTC. Las fechas son AAAA-MM-DD

CantidadesEn la unidad de inventario del artículo. El dinero va en centavos

Webhooks

Se configuran en Configuración → Webhooks. Cada webhook muestra su estado, las últimas 50 entregas con la respuesta del receptor y el contenido exacto que se envió. Enviar prueba, Reintentar, Rotar secreto y Pausar están a un clic.

Evento→Cuándo

stock.receivedSe registró una recepción sin orden de compra

purchase_order.receivedSe recibió inventario contra una orden de compra

stock.issuedSalió inventario del almacén

stock.adjustedSe corrigió un saldo

stock.transferredSe movió inventario entre ubicaciones o sitios

purchase_order.createdSe creó una orden de compra

purchase_order.updatedCambió una orden de compra (estado, líneas, fechas)

lot.status_changedUn lote fue liberado, retenido, puesto en cuarentena o rechazado

shortage.detectedEl barrido diario encontró artículos bajo el mínimo

pingPulsaste Enviar prueba

Entrega

POST https://your-system.example.com/inventoryhero
X-Klovio-Event: purchase_order.received
X-Klovio-Delivery: 01M4K4YHM335KQ1VNYH1ND8245
X-Klovio-Signature: t=1791600000,sig=5f1c…

{
  "event": "purchase_order.received",
  "attempt": 1,
  "data": {
    "poNumber": "PO-1042",
    "externalRef": "4500012345",
    "status": "partial",
    "lines": [{ "sku": "SKU-000214", "qty": 24, "lotCode": "L2610-07" }]
  }
}

Responde con cualquier 2xx en menos de 10 segundos. Cualquier otra respuesta se reintenta a 1 minuto, 5 minutos, 15 minutos, 1 hora, 4 horas, 12 horas y 24 horas, siempre con el mismo id, así que es fácil ignorar duplicados. La firma en X-Klovio-Signature es el HMAC-SHA256 de t.body con tu secreto de firma; rechaza todo lo que tenga más de cinco minutos.

Integración ERP

Conectar SAP

Leer la guía de integración con SAP →

Cada instalación de SAP es distinta, así que Klovio entrega el enlace con SAP como un proyecto con alcance definido junto con tu equipo de SAP. Trabajamos dentro de tu plataforma de integración (SAP Integration Suite, Boomi, MuleSoft) o ponemos el middleware.

Fase 1 · Disponible hoy

Intercambio de archivos

SAP exporta órdenes de compra e InventoryHero las importa. InventoryHero exporta recepciones e inventario y SAP los importa, diario o cada hora.

Fase 2 · Proyecto de integración

Enlace en vivo

SAP crea las órdenes de compra por la API al liberarlas. Las entradas de mercancía, las salidas y las correcciones de inventario llegan a SAP por webhooks en el momento en que ocurren en el piso.

SAP→InventoryHero

Número de material (MATNR)Artículo · items.externalRef

Número de proveedor (LIFNR)Proveedor · vendors.externalRef

Orden de compra (EBELN)Orden de compra · purchaseOrders.externalRef

Centro / almacén (WERKS / LGORT)Sitio y ubicación

Lote (CHARG)Lote · lotCode

Unidad de medida base (MEINS)Unidad de inventario · uom

Otros ERPNetSuite Dynamics 365 Acumatica Sage Prophet 21

Versiones

La versión actual es la 4.12. Dentro de una versión solo agregamos campos, endpoints, eventos y parámetros opcionales nuevos. Nada se elimina, se renombra ni cambia de significado. Un cambio que pudiera romper a un cliente saldría como una versión nueva, con la anterior funcionando al menos doce meses más y aviso por correo a los administradores.

Historial de cambios

Octubre de 2026Referencias ERP en artículos, proveedores y órdenes de compra; filtros updatedSince, includeDeleted, since y until; webhooks firmados con reintentos; vencimiento y alcances de tokens; el documento OpenAPI.

Septiembre de 2026Tokens de API, artículos, proveedores, órdenes de compra, registro de inventario, libro de movimientos, reportes.

Planea tu integración con nosotros.

Cuéntanos qué sistemas necesitas conectar. Lo definimos con tu equipo y lo probamos en un espacio de trabajo de pruebas antes de tocar producción.

Habla con nosotros