CVA WEB SERVICE

Conecta tu página con nuestro Web Service y obtén en tiempo real, inventarios, precios, promociones, descripción e imágenes de producto. Ofrecemos los datos en formato XML

1. Genera tu acceso

Para obtener acceso al Web Service se requiere dar de alta la dirección IP asociada a tu dominio, o en caso de estar realizando pruebas, la dirección IP de tu router/modem esto en la plataforma ME. Véase Registrar IP.

2. Conociendo los parámetros

Parámetro	Descripción	Tipo
cliente	Número de cliente	Numérico
marca	Nombre de marca (Véase Marcas )	String
grupo	Nombre de Grupo (Véase Grupos)	String
codigo	Numero de parte	String
clave	Clave del producto	String
desc	Recibe cadena con búsqueda libre.	String
porcentaje	Recibe Porcentaje de utilidad	Numérico
subgpo	Si es igual a 1 regresa el subgrupo	1
sucursales	Si es igual a 1 y regresa el Tipo de cambio	1
dt	Si es igual a 1 regresa la descripción técnica	1
dc	Si es igual a1 regresa la descripción comercial	1
exist	Veáse Exst	(1, 2, 3, 4)
promos	Si es igual a 1 regresan las promociones activas de un producto.	1
TipoProducto	Regresa el tipo de producto, si es producto o paquete.	1
MonedaPesos	Si es igual a 1 regresa precios en MN	1
TipoCompra	Retorna el precio especial ME (válido solo si levanta el pedido en dicha plataforma)	1
marca2	Clave de la marca. (Véase *Marcas2)	Numerico
grupo2	Clave de la grupo. (Véase *Grupos2)	Numerico
TotalSuc	Regresa la suma del total de las existencias (*requiere sucursales=1)	1
tipo	Si es igual a 1 regresa el tipo de producto.	1
depto	Regresa el tipo de departamento que pertenece.	1

3. Realizando Consultas

3.1 Consulta producto por número de parte. GET

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&codigo=WD5000AZLX

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>HD-1014</clave>

						    <codigo_fabricante>WD5000AZLX</codigo_fabricante>

						    <descripcion>DD INTERNO WD BLUE 3.5 500GB SATA3 6GB/S 32MB 7200RPM P/PC COMP BASICO</descripcion >

						    <principal>ALMACENAMIENTO</principal >

						    <grupo>DISCOS DUROS</grupo >

						    <marca>WD - WESTERN DIGITAL</marca >

						    <garantia>2 ANIOS</garantia >

						    <clase>AC</clase >

						    <disponible >5</disponible >

						    <precio>39.14</precio >

						    <moneda>Dolares</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9678446.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						</articulos>

3.2 Consulta producto por Clave CVA. GET

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=HD-1014

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>HD-1014</clave>

						    <codigo_fabricante>WD5000AZLX</codigo_fabricante>

						    <descripcion>DD INTERNO WD BLUE 3.5 500GB SATA3 6GB/S 32MB 7200RPM P/PC COMP BASICO</descripcion >

						    <principal>ALMACENAMIENTO</principal >

						    <grupo>DISCOS DUROS</grupo >

						    <marca>WD - WESTERN DIGITAL</marca >

						    <garantia>2 ANIOS</garantia >

						    <clase>AC</clase >

						    <disponible >5</disponible >

						    <precio>39.14</precio >

						    <moneda>Dolares</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9678446.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						</articulos>

3.3 Consulta producto por Marca. GET

Con el parámetro marca, para el ejemplo marca=ACTECK obtiene todos los productos de la marca. Véase catálogo Marcas

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&marca=ACTECK

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>AC-3812</clave>

						    <codigo_fabricante>MVFT-002</codigo_fabricante>

						    <descripcion>FUNDA CON TECLADO ALAMBRICO 7 Y 8 PULGADAS ACTECK AJUSTABLE NEGRO CONECTOR MICRO USB MODELO FT-900</descripcion >

						    <principal>ACCESORIOS</principal >

						    <grupo>FUNDAS</grupo >

						    <marca>ACTECK</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>122.34</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9526286.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item>

						    <clave>AC-6978</clave>

						    <codigo_fabricante>TB-916684</codigo_fabricante>

						    <descripcion>MOUSE PAD TRUE BASIX / ACTECK DE TELA PLSTICO COLOR NEGRO</descripcion >

						    <principal>ACCESORIOS</principal >

						    <grupo>ACCESORIOS</grupo >

						    <marca>ACTECK</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>35.73</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10097003.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item >

						   ...

						   ...

						  </item >

						</articulos>

3.4 Consulta producto por Grupo. GET

Con el parámetro grupo, para el ejemplo grupo=BOCINAS obtiene todos los productos del grupo. Véase catálogo Grupos

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&grupo=BOCINAS

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>SPK-1063</clave>

						    <codigo_fabricante>980-001004</codigo_fabricante>

						    <descripcion>FBOCINAS LOGITECH S150 2.0 NEGRAS (ENERGIA Y AUDIO POR USB) PC/MAC</descripcion >

						    <principal>AUDIO</principal >

						    <grupo>BOCINAS</grupo >

						    <marca>LOGITECH</marca >

						    <garantia>3 ANIOS</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>184.88</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9560487.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item>

						    <clave>SPK-1118</clave>

						    <codigo_fabricante>31731006102</codigo_fabricante>

						    <descripcion>BOCINAS GENIUS SP-U115 1.5 WATTS USB AZUL</descripcion >

						    <principal>AUDIO</principal >

						    <grupo>BOCINAS</grupo >

						    <marca>GENIUS</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>130.15</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9601339.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item >

						   ...

						   ...

						  </item >

						</articulos>

3.4.1 Consulta producto por Grupo2. GET

Con el parámetro grupo, para el ejemplo grupo2=268 obtiene todos los productos del grupo. Véase catálogo Grupos

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&grupo2=268

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>SPK-1063</clave>

						    <codigo_fabricante>980-001004</codigo_fabricante>

						    <descripcion>FBOCINAS LOGITECH S150 2.0 NEGRAS (ENERGIA Y AUDIO POR USB) PC/MAC</descripcion >

						    <principal>AUDIO</principal >

						    <grupo>BOCINAS</grupo >

						    <marca>LOGITECH</marca >

						    <garantia>3 ANIOS</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>184.88</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9560487.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item>

						    <clave>SPK-1118</clave>

						    <codigo_fabricante>31731006102</codigo_fabricante>

						    <descripcion>BOCINAS GENIUS SP-U115 1.5 WATTS USB AZUL</descripcion >

						    <principal>AUDIO</principal >

						    <grupo>BOCINAS</grupo >

						    <marca>GENIUS</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>130.15</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/9601339.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item >

						   ...

						   ...

						  </item >

						</articulos>

3.4.1.1 Filtra por subgrupos concatenando al grupo2 GET

Con el parámetro grupo2, para el ejemplo grupo2=268,15462 obtiene todos los productos del grupo BOCINAS y subgrupo BAFLE, para filtrar los subgrupos basta con concatenar la clave comaseparado del grupo. Véase catálogo Grupos

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&grupo2=268,15462

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>SPK-1655</clave>

						    <codigo_fabricante>GSP-206</codigo_fabricante>

						    <descripcion>BAFLE AMPLIFICADO GHIA DOBLE BOCINA 6.5 PULG RECARGABLE /BT/USB/MICROSD/MIC/CONT.R./ LUZ LED</descripcion >

						    <grupo>BOCINAS</grupo >

						    <marca>GHIA</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >10</disponible >

						    <precio>184.88</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10079743.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item >

						   ...

						   ...

						  </item >

						</articulos>

3.5 Consulta producto por búsqueda genérica. GET

Con el parámetro desc puedes realizar búsquedas genéricas (realiza la búsqueda dentro de la descripcion corta de producto)
Ejemplo: una búsqueda genérica que contenga la palabra clave GAMING

EJEMPLO DE REQUEST

GET

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

EJEMPLO DE RESPUESTA 200 OK


							
						<articulos>

						  <item>

						    <clave>CS-702</clave>

						    <codigo_fabricante>BR-922951</codigo_fabricante>

						    <descripcion>GABINETE GAMING BALAM RUSH/ACTECK/ERYX /MID TOWER MICRO ATX/MINI ITX/ 3 VENTILADORES LED/USB 3.0/ COLOR NEGRO/BR-922951</descripcion >

						    <principal>COMPONENTES</principal >

						    <grupo>GABINETES</grupo >

						    <marca>ACTECK</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>645.8</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10190571.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item>

						    <clave>CS-724</clave>

						    <codigo_fabricante>BR-929608</codigo_fabricante>

						    <descripcion>GABINETET BALAM RUSH GAMING MEDIA TORRE ATX/MICRO ATX/MINI ITX/2 VENT RGB/USB 3.0/ KRAKEN/COLOR NEGRO/BR-929608</descripcion >

						    <principal>GABINETET BALAM RUSH GAMING MEDIA TORRE ATX/MICRO ATX/MINI ITX/2 VENT RGB/USB 3.0/ KRAKEN/COLOR NEGRO/BR-929608</principal >

						    <grupo>GABINETES</grupo >

						    <marca>ACTECK</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >0</disponible >

						    <precio>1092.85</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10203031.jpg</imagen>

						    <disponibleCD >0</disponibleCD>

						  </item >

						
						  <item >

						   ...

						   ...

						  </item >

						</articulos>

3.6 Agregar porcentaje GET

El parámetro porcentaje permite aumentar un porcentaje sobre nuestro precio para calcular su utilidad ejemplo:
Subir porcentaje de 16% al producto con clave RELOJ-27, lo que aumentará en el nodo precio ese porcentaje

** Los precios sin porcentaje se encuentran sin IVA, por lo que es recomendable agregar el IVA en el porcentaje para contemplar el impuesto.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&porcentaje=16


							
						<articulos>

						  <item>

						    <clave>RELOJ-27</clave>

						    <codigo_fabricante>GAC-144</codigo_fabricante>

						    <descripcion>GHIA SMART WATCH CYGNUS /1.1 TOUCH/ HEART RATE/ BT/ SENSOR G/ SIM CARD 2G/GAC-144 BLANCO</descripcion >

						    <principal>RELOJES</principal >

						    <grupo>RELOJES</grupo >

						    <marca>GHIAL</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >5</disponible >

						    <precio>979.01</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10063365.jpg</imagen>

						    <disponibleCD >551</disponibleCD>

						  </item >

						</articulos>

3.7 Consulta disponibilidad en sucursales GET

Si agregamos el parámetro sucursales=1 entonces mostrará la existencia del producto en cada una de las sucursales. Con el parámetro TotalSuc=1 podemos obtener la suma total de las existencias.
**El Precio de un producto puede variar de una sucursal a otra así como el precio del flete depende de la distancia origen y destino.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&sucursales=1


							
						<articulos>

						  <item>

						    <clave>RELOJ-27</clave>

						    <codigo_fabricante>GAC-144</codigo_fabricante>

						    <descripcion>GHIA SMART WATCH CYGNUS /1.1 TOUCH/ HEART RATE/ BT/ SENSOR G/ SIM CARD 2G/GAC-144 BLANCO</descripcion >

						    <principal>RELOJES</principal >

						    <grupo>RELOJES</grupo >

						    <marca>GHIAL</marca >

						    <garantia>1 ANIO</garantia >

						    <clase>AC</clase >

						    <disponible >5</disponible >

						    <precio>979.01</precio >

						    <moneda>Pesos</moneda >

						    <ficha_tecnica/>

						    <ficha_comercial/>

						    <imagen>http://www.grupocva.com/detalle_articulo/10063365.jpg</imagen>

						    <disponibleCD >551</disponibleCD>

						    <VENTAS_ACAPULCO>0</VENTAS_ACAPULCO>

						    <VENTAS_AGUASCALIENTES>2</VENTAS_AGUASCALIENTES>

						    <VENTAS_CAMPECHE>0</VENTAS_CAMPECHE>

						    <VENTAS_CANCUN>2</VENTAS_CANCUN>

						    <VENTAS_CHIHUAHUA>2</VENTAS_CHIHUAHUA>

						    <VENTAS_COLIMA>0</VENTAS_COLIMA>

						    <VENTAS_CUERNAVACA>0</VENTAS_CUERNAVACA>

						    <VENTAS_CULIACAN>3</VENTAS_CULIACAN>

						    <VENTAS_DF_TALLER>42</VENTAS_DF_TALLER>

						    <VENTAS_DURANGO>0</VENTAS_DURANGO>

						    <VENTAS_HERMOSILLO>2</VENTAS_HERMOSILLO>

						    <VENTAS_LA_PAZ>0</VENTAS_LA_PAZ>

						    <VENTAS_LEON>2</VENTAS_LEON>

						    <VENTAS_MERIDA>2</VENTAS_MERIDA>

						    <VENTAS_MONTERREY>1</VENTAS_MONTERREY>

						    <VENTAS_MORELIA>2</VENTAS_MORELIA>

						    <VENTAS_OAXACA>0</VENTAS_OAXACA>

						    <VENTAS_PACHUCA>0</VENTAS_PACHUCA>

						    <VENTAS_PUEBLA>5</VENTAS_PUEBLA>

						    <VENTAS_QTOUCH>0</VENTAS_QTOUCH>

						    <VENTAS_QUERETARO>3</VENTAS_QUERETARO>

						    <VENTAS_SAN_LUIS_POTOSI>0</VENTAS_SAN_LUIS_POTOSI>

						    <VENTAS_TAMPICO>0</VENTAS_TAMPICO>

						    <VENTAS_TEPIC>0</VENTAS_TEPIC>

						    <VENTAS_TIJUANA>0</VENTAS_TIJUANA>

						    <VENTAS_TLAXCALA>0</VENTAS_TLAXCALA>

						    <VENTAS_TOLUCA>0</VENTAS_TOLUCA>

						    <VENTAS_TORREON>0</VENTAS_TORREON>

						    <VENTAS_TUXTLA>3</VENTAS_TUXTLA>

						    <VENTAS_VERACRUZ>3</VENTAS_VERACRUZ>

						    <VENTAS_VILLAHERMOSA>2</VENTAS_VILLAHERMOSA>

						    <VENTAS_ZACATECAS>0</VENTAS_ZACATECAS>

						    <ExsTotal>634</ExsTotal>

						  </item >

						</articulos>

3.8 Utilizando el parámetro Subgrupo GET

Si el parámetro subgpo=1 la respuesta agrega en el xml el primer subgrupo del grupo del artículo consultado.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&subgpo=1


							
						    <grupo>RELOJES</grupo >

						    <subgrupo>SMARTWATCH</grupo >

3.9 Mostrar el tipo de cambio GET

Si el parámetro tc=1 se añadirán los campos 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.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&tc=1


							
						    <tipocambio>21.32</tipocambio >

						    <fechaactualizatipoc>16/10/2020 13:33:44</fechaactualizatipoc>

** 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), se recomienda realizar 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.

3.10 Cambiar los precios a Pesos GET

Si requieres todos los precios en pesos mexicanos ya que algunos productos tienen el precio en Dólares, el parámetro MonedaPesos=1 retorna los productos en MN con el tipo de cambio actual, se usa el parámetro aunado al parámetro tc=1

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&tc=1&MonedaPesos=1


							
						    <tipocambio>21.32</tipocambio >

						    <fechaactualizatipoc>16/10/2020 13:33:44</fechaactualizatipoc>

3.11 El uso del parámetro tipo=1 GET

Si tipo=1 entonces el sistema te devolverá un nuevo nodo de XML <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.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&tipo=1


							
						    <TipoProducto>NORMAL</TipoProducto >

3.12 Activando el parámetro Depto GET

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 respuesta mostrará la siguiente información.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&depto=1


							
						    <IdDepartamento>823</IdDepartamento >

						    <Departamento>C</Departamento >

Dónde los valores representan lo siguiente:

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.
S P C D	SE TIENE EXISTENCIA EN EL CENTRO DE DISTRIBUCION
SPF	PRODUCTOS BAJO PEDIDO.

3.13 Consultar la descripción técnica y comercial GET

Si los parámetros dt=1 y dc=1 se encuentran en 1 se mostrará la descripción técnica y comercial del producto, si esta en cero o no incluye el parámetro no te mostrara el elemento XML.

EJEMPLO DE REQUEST

GET

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&dt=1&dc=1


							
						    <ficha_tecnica>GHIA SMART WATCH CYGNUS // 1.1 PULGADAS// 240*240 PIXELES // 320 MAH // SIM CARD 2G// 32MB RAM// 32MB ROM // SENSOR G// GAC-144// BLANCO//
</ficha_tecnica >

						    <ficha_comercial>SMARTWATCH GHIA CYGNUS MANTEN SIEMPRE EL ESTILO CON SU DISENO ELEGANTE, EXCELENTE ACCESORIO PARA EL TRABAJO Y LA VIDA DIARIA. RECIBE NOTIFICACIONES, ALERTAS, RECORDATORIOS, MIDE TU CONSUMO DE CALORIAS, CONTEO DE PASOS (PODOMETRO), RECIBE LLAMADAS, MONITOREO DE SUENO¿ TODO LO QUE NECESITAS DE UN GADGET PARA EL DIA A DIA. AGREGA UN SIM A TU SMARTWATCH PARA REALIZAR Y RECIBIR LLAMADAS DESDE TU RELOJ SIN NECESIDAD DEL MOVIL, PRACTICO CUANDO ESTAS EN CONSTANTE MOVIMIENTO Y REQUIERES SIEMPRE ESTAR DISPONIBLE. LLEVA CONTROL Y RECORD DESDE LA APLICACIÓN GHIA WATCH GRATUITA Y DISPONIBLE PARA ANDROID E IOS. ¡ENCUENTRA EL IDEAL PARA TI! GHIA, TECNOLOGIA DE CALIDAD AL ALCANCE DE TODOS. 
</ficha_comercial >

3.14 Filtro de existencias GET

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 exist 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.

3.15 Consultar Promociones GET

El Web Service puede mostrar información de las promociones que vigentes basadas en descuento al precio o de precio fijo, cuando hay varias promociones de precio para el producto el Web service muestra la promoción que hace que el producto quede más económico. Para obtener las promociones se activa el parámetro promos=1 .

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=AC-4996&promos=1


							
						    <TotalDescuento>10%</TotalDescuento >

						    <MonedaDescuento></MonedaDescuento >

						    <PrecioDescuento>130.21</PrecioDescuento >

						    <MonedaPrecioDescuento>Pesos</MonedaPrecioDescuento >

						    <ClavePromocion>413170</ClavePromocion >

						    <DescripcionPromocion>POWER BANK CON INDICADOR EXACTO DE BATERIA</DescripcionPromocion >

						    <VencimientoPromocion>Por Cantidad</VencimientoPromocion >

						    <DisponibleEnPromocion>251</DisponibleEnPromocion >

En el ejemplo anterior el producto tiene la oferta con precio con descuento de $130.21, siendo esta la mejor promoción aplicable al producto. Cuando el campo <DisponibleEnPromocion> tiene un valor, quiere decir que solo esa cantidad de productos están disponibles para esa promoción.

* Es muy importante tomar en cuenta el vencimiento de la promoción, las promociones mostradas pueden expirar por fecha o por existencias, así que se tiene la responsabilidad 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

** Al utilizar el Webservice acepta el funcionamiento del mismo y que las promociones, existencias, precios y disponibilidad puede cambiar sin previo avisa, por lo que se recomienda siempre consultar en tiempo real.

3.16 Manejo de paquetes GET

La Logística 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.
Si 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.

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=PAQ-587&TipoProducto=1


							
						    <productopaquete>PAQUETE</productopaquete >

						    <componentes>AL-18,AL-15,AL-16,AL-22</componentes >

3.17 Precio especial ME / Webservice GET

Los productos cuentan con un precio especial por levantarse dentro del sistema ME o usando el Webservice; para que el Webservice 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.

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=PAQ-587&TipoCompra=1

3.18 Obtener imágenes de mejor calidad GET

Para obtener imágenes de mejor calidad utilizamos el siguiente endpoint

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

EJEMPLO DE REQUEST

GET

Con los siguientes parámetros: cliente (Número Cliente) y clave (clave de producto) retorna las ligas de las imágenes en mejor resolución.

http://www.grupocva.com/catalogo_clientes_xml/imagenes_alta.xml?cliente=23534&clave=RELOJ-27


							
						   <producto>

						    <imagen>http://www.grupocva.com/detalle_articulo/img_large.php?id=108475</imagen>

						    <imagen>http://www.grupocva.com/detalle_articulo/img_large.php?id=108476</imagen>

						    <imagen>http://www.grupocva.com/detalle_articulo/img_large.php?id=108477</imagen>

						   <producto>

3.19 Obtener productos compatibles / Similares GET

Para obtener una lista de productos compatibles con otro producto, utilizamos el siguiente endpoint:

https://www.grupocva.com/catalogo_clientes_xml/productos_compatibles.xml

EJEMPLO DE REQUEST

GET

Utilizando el parámetro clave (Clave del producto). retorna clave y descripcion de los prodcutos.

https://www.grupocva.com/catalogo_clientes_xml/productos_compatibles.xml?clave=RELOJ-27


							
						   <productos>

						    <producto>

						     <clave>http://www.grupocva.com/detalle_articulo/img_large.php?id=108476</clave>

						     <descripcion>http://www.grupocva.com/detalle_articulo/img_large.php?id=108476</descripcion>

						    </producto>

						
						    <producto>

						     <clave>http://www.grupocva.com/detalle_articulo/img_large.php?id=108476</clave>

						     <descripcion>http://www.grupocva.com/detalle_articulo/img_large.php?id=108476</descripcion>

						    </producto>

						
						    <producto>

						     ... 

						    </producto>

						
						   <productos>

3.20 Filtrar productos por Solución GET

Con el parámetro Solucion=(ID de Solucion) *Véase catálogo Soluciones Esta consulta filtra los productos Solucion=21 Gamer de la marca=Acteck

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=64771&marca=ACTECK&Solucion=21

3.20 Obtener el tránsito a sucursal. GET

Utilizando el parámetro trans=1 podemos obtener la cantidad en tránsito a la sucursal.

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios_perron.xml?cliente=23534&clave=CN-4011&trans=1


							
						    <en_transito>21</en_transito >

3.21 Consultar dimensiones de productos GET

Para consultar las dimensiones de un producto se utiliza el parámetro dimen=1 Retornará las dimensiones en metros y el peso en kilos.

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=CEL-109&dimen=1


							
						    <dimensiones>.05,.1,.17</dimensiones >

						    <peso>.36</peso >

3.22 Información Técnica Desglosada GET

Puedes obtener la información técnica de un producto desglosada en características. Utilizando los parámetros cliente y clave.

Endpoint

https://www.grupocva.com/catalogo_clientes_xml/informacion_tecnica.xml

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/informacion_tecnica.xml?cliente=23534&clave=RELOJ-27


					
						   <producto>

						    <dato nombre="MONITOREA" >CALORIAS</dato >

						    <dato nombre="MONITOREA" >PASOS</dato >

						    <dato nombre="LLAMADA ENTRANTE" >SI </dato >

						    <dato nombre="RESISTENTE AL AGUA" >SI </dato >

						    <dato nombre="INCLUYE ALTAVOZ" >SI </dato >

						    <dato nombre="DISPLAY TACTIL" >SI </dato >

						    <dato nombre="NOTIFICACIONES" >TWITTER</dato >

						    <dato nombre="NOTIFICACIONES" >SI</dato >

						    <dato nombre="NOTIFICACIONES" >FACEBOOK</dato >

						    <dato nombre="NOTIFICACIONES" >LLAMADA ENTRANTE</dato >

						    <dato nombre="NOTIFICACIONES" >WHATSAPP</dato >

						    <dato nombre="NOTIFICACIONES" >CORREO ELECTRONICO</dato >

						    <dato nombre="INTERFAZ" >BLUETOOTH</dato >

						    <dato nombre="COMPATIBILIDAD" >ANDROID 4.3 O SUPERIOR</dato >

						    <dato nombre="COMPATIBILIDAD" >IOS 8 O SUPERIOR</dato >

						    <dato nombre="RESOLUCION" >240 X 240 P</dato >

						    <dato nombre="TIPO DE MATERIAL" >METAL</dato >

						    <dato nombre="TIPO DE MATERIAL" >HULE</dato >

						    <dato nombre="DURACION DE BATERIA APROXIMADA" >24 HRS</dato >

						    <dato nombre="COLOR" >BLANCO</dato >

						    <dato nombre="TIPO DE PANTALLA" >LCd</dato >

						    <dato nombre="RESISTENTE A SALPICADURAS"" >SI</dato >

						   </producto>

3.23 Obtener UPC GET

Para consultar el UPC se utiliza el parámetro upc=1 Retornará un campo con el UPC * Cabe mencionar que no todos los productos cuentan con este dato.

EJEMPLO DE REQUEST

GET

https://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&clave=RELOJ-27&upc=1


							
						    <upc>7503025717326</upc >

Registrar dirección IP

Para obtener acceso a nuestro Web Service es necesario registrar la(s) direccion(es) IP desde donde vas a realizar las consultas, para ello ingresa a la plataforma ME

Ingresar en las opciones Información adicional > me interfaz XML. En el campo DIRECCION IP PERMITIDAD ingresa la dirección IP a registrar.

Endpoint / Documentación de Pedidos

Contamos con un Web Service tipo SOAP para levantar pedidos, en la siguiente liga se puede encontrar la documentación y endpoints

https://www.grupocva.com/pedidos_web/pedidos_ws_cva.php

4. Consideraciones

Se recomienda realicen todas tus transacciones en línea (es decir que no hagas una descarga de todo el catálogo una sola vez, si no realizar las consultas 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.

* Al utilizar el Webservice acepta el funcionamiento del mismo y que las promociones, existencias, precios y disponibilidad puede cambiar sin previo avisa, por lo que se recomienda siempre consultar en tiempo real.

Información adicional

Para dudas/preguntas Departamento de Desarrollo

Juan Alfaro	jalfaro@grupocva.com
David Solórzano	sdavid@grupocva.com

5. Preguntas Frecuentes

Los productos cuentan con un precio especial por levantarse dentro del sistema ME, para que el Webservice 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. Véase Precio especial ME

Para ello ingresa a la plataforma ME

Ingresar en las opciones Información adicional > me interfaz XML. En el campo DIRECCION IP PERMITIDAD ingresa la dirección IP a registrar.

Contamos con un web Service SOAP para el alta de pedidos, puede econtrar la documentacion/endpoints Aquí

Para consultar por subgrupo, es necesario hacerlo con el parámetro grupo2. Véase grupos
Consultando por grupo2 se realiza utilizando el id del grupo y el respectivo subgrupo coma separados
Ejemplo:

http://www.grupocva.com/catalogo_clientes_xml/lista_precios.xml?cliente=23534&grupo2=268,15462

6. Crear un Pedido POST

Para crear pedidos contamos con un servicio web SOAP que recibe un XML como request y entrega un XML como response.

Parámetro	Descripción
<Usuario>	Nombre de usuario (El mismo de la plataforma ME)
<PWD>	Contraseña (La misma de la plataforma ME)
<NumOC>	Tu identificador/numero de orden
<Paqueteria>	Clave de la paqueteria (Véase Catalogo Paqueterias )
<CodigoSucursal>	Clave de la sucursal (Véase Catalogo sucursal )
<Observaciones>	Alguna observacion sobre el pedido.
<clave>	Clave del producto
<cantidad>	La cantidad del producto
<TipoFlete>	Si el producto lleva flete SF: Sin flete FF: Flete cobrado en la factura de CVA FS: Flete cobrado en la factura de CVA Asegurado
<Calle>	Calle de envio
<Numero>	Numero
<NumeroInt>	Numero interior
<Colonia>	Colonia de envio
<Estado>	Clave de Estado (Véase Catalogo de Ciudades )
<Ciudad>	Clave de Ciudad (Véase Catalogo de Ciudades )
<Atencion>	Con atencion a quien (nombre)

URL: https://www.grupocva.com/pedidos_web/pedidos_ws_cva.php?wsdl

EJEMPLO DE REQUEST

POST

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
  <PedidoWeb xmlns='urn:PedidoWebwsdl#PedidoWeb'>
   <Usuario>TUUSUARIO</Usuario>
   <PWD>TUPASSWORD</PWD>
   <XMLOC xsi:type="xsd:string">
    <PEDIDO>
    <NumOC>ORDEN_001</NumOC>
    <Paqueteria>0</Paqueteria>
    <CodigoSucursal>1</CodigoSucursal>
    <PedidoBO>N</PedidoBO>
    <Observaciones>Pedidos de prueba desde POSTMAN by SDAVID </Observaciones>
    <productos>
     <producto>
      <clave>NOT-4131</clave>
      <cantidad>1</cantidad>
     </producto>
    </productos>
   <TipoFlete>SF</TipoFlete>
   <Calle>JOSE RAMOS</Calle>
   <Numero>845</Numero>
   <NumeroInt>845</NumeroInt>
   <Colonia>TETLAN</Colonia>
   <Estado>1</Estado>
   <Ciudad>1</Ciudad>
   <Atencion>SF</Atencion>
   </PEDIDO>
  </XMLOC>
</PedidoWeb>
</soap:Body>
</soap:Envelope>

RESPONSE


							
						<?xml version="1.0" encoding="ISO-8859-1"?>

						<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">

						  <SOAP-ENV:Body>

						    <ns1:PedidoWebResponse xmlns:ns1="urn:PedidoWebwsdl#PedidoWeb">

						      <error xsi:type="xsd:string"></error>

						      <estado xsi:type="xsd:string">AFECTADO</estado>

						      <pedido xsi:type="xsd:string">NGB-500204</pedido>

						      <total xsi:type="xsd:string">70.01</total>

						      <agentemail xsi:type="xsd:string">gjmiranda@grupocva.com</agentemail>

						      <almacenmail xsi:type="xsd:string">valenzuelaj@grupocva.com</almacenmail>

						    </ns1:PedidoWebResponse>

						  </SOAP-ENV:Body>

						</SOAP-ENV:Envelope>

DOCUMENTACION CVA API

CVA WEB SERVICE

1. Genera tu acceso

2. Conociendo los parámetros

3. Realizando Consultas

3.1 Consulta producto por número de parte. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.2 Consulta producto por Clave CVA. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.3 Consulta producto por Marca. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.4 Consulta producto por Grupo. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.4.1 Consulta producto por Grupo2. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.4.1.1 Filtra por subgrupos concatenando al grupo2 GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.5 Consulta producto por búsqueda genérica. GET

EJEMPLO DE REQUEST

EJEMPLO DE RESPUESTA 200 OK

3.6 Agregar porcentaje GET

EJEMPLO DE REQUEST

3.7 Consulta disponibilidad en sucursales GET

EJEMPLO DE REQUEST

3.8 Utilizando el parámetro Subgrupo GET

EJEMPLO DE REQUEST

3.9 Mostrar el tipo de cambio GET

EJEMPLO DE REQUEST

3.10 Cambiar los precios a Pesos GET

EJEMPLO DE REQUEST

3.11 El uso del parámetro tipo=1 GET

EJEMPLO DE REQUEST

3.12 Activando el parámetro Depto GET

EJEMPLO DE REQUEST

3.13 Consultar la descripción técnica y comercial GET

EJEMPLO DE REQUEST

3.14 Filtro de existencias GET

3.15 Consultar Promociones GET

EJEMPLO DE REQUEST

3.16 Manejo de paquetes GET

EJEMPLO DE REQUEST

3.17 Precio especial ME / Webservice GET

EJEMPLO DE REQUEST

3.18 Obtener imágenes de mejor calidad GET

EJEMPLO DE REQUEST

3.19 Obtener productos compatibles / Similares GET

EJEMPLO DE REQUEST

3.20 Filtrar productos por Solución GET

EJEMPLO DE REQUEST

3.20 Obtener el tránsito a sucursal. GET

EJEMPLO DE REQUEST

3.21 Consultar dimensiones de productos GET

EJEMPLO DE REQUEST

3.22 Información Técnica Desglosada GET

EJEMPLO DE REQUEST

3.23 Obtener UPC GET

EJEMPLO DE REQUEST

Registrar dirección IP

Catalogo de Marcas

Catalogo de Grupos

Catalogo de Marcas 2

Catalogo de Grupos 2

Catalogo de Soluciones

Catalogo de Ciudades

Catalogo de Sucursales

Catalogo de Paqueterías

Endpoint / Documentación de Pedidos

4. Consideraciones

Información adicional

5. Preguntas Frecuentes

6. Crear un Pedido POST

EJEMPLO DE REQUEST

RESPONSE