Explorador de la API
Todos los endpoints de la API de integración de Sifende, con schemas, ejemplos en cURL, JavaScript, Python y Java, y un playground para probar con tu API key.
Cada endpoint tiene su página, generada desde el spec OpenAPI: parámetros, schemas de solicitud y respuesta, errores posibles y ejemplos listos para copiar. La URL base es https://api.sifende.com.py y todas las rutas usan el prefijo /api/v1/; la autenticación se explica en Autenticación.
- postEmitir un documento electrónicoRegistra el documento y lo encola para SIFEN.
- getConsultar el estado de un documentoEstados terminales: APROBADO, APROBADO_OBSERVACION, RECHAZADO y ERROR.
- getDescargar el KuDE en PDFDescarga el KuDE en PDF de un documento.
- postCancelar un documentoEnvía a SIFEN el evento de cancelación.
- postInutilizar un rango de numeraciónInforma a SIFEN que un rango de números de un timbrado no se va a usar.
- putActualizar un webhookReemplaza la URL, los eventos y el estado del webhook; el ambiente no cambia.
- getConsultar un webhookDevuelve un webhook del ambiente de la API key, sin el secreto.
- postCrear un webhookRegistra una URL para recibir eventos en el ambiente de la API key; el ambiente no se envía en el body.
- getDescargar el KuDE en cinta de papel como imagen para ESC/POSDevuelve el ticket como PNG de 1 bit con el ancho exacto de una línea de la impresora a 203 dpi: 576 o 512 puntos para papel de 80 mm, 384 para 58 mm.
- getDescargar el KuDE en cinta de papel (PDF)Genera el KuDE en formato cinta de papel para impresoras térmicas de 80 o 58 mm (Manual Técnico V150, cap.
- getDescargar el XML firmado de un documentoDescarga el XML firmado tal como se envió a SIFEN, con el código QR incluido.
- deleteEliminar un webhookElimina el webhook y cancela sus entregas pendientes.
- getListar las entregas de un webhookDevuelve, paginado y con las más recientes primero, el historial de entregas del webhook: estado, cantidad de intentos y último error.
- getListar webhooksDevuelve los webhooks del contribuyente en el ambiente de la API key, los más recientes primero.
- postNominar el receptor de una factura innominadaIdentifica al receptor de una factura innominada aprobada mediante un evento de nominación ante SIFEN.
- deleteRevocar la API keyElimina la API key con la que se hace este pedido; desde ese momento responde 401.
- postRotar el secreto de un webhookGenera un secreto nuevo y deja de firmar con el anterior, también las entregas pendientes.
- getListar eventos del contribuyenteDevuelve, paginados, los eventos de cancelación, inutilización y nominación del contribuyente de la API key.
- getConsultar un evento por su idDevuelve el detalle de un evento de cancelación, inutilización o nominación del contribuyente de la API key.
- getConsultar el contribuyente emisorDevuelve los datos del contribuyente identificado por la API key, tal como se usan al emitir en el ambiente de la clave: datos fiscales, dirección…
- getConsultar plan y consumoDevuelve el ciclo y consumo del contribuyente identificado por la API key.
- getConsultar plan y consumo (ruta deprecada)Ruta anterior de GET /api/v1/contribuyente/plan-consumo, con la misma respuesta.
- getConsultar un RUC o cédula en el padrónDevuelve razón social, estado, tipo de contribuyente y domicilio fiscal con los códigos geográficos de SIFEN, listos para completar el receptor de un…
- getListar todas las enumeraciones de SIFENCatálogo completo de valores válidos, con su código SIFEN y su descripción.
- getListar departamentosDevuelve los departamentos de Paraguay con el código que SIFEN espera en el domicilio del receptor.
- getListar distritos de un departamentoDevuelve los distritos de un departamento con el código que SIFEN espera en el domicilio del receptor.
- getListar ciudades de un distritoDevuelve las ciudades de un distrito con el código que SIFEN espera en el domicilio del receptor.
- getListar ciudades de un departamentoDevuelve todas las ciudades de un departamento con el código que SIFEN espera en el domicilio del receptor.
Para ver los endpoints agrupados por tema, con guías y casos de uso, entrá a la Referencia API. Para ver los campos de cada tipo de documento, consultá los modelos de datos.