Integraciones
API REST y webhooks de Chainlink WMS
La API REST de Chainlink WMS conecta su ERP, su tienda en línea o un sistema propio con el almacén, con OAuth2, en todos los planes. Los webhooks firmados notifican cada evento en Professional y Enterprise.
- Disponible en
- API en todos los planes · webhooks en Professional y Enterprise
- Autenticación
- OAuth2 con cliente de API
- Webhooks
- Firmados con HMAC-SHA256
- Especificación
- OpenAPI 3.1
Revisado el 23 de octubre de 2026 por el Equipo de Business in a Wave
¿Qué se puede hacer con la API?
Su ERP envía órdenes y pedidos, el almacén los ejecuta y su sistema recibe el resultado por webhook o lo consulta.
- Productos, almacenes, ubicaciones y socios
- Existencias por ubicación, lote y serie
- Documentos, recepciones, surtidos y transferencias
- Carga masiva
¿Cómo se autentica una integración?
Con un cliente de API creado en Configuración › Integraciones › Clientes de la API.
- Con su identificador y su secreto se solicita un token OAuth2
- El secreto se muestra una sola vez; al revocar el cliente, se anula el acceso
- Wizard, impresoras y lectores usan tokens de dispositivo
¿Cómo se reintenta una escritura sin duplicar documentos?
Con el encabezado Idempotency-Key, repetir una escritura devuelve el documento ya creado en lugar de crear otro.
- Los documentos aceptan el folio de su sistema como referencia externa
¿Cómo se mantiene sincronizado un ERP?
Los listados aceptan updated_since: su ERP consulta solo lo que cambió desde su último ciclo.
- Con webhooks, el aviso llega en cuanto ocurre el evento
¿Qué límites tiene cada plan?
Al exceder el límite por minuto, la API responde 429 con Retry-After.
| Función | Essentials | Professional | Enterprise |
|---|---|---|---|
| API REST | Sí | Sí | Sí |
| Solicitudes por minuto | 60 | 300 | Por contrato |
| Clientes de API | 1 | 5 | Por contrato |
| Renglones por archivo de carga masiva | 2,000 | 10,000 | Por contrato |
| Webhooks | No | Sí | Sí |
¿Qué eventos notifican los webhooks?
Una suscripción elige sus eventos: recepciones, surtidos, transferencias, embarques, devoluciones, conteos, productos y existencias.
- Firma HMAC-SHA256 con el secreto de la suscripción
- Su sistema responde 2xx en menos de 15 segundos
- Hasta 5 reintentos, de 10 segundos a 10 minutos, y reencolado por hora durante 24 horas
- El mismo identificador de entrega en cada reintento
¿Dónde está la documentación técnica?
OpenAPI en JSON y YAML y una colección de Postman, en el portal de desarrolladores.
Cómo se configura
Artículos del centro de ayuda con los pasos dentro de Chainlink.
Siga leyendo
Preguntas frecuentes
Para cualquier otra consulta, contacte a ventas.
¿La API tiene costo aparte? +
No. La API está incluida en todos los planes; el plan define cuántas solicitudes por minuto y cuántos clientes de API puede tener su empresa. Los webhooks están en Professional y Enterprise.
¿La API permite crear conteos? +
No. La API pública no tiene conteos; el resultado de un conteo llega a su sistema por webhook cuando se finaliza.
¿Qué responde la API si el plan no incluye una función? +
Responde 402. Al exceder el límite por minuto responde 429 con el encabezado Retry-After, y una solicitud con datos inválidos recibe 422 con el campo por corregir.
Contrate Chainlink en línea
Su instancia se crea al terminar el alta, lista para configurar su almacén.
Essentials y Professional se contratan en línea con tarjeta: al contratar se cobran el primer mes y la implementación. Prueba de 30 días por invitación: solicítela a ventas.