API Terceros/Grupo Ventas Compras - Historial de revisiones

Dvaldes: /* Métodos */

2023-06-27T19:50:11Z

Métodos

← Revisión anterior		Revisión del 14:50 27 jun 2023
Línea 133:		Línea 133:
	\| descripcion_cuenta_rte_iva \|\| string \|\| Descripción de la cuenta Rte. IVA		\| descripcion_cuenta_rte_iva \|\| string \|\| Descripción de la cuenta Rte. IVA
	\|-		\|-
	\| tipogrupo \|\| int \|\| Tipo de retención (Ventas o Compras)		\| tipogrupo \|\| int \|\| Tipo de retención (Ventas es 0 y Compras es 1)
	\|-		\|-
	\| aplica_iva_teorico \|\| bool \|\| Si aplica IVA teórico		\| aplica_iva_teorico \|\| bool \|\| Si aplica IVA teórico

Dvaldes: /* Métodos */

2023-06-08T19:27:21Z

Métodos

← Revisión anterior		Revisión del 14:27 8 jun 2023
Línea 69:		Línea 69:
	"porcentaje_rte_iva": 1000.00,		"porcentaje_rte_iva": 1000.00,
	"cuenta_rte_fuente": 1234567,		"cuenta_rte_fuente": 1234567,
			"descripcion_cuenta_rte_fuente": "DESCRIPCION CUENTA RTE. FUENTE",
	"cuenta_rte_ica": 1234567,		"cuenta_rte_ica": 1234567,
			"descripcion_cuenta_rte_ica": "DESCRIPCION CUENTA RTE. ICA",
	"cuenta_rte_iva": 1234567,		"cuenta_rte_iva": 1234567,
			"descripcion_cuenta_rte_iva": "DESCRIPCION CUENTA RTE. IVA",
	"tipogrupo": 1,		"tipogrupo": 1,
	"aplica_iva_teorico": false,		"aplica_iva_teorico": false,
Línea 76:		Línea 79:
	"porcentaje_iva_teorico": 1000.00,		"porcentaje_iva_teorico": 1000.00,
	"cuenta_iva_teorico": 1234567,		"cuenta_iva_teorico": 1234567,
	"cuenta_ret_iva_teorico": 1234567		"descripcion_cuenta_rte_iva": "DESCRIPCION CUENTA IVA TEORICO",
			"cuenta_ret_iva_teorico": 1234567,
			"descripcion_cuenta_rte_iva": "DESCRIPCION CUENTA RTE. IVA TEORICO"
	}		}
	]		]
Línea 117:		Línea 122:
	\|-		\|-
	\| cuenta_rte_fuente \|\| int \|\| Cuenta Rte. Fuente		\| cuenta_rte_fuente \|\| int \|\| Cuenta Rte. Fuente
			\|-
			\| descripcion_cuenta_rte_fuente \|\| string \|\| Descripción de la cuenta Rte. Fuente
	\|-		\|-
	\| cuenta_rte_ica \|\| int \|\| Cuenta Rte. ICA		\| cuenta_rte_ica \|\| int \|\| Cuenta Rte. ICA
			\|-
			\| descripcion_cuenta_rte_ica \|\| string \|\| Descripción de la cuenta Rte. ICA
	\|-		\|-
	\| cuenta_rte_iva \|\| int \|\| Cuenta Rte. IVA		\| cuenta_rte_iva \|\| int \|\| Cuenta Rte. IVA
			\|-
			\| descripcion_cuenta_rte_iva \|\| string \|\| Descripción de la cuenta Rte. IVA
	\|-		\|-
	\| tipogrupo \|\| int \|\| Tipo de retención (Ventas o Compras)		\| tipogrupo \|\| int \|\| Tipo de retención (Ventas o Compras)
Línea 131:		Línea 142:
	\|-		\|-
	\| cuenta_iva_teorico \|\| int \|\| Cuenta IVA teórico		\| cuenta_iva_teorico \|\| int \|\| Cuenta IVA teórico
			\|-
			\| descripcion_cuenta_iva_teorico \|\| string \|\| Descripción de la cuenta IVA teórico
	\|-		\|-
	\| cuenta_ret_iva_teorico \|\| int \|\| Cuenta Rte. IVA teórico		\| cuenta_ret_iva_teorico \|\| int \|\| Cuenta Rte. IVA teórico
			\|-
			\| descripcion_cuenta_ret_iva_teorico \|\| string \|\| Descripción de la cuenta Rte. IVA teórico
	\|}		\|}
	</Tab>		</Tab>

Dvaldes: /* Métodos */

2023-05-29T17:20:58Z

Métodos

← Revisión anterior		Revisión del 12:20 29 may 2023
Línea 20:		Línea 20:

	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/GrupoVentas		<nowiki>https://www.apis.serpi.com.co/api/v1/GrupoVentas</nowiki>

	'''EndPoint con parámetros:'''		'''EndPoint con parámetros:'''

Dvaldes: /* Métodos */

2023-05-29T17:20:29Z

Métodos

← Revisión anterior		Revisión del 12:20 29 may 2023
Línea 23:		Línea 23:

	'''EndPoint con parámetros:'''		'''EndPoint con parámetros:'''
	https://www.apis.serpi.com.co/api/v1/GrupoVentas?limite=50&pagina=1		<nowiki>https://www.apis.serpi.com.co/api/v1/GrupoVentas?limite=50&pagina=1</nowiki>

	{\| class="wikitable"		{\| class="wikitable"

Dvaldes: /* ¿Cómo consumir la API? */

2023-05-29T17:18:14Z

¿Cómo consumir la API?

← Revisión anterior		Revisión del 12:18 29 may 2023
Línea 415:		Línea 415:
	<Tab name = "Java">		<Tab name = "Java">
	'''Request'''		'''Request'''
	<syntaxhighlight lang="java~~" line="1~~">		<syntaxhighlight lang="java">
	OkHttpClient client = new OkHttpClient().newBuilder()		OkHttpClient client = new OkHttpClient().newBuilder()
	.build();		.build();
			MediaType mediaType = MediaType.parse("text/plain");
			RequestBody body = RequestBody.create(mediaType, "");
	Request request = new Request.Builder()		Request request = new Request.Builder()
	.url("https://~~www.apis.serpi.com.co~~/api/v1/~~ListaPrecioDetalle?limite=50&pagina=1~~")		.url("https://localhost:44305/api/v1/GrupoVentas")
	.method("GET", ~~null~~)		.method("GET", body)
	.addHeader("~~serpi-token~~", "{{token}}")		.addHeader("secretkey", "{{secret key}}")
			.addHeader("Authorization", "Bearer{{token}}")
	.build();		.build();
	Response response = client.newCall(request).execute();		Response response = client.newCall(request).execute();
	</syntaxhighlight>		</syntaxhighlight>
			</Tab>

	'''~~Response~~'''		<Tab name = "C#">
	<syntaxhighlight lang="~~java" line="1~~">		'''Request'''
	{		<syntaxhighlight lang="c#">
	"~~code~~"~~: 200,~~		var client = new HttpClient();
	"~~error~~"~~: null~~,		var request = new HttpRequestMessage(HttpMethod.Get, "https://localhost:44305/api/v1/GrupoVentas");
	"~~msg~~": "~~Information found for the current month~~",		request.Headers.Add("secretkey", "{{secret key}}");
	"~~data~~"~~: [~~		request.Headers.Add("Authorization", "Bearer{{token}}");
	{		var content = new StringContent("", null, "text/plain");
	~~"operation":~~ "",		request.Content = content;
	~~"description": ""~~,		var response = await client.SendAsync(request);
	~~"items":~~ "",		response.EnsureSuccessStatusCode();
	~~"date": ""~~		Console.WriteLine(await response.Content.ReadAsStringAsync());
	}
	]
	}
	</syntaxhighlight>		</syntaxhighlight>
	</Tab>		</Tab>

	<Tab name = "~~Python~~">		<Tab name = "PHP">
	'''Request'''		'''Request'''
	<syntaxhighlight lang="~~java" line="1~~">		<syntaxhighlight lang="php">
	~~import requests~~		<?php
			require_once 'HTTP/Request2.php';
	~~url~~ = "https://~~www.apis.serpi.com.co~~/api/v1/~~ListaPrecioDetalle?limite~~=~~50&pagina=1"~~		$request = new HTTP_Request2();
			$request->setUrl('https://localhost:44305/api/v1/GrupoVentas');
	~~payload~~={}		$request->setMethod(HTTP_Request2::METHOD_GET);
	~~headers~~ = {		$request->setConfig(array(
	~~'serpi~~-~~token~~': '{{~~token~~}}'		'follow_redirects' => TRUE
			));
			$request->setHeader(array(
			'secretkey' => '{{secret key}}',
			'Authorization' => 'Bearer{{token}}'
			));
			$request->setBody('');
			try {
			$response = $request->send();
			if ($response->getStatus() == 200) {
			echo $response->getBody();
			}
			else {
			echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
			$response->getReasonPhrase();
			}
	}		}
			catch(HTTP_Request2_Exception $e) {
	~~response = requests.request~~(~~"GET", url, headers=headers, data=payload~~)		echo 'Error: ' . $e->getMessage();

	~~print(response.text)~~
	~~</syntaxhighlight>~~

	''~~'Response'''~~
	~~<syntaxhighlight lang="java" line="1"~~>
	{
	~~"code": 200,~~
	~~"error": null,~~
	~~"msg": "Information found for the current month",~~
	~~"data": [~~
	{
	~~"operation": "",~~
	~~"description": "",~~
	~~"items": "",~~
	~~"date": ""~~
	}
	]
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Dvaldes: /* ¿Cómo consumir la API? */

2023-05-27T16:50:23Z

¿Cómo consumir la API?

← Revisión anterior		Revisión del 11:50 27 may 2023
Línea 419:		Línea 419:
	.build();		.build();
	Request request = new Request.Builder()		Request request = new Request.Builder()
	.url("https://~~wv9901~~.~~wolkvox~~.com/api/v2/~~reports_manager.php~~?~~api=agent_1&date_ini~~=~~{{YYYYmmddHHiiss}}~~&~~date_end~~=~~{{YYYYmmddHHiiss}}~~")		.url("https://www.apis.serpi.com.co/api/v1/ListaPrecioDetalle?limite=50&pagina=1")
	.method("GET", null)		.method("GET", null)
	.addHeader("~~wolkvox~~-token", "{{token}}")		.addHeader("serpi-token", "{{token}}")
	.build();		.build();
	Response response = client.newCall(request).execute();		Response response = client.newCall(request).execute();
Línea 449:		Línea 449:
	import requests		import requests

	url = "https://~~wv9901~~.~~wolkvox~~.com/api/v2/~~reports_manager.php~~?~~api=agent_1&date_ini~~=~~{{YYYYmmddHHiiss}}~~&~~date_end~~=~~{{YYYYmmddHHiiss}}~~"		url = "https://www.apis.serpi.com.co/api/v1/ListaPrecioDetalle?limite=50&pagina=1"

	payload={}		payload={}
	headers = {		headers = {
	'~~wolkvox~~-token': '{{token}}'		'serpi-token': '{{token}}'
	}		}

Gpazos en 15:16 27 may 2023

2023-05-27T15:16:29Z

← Revisión anterior		Revisión del 10:16 27 may 2023
Línea 1:		Línea 1:
	'''Descripción:'''		'''Descripción:'''
	~~Este reporte entrega una visión completa de la gestión del agente al resumir individualmente~~ la ~~actividad del asesor indicando el total~~ de ~~las llamadas gestionadas (inbound/ outbound/ internal), el tiempo que ha usado en cada fase de la atención al cliente (tiempo de Ring, ACW~~ y ~~AHT), fecha y hora de Log In/Log Out, además~~ la ~~cantidad de hits y RPC~~.		Esta API permite la sincronizacion de Grupo Ventas Compras entre SERPI y la plataforma que lo requiera permitiendo tener un manejo estándar entre las dos herramientas.

	'''Autorización:'''		'''Autorización:'''
Línea 6:		Línea 6:

	'''Beneficio:'''		'''Beneficio:'''
	~~Este reporte permite hacer una medición de la productividad individual de los agentes teniendo en cuenta el tiempo dedicado a la gestión de llamadas y sus logros (hits y RPC)~~

	'''Tipos de peticiones:'''		'''Tipos de peticiones:'''
Línea 12:		Línea 11:

	'''¿Cómo funciona?'''		'''¿Cómo funciona?'''
	*El consumo de esta API se realiza por método GET.
	*Para consumir esta API debe reemplazar en la url {ip_ipdialbox} por la nomenclatura del servidor de la operación y el {token} generado desde wolkvox Manager para obtener la información de manera segura.
	*Tenga en cuenta que un mismo token no puede ser consumidos de manera simultanea, por lo cual puede programar que la siguiente API sea consumida cuando el resultado de la anterior sea exitoso.		*Tenga en cuenta que un mismo token no puede ser consumidos de manera simultanea, por lo cual puede programar que la siguiente API sea consumida cuando el resultado de la anterior sea exitoso.
	*En términos de tiempo, para hacer seguimiento a su operación puede hacer un consumo cada 5 minutos de la información.		*En términos de tiempo, para hacer seguimiento a su operación puede hacer un consumo cada 5 minutos de la información.

Dvaldes: /* Métodos */

2023-05-25T20:25:48Z

Métodos

← Revisión anterior		Revisión del 15:25 25 may 2023
Línea 23:		Línea 23:

	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~RegimenTributario~~		https://www.apis.serpi.com.co/api/v1/GrupoVentas

	'''EndPoint con parámetros:'''		'''EndPoint con parámetros:'''
	https://www.apis.serpi.com.co/api/v1/~~RegimenTributarios~~?limite=50&pagina=1		https://www.apis.serpi.com.co/api/v1/GrupoVentas?limite=50&pagina=1

	{\| class="wikitable"		{\| class="wikitable"
Línea 142:		Línea 142:
	<Tab name = "API Creación (POST) ">		<Tab name = "API Creación (POST) ">
	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~RegimenTributario~~		https://www.apis.serpi.com.co/api/v1/GrupoVentas

	{\| class="wikitable"		{\| class="wikitable"
Línea 261:		Línea 261:
	<Tab name = "API Modificar(PUT) ">		<Tab name = "API Modificar(PUT) ">
	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~RegimenTributario~~		https://www.apis.serpi.com.co/api/v1/GrupoVentas

	{\| class="wikitable"		{\| class="wikitable"

Dvaldes: /* Métodos */

2023-05-25T20:25:10Z

Métodos

← Revisión anterior		Revisión del 15:25 25 may 2023
Línea 230:		Línea 230:

	==== '''AVISO IMPORTANTE:''' ====		==== '''AVISO IMPORTANTE:''' ====
	Digite null o 0 (si es un campo del tipo double), para aquellos valores donde los campos no sean obligatorios		Digite null o 0 (si es un campo del tipo double o int), para aquellos valores donde los campos no sean obligatorios y donde no se va a asignar algún valor.


Línea 241:		Línea 241:
	"message": "registro creado exitosamente"		"message": "registro creado exitosamente"
	}		}
			</syntaxhighlight>

			'''Validaciones'''
			<syntaxhighlight lang="JSON">
	{		{
	"success": false,		"success": false,
Línea 349:		Línea 352:

	==== '''AVISO IMPORTANTE:''' ====		==== '''AVISO IMPORTANTE:''' ====
	Digite null o 0 (si es un campo del tipo double), para aquellos valores donde los campos no sean obligatorios		Digite null o 0 (si es un campo del tipo double o int), para aquellos valores donde los campos no sean obligatorios y donde no se va a asignar algún valor.


Línea 361:		Línea 364:
	}		}

			{
			"success": false,
			"code": 204,
			"errors": null,
			"message": "No se encontraron registros con el id 1"
			}
			</syntaxhighlight>

			'''Validaciones'''
			<syntaxhighlight lang="JSON">
	{		{
	"success": false,		"success": false,
Línea 371:		Línea 384:
	],		],
	"message": "Se presentaron errores al modificar el registro"		"message": "Se presentaron errores al modificar el registro"
	}

	{
	~~"success": false,~~
	~~"code": 204,~~
	~~"errors": null,~~
	~~"message": "No se encontraron registros con el id 2"~~
	}		}
	</syntaxhighlight>		</syntaxhighlight>

Dvaldes: /* Métodos */

2023-05-25T19:46:57Z

Métodos

← Revisión anterior		Revisión del 14:46 25 may 2023
Línea 23:		Línea 23:

	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~GrupoVentas~~		https://www.apis.serpi.com.co/api/v1/RegimenTributario

	'''EndPoint con parámetros:'''		'''EndPoint con parámetros:'''
	https://www.apis.serpi.com.co/api/v1/~~GrupoVentas~~?limite=50&pagina=1		https://www.apis.serpi.com.co/api/v1/RegimenTributarios?limite=50&pagina=1

	{\| class="wikitable"		{\| class="wikitable"
Línea 142:		Línea 142:
	<Tab name = "API Creación (POST) ">		<Tab name = "API Creación (POST) ">
	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~GrupoVentas~~		https://www.apis.serpi.com.co/api/v1/RegimenTributario

	{\| class="wikitable"		{\| class="wikitable"
Línea 258:		Línea 258:
	<Tab name = "API Modificar(PUT) ">		<Tab name = "API Modificar(PUT) ">
	'''EndPoint:'''		'''EndPoint:'''
	https://www.apis.serpi.com.co/api/v1/~~GrupoVentas~~		https://www.apis.serpi.com.co/api/v1/RegimenTributario

	{\| class="wikitable"		{\| class="wikitable"