Referencia API

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 solicitudes antes de mandarlas 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:

• Explorador de la API — todos los endpoints con schemas, ejemplos y playground
• 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, AFE, NCE, NDE, NRE y entidades compartidas
• Eventos SIFEN — cancelación, inutilización y nominación
• Webhooks — eventos, firma y administración por API

Datos de referencia

• Catálogo de enumeraciones — valores aceptados por la API
• Geografía — códigos de departamentos, distritos y ciudades

Panel

• Guías del panel — configuración y acceso del equipo
• API keys — crear, rotar y eliminar claves

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