Sifende
Referencia API

Changelog

Historial de cambios de la API de Sifende — nuevas funcionalidades, correcciones y breaking changes.

Actualizado el

2026-11-13

Nuevo

  • API integradora: los socios integradores dan de alta y configuran a sus clientes desde su propio sistema con una key ik_… creada en el portal de socios. Cubre alta con o sin titular, plan y pagador, certificado, establecimientos, personalización, webhooks y API keys de cada cliente. Ver la guía de alta por API. Los endpoints están en el spec OpenAPI y en el explorador de la API, con el esquema de seguridad integradorKey.

2026-11-09

Nuevo

  • DELETE /api/v1/contribuyente/api-key revoca la API key con la que se hace el pedido, para que una integración se dé de baja sin entrar al panel. Responde 204; después la clave responde 401.

Cambios

  • Revocar la propia clave y eliminar un webhook ya no responden 403 plan-operation-not-allowed cuando el plan dejó de incluir la API de integración.

2026-10-27

Nuevo

  • El contribuyente elige cuándo se envía el documento por correo al receptor desde Editar contribuyente → Configuración: al emitir (por defecto), cuando la SIFEN lo aprueba, o nunca, para enviarlo desde tu propio sistema con el KuDE y el XML descargados por API. El email del receptor sigue siempre en el XML.

2026-10-24

Cambios

  • SANDBOX ya no exige un certificado activo: si el contribuyente todavía no cargó el suyo, Sifende firma con uno de prueba. En SANDBOX, GET /api/v1/contribuyente devuelve listoParaEmitir: true sin certificado, con certificadoConfigurado: false. Los correos de documentos SANDBOX salen marcados como prueba.

2026-10-20

Nuevo

  • POST /api/v1/documento-electronico acepta numeroDocumento, codigoSeguridad y numeroTimbrado para sistemas que numeran por su cuenta, como un ERP. Un número repetido devuelve 409 document-number-in-use con el cdc del documento existente; uno inutilizado, 409 document-number-voided; un timbrado distinto, 422 timbrado-mismatch. Un número cuyo documento fue rechazado devuelve 422 document-number-requires-voiding: se inutiliza y se emite con otro número. Ver Numeración desde tu sistema.
  • GET /api/v1/documento-electronico/{cdc}/xml descarga el XML firmado del documento, con el QR, usando la API key. Responde 404 si el documento no es del contribuyente y ambiente de la clave, y 409 si todavía no tiene XML.
  • Administrar webhooks por API: /api/v1/contribuyente/webhooks permite listar, crear, consultar, actualizar y eliminar webhooks, rotar su secreto y consultar sus entregas con la API key, sin entrar al panel. El ambiente sale de la clave: una clave sólo ve los webhooks de su ambiente. El secreto whsec_… se devuelve únicamente al crear y al rotar. Crear y rotar rechazan Idempotency-Key con 400 idempotency-not-supported.

2026-10-10

Nuevo

  • GET /api/v1/contribuyente devuelve los datos del contribuyente asociado a la API key: RUC, razón social, dirección, actividades económicas, timbrado del ambiente de la clave, establecimientos y logo, con un estadoConfiguracion que indica si la emisión va a pasar los controles de configuración.
  • GET /api/v1/contribuyente/plan-consumo es la nueva ruta de la consulta de plan y consumo, con la misma respuesta.

Deprecado

  • GET /api/v1/documento-electronico/plan-consumo sigue respondiendo igual hasta el 2027-01-15, cuando se remueve. Sus respuestas incluyen los headers Deprecation, Sunset y Link con la ruta nueva. Cambiá la URL a /api/v1/contribuyente/plan-consumo; la autenticación y la respuesta no cambian.

2026-10-05

Comportamiento

  • Una Idempotency-Key ya registrada devuelve la operación original aunque cambien el body o el CDC. Antes respondía 422 idempotency-key-reused; ahora ese error sólo aparece si usás la clave para otro tipo de operación. Si reutilizás una clave por error, recibís la operación anterior en lugar de un error.
  • El replay y la recuperación de eventos pendientes funcionan aunque el documento esté archivado.
  • La clave sigue reservada después de los 7 días de replay, hasta que termina la conservación del documento.

2026-10-03

Nuevo

  • Autofactura Electrónica disponible para compras a personas locales no contribuyentes, en guaraníes y al contado, con consulta de estado y KuDE.
  • GET /api/v1/geografia/departamentos/{departamentoId}/ciudades lista las ciudades del departamento sin elegir un distrito. En AFE, el distrito es opcional en el domicilio del vendedor y en el lugar de la operación.
  • GET /api/v1/public/enums incluye tipoConstancia.

2026-10-02

Nuevo

  • Cada API key pertenece a un ambiente fijo. Las claves nuevas usan sk_sandbox_ para Sandbox de Sifende, sk_test_ para pruebas con SIFEN y sk_live_ para producción, con la misma URL base. Las claves anteriores conservan su ambiente aunque su prefijo no coincida; verificalo en el panel.
  • Timbrado y CSC configurables para DEV y PROD desde el panel. SANDBOX proporciona sus valores de prueba; el certificado activo sirve para los tres ambientes.
  • Sandbox de Sifende permite probar emisión y notificaciones sin enviar documentos a SIFEN; su KuDE indica que no tiene validez fiscal.
  • Filtro de ambiente en los documentos del panel: Desarrollo, Producción y Sandbox.
  • Webhooks por ambiente, con hasta cinco endpoints activos por contribuyente y ambiente. Las notificaciones nuevas incluyen ambiente en la raíz y mantienen version: "1".
  • Las respuestas de emisión y consulta de estado incluyen ambiente: DEV, PROD o SANDBOX. Este valor permanece asociado al documento.
  • sandbox-operation-not-supported: respuesta 422 al intentar cancelar, inutilizar o nominar en SANDBOX.
  • Nota de Remisión Electrónica disponible, con consulta de estado y KuDE.

Documentación

  • Se documentan las facturas a crédito en PYG por PLAZO o CUOTA.
  • Se documenta la personalización del correo, con logo, nombre comercial, colores, datos de contacto y correo de prueba.

Si ya usás webhooks

Los endpoints existentes quedan asignados al ambiente que tenía el contribuyente al aplicar este cambio. Revisá el ambiente que muestra cada endpoint en Webhooks. Para recibir eventos de otro ambiente, creá otro endpoint y guardá su secreto. Las entregas anteriores conservan su payload y destinatario originales: pueden no incluir ambiente y corresponder a otro ambiente, incluso en un reintento. La firma y los reintentos se mantienen.

2026-09-08

Nuevo

  • GET /api/v1/padron/{documento} consulta un RUC o cédula y devuelve razón social, estado, tipo de contribuyente y domicilio fiscal con los códigos geográficos de SIFEN
  • Los nombres de campo y las enumeraciones son los del receptor del documento electrónico (tipoContribuyente, tipoContribuyenteReceptor, tipoDocumento, numeroDocumento, digitoVerificador, nombreRazonSocial), y estadoRuc trae el código SET del estado
  • Acepta el documento con o sin puntos y con o sin dígito verificador; una cédula que no es RUC responde con tipoContribuyente: NO_CONTRIBUYENTE y tipoDocumento: CEDULA_PARAGUAYA
  • domicilio y email pueden venir en null cuando el padrón no los tiene
  • Límite de 60 consultas por minuto por API key y 120 por contribuyente, con 429 rate-limit-exceeded y Retry-After; la consulta es de sólo lectura y no consume el plan de consumo

2026-08-18

Nuevo

  • GET /api/v1/documento-electronico/plan-consumo consulta el plan, el ciclo, el cupo, las reservas y el costo adicional estimado del contribuyente asociado a la API key
  • Idempotency-Key opcional en emisión, cancelación e inutilización, con namespace único por contribuyente y replay exacto durante 7 días
  • Retries dirigidos por el cliente con la misma clave ante conexión sin respuesta, 409 idempotency-in-progress o 503 idempotency-upstream-unknown

Comportamiento

  • Una clave cuyo replay venció queda reservada permanentemente y devuelve 409 idempotency-key-expired; no puede reutilizarse
  • En cancelación, SIFEN 4003 se acepta como éxito equivalente; el protocolo puede ser null
  • En inutilización, SIFEN 4066 deja el evento INDETERMINADA y devuelve el terminal 409 idempotency-outcome-unknown

2026-08-13

Nuevo

  • Webhooks salientes por contribuyente para documento.aprobado, documento.rechazado, documento.cancelado y lote.procesado
  • Firma verificable, entregas con reintentos e historial de 90 días
  • Panel para administrar endpoints, rotar secretos y consultar intentos de entrega

2026-08-10

Nuevo

  • GET /api/v1/public/enums expone la categoría tipoContribuyenteReceptor (PERSONA_FISICA / PERSONA_JURIDICA), obligatoria para receptores contribuyentes. El endpoint pasa de 18 a 19 categorías

2026-04-15

Nuevo

  • Notas de Débito Electrónicas (NDE) mediante POST /api/v1/documento-electronico con tipoDocumento: "NOTA_DE_DEBITO_ELECTRONICA"
  • Soporte para receptor B2B en Facturas Electrónicas

Corrección

  • Corrección del cálculo de IVA incluido en el precio de los ítems gravados

2026-03-01

Nuevo

  • Soporte para Notas de Crédito Electrónicas (NCE)

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