Descripción general de la API

Maxim

Maxim

Última actualización el Oct 8, 2026

La API de Controlata permite que sistemas externos (un sitio web, un CRM, un sistema contable o un marketplace) trabajen con tus datos en Controlata: gestionar el catálogo de materiales, productos y recursos, crear ventas, compras, producciones, bajas, traslados e inventarios físicos, y leer las existencias en los almacenes.

La conexión requiere experiencia en programación y con APIs. Si no eres desarrollador, entrega esta documentación a un especialista técnico o a un asistente de IA: cada artículo se puede copiar en formato Markdown.

Conexión

  1. Abre Configuración → Integraciones y pulsa Conectar junto a API general.
  2. Copia la Clave API. Autoriza todas las solicitudes.
  3. Si lo necesitas, cambia el Prefijo del número de venta. El valor por defecto es «A-».

Dirección base y formato de las solicitudes

Dirección base de la API:

https://api.controlata.com/connect/

En esta documentación las rutas de los métodos se indican respecto a esta dirección. Por ejemplo, el método v1/materials/add se llama en https://api.controlata.com/connect/v1/materials/add.php. El primer segmento de la ruta es la versión del método: una versión nueva aparece solo si la respuesta cambia de forma incompatible, y la anterior sigue funcionando.

  • Todos los métodos se llaman con una solicitud POST.
  • Cuerpo de la solicitud: JSON en UTF-8, encabezado Content-Type: application/json.

La API está pensada para solicitudes desde tu servidor. Las solicitudes desde un navegador en otro dominio se rechazan con el código 401.

Autorización

Pasa la Clave API en el encabezado Authorization tal cual, sin la palabra Bearer:

Authorization: tu_clave_api

Ejemplo de solicitud:

curl -X POST https://api.controlata.com/connect/v1/storages/get_list.php \
  -H "Authorization: tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{}'

Respuestas y errores

Una respuesta correcta llega con el código 200 y el campo success igual a true. El resto de los campos dependen del método:

{
    "success": true,
    "material_id": 2051
}

En caso de error, success es false y el campo error contiene una descripción en inglés:

{
    "success": false,
    "error": "Material not found or access denied"
}
Código HTTP Cuándo Cuerpo de la respuesta
200 Solicitud ejecutada JSON, success: true
400 Error en los datos de la solicitud: falta un campo obligatorio, un valor no válido, no se encuentra un registro JSON, success: false
401 Falta la Clave API o no es válida Vacío
429 Límite diario de solicitudes alcanzado JSON, success: false
500 Error interno JSON, success: false

Si falta un campo obligatorio, el error se ve como «No in input», por ejemplo «No material_id in input». El resto de los errores se enumeran en el artículo de cada método.

Límite de solicitudes

Una empresa puede enviar hasta 10 000 solicitudes al día. Se cuentan todas las solicitudes con una clave válida, incluidas las que terminan en error. El contador se reinicia una vez al día, por la noche. Al superar el límite, la API responde con el código 429 y el error «Daily connections limit reached».

Qué sigue

Controlata guarda un registro de las solicitudes a la API. Si una solicitud no funciona como esperas, escribe al soporte e indica el método y la hora de la solicitud.