Autofactura

Usá una 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.

Paso 1: Armá 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.

{
  "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. Consultá el modelo de autofactura para todos los campos y sus límites.

Paso 2: Enviá la autofactura

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.

Paso 3: Esperá la aprobación y descargá el KuDE

Consultá el estado hasta obtener APROBADO o APROBADO_OBSERVACION. Después, descargá el 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 y continuá el seguimiento con el mismo CDC.

Errores frecuentes

Las demás respuestas de error están en la referencia de errores.