# Ver la DIOT de un mes

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

Lo efectivamente pagado a cada proveedor en el mes (facturas PUE y complementos de pago recibidos), con sus notas de crédito como devoluciones, por tipo de operación. Sale de las facturas recibidas que trajo de las descargas del SAT. Desde enero de 2025 (formato 2025).

## 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 diot = await fiscalisto.accounting.diot({ month: "2026-10" });
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

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

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

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

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

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

## Con el SDK de .NET

```csharp
using Fiscalisto;

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

var diot = await fiscalisto.Accounting.DiotAsync(new GetDiotParams { 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()

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

## Con el SDK de Java

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

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

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

## Respuesta 200

Correcto.

Un objeto `Diot`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"diot"` | 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). |
| `proportion` | number | sí | La proporción de IVA acreditable del mes para gastos comunes (1 si no la aplica). |
| `lines` | arreglo de objeto | sí | Una línea por proveedor y tipo de operación, con lo pagado en el mes. |
| `lines[].tax_id` | string | sí | RFC (Rfc), 12 caracteres una persona moral y 13 una física. |
| `lines[].name` | string o null | sí | Nombre. |
| `lines[].third_party_type` | `15`, `04`, `05` | sí | Tipo de tercero: 04 nacional, 05 extranjero, 15 global. |
| `lines[].operation_type` | `85`, `87`, `02`, `03`, `06`, `07` | sí | Tipo de operación: 02 enajenación de bienes, 03 servicios profesionales, 06 uso o goce temporal, 07 importación, 85 otros, 87 operaciones globales. |
| `lines[].paid` | objeto | sí | Lo pagado en el mes por tasa, en pesos, con su IVA. |
| `lines[].paid.base_16` | number | sí | Valor de los actos al 16 %. |
| `lines[].paid.base_8` | number | sí | Valor de los actos al 8 % (región fronteriza). |
| `lines[].paid.base_0` | number | sí | Valor de los actos al 0 %. |
| `lines[].paid.exempt` | number | sí | Valor de los actos exentos. |
| `lines[].paid.not_taxable` | number | sí | Valor de los actos no objeto de IVA. |
| `lines[].paid.vat` | number | sí | El IVA de esos actos. |
| `lines[].returns` | objeto | sí | Las devoluciones (notas de crédito) del mes, por tasa. |
| `lines[].returns.base_16` | number | sí | Valor de los actos al 16 %. |
| `lines[].returns.base_8` | number | sí | Valor de los actos al 8 % (región fronteriza). |
| `lines[].returns.base_0` | number | sí | Valor de los actos al 0 %. |
| `lines[].returns.exempt` | number | sí | Valor de las devoluciones exentas. |
| `lines[].returns.not_taxable` | number | sí | Valor de los actos no objeto de IVA. |
| `lines[].returns.vat` | number | sí | El IVA de esos actos. |
| `lines[].blacklisted` | boolean | sí | El proveedor está en la lista 69-B definitiva: revise si deduce sus CFDI. |
| `warnings` | arreglo de string | sí | Lo que conviene revisar antes de presentarla. |

```json
{
  "object": "diot",
  "livemode": false,
  "issuer": "iss_OufpKqnrvx9p",
  "month": "2026-09",
  "proportion": 1,
  "lines": [
    {
      "tax_id": "CACX7605101P8",
      "name": "XOCHILT CASAS CHAVEZ",
      "third_party_type": "04",
      "operation_type": "03",
      "paid": {
        "base_16": 12000,
        "base_8": 0,
        "base_0": 0,
        "exempt": 0,
        "not_taxable": 0,
        "vat": 1920
      },
      "returns": {
        "base_16": 0,
        "base_8": 0,
        "base_0": 0,
        "exempt": 0,
        "not_taxable": 0,
        "vat": 0
      },
      "blacklisted": false
    }
  ],
  "warnings": []
}
```

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