Reporte Auxiliar General [Beta]

Permite obtener una lista de elementos, donde cada elemento contiene la información de cada cuenta contable necesaria y suficiente para construir el informe contable Auxiliar General.

Endpoint: https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger

{{instancia}}: Hace referencia a la instancia de cada inmobiliaria.

Petición

Ejemplos de peticiones

https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger

https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger?fecha_ini=2025-01-01

https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger?fecha_ini=2025-01-01&fecha_fin=2025-04-15

https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger?fecha_ini=2025-01-01&fecha_fin=2025-04-15&cuenta_ini=1

https://{{instancia}}.arrendasoft.co/service/v2/public/accounting/general-ledger?fecha_ini=2025-01-01&fecha_fin=2025-04-15&cuenta_ini=1&cuenta_fin=2

Respuesta

Lista de elementos, donde cada elemento contiene la información de los datos obtenidos, error, mensaje, listado de las cuentas y detalles.

{
    "error": false,
    "message": "",
    "body": [
        {
            "cuenta": "11050502",
            "nombre_cuenta": "Caja generales MO",
            "saldo_anterior": 12118088.71,
            "debitos": 5664964,
            "creditos": 0,
            "saldo_actual": 17783052.71,
            "base_retencion": 0,
            "terceros": {
                "89": {
                    "documento_tercero": "11223344",
                    "nombre_tercero": "COOPERATIVA",
                    "saldo_anterior": -374086,
                    "debitos": 5664964,
                    "creditos": 0,
                    "saldo_actual": 5290878,
                    "base_retencion": 0,
                    "detalles": [
                        {
                            "fecha_documento": "2024-02-02",
                            "consecutivo_documento": "RC-20200",
                            "detalle_documento": "Pago en Consignación",
                            "debitos": 2323912,
                            "creditos": 0,
                            "base_retencion": 0
                        },
                        {
                            "fecha_documento": "2024-02-02",
                            "consecutivo_documento": "RC-20202",
                            "detalle_documento": "Pago",
                            "debitos": 3341052,
                            "creditos": 0,
                            "base_retencion": 0
                        }
                    ]
                }
            }
        }
    ]
}

Claves y Descripciones del JSON de Reporte Auxiliar General

Esta tabla enumera las claves presentes en el JSON principal de la respuesta y proporciona una breve descripción de cada una, explicando su propósito y el tipo de información que contienen.

Cuerpo

Cada elemento dentro de la lista body, tiene las siguientes claves:

PaginaciónTerceros

Cada elemento dentro de la lista paginationterceros tiene las siguientes claves:

Detalles

Cada elemento dentro de la lista detalles tiene las siguientes páginasclaves:

Ejemplos

curl -X GET "https://{{instancia}}.arrendasoft.co/service/v2/public/invoices/list?page_size=100accounting/general-ledger?fecha_ini=2024-01-01&page=3"fecha_fin=2024-02-28&cuenta_ini=1&cuenta_fin=2" -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_AUTHENTICATION_TOKEN"

<?php

$instance = 'your_instance'; // Reemplace con su instancia actual
$token = 'YOUR_AUTHENTICATION_TOKEN'; // Reemplace con el token obtenido desde el servicio de login

// Parámetros de ejemplo para listar facturasinformación del reporte contable auxiliar general
$pagefecha_ini = 1;'2024-01-01';
page_size$fecha_fin = 50;'2024-03-11';
$cuenta_ini = '1';
$cuenta_fin = '3';

$url = "https://{$instance}.arrendasoft.co/service/v2/public/invoices/list?accounting/general-ledger?";
$queryParams = [
    'page'fecha_ini' => $page,fecha_ini,
    'page_size'fecha_fin' => $page_sizefecha_fin,
    'cuenta_ini' => $cuenta_ini,
    'cuenta_fin' => $cuenta_fin
];
$url .= http_build_query($queryParams);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer ' . $token
]);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    echo "HTTP Status Code: " . $http_code . "\n";
    echo "Response: " . $response . "\n";
    
    // Procesar la respuesta
    $info = json_decode($response, true);
    $body = $info['body'] ?? [];
    if ($http_code == 200 && !empty($body)) {
        echo "Se consultaron " . count($body) . " facturas.cuentas.\n";
        
        // Ejemplo: Imprimir los números de las facturascuentas
        foreach($body as $invoice) {
          echo "FacturaCuenta número: " . $invoice['factura_numero'cuenta'] . "\n";
        }
    } else {
        echo "{$info['message']}.\n";
    }
}
curl_close($ch);

?>