Endpoints de la API. Especificación exacta de cada operación de la API v1 (parámetros, cuerpo, respuestas y ejemplos), generada del documento OpenAPI con el que se valida cada respuesta real. Los procedimientos completos están en Guías.

POST /products

Crear un producto

Da de alta un producto. El código (item_code, o sku) debe ser único en la instancia.

Alcance (cliente de integración): products:write
Permiso (token de usuario): inventory.manage
Idempotency-Key: Opcional

Cabeceras

Idempotency-Key string

Llave única por operación (se recomienda un UUID v4). Reenviar la misma solicitud con la misma llave en las siguientes 24 horas devuelve la respuesta original sin repetir la operación.

Cuerpo de la solicitud application/json

item_code string
sku string

Alias de item_code.
name string obligatorio
barcode string | null
type string | null
man_ser_num boolean | null
man_btch_num boolean | null
sales_unit string | null
purchase_unit string | null
inventory_item boolean | null

Respuestas

201 Producto creado. Location apunta al nuevo recurso.

data objeto obligatorio
14 campos de data
- id integer obligatorio
- item_code string obligatorio
  
  Código del producto en la instancia.
- sku string obligatorio
  
  Igual a item_code.
- name string obligatorio
- barcode string | null
- type string | null
- image_url string | null
- man_btch_num boolean
  
  Se maneja por lotes.
- man_ser_num boolean
  
  Se maneja por números de serie.
- sales_unit string | null
- purchase_unit string | null
- inventory_item boolean
- created_at string (date-time) | null
- updated_at string (date-time) | null

401 Falta el token o no es válido.

Cuerpo: el sobre de error.

402 La función no está en el plan de la empresa, o la cuenta está suspendida o cancelada.

Cuerpo: el sobre de error.

403 Al cliente le falta el alcance (missing_scope), al usuario el permiso (forbidden), o el token de usuario no tiene acceso a la ruta (client_not_allowed: aplicación móvil o usuario con verificación en dos pasos).

Cuerpo: el sobre de error.

409 Otra solicitud con la misma Idempotency-Key sigue en proceso.

Cuerpo: el sobre de error.

422 Datos no válidos (validation_failed), una llave de idempotencia reutilizada con otra solicitud (idempotency_key_reused) o una regla de negocio que bloquea la operación (rule_blocked).

Cuerpo: el sobre de error.

429 Se superó el límite por minuto. Reintente después de los segundos de Retry-After.

Cuerpo: el sobre de error.

Probar

Probar con una instancia

La solicitud sale del navegador hacia la instancia indicada; nada pasa por chainlink.mx. El token se conserva solo en esta pestaña.

Instancia https://.chainlink.mx Token de acceso

Obtener un token con un cliente de integración

Credenciales de Configuración › Clientes API (grant client_credentials). El secreto se usa una vez y no se guarda. Los tokens de usuario se obtienen fuera de la consola; ver Autenticación.

client_id client_secret

Alcances (scope)

Cuerpo (JSON) Esta solicitud modifica datos reales de la instancia.

Solicitud

curl -X POST "https://empresa.chainlink.mx/api/v1/products" \
  -H "Authorization: Bearer $CHAINLINK_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "item_code": "P-1004",
    "name": "Frijol negro 900 g",
    "barcode": "7501234567904",
    "man_btch_num": true,
    "sales_unit": "PZA"
}'

<?php

$client = new \GuzzleHttp\Client();
$response = $client->request('POST', 'https://empresa.chainlink.mx/api/v1/products', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('CHAINLINK_TOKEN'),
        'Accept' => 'application/json',
        'Idempotency-Key' => (string) \Ramsey\Uuid\Uuid::uuid4(),
    ],
    'json' => [
        'item_code' => 'P-1004',
        'name' => 'Frijol negro 900 g',
        'barcode' => '7501234567904',
        'man_btch_num' => true,
        'sales_unit' => 'PZA',
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch('https://empresa.chainlink.mx/api/v1/products', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CHAINLINK_TOKEN}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
      "item_code": "P-1004",
      "name": "Frijol negro 900 g",
      "barcode": "7501234567904",
      "man_btch_num": true,
      "sales_unit": "PZA"
  }),
});

const data = await response.json();

import os
import uuid

import requests

response = requests.post(
    "https://empresa.chainlink.mx/api/v1/products",
    headers={
        "Authorization": f"Bearer {os.environ['CHAINLINK_TOKEN']}",
        "Accept": "application/json",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "item_code": "P-1004",
        "name": "Frijol negro 900 g",
        "barcode": "7501234567904",
        "man_btch_num": True,
        "sales_unit": "PZA"
    },
)
data = response.json()

Respuesta

{
    "data": {
        "id": 104,
        "item_code": "P-1004",
        "sku": "P-1004",
        "name": "Frijol negro 900 g",
        "barcode": "7501234567904",
        "type": null,
        "image_url": null,
        "man_btch_num": true,
        "man_ser_num": false,
        "sales_unit": "PZA",
        "purchase_unit": null,
        "inventory_item": false,
        "created_at": "2026-10-06T16:20:11.000000Z",
        "updated_at": "2026-10-06T16:20:11.000000Z"
    }
}

{
    "error": {
        "code": "unauthenticated",
        "message": "Falta el token de acceso o ya no es válido.",
        "doc_url": "https://chainlink.mx/developers/errores#unauthenticated",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [],
    "message": "Falta el token de acceso o ya no es válido."
}

{
    "error": {
        "code": "feature_not_in_plan",
        "message": "Función no disponible en tu plan actual.",
        "feature": "webhooks.enabled",
        "upgrade_url": "/billing/plans",
        "doc_url": "https://chainlink.mx/developers/errores#feature_not_in_plan",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [],
    "message": "Función no disponible en tu plan actual."
}

{
    "error": {
        "code": "missing_scope",
        "message": "El cliente no tiene el alcance products:write.",
        "scope": "products:write",
        "doc_url": "https://chainlink.mx/developers/errores#missing_scope",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [],
    "message": "El cliente no tiene el alcance products:write."
}

{
    "error": {
        "code": "duplicate_in_flight",
        "message": "Esta solicitud ya se está procesando.",
        "doc_url": "https://chainlink.mx/developers/errores#duplicate_in_flight",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [],
    "message": "Esta solicitud ya se está procesando."
}

{
    "error": {
        "code": "validation_failed",
        "message": "El campo name es obligatorio.",
        "field": "name",
        "doc_url": "https://chainlink.mx/developers/errores#validation_failed",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [
        {
            "field": "name",
            "message": "El campo name es obligatorio."
        }
    ],
    "message": "El campo name es obligatorio."
}

{
    "error": {
        "code": "rate_limited",
        "message": "Superaste el límite de solicitudes por minuto. Espera los segundos que indica Retry-After.",
        "doc_url": "https://chainlink.mx/developers/errores#rate_limited",
        "request_id": "req_01j9x2m4k7q8r5t6v3w0y1z2a3"
    },
    "errors": [],
    "message": "Superaste el límite de solicitudes por minuto. Espera los segundos que indica Retry-After."
}