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 __HTMLTAG0__
Organization: __HTMLTAG0__
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.