✏️ Actualizar Unidades de Paquete en el Carrito

Endpoint utilizado para actualizar la cantidad de unidades de un paquete dentro de una orden de compra existente.

PUT /ordenes-compras v1.0.0
Autenticación
Bearer Token
Ambiente
Servidor según ambiente (dev, test o prod). `guias-anticipadas-services-test.coordinadora.com` se define sin protocolo; el pipeline antepone `https://`.

Descripción

📝 Descripción:

  • Endpoint utilizado para actualizar la cantidad de unidades de un paquete dentro de una orden de compra existente.

Si unidades es 0, la línea del paquete se elimina del carrito.

🔒 Autenticación:

  • 🔑 Se requiere un token de autenticación válido como Bearer Token en el header Authorization.
  Authorization: Bearer <token>

Quick Start

  1. Obtén tus credenciales de acceso (Bearer Token).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

PUT /ordenes-compras

Base URL https://guias-anticipadas-services-test.coordinadora.com

Parámetros

Sin parámetros declarados.

Body *

{
    "type": "object",
    "required": [
        "nit",
        "email",
        "id_paquete",
        "unidades"
    ],
    "properties": {
        "nit": {
            "type": "string",
            "minLength": 1,
            "example": "900123456-1",
            "description": "🏢 NIT del cliente"
        },
        "email": {
            "type": "string",
            "minLength": 1,
            "example": "cliente@empresa.com",
            "description": "📧 Email del cliente"
        },
        "division": {
            "type": "string",
            "minLength": 1,
            "example": "DIV01",
            "description": "🏷️ División del cliente (opcional)"
        },
        "id_paquete": {
            "type": "integer",
            "minimum": 1,
            "example": 10,
            "description": "🔢 Identificador del paquete a actualizar"
        },
        "unidades": {
            "type": "integer",
            "minimum": 0,
            "example": 3,
            "description": "📦 Nueva cantidad de unidades. `0` elimina el paquete del carrito"
        }
    }
}

Ejemplo de request

{
    "nit": "900123456-1",
    "email": "cliente@empresa.com",
    "division": "DIV01",
    "id_paquete": 10,
    "unidades": 3
}

Respuesta

200
✅ Unidades actualizadas correctamente
{
    "isError": false,
    "data": [
        []
    ]
}

Ejemplo de respuesta

200 ✅ Unidades actualizadas correctamente 
{
    "isError": false,
    "data": [
        []
    ]
}

Errores

400
❌ Error de validación o de negocio
{
    "isError": true,
    "message": "Los valores de entrada no son correctos.",
    "code": "BAD_REQUEST",
    "statusCode": 400,
    "cause": "El campo unidades no puede ser negativo"
}
500
💥 Error interno del servidor
{
    "isError": true,
    "message": "Error al actualizar el carrito",
    "code": "CONFUSED",
    "statusCode": 500,
    "cause": "Default translator error"
}