https://www.wikiserpi.com/index.php?action=history&feed=atom&title=API_BI_Venta_Detalle
API BI Venta Detalle - Historial de revisiones
2026-11-11T07:18:55Z
Historial de revisiones de esta página en la wiki
MediaWiki 1.43.0
https://www.wikiserpi.com/index.php?title=API_BI_Venta_Detalle&diff=1145&oldid=prev
Lmedina: /* ¿Cómo consumir la API? */
2023-12-18T21:32:10Z
<p><span class="autocomment">¿Cómo consumir la API?</span></p>
<table style="background-color: #fff; color: #202122;" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="es">
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">← Revisión anterior</td>
<td colspan="2" style="background-color: #fff; color: #202122; text-align: center;">Revisión del 16:32 18 dic 2023</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l271">Línea 271:</td>
<td colspan="2" class="diff-lineno">Línea 271:</td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>require_once 'HTTP/Request2.php';</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>require_once 'HTTP/Request2.php';</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request = new HTTP_Request2();</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request = new HTTP_Request2();</div></td></tr>
<tr><td class="diff-marker" data-marker="−"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>$request->setUrl('https://localhost:4444/api/v1/<del style="font-weight: bold; text-decoration: none;">BICartera</del>');</div></td><td class="diff-marker" data-marker="+"></td><td style="color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>$request->setUrl('https://localhost:4444/api/v1/<ins style="font-weight: bold; text-decoration: none;">BIVentaDetalle</ins>');</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request->setMethod(HTTP_Request2::METHOD_GET);</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request->setMethod(HTTP_Request2::METHOD_GET);</div></td></tr>
<tr><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request->setConfig(array(</div></td><td class="diff-marker"></td><td style="background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>$request->setConfig(array(</div></td></tr>
</table>
Lmedina
https://www.wikiserpi.com/index.php?title=API_BI_Venta_Detalle&diff=1144&oldid=prev
Lmedina: Página creada con «'''Descripción:''' PENDIENTE '''Autorización:''' Se requiere autenticación para todas las solicitudes. Las credenciales de autenticación deben ser incluidas en la cabecera de todas las solicitudes a través del campo Authorization utilizando el token de acceso entregado SERPI ERP. '''Beneficio:''' PENDIENTE '''Tipos de peticiones:''' GET '''¿Cómo funciona?''' PENDIENTE == Métodos == <Tabs> <!-- **************************************************************…»
2023-12-18T21:27:29Z
<p>Página creada con «'''Descripción:''' PENDIENTE '''Autorización:''' Se requiere autenticación para todas las solicitudes. Las credenciales de autenticación deben ser incluidas en la cabecera de todas las solicitudes a través del campo Authorization utilizando el token de acceso entregado SERPI ERP. '''Beneficio:''' PENDIENTE '''Tipos de peticiones:''' GET '''¿Cómo funciona?''' PENDIENTE == Métodos == <Tabs> <!-- **************************************************************…»</p>
<p><b>Página nueva</b></p><div>'''Descripción:'''<br />
PENDIENTE<br />
<br />
'''Autorización:'''<br />
Se requiere autenticación para todas las solicitudes. Las credenciales de autenticación deben ser incluidas en la cabecera de todas las solicitudes a través del campo Authorization utilizando el token de acceso entregado SERPI ERP.<br />
<br />
'''Beneficio:'''<br />
PENDIENTE<br />
<br />
'''Tipos de peticiones:'''<br />
GET<br />
<br />
'''¿Cómo funciona?'''<br />
PENDIENTE<br />
<br />
== Métodos ==<br />
<Tabs><br />
<!-- ************************************************************** GET ********************************************************************** --><br />
<Tab name = "API Consulta (GET) "><br />
<br />
'''EndPoint:'''<br />
https://localhost:44305/api/v1/BIVentaDetalle<br />
<br />
'''EndPoint Con Parametros:'''<br />
https://localhost:44305/api/v1/BIVentaDetalle?tipo_documento=FE&fecha_desde=2017-12-01&fecha_hasta=2017-12-15<br />
<br />
{| class="wikitable"<br />
|+ Headers<br />
|-<br />
! Header !! Descripción <br />
|-<br />
| secretkey || Secretkey proporcionada al cliente para consumos de las APIs<br />
|}<br />
<br />
'''Authorization:'''<br />
<syntaxhighlight ><br />
Usar Bearer. Ejemplo “bearer {{token}}”.<br />
{{token}} Token de autorizacion generado por SerpiERP<br />
</syntaxhighlight><br />
<br />
{| class="wikitable"<br />
|+ Parámetros<br />
|-<br />
! Parámetro !! Tipo de dato !! Requerido !! Descripción<br />
|-<br />
| Límite || int || No || Este parámetro indica la cantidad de resultados que se deben devolver en una sola página<br />
|-<br />
| Página || int || No || Este parámetro indica el número de la página que se debe devolver. Por ejemplo, si se establece en 3, se devolverán los resultados de la tercera página<br />
|}<br />
<br />
'''Response'''<br />
<syntaxhighlight lang="JSON"><br />
{<br />
"success": true,<br />
"code": 200,<br />
"errors": null,<br />
"message": "1 registro(s) encontrados",<br />
"result": [<br />
{<br />
"numero": 1521,<br />
"fecha": "2017-12-04T00:00:00",<br />
"ano": 2017,<br />
"mes": 12,<br />
"periodo": "201712",<br />
"contab": true,<br />
"anulado": false,<br />
"vendedor": 7363,<br />
"proyecto": null,<br />
"actividad": null,<br />
"cod_empresa": 1,<br />
"codcentro": 1,<br />
"nit": "94427979",<br />
"dv": 0,<br />
"cliente": "EDWIN RAMON GIRALDO LOPEZ",<br />
"vendedor_nombre": "NATALIA ARIAS OCAMPO",<br />
"categoria": "FV",<br />
"tipodoc": "FV",<br />
"documento": "FACTURA DE VENTA",<br />
"codigo": "PT002",<br />
"descripcion_articulo": "Hidrokeratina Caja 30 Und X 30 Ml ",<br />
"referencia": "HKERA CAJA",<br />
"cantidad": 6.00000,<br />
"netcant": 6.00000,<br />
"precio": 44070.00000,<br />
"impuesto": 41196.64000,<br />
"descuento": 47595.60000,<br />
"subtotal": 216824.40000,<br />
"neto": 216824.40000,<br />
"bruto": 264420.00000,<br />
"valiva": 41196.64000,<br />
"total": 258021.04000,<br />
"flete": -216824.40000,<br />
"valorimpaiu": 0.00000,<br />
"valoraiu": 0.00000,<br />
"porcimpaiu": 0.00000,<br />
"porcaiu": 0.00000,<br />
"porcimp": 19.00000,<br />
"descuentoc": 0.00000,<br />
"descuentop": 0.00000,<br />
"descuentol": 18.00000,<br />
"empresa": "DEMO2 - GIORGIO ",<br />
"niT_EMPRESA": "987654321",<br />
"digitO_EMPRESA": 4,<br />
"linea": "LINEA KERA",<br />
"cod_cate": "6",<br />
"categoria_articulo": "CREMAS",<br />
"centroperacion": "PRINCIPAL",<br />
"ciudad": "SANTIAGO DE CALI",<br />
"cod_ciu": "001",<br />
"cod_depar": "76",<br />
"departamento": "VALLE DEL CAUCA",<br />
"preforigen": null,<br />
"numorigen": null,<br />
"numremision": null,<br />
"numordencompra": null<br />
}<br />
]<br />
}<br />
<br />
{<br />
"success": true<br />
"code": 201,<br />
"message": "No se encontraron registros",<br />
"result": []<br />
}<br />
</syntaxhighlight><br />
<br />
{| class="wikitable"<br />
|+ Campos de resultados<br />
|-<br />
! Campo !! Tipo de dato !! Descripción<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|-<br />
| id || int || Identificador del país<br />
|-<br />
| nombre || string || Nombre del país<br />
|-<br />
| codigo || string || Código del país<br />
|-<br />
| codigo_alfa || string || Nomenclatura del país<br />
|}<br />
</Tab><br />
</Tabs><br />
<br />
== Códigos de estado HTTP ==<br />
{| class="wikitable left"<br />
! Código !! Descripción<br />
|-<br />
| 200 || La solicitud ha sido exitosa<br />
|-<br />
| 201 || La solicitud ha tenido éxito y ha llevado a la creación de un recurso<br />
|-<br />
| 204 || La solicitud se ha completado correctamente, pero no hay contenido para devolver en la respuesta<br />
|-<br />
| 400 || El servidor no puede o no procesará la petición debido a algo que es percibido como un error del cliente<br />
|-<br />
| 401 || La solicitud requiere autenticación, pero el cliente no ha proporcionado credenciales válidas o no está autorizado para acceder al recurso<br />
|-<br />
| 403 || El servidor ha entendido la solicitud, pero se niega a cumplirla debido a que el cliente no tiene permisos para acceder al recurso<br />
|-<br />
| 404 || El recurso solicitado no se ha encontrado en el servidor<br />
|-<br />
| 500 || Internal Server Error<br />
|-<br />
| 503 || El servidor no está disponible actualmente debido a una sobrecarga o mantenimiento temporal<br />
|}<br />
<br />
== ¿Cómo consumir la API? ==<br />
<br />
<Tabs><br />
<br />
<Tab name = "Java"><br />
'''Request'''<br />
<syntaxhighlight lang="java"><br />
OkHttpClient client = new OkHttpClient().newBuilder()<br />
.build();<br />
MediaType mediaType = MediaType.parse("text/plain");<br />
RequestBody body = RequestBody.create(mediaType, "");<br />
Request request = new Request.Builder()<br />
.url("https://localhost:4444/api/v1/BIVentaDetalle")<br />
.method("GET", body)<br />
.addHeader("secretkey", "{{secret key}}")<br />
.addHeader("Authorization", "Bearer{{token}}")<br />
.build();<br />
Response response = client.newCall(request).execute();<br />
</syntaxhighlight><br />
</Tab><br />
<br />
<Tab name = "C#"><br />
'''Request'''<br />
<syntaxhighlight lang="c#"><br />
var client = new HttpClient();<br />
var request = new HttpRequestMessage(HttpMethod.Get, "https://localhost:4444/api/v1/BIVentaDetalle");<br />
request.Headers.Add("secretkey", "{{secret key}}");<br />
request.Headers.Add("Authorization", "Bearer{{token}}");<br />
var content = new StringContent("", null, "text/plain");<br />
request.Content = content;<br />
var response = await client.SendAsync(request);<br />
response.EnsureSuccessStatusCode();<br />
Console.WriteLine(await response.Content.ReadAsStringAsync());<br />
</syntaxhighlight><br />
</Tab><br />
<br />
<Tab name = "PHP"><br />
'''Request'''<br />
<syntaxhighlight lang="php"><br />
<?php<br />
require_once 'HTTP/Request2.php';<br />
$request = new HTTP_Request2();<br />
$request->setUrl('https://localhost:4444/api/v1/BICartera');<br />
$request->setMethod(HTTP_Request2::METHOD_GET);<br />
$request->setConfig(array(<br />
'follow_redirects' => TRUE<br />
));<br />
$request->setHeader(array(<br />
'secretkey' => '{{secret key}}',<br />
'Authorization' => 'Bearer {{token}}'<br />
));<br />
$request->setBody('');<br />
try {<br />
$response = $request->send();<br />
if ($response->getStatus() == 200) {<br />
echo $response->getBody();<br />
}<br />
else {<br />
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .<br />
$response->getReasonPhrase();<br />
}<br />
}<br />
catch(HTTP_Request2_Exception $e) {<br />
echo 'Error: ' . $e->getMessage();<br />
}<br />
</syntaxhighlight><br />
</Tab><br />
<br />
</Tabs><br />
<br />
[[Category:Documentación APIs]]<br />
<!-- [[Category:Pages with syntax highlighting errors]] --></div>
Lmedina