Referencia API

Referencia API

Documentación completa de todos los endpoints de la API de Sifende — schemas, ejemplos de código y referencia de errores.

URL base

https://api.sifende.com.py

Todos los endpoints usan el prefijo /api/v1/.

Spec OpenAPI

El contrato completo, generado desde el código de la API, está publicado en una URL estable:

https://sifende.com.py/openapi/v1.json

Sirve para validar requests antes de mandarlos y para generar clientes. Ver OpenAPI y JSON Schema.

Autenticación

Todas las llamadas a la API de integración requieren:

Authorization: Bearer {tu-api-key}

Ver Autenticación para más detalles.

Secciones

API de integración (API key)

La API principal para integraciones ERP:

Documentos Electrónicos — emitir, consultar, cancelar, inutilizar
Consultar el Padrón — validar un RUC o cédula en el padrón de la SET
Modelos de Datos — schemas de FE, NCE, NDE y entidades compartidas
Eventos SIFEN — cancelación e inutilización
API Keys — crear, rotar y revocar claves

Datos de referencia

Catálogos — enumeraciones SIFEN, geografía, actividades económicas

API de sesión (Keycloak JWT)

Para frontends personalizados sobre Sifende:

Endpoints de Sesión — contribuyentes, lotes, documentos, timbrado, usuarios

Referencia global

Autenticación
Convenciones — RUC, guaraníes, fechas, CDC
Errores — Problem Details, códigos SIFEN
Enumeraciones — todos los valores SIFEN válidos
OpenAPI y JSON Schema — spec generado desde el código, validación local y generación de clientes
Versionado
Changelog

Ir a Producción

Checklist completo para pasar tu integración de Sifende al ambiente de producción — credenciales, manejo de errores y pruebas finales.

Autenticación

Cómo autenticarte con la API de Sifende — API key para integraciones ERP y Keycloak JWT para frontends personalizados.

On this page

URL base Spec OpenAPI Autenticación Secciones API de integración (API key)Datos de referencia API de sesión (Keycloak JWT)Referencia global