En esta guía obtendrás un token, crearás un producto en el catálogo y lo consultarás para confirmar que se dio de alta. Necesitas que la API esté habilitada para tu tenant y un usuario cuyo rol incluya el permiso inventory.manage (editar productos e inventario).

Antes de empezar

Reemplaza tu-empresa por el subdominio de tu organización en todos los ejemplos. La URL base es https://tu-empresa.chainlink.mx/api/v1.

Paso 1 · Obtén un token

Inicia sesión con tu usuario del tenant para recibir un access_token:

cURL

TOKEN=$(curl -s -X POST "https://tu-empresa.chainlink.mx/api/login" \
  -H "Accept: application/json" -H "Content-Type: application/json" \
  -d '{"username":"tu_usuario","password":"tu_contraseña"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['access_token'])")

echo "Token: $TOKEN"

Paso 2 · Crea un producto

Envía un POST a /api/v1/products. Solo item_code y name son obligatorios; el resto de los campos son opcionales.

cURL

curl -X POST "https://tu-empresa.chainlink.mx/api/v1/products" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "item_code": "SKU-001",
    "name": "Producto de ejemplo",
    "barcode": "7501000000017",
    "sales_unit": "PZA",
    "purchase_unit": "PZA",
    "inventory_item": true
  }'

La API responde 201 Created con el producto creado:

Respuesta 201

{
  "data": {
    "id": 128,
    "item_code": "SKU-001",
    "sku": "SKU-001",
    "name": "Producto de ejemplo",
    "barcode": "7501000000017",
    "type": null,
    "image_url": null,
    "man_btch_num": false,
    "man_ser_num": false,
    "sales_unit": "PZA",
    "purchase_unit": "PZA",
    "inventory_item": true,
    "created_at": "2026-07-20T18:00:00.000000Z",
    "updated_at": "2026-07-20T18:00:00.000000Z"
  }
}

Si recibes 403 Forbidden, tu token no tiene el permiso inventory.manage. Si recibes 422, revisa los mensajes de validación (por ejemplo, item_code ya existe: debe ser único). Consulta Errores.

Paso 3 · Consúltalo

Verifica el alta buscando por su código con el endpoint universal de lookup:

cURL

curl "https://tu-empresa.chainlink.mx/api/v1/lookup/SKU-001" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Con esto diste de alta y consultaste un producto. Continúa en la referencia de Productos para actualizar, listar y borrar, o revisa Inventario para consultar existencias.

Referencia de Productos → Convenciones de la API