# Ver la balanza de comprobación

`GET https://api.fiscalisto.com/v1/accounting/trial_balance`

Saldo inicial, cargos, abonos y saldo final de cada cuenta en el mes. Los saldos iniciales se acumulan desde el primer CFDI, o desde los saldos iniciales capturados en la app (las de resultados, desde enero), y los resultados de cada año anterior se cierran a capital.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `month` | consulta | sí | El mes (AAAA-MM). |
| `issuer` | consulta |  | El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. |

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

const trialBalance = await fiscalisto.accounting.trialBalance({ month: "2026-10" });
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

trial_balance = fiscalisto.accounting.trial_balance({"month": "2026-10"})
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

$trialBalance = $fiscalisto->accounting->trialBalance(['month' => '2026-10']);
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var trialBalance = await fiscalisto.Accounting.TrialBalanceAsync(new GetTrialBalanceParams { Month = "2026-10" });
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	trialBalance, err := client.Accounting.TrialBalance(ctx, &fiscalisto.GetTrialBalanceParams{Month: "2026-10"})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", *trialBalance)
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;
import com.fiscalisto.model.GetTrialBalanceParams;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

var trialBalance = fiscalisto.accounting().trialBalance(new GetTrialBalanceParams().setMonth("2026-10"));
System.out.println(trialBalance);
```

## Respuesta 200

Correcto.

Un objeto `TrialBalance`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"trial_balance"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `issuer` | string | sí | El emisor. |
| `month` | string | sí | El mes (AAAA-MM). |
| `journal_entries` | integer | sí | Cuántas pólizas tuvo el mes. (de -9007199254740991 a 9007199254740991) |
| `accounts` | arreglo de objeto | sí | Cada cuenta con movimiento o saldo: saldo inicial, cargos, abonos y saldo final. |
| `accounts[].object` | `"ledger_account"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `accounts[].number` | string | sí | Número de empleado (NumEmpleado). |
| `accounts[].name` | string | sí | Nombre. |
| `accounts[].grouping_code` | string | sí | El código agrupador del SAT. |
| `accounts[].nature` | `debit`, `credit` | sí | debit (deudora) o credit (acreedora). |
| `accounts[].opening_balance` | number | sí | El saldo al empezar el mes. |
| `accounts[].debit` | number | sí | Los cargos del mes. |
| `accounts[].credit` | number | sí | Los abonos del mes. |
| `accounts[].closing_balance` | number | sí | El saldo al terminar el mes. |
| `totals` | objeto | sí | Cargos y abonos del mes: siempre iguales. |
| `totals.debit` | number | sí | Todos los cargos del mes. |
| `totals.credit` | number | sí | Todos los abonos del mes. |

```json
{
  "object": "trial_balance",
  "livemode": false,
  "issuer": "iss_OufpKqnrvx9p",
  "month": "2026-10",
  "journal_entries": 1,
  "accounts": [
    {
      "object": "ledger_account",
      "number": "105-01",
      "name": "Clientes nacionales",
      "grouping_code": "105.01",
      "nature": "debit",
      "opening_balance": 0,
      "debit": 5800,
      "credit": 0,
      "closing_balance": 5800
    },
    {
      "object": "ledger_account",
      "number": "208-01",
      "name": "IVA trasladado cobrado",
      "grouping_code": "208.01",
      "nature": "credit",
      "opening_balance": 0,
      "debit": 0,
      "credit": 800,
      "closing_balance": 800
    },
    {
      "object": "ledger_account",
      "number": "401-01",
      "name": "Ventas y/o servicios gravados a la tasa general",
      "grouping_code": "401.01",
      "nature": "credit",
      "opening_balance": 0,
      "debit": 0,
      "credit": 5000,
      "closing_balance": 5000
    }
  ],
  "totals": {
    "debit": 5800,
    "credit": 5800
  }
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.
