Contamos con interfaces con las que podemos proporcionar datos necesarios para integrar con una

aplicación externa. Nuestras interfaces están diseñadas para dinámicamente entregar datos en formato
XML.
Como se comenta los datos son servidos dinámicamente y están en tiempo real.

Aquí ejemplos de cómo usar las interfaces:

En este ejemplo se está usando un cliente de prueba el 26813 para ver sus datos, cambiar el número 26813
por su número de cliente para observar datos reales.

Buscar un producto con el número de parte WD5000AZLX

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=%25&
grupo=%25&clave=%25&codigo=WD5000AZLX

Buscar un producto con el código CVA HD-1014

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=%&grupo=%&cl
ave=HD-1014&codigo=%

Todos los productos de CVA: (catálogo completo no recomendado)

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=%&grupo=%&cl
ave=%&codigo=%

Todos los elementos de la marca de HP:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=HP&grupo=%&c
lave=%&codigo=%

Todas la impresoras de la marca hp:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=HP&grupo=%im
presora%&clave=%&codigo=%

Realizar una búsqueda genérica que contenga una palabra PAVILION con promociones:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&desc=PAVILION&promos=1

**La búsqueda genérica busca la palabra dentro de la descripción corta.

Existe la opción de aumentar un porcentaje sobre nuestro precio para que calcular su utilidad ejemplo:

Subir 10% sobre el precio de CVA a todo el producto HP.

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=HP&grupo=%im
presora%&clave=%&codigo=%&porcentaje=10

Subir porcentaje de 11% al HD-1014:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&marca=%&grupo=%&cl
ave=HD-1014&codigo=%&porcentaje=11

Parámetro “sucursales”
Si sucursales=1 entonces la interfaz mostrara la información de la existencia de cada una de las sucursales.
Al usar esta información que entendido que se comprende que el precio de un producto a otra
puede variar y que el precio del flete depende de la distancia origen y destino.

Parámetro subgrupo.
subgpo=1

Si subgpo=1 se muestra en el xml el primer subgrupo del grupo del articulo consultado.

Parámetro “TC”.

Si “ tc=1” se mostrara el campo de valor de tipo de cambio de dólar y su última fecha de actualización por
nuestra parte, si está en cero o no incluyes el parámetro no te mostrara el elemento XML.
http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=26813&marca=HP&grupo=%im
presora%&clave=%&codigo=%&porcentaje=10&tc=1

Se aclara que el uso del tipo de cambio publicado es totalmente del dominio de CVA, sujeto a cambios
durante el día sin previo aviso (es por eso que también te estamos brindando la fecha de última
actualización del tc), así que recomiendo bajar las actualizaciones en tiempo real, de esa manera siempre
se tiene el precio actualizado incluso con los cambios que se puedan generar en el día.
El utilizar este sistema es bajo el entendido que el sistema trabaja de esta manera.

De igual manera se puede utilizar el parametro MonedaPesos=1 que te devolverá los productos en pesos

Parámetro Tipo

Si “&tipo=1” entonces el sistema te devolverá un nuevo nodo de xml de la siguiente manera:

<TipoProducto>EXISTENCIA</TipoProducto>

Este es el equivalente para el servicio web de los “productos por salir” estos productos están
disponibles solo hasta agotar existencias y no genera backorder o sea que no compran aunque
sean solicitados (se ponen por salir porque es posible que ni el proveedor siga surtiendo el
producto o este descontinuado), ósea que se debe limitar a ofrecer la existencia mostrada.

Parámetro Depto.

CVA clasifica los productos de acuerdo a su tiempo de vida o de acuerdo a su forma de adquirir o
comprar el producto, al activar el parámetro depto=1 la interfaz mostrara la información.

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&marca=HP&grupo=%25&
codigo=%25&porcentaje=11&depto=1

Los valores son:

A PRODUCTO CON VENTA ALTA LOS PRODUCTOS

TIENEN UNA EXISTENCIA ALTA Y REGULAR EN
LAS SUCURSALES.
B PRODUCTO CON VENTAS MEDIAS LOS
 PRODUCTOS TIENEN MEDIANA EXISTENCIA Y
SU RESURTIDO ES REGULAR.
C PRODUCTO CON BAJAS VENTAS ESTE
PRODUCTO MANTIENE UN INVENTARIO BAJO.
POR SALIR YA NO SE SURTE Y ESTARA LIMITADA A LAS
EXISTENCIAS ACTUALES.
SP CD SE TIENE EXISTENCIA EN EL CENTRO DE
DISTRIBUCION
SPF PRODUCTOS BAJO PEDIDO.

Descripciones técnica y comercial.

Si “ dt=1” y “dc=1” se le mostrara descripción técnica y comercial, si esta en cero o no incluye el

parámetro no te mostrara el elemento XML.

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&marca=HP&gr
upo=%impresora%&clave=%&codigo=%&porcentaje=10&tc=1&dc=1&dt=1

Filtro de existencias (11 de Mayo 2012).

Usted puede determinar si quiere que el servicio XML muestre el catálogo completo de productos o solo los
productos que cuenten con existencia en su almacén (este almacén es el que corresponde a la sucursal
donde se dio de alta) o el del centro de distribución de su almacén, por default el servicio mostrara todos
los elementos.

El parámetro que controla el comportamiento del filtro es llamado “exis” y se utiliza de la siguiente manera:

&exist=1 muestra lo que tenga disponible en la sucursal (independiente del centro de

distribución)

&exist=2 muestra lo que tenga disponible en el centro de distribución (independiente de la

sucursal)

&exist=3 muestra lo que tenga disponible en la sucursal y en el centro de distribución

&exist=4 muestra lo que tenga disponible en sucursal o en centro de distribución

Manejo de promociones.

El sistema puede mostrar información de las promociones que están corriendo basadas en descuento al
precio o de precio fijo, cuando hay varias promociones de precio para el producto el sistema muestra la
promoción que hace que el producto quede más económico; ejemplo:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&marca=HP&grupo=%25&codigo=%25&t
c=1&promos=1&porcentaje=0

Al activar los parámetros de promos y porcentaje, el sistema te mostrara los campos extras:

<?xml version="1.0" encoding="UTF-8" ?>

- <articulos>
- <item>
<clave>PR-810</clave>
<codigo_fabricante>PT-90</codigo_fabricante>
<descripcion>ROTULADOR DE ETIQUETAS PT-90 BROTHER C/ PANTALLA LCD</descripcion>
<grupo>IMPRESORAS</grupo>
<marca>BROTHER</marca>
<garantia>1 ANIO</garantia>
<clase>AC</clase>
<disponible>0</disponible>
<precio>375.82</precio>
<moneda>Pesos</moneda>
<ficha_tecnica />
<ficha_comercial />
<imagen>http://www.grupocva.com/detalle_articulo/imagen_art.php?fProd=496689</imagen>
<disponibleCD>0</disponibleCD>
<tipocambio>12.4</tipocambio>
<fechaactualizatipoc>21/01/2011 13:41:51</fechaactualizatipoc>
<TotalDescuento>5%</TotalDescuento>
<MonedaDescuento />
<PrecioDescuento>357.03</PrecioDescuento>
<MonedaPrecioDescuento>Pesos</MonedaPrecioDescuento>
<ClavePromocion>19311</ClavePromocion>
<VencimientoPromocion>31/01/2011</VencimientoPromocion>
<DisponibleEnPromocion>1</DisponibleEnPromocion>
</item>
</articulos>

En este ejemplo este producto tiene un descuento del 5% sobre el precio <precio>375.82</precio> aunque
pueden aplicar varias promociones para ese producto la mejor promoción que te podemos ofrecer para
mejorar tu precio de acuerdo a cálculos es tomando la
promoción <ClavePromocion>19311</ClavePromocion> y su precio queda de
: <PrecioDescuento>357.03</PrecioDescuento>. Cuando el campo de <TotalDescuento> este vacío, es
porque es un precio directo y el campo </MonedaPrecioDescuento> te indica la moneda en el cual esta esté
precio ya que en ocasiones el precio directo está en moneda diferente del precio de lista, cuando la
promoción está limitada a cantidad, <DisponibleEnPromocion>1</DisponibleEnPromocion> te muestra los
disponibles a ese precios.

Es muy importante tomar en cuenta el vencimiento de la promoción, las promociones que le estamos
mostrando pueden expirar por fecha o por que sean hasta agotar existencias, así que ustedes son
responsables de leer el dato, y tomarlo en cuenta para cuando lo ofrezcan, así como saber que ustedes
pudieron mostrar un precio y al momento que levanten el pedido pueden haber agotado existencias, o
pudo expirar la promoción, eso es así en la operación normal de las promociones.
El utilizar este sistema es bajo el entendido que el sistema trabaja de esta manera.

Manejo de paquetes (14 de Junio 2013)

La Logistica de CVA determina que los paquetes no necesariamente llegan a tener marca y grupo o
clasificadores en general, los que regularmente cuentan con estos clasificadores son los productos.

Se agrega el parámetro TipoProducto=1.

Este parámetro determina si se muestra o no el campo:

<productopaquete>PRODUCTO</productopaquete>
El cual en caso de ser producto simple mostrara en su valor PRODUCTO y en caso de ser paquete
su valor será PAQUETE.

Este elemento está diseñado para que el usuario pueda filtrar por tipo de productos.

Además al activar el parámetro se muestra también el elemento:

<componentes>AA-33,AC-2505,AC-2511</componentes>

El cual despliega en el elemento los productos que conforman el paquete, (en caso de que
<productopaquete>PAQUETE</productopaquete>) con lo cual el usuario pudiese desplegar los
componentes y desglosar sus características.

Precios.

Los productos cuentan con un precio especial por levantarse dentro del sistema ME, para que el XML te
muestre este precio se utiliza el parámetro TipoCompra=1, por default se muestras los precios por levantar
en la sucursal, en caso de activar este parámetro recuerde que este precio se respeta levantado los
productos en el ME.

CATALOGO DE MARCAS

http://www.grupocva.com/catalogo_clientes_xml/marcas.xml

CATALOGO DE GRUPOS:

http://www.grupocva.com/catalogo_clientes_xml/grupos.xml

Les recomendamos hagan todas tus transacciones en línea(es decir que no hagas una descarga de todo el
catalogo una sola vez, si no leas al momento) porque aunque hasta el momento no hay, puede haber
promociones que tengan vencimiento por hora y está en nuestro ámbito implementarlo, ustedes a través
del campo de vencimiento quedan avisados de la expiración, además se darían cuenta cuando una
promoción dejo de existir porque las existencias hayan agotado.

Aunque podemos proveerle el catálogo completo para que se actualice cada que usted lo consulte , este
método PARA NADA LO RECOMENDAMOS, ya que nuestro catálogo es muy amplio y se encuentra en
crecimiento constante, una consulta de esta información puede llegar a medir hasta 90 MB y consumirá
ancho de banda tanto de su empresa como la nuestra, sin embargo si su aplicación así lo requiere existe este
método, evítelo en la manera que te sea posible, consulte con su programador para hacer consultas
específicas.

Estamos para servirle.

Saludos y gracias.
Departamento de Ti.