### Create Web Order - API Request Example

Source: https://apicvaservices.grupocva.com/documentation/index

This example shows how to create a web order using the API. It includes optional parameters like 'test' for trial orders and 'cotiza_flete' to include shipping costs. The request body is a JSON object specifying order details, shipping information, and products.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/pedidos_web/crear_orden' \
--header 'Authorization: Bearer TU_API_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "test": 1, // Opcional, (genera pedidos de prueba)
    "num_oc": "452069",
    "codigo_sucursal": 1,
    "observaciones": "Aqui van las observaciones que quiera darle a su pedido.",
    "tipo_flete": "FF",
    "cotiza_flete": 1, // Opcional (agrega la cotizacion del flete del pedido en la respuesta)
    "flete": {
        "calle": "Circ. Jorge Álvarez del Castillo",
        "numero": "1517",
        "numero_interior": "C",
        "cp": "44610",
        "colonia": "Country Club",
        "estado": 15,
        "ciudad": 558,
        "paqueteria": 6,
        "atencion": "John Doe"
    },
    "productos": [
        {
            "clave": "HD-3235",
            "cantidad": 1
        }
    ]
}'
```

--------------------------------

### GET /api/v2/catalogo_clientes/soluciones

Source: https://apicvaservices.grupocva.com/documentation/index

Lists the available solutions catalog.

```APIDOC
## Soluciones

### Description
Lists the available solutions catalog.

### Method
GET

### Endpoint
/api/v2/catalogo_clientes/soluciones

### Parameters
#### Query Parameters
None

#### Request Body
None

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/soluciones'
```

### Response
#### Success Response (200)
- **soluciones** (array) - A list of solution objects.
  - **clave** (string) - The solution's unique identifier.
  - **descripcion** (string) - The description of the solution.

#### Response Example
```json
{
    "soluciones": [
        {
            "clave": "1",
            "descripcion": "ALMACENAMIENTO"
        },
        {
            "clave": "2",
            "descripcion": "CABLEADO ESTRUCTURADO"
        }
    ]
}
```
```

--------------------------------

### Buscar productos por marca (HTTP GET)

Source: https://apicvaservices.grupocva.com/documentation/index

Consulta la API para obtener productos filtrados por marca. Este endpoint es útil para listar inventario de un fabricante específico. La solicitud GET es insensible a mayúsculas y minúsculas.

```HTTP
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?marca=acteck
```

--------------------------------

### Buscar producto por número de pieza (HTTP GET)

Source: https://apicvaservices.grupocva.com/documentation/index

Realiza una búsqueda de producto utilizando el código del fabricante como parámetro. Esta es una solicitud GET a la API que devuelve los detalles del producto si la consulta es exitosa.

```HTTP
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?codigo=6QN28A#BGJ
```

--------------------------------

### Shipping Guides Documentation

Source: https://apicvaservices.grupocva.com/documentation/index

Access the comprehensive documentation for shipping guides.

```APIDOC
## GET /documentation/shipping-guides

### Description
Provides a link to the detailed documentation regarding shipping guides.

### Method
GET

### Endpoint
/documentation/shipping-guides

### Response
#### Success Response (200)
- **documentation_url** (string) - URL to the shipping guides documentation.

#### Response Example
```json
{
  "documentation_url": "https://example.com/docs/shipping-guides"
}
```
```

--------------------------------

### Get Product Catalog (Full)

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves the complete list of available products in the catalog. If no query parameters are provided, the full catalog is returned.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves the complete list of products available in the catalog. This is the default behavior when no query parameters are specified.

### Method
GET

### Endpoint
`https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios`

### Headers
- `Authorization`: Bearer TU_API_TOKEN

### Query Parameters
- **codigo** (string) - Optional - CVA code of the product.
- **clave** (string) - Optional - Manufacturer's code (part number). This parameter has higher precedence than `codigo`.
- **marca** (string) - Optional - Brand name.
- **grupo** (string) - Optional - Group name.
- **desc** (string) - Optional - Free text search string.
- **porcentaje** (float) - Optional - Increases the price by the indicated percentage to calculate profit.
- **MonedaPesos** (bool) - Optional - Returns prices in Mexican Pesos (deprecated).
- **subgrupo** (bool) - Optional - Returns the product's sub-group.
- **dt** (bool) - Optional - Returns the technical description.
- **dc** (bool) - Optional - Returns the commercial description.
- **TipoProducto** (bool) - Optional - Returns the product type (product or package).
- **depto** (bool) - Optional - Returns the department the product belongs to.
- **codigosat** (bool) - Optional - Returns SAT (Mexican tax authority) required information.
- **page** (int) - Optional - The page number to query from the response.

### Request Example
```http
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios
Authorization: Bearer TU_API_TOKEN
```

### Response
#### Success Response (200)
- **articulos** (array) - An array of product objects.
  - **id** (integer) - Product ID.
  - **clave** (string) - Manufacturer's part number.
  - **codigo_fabricante** (string) - Manufacturer's code.
  - **descripcion** (string) - Product description.
  - **principal** (string) - Primary category.
  - **grupo** (string) - Product group.
  - **disponible** (integer) - Availability status.
  - **marca** (string) - Product brand.
  - **garantia** (string) - Warranty information.
  - **clase** (string) - Product class.
  - **moneda** (string) - Currency.
  - **precio** (float) - Product price.
  - **imagen** (string) - URL of the product image.
  - **disponibleCD** (integer) - Availability at distribution center.

#### Response Example
```json
{
  "articulos": [
    {
      "id": 10431032,
      "clave": "SWS-5678",
      "codigo_fabricante": "HW-POS-NST1789I5-W-8GB/240GB",
      "descripcion": "SOFT RESTAURANT PUNTO DE VENTA POS 17 PULG/CORE I5/8GB RAM/240GB SSD/WINDOWS/VESA",
      "principal": "SOFTWARE",
      "grupo": "SOFTWARE",
      "disponible": 0,
      "marca": "SOFT RESTAURANT",
      "garantia": "SG",
      "clase": "AC",
      "moneda": "Pesos",
      "precio": 15877.44,
      "imagen": "https://www.grupocva.com/detalle_articulo/10431032.jpg",
      "disponibleCD": 0
    }
    // ... More articles
  ]
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/lista_precios

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves pricing information for products, with an option to include package details.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves pricing information for products, with an option to include package details. The `TipoProducto` query parameter determines if detailed package information is returned.

### Method
GET

### Endpoint
`/api/v2/catalogo_clientes/lista_precios`

### Parameters
#### Query Parameters
- **clave** (string) - Required - The product or package key.
- **TipoProducto** (boolean) - Optional - If true, includes the `producto_paquete` field in the response. Defaults to false.

### Request Example
```
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PAQ-586&TipoProducto=true' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **id** (integer) - Unique identifier for the product.
- **clave** (string) - Product or package key.
- **codigo_fabricante** (string) - Manufacturer's code.
- **descripcion** (string) - Product description.
- **principal** (null) - Placeholder for primary information.
- **grupo** (null) - Placeholder for group information.
- **disponible** (integer) - Availability status.
- **marca** (null) - Product brand.
- **garantia** (string) - Warranty information.
- **clase** (string) - Product class.
- **moneda** (string) - Currency of the price.
- **precio** (float) - Product price.
- **imagen** (string) - URL of the product image.
- **disponibleCD** (integer) - Availability at distribution center.
- **producto_paquete** (object) - Contains details about the package if `TipoProducto` is true. 
  - **tipo** (string) - Type of product, either 'PRODUCTO' or 'PAQUETE'.
  - **componentes** (string) - Comma-separated list of CVA keys for products that make up the package (only if `tipo` is 'PAQUETE').

#### Response Example
```json
{
    "id": 10132410,
    "clave": "PAQ-586",
    "codigo_fabricante": "DELL",
    "descripcion": "Kit Teclado KB-645 Mouse MS-1105",
    "principal": null,
    "grupo": null,
    "disponible": 0,
    "marca": null,
    "garantia": "SG",
    "clase": "AC",
    "moneda": "Pesos",
    "precio": 307.52,
    "imagen": "https://www.grupocva.com/detalle_articulo/10132410.jpg",
    "disponibleCD": 0,
    "producto_paquete": {
        "tipo": "PAQUETE",
        "componentes": "MS-1105, KB-645"
    }
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/lista_precios

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves product information. This endpoint can be used to get details for a specific product using its key or to get a list of all products. It supports various query parameters to include additional information in the response.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves product information. This endpoint can be used to get details for a specific product using its key or to get a list of all products. It supports various query parameters to include additional information in the response.

### Method
GET

### Endpoint
/api/v2/catalogo_clientes/lista_precios

### Query Parameters
- **clave** (string) - Optional - The product key to filter results.
- **subgpo** (bool) - Optional - If true, displays the product's sub-group name. Defaults to false.
- **tc** (bool) - Optional - If true, includes dollar exchange rate and its last update date. Defaults to false.
- **tipo** (bool) - Optional - If true, adds a 'TipoProducto' key to the JSON response, indicating product availability status. Defaults to false.
- **depto** (bool) - Optional - If true, adds a 'departamento' key to the JSON response, providing department information and its classification. Defaults to false.

### Request Example
```json
GET /api/v2/catalogo_clientes/lista_precios?clave=KB-890&subgpo=true&tc=true&tipo=true&depto=true
```

### Response
#### Success Response (200)
- **clave** (string) - Product key.
- **descripcion** (string) - Product description.
- **subgrupo** (string) - Product sub-group name (if `subgpo` is true).
- **tipo_cambio** (number) - Current dollar exchange rate (if `tc` is true).
- **fecha_actualizacion_tipo_cambio** (string) - Last update date for the exchange rate (if `tc` is true).
- **tipo_producto** (string) - Product type classification (if `tipo` is true).
- **departamento** (object) - Department information (if `depto` is true).
  - **id** (number) - Department ID.
  - **nombre** (string) - Department name.

#### Response Example
```json
{
    "clave": "KB-890",
    "descripcion": "Example Product",
    "subgrupo": "Electronics",
    "tipo_cambio": 18.07,
    "fecha_actualizacion_tipo_cambio": "19/07/2024 11:04:18",
    "tipo_producto": "EXISTENCIA",
    "departamento": {
        "id": 1261,
        "nombre": "POR SALIR"
    }
}
```

### Error Handling
- **400 Bad Request**: Invalid query parameters.
- **404 Not Found**: Product not found.
- **500 Internal Server Error**: Server error.
```

--------------------------------

### GET /api/v2/catalogo_clientes/grupos

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves a catalog of product groups offered by CVA.

```APIDOC
## Grupos

### Description
Retrieves a catalog of product groups offered by CVA.

### Method
GET

### Endpoint
/api/v2/catalogo_clientes/grupos

### Parameters
#### Query Parameters
None

#### Request Body
None

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/grupos'
```

### Response
#### Success Response (200)
- **grupos** (array) - A list of group names.

#### Response Example
```json
{
    "grupos": [
        {
            "grupo": "ACCESO VIDEOCONFERENCIA"
        },
        {
            "grupo": "ACCESORIOS"
        }
    ]
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/lista_precios?desc={keyword}

Source: https://apicvaservices.grupocva.com/documentation/index

Performs a generic search for products based on a keyword found within their descriptions. The search is case-insensitive.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios?desc={keyword}

### Description
Retrieves products by performing a generic search using a keyword that appears in the product's short description. This search is not case-sensitive.

### Method
GET

### Endpoint
`https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios`

### Parameters
#### Query Parameters
- **desc** (string) - Required - The keyword to search for within the product descriptions.

### Request Example
```json
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?desc=GAMING
```

### Response
#### Success Response (200)
- **articulos** (array) - A list of product objects matching the search query.
  - **id** (integer) - Unique identifier for the product.
  - **clave** (string) - Product key or SKU.
  - **codigo_fabricante** (string) - Manufacturer's code for the product.
  - **descripcion** (string) - Detailed description of the product.
  - **principal** (string) - Main category of the product.
  - **grupo** (string) - Group the product belongs to.
  - **disponible** (integer) - Current stock quantity.
  - **marca** (string) - Brand of the product.
  - **garantia** (string) - Warranty information.
  - **clase** (string) - Product class.
  - **moneda** (string) - Currency for the price.
  - **precio** (number) - Price of the product.
  - **imagen** (string) - URL of the product image.
  - **disponibleCD** (integer) - Available quantity at the distribution center.

#### Response Example
```json
{
    "articulos": [
        {
            "id": 10430953,
            "clave": "NOT-9804",
            "codigo_fabricante": "82XV00PRLM",
            "descripcion": "LAPTOP LENOVO IDEA GAMING LOQ 15IRH8 / CORE I5-12450H / 8GB DDR5 / 512GB SSD / RTX 2050 4GB / 15.6 FHD (1920X1080) / STORM GREY / WIN 11 HOME / 1 YR CS",
            "principal": "COMPUTADORAS",
            "grupo": "PORTATILES",
            "disponible": 0,
            "marca": "LENOVO",
            "garantia": "1 AÑO",
            "clase": "AC",
            "moneda": "Pesos",
            "precio": 12873.6,
            "imagen": "https://www.grupocva.com/detalle_articulo/10430953.jpg",
            "disponibleCD": 0
        },
        {
            "id": 10427317,
            "clave": "MS-1605",
            "codigo_fabricante": "CH-9319511-NA2",
            "descripcion": "MOUSE CORSAIR M65 RGB ULTRA WIRELESS /LED/ INALAMBRICO / OPTICO / 26000 DPI / GAMING/ WHITE",
            "principal": "COMPONENTES",
            "grupo": "MOUSE",
            "disponible": 1,
            "marca": "CORSAIR",
            "garantia": "1 AÑO",
            "clase": "AC",
            "moneda": "Dolares",
            "precio": 98.17,
            "imagen": "https://www.grupocva.com/detalle_articulo/10427317.jpg",
            "disponibleCD": 0
        }
    ]
}
```
```

--------------------------------

### Get Product SAT Information

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieve SAT (Servicio de Administración Tributaria) information for a product by adding the `codigosat=true` parameter. This will include the SAT key and description in the response.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves product information including SAT details when the `codigosat` parameter is enabled.

### Method
GET

### Endpoint
`/api/v2/catalogo_clientes/lista_precios`

### Query Parameters
- **clave** (string) - Required - The product key.
- **codigosat** (boolean) - Optional - If true, includes SAT information (key and description) in the response. Defaults to false.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=KB-645&codigosat=true' \
--header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **sat_info** (object) - Contains SAT details.
  - **clave** (integer) - The SAT key.
  - **descripcion** (string) - The SAT description.

#### Response Example
```json
{
    "sat_info": {
        "clave": 43211706,
        "descripcion": "Teclados"
    }
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/informacion_tecnica

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves detailed technical specifications for a product identified by its 'clave' (key).

```APIDOC
## GET /api/v2/catalogo_clientes/informacion_tecnica

### Description
Retrieves detailed technical specifications for a product identified by its 'clave' (key).

### Method
GET

### Endpoint
https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/informacion_tecnica

### Parameters
#### Query Parameters
- **clave** (string) - Required - The CVA key of the product.
- **Authorization** (string) - Required - Bearer token for authentication.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/informacion_tecnica?clave=RELOJ-27' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **especificaciones** (array) - An array of specification objects, where each object has a 'nombre' (name) and 'valor' (value) field.

#### Response Example
```json
{
    "especificaciones": [
        {
            "nombre": "MONITOREA",
            "valor": "CALORIAS"
        },
        {
            "nombre": "MONITOREA",
            "valor": "PASOS "
        }
    ]
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/lista_precios

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieve product pricing information. This endpoint allows you to fetch details about products, including their price, availability, and optionally, processor information.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieve product pricing information. This endpoint allows you to fetch details about products, including their price, availability, and optionally, processor information.

### Method
GET

### Endpoint
/api/v2/catalogo_clientes/lista_precios

### Parameters
#### Query Parameters
- **clave** (string) - Required - The product key to query.
- **procesador** (boolean) - Optional - If true, includes the processor node in the response if available.
- **trans** (boolean) - Optional - If true, includes the quantity in transit to the branch.

### Request Example
```json
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PCGHIA-3480&procesador=true
GET https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=CSP-438&trans=true
```

### Response
#### Success Response (200)
- **id** (integer) - The product ID.
- **clave** (string) - The product key.
- **codigo_fabricante** (string) - The manufacturer's code.
- **descripcion** (string) - The product description.
- **principal** (string) - The main category.
- **grupo** (string) - The product group.
- **disponible** (integer) - The available quantity.
- **marca** (string) - The product brand.
- **garantia** (string) - The product warranty information.
- **clase** (string) - The product class.
- **moneda** (string) - The currency of the price.
- **precio** (float) - The product price.
- **brand_image** (string or null) - The brand image URL.
- **imagen** (string) - The product image URL.
- **disponibleCD** (integer) - The quantity available at the distribution center.
- **promociones** (any or null) - Promotional information.
- **procesador** (string or null) - The processor information (only if `procesador=true` and available).
- **en_transito** (integer) - The quantity in transit (only if `trans=true`).

#### Response Example
```json
{
    "id": 10450943,
    "clave": "PCGHIA-3480",
    "codigo_fabricante": "INTEL CORE SERIES",
    "descripcion": "GHIA FRONTIER SLIM / INTEL CORE I3-13100, 4 NCLEOS MAX 4.50 GHZ / RAM 8 GB / SSD NVME 1 TB / SIN SISTEMA",
    "principal": "COMPUTADORAS",
    "grupo": "PC´S",
    "disponible": 0,
    "marca": "GHIA",
    "garantia": "1 AÑO",
    "clase": "AC",
    "moneda": "Dolares",
    "precio": 1.09,
    "brand_image": null,
    "imagen": "https://me2.grupocva.com/me/imagen/imagen_art_detalles.php?fProd=10450943",
    "disponibleCD": 0,
    "promociones": null,
    "procesador": "INTEL CORE i3",
    "en_transito": 3
}
```
```

--------------------------------

### Get Products by Solution (Acteck, Gamer) using curl

Source: https://apicvaservices.grupocva.com/documentation/index

This snippet demonstrates how to fetch products from the CVAServices API that belong to a specific solution (e.g., 'Gamer' with ID 21) and brand (e.g., 'Acteck'). It requires an API token for authorization. The response is a JSON object containing a list of articles.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?marca=acteck&Solucion=21' \
      --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### GET /api/v2/catalogo_clientes/imagenes_alta

Source: https://apicvaservices.grupocva.com/documentation/index

Fetches high-quality images for a specific product using its 'clave'. Handles cases where products may not have images.

```APIDOC
## GET /api/v2/catalogo_clientes/imagenes_alta

### Description
Fetches high-quality images for a specific product using its 'clave'. Handles cases where products may not have images.

### Method
GET

### Endpoint
https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/imagenes_alta

### Parameters
#### Query Parameters
- **clave** (string) - Required - The CVA key of the product.
- **Authorization** (string) - Required - Bearer token for authentication.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/imagenes_alta?clave=PC-6150' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **imagenes** (array) - An array of URLs pointing to the high-quality images of the product. Can be `null` if no images are available.

#### Response Example
```json
{
    "imagenes": [
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=341116",
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=341118"
    ]
}
```
```

--------------------------------

### GET /api/v2/catalogo_clientes/lista_precios?images=1&completos=1

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves a list of products that have complete high-resolution images. This endpoint is useful for ensuring that all product listings have associated visual assets.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios?images=1&completos=1

### Description
Searches for products that have complete high-resolution images. This filter excludes products without associated images, ensuring quality and presentation standards.

### Method
GET

### Endpoint
https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios

### Query Parameters
- **images** (integer) - Optional - Set to 1 to include images in the response.
- **completos** (boolean) - Optional - Filters for products with complete high-resolution images. Defaults to false.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?images=1&completos=1' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **articulos** (array) - An array of product objects.
  - **id** (integer) - Product ID.
  - **clave** (string) - Product key.
  - **codigo_fabricante** (string) - Manufacturer's product code.
  - **descripcion** (string) - Product description.
  - **principal** (string) - Main category.
  - **grupo** (string) - Product group.
  - **disponible** (integer) - Availability status.
  - **marca** (string) - Product brand.
  - **garantia** (string) - Warranty information.
  - **clase** (string) - Product class.
  - **moneda** (string) - Currency for the price.
  - **precio** (float) - Product price.
  - **brand_image** (string) - URL for the brand logo.
  - **imagen** (string) - URL for the main product image.
  - **disponibleCD** (integer) - CD availability status.
  - **promociones** (any) - Promotional information, if any.
  - **imagenes** (array) - An array of URLs for high-resolution images.

#### Response Example
```json
{
    "articulos": [
        {
            "id": 10447222,
            "clave": "MNL-2808",
            "codigo_fabricante": "32GS60QC",
            "descripcion": "MONITOR LG ULTRAGEAR 32GS60QC GAMER CURVO QHD 31.5,PANEL VA, 2560X1440, 180HZ, TR 1MS, CURVATURA 1000R, HDR10, AMD FREESYNC, ASPECTO 16:09, CONTRASTE 3000:1, DISPLAYPORT, HDMI, MONTAJE 100X100",
            "principal": "COMPONENTES",
            "grupo": "MONITORES",
            "disponible": 0,
            "marca": "LG",
            "garantia": "SG",
            "clase": "AC",
            "moneda": "Pesos",
            "precio": 5285.87,
            "brand_image": "https://me2.grupocva.com/me/imagen/logos/brand_logo.php?id=174",
            "imagen": "https://me2.grupocva.com/me/imagen/imagen_art_detalles.php?fProd=10447222",
            "disponibleCD": 0,
            "promociones": null,
            "imagenes": [
                "https://www.grupocva.com/detalle_articulo/img_large.php?id=360946",
                "https://www.grupocva.com/detalle_articulo/img_large.php?id=360948",
                "https://www.grupocva.com/detalle_articulo/img_large.php?id=360970",
                "https://www.grupocva.com/detalle_articulo/img_large.php?id=360972",
                "https://www.grupocva.com/detalle_articulo/img_large.php?id=360990"
            ]
        }
    ]
}
```
```

--------------------------------

### Get Product List with Special Pricing

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves a list of products, optionally applying special pricing for 'ME' orders. This endpoint allows filtering by product key and activating special pricing using the 'TipoCompra' parameter.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves products, optionally filtering by product key and applying special pricing for 'ME' orders.

### Method
GET

### Endpoint
`https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios`

### Parameters
#### Query Parameters
- **clave** (string) - Required - Product key to filter by.
- **TipoCompra** (boolean) - Optional - Activates special 'ME' pricing. Defaults to `false`.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PR-2586&TipoCompra=true' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **id** (integer) - Product ID.
- **clave** (string) - Product key.
- **codigo_fabricante** (string) - Manufacturer's code.
- **descripcion** (string) - Product description.
- **principal** (string) - Main category.
- **grupo** (string) - Product group.
- **disponible** (integer) - Available stock in the user's branch.
- **marca** (string) - Product brand.
- **garantia** (string) - Product warranty.
- **clase** (string) - Product class.
- **moneda** (string) - Currency.
- **precio** (float) - Product price (special price if TipoCompra is true).
- **imagen** (string) - URL of the product image.
- **disponibleCD** (integer) - Available stock in the distribution center.

#### Response Example
```json
{
    "id": 10412212,
    "clave": "PR-2586",
    "codigo_fabricante": "6QN28A#BGJ",
    "descripcion": "IMPRESORA HP OPS LASERJET ENTERPRISE 5700DN, 45 PPM NEGRO/ COLOR, LASER COLOR, USB, WIFI, ETHERNET (RED), DUPLEX, ADF, BLUETOOTH (SUSTITUTO M555DN)",
    "principal": "IMPRESION",
    "grupo": "IMPRESORAS",
    "disponible": 0,
    "marca": "HP",
    "garantia": "1 AÑO",
    "clase": "AC",
    "moneda": "Pesos",
    "precio": 16930.58,
    "imagen": "https://www.grupocva.com/detalle_articulo/10412212.jpg",
    "disponibleCD": 6
}
```
```

--------------------------------

### Get Product Images

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieve high-resolution images for a product by adding the `images=true` parameter. This provides an array of image URLs associated with the product.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves product information including an array of image URLs when the `images` parameter is enabled.

### Method
GET

### Endpoint
`/api/v2/catalogo_clientes/lista_precios`

### Query Parameters
- **clave** (string) - Required - The product key.
- **images** (boolean) - Optional - If true, includes an array of image URLs for the product. Defaults to false.

### Request Example
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=SPK-2093&images=true' \
--header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **imagenes** (array) - An array of image URLs for the product. Can be null if no images are available.

#### Response Example
```json
{
    "id": 10253052,
    "clave": "SPK-2093",
    "descripcion": "AUDIFONOS GAMER OCELOT TIPO DIADEMA/OVER-EAR/USB/3.5MM/COLOR ROSA CON NEGRO/ALAMBRICOS/ILUMINACION BLANCA/CONTROL DE AUDIO/MICROFONO CANCELACION DE RUIDO/AJUSTABLES/MULTIPLATAFORMA",
    "imagen": "https://www.grupocva.com/detalle_articulo/10253052.jpg",
    "imagenes": [
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=323327",
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=323331",
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=323330",
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=323328",
        "https://www.grupocva.com/detalle_articulo/img_large.php?id=323329"
    ]
}
```
```

--------------------------------

### Get Product Pricing with Utility Percentage (API)

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves product pricing and applies a specified percentage to calculate utility. This is useful for resellers to determine their profit margin on products.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PR-2586&porcentaje=16' \
      --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product List with Utility Percentage

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves a list of products, allowing the application of a utility percentage to the base price. This is useful for calculating profit margins.

```APIDOC
## GET /api/v2/catalogo_clientes/lista_precios

### Description
Retrieves products and applies a specified utility percentage to their prices.

### Method
GET

### Endpoint
`https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios`

### Parameters
#### Query Parameters
- **clave** (string) - Required - Product key to filter by.
- **porcentaje** (integer) - Optional - The percentage to increase the price by for utility calculation. Defaults to `null`.

### Request Example
#### Single Product with Percentage
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PR-2586&porcentaje=16' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```
#### List of Products with Percentage
```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?porcentaje=16' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

### Response
#### Success Response (200)
- **id** (integer) - Product ID.
- **clave** (string) - Product key.
- **codigo_fabricante** (string) - Manufacturer's code.
- **descripcion** (string) - Product description.
- **principal** (string) - Main category.
- **grupo** (string) - Product group.
- **disponible** (integer) - Available stock in the user's branch.
- **marca** (string) - Product brand.
- **garantia** (string) - Product warranty.
- **clase** (string) - Product class.
- **moneda** (string) - Currency.
- **precio** (float) - Product price (with utility percentage applied).
- **imagen** (string) - URL of the product image.
- **disponibleCD** (integer) - Available stock in the distribution center.

#### Response Example
```json
{
    "id": 10412212,
    "clave": "PR-2586",
    "codigo_fabricante": "6QN28A#BGJ",
    "descripcion": "IMPRESORA HP OPS ENTERPRISE 5700DN, 45 PPM NEGRO/ COLOR, LASERJET, DUPLEX, USB, ETHERNET,BLUETOOTH, WIFI-DIRECT(SUSTITUTO M555DN)",
    "principal": "IMPRESION",
    "grupo": "IMPRESORAS",
    "disponible": 3,
    "marca": "HP",
    "garantia": "1 AÑO",
    "clase": "AC",
    "moneda": "Pesos",
    "precio": 19253.48,
    "imagen": "https://www.grupocva.com/detalle_articulo/10412212.jpg",
    "disponibleCD": 6
}
```
```

--------------------------------

### Get Product Images

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieve high-resolution images for a product by appending `images=true` to the product listing request. This parameter is useful for fetching image URLs directly. Note that not all products may have images.

```bash
curl  --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=SPK-2093&images=true' \
      --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get High-Quality Product Images

Source: https://apicvaservices.grupocva.com/documentation/index

Fetches high-resolution images for a specified product using its CVA key. This is ideal for obtaining product visuals. Note that some products may not have images available, returning null.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/imagenes_alta?clave=PC-6150' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product Price with Processor Info (curl)

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves a product's price list and includes processor information if available by setting the 'procesador' parameter to 'true'. This is useful for detailed product inquiries.

```curl
curl  --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=PCGHIA-3480&procesador=true' \
      --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product Dimensions

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieve physical dimensions (height, width, depth, weight) for a product by appending `dimen=true` to the product listing request. Dimensions are returned in meters and weight in kilograms.

```bash
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=FRE-6&dimen=true' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product Availability in Branches (curl)

Source: https://apicvaservices.grupocva.com/documentation/index

This snippet shows how to retrieve product availability across various branches using a curl command. It requires a product key and an API token for authorization. The response is a JSON object detailing the stock in each branch.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=CV-1856&sucursales=true' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product Technical Information

Source: https://apicvaservices.grupocva.com/documentation/index

Retrieves detailed technical specifications for a product using its unique key. This endpoint is useful for obtaining specific feature details of a product. Requires an API token for authorization.

```curl
curl --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/informacion_tecnica?clave=RELOJ-27' \
     --header 'Authorization: Bearer TU_API_TOKEN'
```

--------------------------------

### Get Product Subgroup Information (curl)

Source: https://apicvaservices.grupocva.com/documentation/index

This example demonstrates how to fetch the sub-group information for a product using curl. By setting the 'subgpo' parameter to true, the API response will include the 'subgrupo' field for the specified product. An API token is necessary for authentication.

```curl
curl  --location 'https://apicvaservices.grupocva.com/api/v2/catalogo_clientes/lista_precios?clave=KB-890&subgpo=true' \
      --header 'Authorization: Bearer TU_API_TOKEN'
```