Cambiar Estado de Artículo

CAMBIAR ESTADO DE ARTÍCULO

CABECERA

Endpoint para cambiar el estado de un artículo (activo/inactivo) en el sistema TitanicSoft desde Synergy. Permite activar o suspender artículos sin eliminarlos de la base de datos.

Endpoint: /api/articulo/estado

• PUT - Para cambiar el estado del artículo (activo o inactivo)

---

CUERPO

JSON de Ejemplo (Payload)

{
    "synergy_id": "1234",
    "activo": 1
}

---

Validaciones Detalladas

Atributo	Valor Esperado	Tipo de dato	Requisito	Longitud
synergy_id	Ejemplo: “1234” - Identificador único del artículo en Synergy	String	obligatorio	1 hasta 30
activo	0 = Inactivo/Suspendido 1 = Activo	Integer	obligatorio	1 exacto

Nota: El campo activo también acepta valores booleanos (true/false) y strings ("true"/"false", "0"/"1") que se normalizan automáticamente.

---

RESPUESTA EXITOSA

Código HTTP 201

{
    "codigo_http": 201,
    "estado": "Update",
    "synergy_id": "1234",
    "mensaje": "El articulo se actualizo correctamente"
}

---

POSIBLES ERRORES DE VALIDACIÓN

1. Método HTTP No Permitido - Código 405

Escenario: Se utiliza un método diferente a PUT (GET, POST, DELETE, etc.)

{
    "codigo_http": 405,
    "estado": "method_not_allowed",
    "mensaje": "Método no permitido"
}

---

2. Error de Validación de Campos - Código 400

Escenario: Los datos enviados no cumplen con las reglas de validación

Ejemplo 1: Campo requerido faltante

{
    "codigo_http": 400,
    "estado": "validation_error",
    "mensaje": "Error en la validación",
    "detalles": {
        "synergy_id": "El campo synergy_id es requerido"
    }
}

Ejemplo 2: Valor de ‘activo’ inválido

{
    "codigo_http": 400,
    "estado": "validation_error",
    "mensaje": "Error en la validación",
    "detalles": {
        "activo": "El campo activo debe ser 0 o 1"
    }
}

---

3. Artículo No Encontrado - Código 404

Escenario: El synergy_id proporcionado no existe en la base de datos

{
    "codigo_http": 404,
    "estado": "not_found",
    "mensaje": "Artículo no encontrado con el synergy_id proporcionado"
}