Guía de Interacción con APIs de Sytex

1. Introducción

La API de Sytex permite integrar procesos mediante operaciones HTTP, facilitando la lectura y manipulación de datos dentro de la plataforma.Todas las solicitudes y respuestas utilizan el formato JSON.

Recomendaciones generales

  • Método HTTP: la mayoría de los endpoints utilizan POST.
  • Headers obligatorios:
  • Accept: application/json
  • Content-Type: application/json
  • Authorization: Token <su_token>
  • Organization: <id_org>
  • Dominio de producción: https://app.sytex.io/ (puede variar según la instancia).
  • Seguridad: el token está asociado a un usuario de Sytex y hereda sus permisos.
  • Respuestas: en caso de éxito, el servidor devuelve 200 OK. En caso contrario, la API devuelve un mensaje de error indicando el campo o parámetro a corregir.


2. Autenticación

Para acceder a cualquier endpoint es necesario un Token válido.Cada request debe incluir el header:
Authorization: Token <su_token>

Ejemplo:
Authorization: Token a87eb729487427d497250dd7d62692xbcc8e65op

Adicionalmente, todos los requests requieren un header con el número de organización:
Organization: 139



3. Endpoints principales

3.1 Actualizar estado de tareas

URL
https://app.sytex.io/api/import/TaskImport/go/

Ejemplo de request
{
  "code": "<task id>",
  "status_step": "En proceso"
}

Notas
  • El campo status_step debe contener el nombre del estado deseado.
  • Para pasar a Completada, la API valida automáticamente si los documentos obligatorios fueron adjuntados.
  • Si existen preguntas obligatorias en formularios asociados, deberán responderse antes de completar la tarea.


3.2 Añadir ítems en una Operación de Materiales (MO)

URL
https://app.sytex.io/api/import/SimpleOperationItemImport/go/

Ejemplo de request
{
  "destination_location": "1015",
  "destination_location_type": "Depósito virtual",
  "item_number": 1,
  "material": "10000405",
  "operation": "MO-R1-23-2186",
  "quantity": 1,
  "source_location": "1015",
  "source_location_type": "Depósito virtual"
}

Notas
  • Ajustar códigos de operación, material y locations según corresponda.
  • item_number define la línea a adicionar.
  • Los tipos de ubicación (Depósito virtual, Personal, Sitio, etc.) deben coincidir con los definidos en la importación.
  • Si los orígenes/destinos ya se definieron al crear la operación, no es necesario volver a indicarlos.


3.3 Actualizar estado de una MO

URL
https://app.sytex.io/api/import/SimpleOperationImport/go/

Ejemplo de request
{
  "code": "MO-M1-23-59835",
  "status_step": "Confirmada"
}

Notas
  • Igual que en tareas, el campo status_step debe contener el nombre del estado final requerido.


4. Gestión de interacciones y costo

El acceso a la API requiere una licencia mensual con las siguientes condiciones:
  • Costo: 110 USD/mes
  • Límite de requests: hasta 10.000 interacciones mensuales

Pushpin Este documento resume los puntos esenciales para comenzar a trabajar con la API. Para casos de uso avanzados o integraciones específicas, sugerimos coordinar una sesión técnica con el equipo de implementación.