# Autofactura (/docs/guias/autofactura)



Usá una &#x2A;*Autofactura Electrónica (AFE)** cuando tu empresa compra un bien o contrata un servicio a una persona local que no es contribuyente, por ejemplo un productor que vende su cosecha. Quien emite la AFE es el comprador.

La AFE no lleva `receptor`: Sifende completa el comprador con los datos de tu contribuyente. Los datos de quien vende van en `vendedor`, que corresponde al grupo E4 (campos E300 a E399) del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica).

## Paso 1: Prepará la solicitud [#paso-1-prepará-la-solicitud]

Este ejemplo registra la compra de 200 kg de mandioca a un productor de Caaguazú, pagada en efectivo. Reemplazá las identidades, las fechas, las direcciones y los importes por los de tu operación y guardalo como `autofactura.json`.

```json
{
  "tipoDocumento": "AUTOFACTURA_ELECTRONICA",
  "fechaEmision": "2026-10-03T09:30:00",
  "numeroEstablecimiento": 1,
  "puntoExpedicion": 1,
  "tipoTransaccion": "COMPRA_PRODUCTOS",
  "vendedor": {
    "naturaleza": "NO_CONTRIBUYENTE",
    "tipoDocumento": "CEDULA_PARAGUAYA",
    "numeroDocumento": "3456789",
    "nombre": "Ramón Benítez",
    "numeroCasa": 0,
    "domicilio": {
      "direccion": "Compañía Yhovy, camino vecinal",
      "departamento": "6",
      "ciudad": "2988"
    }
  },
  "lugarOperacion": {
    "direccion": "Compañía Yhovy, camino vecinal",
    "departamento": "6",
    "ciudad": "2988"
  },
  "constancia": {
    "tipo": "CONSTANCIA_NO_CONTRIBUYENTE"
  },
  "items": [
    {
      "codigo": "MAN-001",
      "descripcion": "Mandioca fresca",
      "cantidad": 200,
      "unidadMedida": "kg",
      "precioUnitario": 2500
    }
  ],
  "condicionPago": {
    "tipo": "CONTADO",
    "tipoPago": "EFECTIVO",
    "monedaPago": "PYG",
    "montoPago": 500000
  }
}
```

`departamento` y `ciudad` llevan códigos SIFEN, no nombres. Buscalos en el [catálogo de geografía](/docs/referencia/catalogos/geografia). Consultá el [modelo de autofactura](/docs/referencia/modelos/autofactura) para todos los campos y sus límites.

## Paso 2: Enviá la autofactura [#paso-2-enviá-la-autofactura]

```bash
curl -X POST https://api.sifende.com.py/api/v1/documento-electronico \
  -H "Authorization: Bearer $SIFENDE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: compra-mandioca-0001" \
  --data-binary @autofactura.json
```

Antes de aceptar la solicitud, Sifende verifica en el padrón que el vendedor no tenga un RUC vigente. La API responde `202 Accepted` con el CDC y las URLs de seguimiento. Para recuperar una respuesta perdida, repetí la solicitud con la misma `Idempotency-Key` y el mismo contenido; ver la [guía de idempotencia](/docs/guias/idempotencia).

## Paso 3: Esperá la aprobación y descargá el KuDE [#paso-3-esperá-la-aprobación-y-descargá-el-kude]

[Consultá el estado](/docs/guias/consultar-estado) hasta obtener `APROBADO` o `APROBADO_OBSERVACION`. Después, [descargá el KuDE](/docs/guias/descargar-kude) como comprobante de la compra.

Si queda `RECHAZADO`, revisá el motivo y corregí los datos antes de emitir otra autofactura. Si queda `ERROR` o sigue en `EN_LOTE` después de varias horas, revisá el [lote en el panel](/docs/panel/lotes) y continuá el seguimiento con el mismo CDC.

## Errores frecuentes [#errores-frecuentes]

| Respuesta                                                     | Qué revisar                                                                                                                            |
| ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `400` en `vendedor.numeroDocumento`                           | Revisá que la cédula tenga de 5 a 12 dígitos, sin puntos, espacios ni guiones. La AFE sólo admite personas sin RUC o con RUC cancelado |
| `502 padron-no-disponible`                                    | No se pudo consultar el padrón. Reintentá más tarde con la misma `Idempotency-Key`                                                     |
| `400` en `ciudad` o `codigoDistrito`                          | La ciudad no pertenece al departamento, o el código es ambiguo: informá `codigoDistrito`                                               |
| `400` en `condicionPago.montoPago`                            | El pago no coincide con el total. Sifende redondea el total al múltiplo inferior de 50 guaraníes                                       |
| `400` en `receptor`, `monedaOperacion` o `condicionOperacion` | La AFE no admite receptor y sólo admite `PYG` y `CONTADO`                                                                              |
| `400 invalid-format`                                          | La solicitud incluye un campo que la AFE no admite                                                                                     |
| `403 plan-operation-not-allowed`                              | La modalidad packs no permite emitir por API                                                                                           |

Las demás respuestas de error están en la [referencia de errores](/docs/referencia/errores).
