https://www.wikiserpi.com/index.php?action=history&feed=atom&title=API_BI_Inventario_vs_Contabilidad
API BI Inventario vs Contabilidad - Historial de revisiones
2026-08-14T08:30:14Z
Historial de revisiones de esta página en la wiki
MediaWiki 1.43.0
https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1150&oldid=prev
Lmedina: /* Métodos */
2023-12-18T22:10:11Z
<p><span class="autocomment">Métodos</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 18:10 18 dic 2023</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l17">Línea 17:</td>
<td colspan="2" class="diff-lineno">Línea 17:</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><Tabs></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><Tabs></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><!-- ************************************************************** 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><!-- ************************************************************** GET ********************************************************************** --></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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><Tab name = "API Contabilidad Detalle (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><Tab name = "API Contabilidad Detalle (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;"><br></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;"><br></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l189">Línea 189:</td>
<td colspan="2" class="diff-lineno">Línea 188:</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><!-- ***************** GET Contabilidad****************** --></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><!-- ***************** GET Contabilidad****************** --></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><Tab name = "API Balance(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><Tab name = "API Balance(GET) "></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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>'''EndPoint:'''</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>'''EndPoint:'''</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>https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/Contabilidad</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>https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/Contabilidad</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l411">Línea 411:</td>
<td colspan="2" class="diff-lineno">Línea 408:</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><!-- ***************** GET Saldo Inventario****************** --></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><!-- ***************** GET Saldo Inventario****************** --></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><Tab name = "API Saldo Inventario(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><Tab name = "API Saldo Inventario(GET) "></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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>'''EndPoint:'''</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>'''EndPoint:'''</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>https://www.apis.serpi.com.co/api/v1/BIInventarioContabilidad/SaldoInventario</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>https://www.apis.serpi.com.co/api/v1/BIInventarioContabilidad/SaldoInventario</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l632">Línea 632:</td>
<td colspan="2" class="diff-lineno">Línea 627:</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><!-- ***************** GET Movimiento Inventario****************** --></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><!-- ***************** GET Movimiento Inventario****************** --></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><Tab name = "API Movimiento Inventario (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><Tab name = "API Movimiento Inventario (GET) "></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2" class="diff-side-added"></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>'''EndPoint:'''</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>'''EndPoint:'''</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>https://www.apis.serpi.com.co/api/v1/BIInventarioContabilidad/MovimientoInventario</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>https://www.apis.serpi.com.co/api/v1/BIInventarioContabilidad/MovimientoInventario</div></td></tr>
</table>
Lmedina
https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1149&oldid=prev
Lmedina: /* Métodos */
2023-12-18T22:09:08Z
<p><span class="autocomment">Métodos</span></p>
<a href="https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1149&oldid=1148">Mostrar los cambios</a>
Lmedina
https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1148&oldid=prev
Lmedina: /* Métodos */
2023-12-18T22:06:10Z
<p><span class="autocomment">Métodos</span></p>
<a href="https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1148&oldid=1147">Mostrar los cambios</a>
Lmedina
https://www.wikiserpi.com/index.php?title=API_BI_Inventario_vs_Contabilidad&diff=1147&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-18T22:00:32Z
<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 />
<br />
<Tab name = "API Contabilidad Detalle (GET) "><br />
<br />
'''EndPoint:'''<br />
<br />
https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/FlujoCaja<br />
<br />
'''EndPoint Con Parametros:'''<br />
https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/FlujoCaja?año=2020&esalterna=0<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 />
"descrip_sub": "OPERATIVO",<br />
"gdtempresaid1": 1,<br />
"descripcion": "NOMINA, APORTES Y LIQUIDACIONES",<br />
"gdtempresaid": 1,<br />
"cate_flujo": "USO",<br />
"gdtflujocajasubid": 1,<br />
"gdtempresaid2": 1,<br />
"numero": 4875,<br />
"fecha": "2021-01-06T00:00:00",<br />
"ano": 2021,<br />
"mes": 1,<br />
"periodo": "202101",<br />
"semana": 1,<br />
"debito": 0.00000,<br />
"credito": 36440973.00000,<br />
"movimiento": -36440973.00000,<br />
"gdtcuentaid": 2114,<br />
"gdtterceroid": 7345,<br />
"gdtcentrocostoid": null,<br />
"naturaleza": "C",<br />
"valor": 36440973.00000,<br />
"gdtflujocajaid": 4,<br />
"detalle_mov": "NÓMINA DAVIENDA",<br />
"gdttipodocid": 6,<br />
"categoria_doc": "CE",<br />
"prefjo": "CE",<br />
"nom_documento": "COMPROBANTE DE EGRESO",<br />
"nom_auxiliar": "DAVIVIENDA CTA CTE ",<br />
"clase": 1,<br />
"grupo": 11,<br />
"cuenta": 1110,<br />
"subcuenta": 111005,<br />
"auxiliar": 11100501,<br />
"nit": "901067734",<br />
"dv": 4,<br />
"nom_tercero": "DEMO2 - GIORGIO "<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 />
<br />
<!-- ***************** GET Contabilidad****************** --><br />
<Tab name = "API Balance(GET) "><br />
<br />
<br />
'''EndPoint:'''<br />
https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/Contabilidad<br />
<br />
'''EndPoint Con Parametros:'''<br />
https://www.apis.serpi.com.co/api/v1/BIFlujoCajaPeriodo/Contabilidad?grupo=11&año_desde=2019&año_hasta=2021<br />
<br />
''' Headers '''<br />
{| class="wikitable left"<br />
! Header !! Descripción <br />
|-<br />
| secretkey || Secretkey proporcionada al cliente para consumos de las APIs<br />
|}<br />
<br />
'''Authorization:'''<br />
<syntaxhighlight line="1"><br />
Usar Bearer. Ejemplo “bearer {{token}}”.<br />
{{token}} Token de autorizacion generado por SerpiERP<br />
</syntaxhighlight><br />
<br />
'''Request'''<br />
<syntaxhighlight lang="JSON"><br />
[<br />
{<br />
"tipoidentidad": "CC",<br />
"identificacion": "123456789",<br />
"dv": 0,<br />
"tipopersona": 2,<br />
"primernombre": "PEDRO",<br />
"segundonombre": "LUIS",<br />
"primerapellido": "PEREZ",<br />
"segundoapellido": "LOPEZ",<br />
"nombrecompleto": "PEDRO LUIS PEREZ LOPEZ",<br />
"razonsocial": null,<br />
"escliente": true,<br />
"esproveedor": true,<br />
"esempleado": false,<br />
"esvendedor": false,<br />
"esotro": false,<br />
"escobrador": false,<br />
"cumple_dia": 0,<br />
"cumplea_mes": 0,<br />
"cumplea_ano": 0,<br />
"genero": "N",<br />
"direccion": "CRA 1 25 05",<br />
"direccion2": null,<br />
"telefono": null,<br />
"ext": 0,<br />
"movil": null,<br />
"pais": "COLOMBIA",<br />
"departamento": "VALLE",<br />
"ciudad": "SANTIAGO DE CALI",<br />
"codciudad": "76001",<br />
"zona": 0,<br />
"email": "prueba@mail.com",<br />
"activo": true,<br />
"cupocredito": 0.00,<br />
"periodopago": 0,<br />
"codigociiu": null,<br />
"descuentoventa": 0,<br />
"categoriatercero": 1,<br />
"formapago": 0,<br />
"listaprecios": 2,<br />
"grupoventas": 1,<br />
"grupocompras": 2,<br />
"vendedor": 0,<br />
"cobrador": 0,<br />
"fechacreacion": "2020-01-04 10:16:30",<br />
"regimen": 2,<br />
"banco": 0,<br />
"tipo_cuenta": null,<br />
"cuenta_bancaria": null,<br />
"limite_credito": 0.00000,<br />
"camposcliente": {<br />
"ACTIVIDADECONOMICAMUNICIPAL": "BC44",<br />
"Comentarios": "Cliente proveedor de software",<br />
"Comuna": 11,<br />
"FechaAniversario": "2016-06-01",<br />
"ClienteNacional": true,<br />
"Ranking": "2",<br />
"TieneAsesor": "N",<br />
"Vetado": "3",<br />
"TipodeEmpresa": [<br />
"b",<br />
"c"<br />
],<br />
"continente": ""<br />
}<br />
<br />
}<br />
]<br />
<br />
</syntaxhighlight><br />
<br />
''' Campos del request'''<br />
{| class="wikitable"<br />
! Campo !! Tipo !! Requerido !! Descripción<br />
|-<br />
| tipoidentidad || String || SI || Código del tipo de identidad<br />
|-<br />
| identificacion || String || SI || Número de identificación<br />
|-<br />
| dv || Int || SI || Digito de verificación<br />
|-<br />
| tipopersona || Int || SI || Código del tipo de persona (1=JURIDICO, 2=NATURAL)<br />
|-<br />
| primernombre || String || SI (Si tipo persona=NATURAL) || Primer Nombre<br />
|-<br />
| segundonombre || String || NO || Segundo Nombre<br />
|-<br />
| primerapellido || String || SI (Si tipo persona=NATURAL) || Primer Apellido<br />
|-<br />
| segundoapellido || String || NO || Segundo Apellido<br />
|-<br />
| nombrecompleto || String || SI || Nombre Completo<br />
|-<br />
| razonsocial || String || SI (Si tipo persona=JURIDICO) || Razón Social<br />
|-<br />
| escliente || Bool || NO || Seleccionar si el tercero es cliente<br />
|-<br />
| esproveedor || Bool || NO || Seleccionar si el tercero es proveedor<br />
|-<br />
| esempleado || Bool || NO || Seleccionar si el tercero es empleado<br />
|-<br />
| esvendedor || Bool || NO || Seleccionar si el tercero es vendedor<br />
|-<br />
| esotro || Bool || NO || Seleccionar si el tercero es otro<br />
|-<br />
| escobrador || Bool || NO || Seleccionar si el tercero es cobrador<br />
|-<br />
| cumple_dia || Int || NO || Día del cumpleaños<br />
|-<br />
| cumplea_mes || Int || NO || Mes del cumpleaños<br />
|-<br />
| cumplea_ano || Int || NO || Año del cumpleaños<br />
|-<br />
| genero || String || NO || Género del tercero (M=Masculino, F=Femenino)<br />
|-<br />
| direccion || String || SI || Dirección<br />
|-<br />
| direccion2 || String || NO || Dirección complementaria<br />
|-<br />
| telefono || String || NO || Número de teléfono<br />
|-<br />
| ext || Int || NO || Número de extensión<br />
|-<br />
| movil || String || SI || Número de móvil celular<br />
|-<br />
| pais || String || Informativo || Nombre País<br />
|-<br />
| departamento || String || Informativo || Nombre del departamento<br />
|-<br />
| ciudad || String || Informativo || Nombre de la ciudad<br />
|-<br />
| codciudad || String || SI || Código único de la ciudad<br />
|-<br />
| zona || Int || NO || ID de la zona<br />
|-<br />
| email || String || SI || Cuenta de email<br />
|-<br />
| activo || Bool || SI || Estado del tercero (true=Activo, false=Inactivo)<br />
|-<br />
| cupocredito || Decimal || NO || Cupo de crédito<br />
|-<br />
| periodopago || Int || NO || Período de pago en días para el vencimiento de facturas de venta<br />
|-<br />
| codigociiu || String || NO || Código CIIU, Actividades económicas<br />
|-<br />
| descuentoventa || Decimal || NO || Porcentaje para el descuento en ventas<br />
|-<br />
| categoriatercero || Int || SI || ID de la categoría de terceros<br />
|-<br />
| formapago || Int || NO || ID de la forma de pago<br />
|-<br />
| listaprecios || Int || NO || ID de la lista de precios<br />
|-<br />
| grupoventas || Int || SI || ID del grupo de retenciones para ventas<br />
|-<br />
| grupocompras || Int || SI || ID del grupo de retenciones para compras<br />
|-<br />
| vendedor || Int || NO || Número de identificación del vendedor<br />
|-<br />
| cobrador || Int || NO || Número de identificación del cobrador<br />
|-<br />
| fechacreacion || String || NO || Fecha de creación del tercero. Ejemplo "2020-05-20 00:00:00"<br />
|-<br />
| regimen || Int || SI || ID del régimen tributario<br />
|-<br />
| banco || Int || NO || ID del banco<br />
|-<br />
| tipo_cuenta || String || NO || Tipo cuenta bancaria. (A=Cuenta de Ahorro, B=Cuenta Corriente)<br />
|-<br />
| cuenta_bancaria || String || NO || Número de cuenta bancaria<br />
|-<br />
| limite_credito || Decimal || NO || Límite del crédito<br />
|-<br />
| camposPersonalizados || Objeto || NO || Objeto con la información de campos personalizados<br />
|}<br />
<br />
<br />
'''Authorization:'''<br />
<syntaxhighlight line="1"><br />
Usar Bearer. Ejemplo “bearer {{token}}”.<br />
{{token}} Token de autorizacion generado por SerpiERP<br />
</syntaxhighlight><br />
<br />
'''Response'''<br />
<syntaxhighlight lang="JSON" line="1"><br />
{<br />
"success": true,<br />
"code": 201,<br />
"errors": [],<br />
"message": "Se crearon 10 de 10 terceros"<br />
}<br />
</syntaxhighlight><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/BIFlujoCajaPeriodo/FlujoCaja")<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/BIFlujoCajaPeriodo/FlujoCaja");<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/BIFlujoCajaPeriodo/FlujoCaja');<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