Desarrolladores API v1

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.

GET /transfers/{id}

Consultar un traspaso

Alcance (cliente de integración)
transfers:read
Permiso (token de usuario)
Token válido
Idempotency-Key
No aplica

Parámetros de ruta

  • id integer obligatorio

    Identificador numérico del recurso.

Respuestas

200 El traspaso con sus líneas.
  • data objeto obligatorio
    13 campos de data
    • id integer obligatorio
    • status string obligatorio

      Igual a wms_status.

      Valores: pending, transferred, error
    • wms_status string
    • sap_status string | null

      Estado del envío al ERP.

    • from_whs_code string | null
    • to_whs_code string | null
    • doc_entry integer | string | null

      Número del documento en el ERP.

    • message string | null

      Respuesta del ERP cuando hubo error.

    • user_id integer | null
    • operator objeto | null

      La persona que hizo el trabajo.

      2 campos de operator
      • id integer obligatorio
      • name string | null obligatorio
    • created_at string (date-time) | null
    • updated_at string (date-time) | null
    • lines array de objetos obligatorio
      8 campos de lines
      • product_id integer | null
      • item_code string | null
      • qty number
      • from_position string | null
      • to_position string | null
      • batch string | null
      • serial string | null
      • status string | 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.

404 El recurso no existe.

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.

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.

Solicitud 
curl "https://empresa.chainlink.mx/api/v1/transfers/101" \
  -H "Authorization: Bearer $CHAINLINK_TOKEN" \
  -H "Accept: application/json"
Respuesta 
{
    "data": {
        "id": 1,
        "status": "pending",
        "wms_status": "pending",
        "sap_status": "pending",
        "from_whs_code": "CEDIS-GDL",
        "to_whs_code": "TDA-MTY",
        "doc_entry": null,
        "message": null,
        "user_id": 2,
        "operator": {
            "id": 2,
            "name": "Juan Pérez"
        },
        "created_at": "2026-10-06T16:20:11.000000Z",
        "updated_at": "2026-10-06T16:20:11.000000Z",
        "lines": [
            {
                "product_id": 1,
                "item_code": "P-1001",
                "qty": 12,
                "from_position": "R-10-01-1",
                "to_position": "MTY-A-01",
                "batch": "L2610",
                "serial": null,
                "status": "pending"
            }
        ]
    }
}