Sifende
Guías

Autofactura

Emití una autofactura electrónica por una compra a una persona no contribuyente y descargá su KuDE.

Actualizado el

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, que corresponde al grupo E4 (campos E300 a E399) del Manual Técnico V150.

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.

{
  "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

RespuestaQué revisar
400 en vendedor.numeroDocumentoRevisá 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-disponibleNo se pudo consultar el padrón. Reintentá más tarde con la misma Idempotency-Key
400 en ciudad o codigoDistritoLa ciudad no pertenece al departamento, o el código es ambiguo: informá codigoDistrito
400 en condicionPago.montoPagoEl pago no coincide con el total. Sifende redondea el total al múltiplo inferior de 50 guaraníes
400 en receptor, monedaOperacion o condicionOperacionLa AFE no admite receptor y sólo admite PYG y CONTADO
400 invalid-formatLa solicitud incluye un campo que la AFE no admite
403 plan-operation-not-allowedLa modalidad packs no permite emitir por API

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

En esta página

Usamos cookies necesarias para que el sitio funcione. Con tu permiso, también usamos herramientas de analítica para entender cómo se usa el sitio y para medir nuestras campañas publicitarias. Política de privacidad