# Listar las pólizas de un mes

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

Las pólizas de diario del mes, con sus cuentas y código agrupador del SAT: una por cada CFDI de ingreso o egreso vigente, emitido o recibido (los recibidos con la categoría de su gasto); una por cada pago de un complemento; una por cada recibo de nómina, y una con la depreciación de los activos fijos. Un PUE se registra cobrado o pagado según su forma de pago. En pesos; un CFDI en otra moneda sin tipo de cambio no se registra. No incluye movimientos de banco sin CFDI ni provisiones.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `month` | consulta | sí | El mes (AAAA-MM). |
| `limit` | consulta |  | Cuántas por página, de 1 a 1,000. Por omisión 100. |
| `starting_after` | consulta |  | El id de la última póliza de la página anterior. |
| `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();

for await (const item of fiscalisto.accounting.journalEntries({ month: "2026-10" })) {
  console.log(item.id);
}
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

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

for item in fiscalisto.accounting.journal_entries({"month": "2026-10"}):
    print(item["id"])
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

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

foreach ($fiscalisto->accounting->journalEntries(['month' => '2026-10']) as $item) {
    echo $item['id'], "\n";
}
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

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

await foreach (var item in fiscalisto.Accounting.JournalEntriesAutoPagingAsync(new ListJournalEntriesParams { Month = "2026-10" }))
    Console.WriteLine(item.Id);
```

## 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()

	for item, err := range client.Accounting.JournalEntriesAutoPaging(ctx, &fiscalisto.ListJournalEntriesParams{Month: "2026-10"}) {
		if err != nil {
			log.Fatal(err)
		}
		fmt.Println(item.ID)
	}
}
```

## Con el SDK de Java

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

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

for (var item : fiscalisto.accounting().journalEntriesAutoPaging(new ListJournalEntriesParams().setMonth("2026-10"))) {
    System.out.println(item.getId());
}
```

## Respuesta 200

Correcto.

Un objeto `JournalEntryList`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"list"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data` | arreglo de objeto | sí | Los objetos de esta página. |
| `data[].id` | string | sí | El número de la póliza: D-AAAAMM-NNNNN, en orden de fecha dentro del mes. |
| `data[].livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `data[].object` | `"journal_entry"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data[].issuer` | string | sí | El emisor. |
| `data[].type` | `invoice`, `payment_received`, `payment_made`, `payroll`, `depreciation` | sí | De qué es: invoice (un CFDI de ingreso o egreso), payment_received o payment_made (un pago de un complemento), payroll (un recibo de nómina) o depreciation (la depreciación del mes de los activos fijos). |
| `data[].date` | string | sí | La fecha del CFDI o del pago; en la depreciación, el último día del mes. |
| `data[].description` | string | sí | El documento, su folio y la contraparte. |
| `data[].invoice` | string o null | sí | La factura (inv_…) si es la póliza de un CFDI que timbró este emisor; null en los demás casos. |
| `data[].uuid` | string o null | sí | El folio fiscal del CFDI (o del complemento de pago); null en la depreciación. |
| `data[].tax_id` | string o null | sí | El RFC de la contraparte (cliente, proveedor o empleado); null en la depreciación. |
| `data[].total` | number | sí | El total del documento, en su moneda. |
| `data[].currency` | string | sí | La moneda del documento. |
| `data[].exchange_rate` | number o null | sí | El tipo de cambio, si no es en pesos; null si es en pesos. |
| `data[].lines` | arreglo de objeto | sí | Los movimientos, en pesos: el cargo (debit) o abono (credit) a cada cuenta. |
| `data[].lines[].account` | string | sí | El número de cuenta. |
| `data[].lines[].account_name` | string | sí | El nombre de la cuenta. |
| `data[].lines[].grouping_code` | string | sí | Su código agrupador del SAT. |
| `data[].lines[].debit` | number | sí | El cargo, en pesos. |
| `data[].lines[].credit` | number | sí | El abono, en pesos. |
| `has_more` | boolean | sí | true si hay más: pida la siguiente con starting_after igual al id del último. |
| `url` | string | sí | La ruta de esta lista. |

```json
{
  "object": "list",
  "data": [
    {
      "id": "D-202610-00001",
      "object": "journal_entry",
      "livemode": false,
      "issuer": "iss_OufpKqnrvx9p",
      "type": "invoice",
      "date": "2026-10-02",
      "description": "Factura A1042 INMOBILIARIA CVA",
      "invoice": "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN",
      "uuid": "5F3C1B2A-9D8E-4F7A-B6C5-1D2E3F4A5B6C",
      "tax_id": "ICV060329BY0",
      "total": 5800,
      "currency": "MXN",
      "exchange_rate": null,
      "lines": [
        {
          "account": "105-01",
          "account_name": "Clientes nacionales",
          "grouping_code": "105.01",
          "debit": 5800,
          "credit": 0
        },
        {
          "account": "401-01",
          "account_name": "Ventas y/o servicios gravados a la tasa general",
          "grouping_code": "401.01",
          "debit": 0,
          "credit": 5000
        },
        {
          "account": "208-01",
          "account_name": "IVA trasladado cobrado",
          "grouping_code": "208.01",
          "debit": 0,
          "credit": 800
        }
      ]
    }
  ],
  "has_more": false,
  "url": "/v1/accounting/journal_entries"
}
```

## 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.
