Esta solicitud únicamente proporciona la información de la cuenta, incluyendo su nombre, tipo y idPlanCuenta
, necesaria para operar en otras peticiones. Si deseas obtener los saldos de cada cuenta en el árbol de contabilidad, es necesario realizar una solicitud de tipo leer_arbol_contabilidad
.
Validaciones:
Sesión válida: La sesión debe estar activa, lo cual implica que el usuario ha iniciado sesión en Colppy y es un usuario válido.
Permisos y existencia de la empresa: Es necesario que la empresa exista en el sistema y que el usuario cuente con los permisos correspondientes para operar sobre esa empresa.
Parámetros requeridos:
idEmpresa: un número entero que representa el identificador de la empresa sobre la cual se realizará la operación.
query: si se desea obtener el listado completo de las cuentas del diario (plan de cuentas completo), este parámetro debe estar vacío (
""
). Alternativamente, se puede especificar unidPlanCuenta
para obtener los datos de una cuenta específica.
Estos puntos deben cumplirse para proceder correctamente con la operación.
Petición JSON:
{
"auth": {
"usuario": "user@colppyAPI", // Ingresar el usuario dado de alta en dev.colppy.com
"password": "USUARIO_PASSWORD" //Contraseña en MD5 de usuario de dev.colppy.com
},
"service": {
"provision": "Contabilidad",
"operacion": "listar_cuentasdiario"
},
"parameters": {
"sesion": {
"usuario": "user@colppy.com",// Usuario de Colppy.
"claveSesion": "Clave Obtenida al iniciar Sesión en la API"
},
"idEmpresa": "9831",
"query": ""
}
}
Respuesta (éxito)
{
"service": {
"provision": "Contabilidad",
"operacion": "listar_cuentasdiario",
"version": "1_0_0_0",
"response_date": "2017-09-22 11:21:52"
},
"result": {
"estado": 0,
"mensaje": "La operación se realizó correctamente"
},
"response": {
"success": true,
"message": "La operación se realizó con éxito.",
"cuentas": [
{
{
"cuentas": [
{
"Id": "119",
"idPlanCuenta": "511100",
"Descripcion": "511100 - Costo de Mercaderia Vendida",
"idTipoCuenta": "17",
"tipoCuenta": "Costo de Venta"
}
]
}
// Continúa con las cuentas restantes en un formato similar...
]
}
}
Por cualquier duda o consulta podes ponerte en contacto con nosotros vía e-mail a: soporte@colppy.com