Documentos Electrónicos
API de emisión, consulta y gestión de documentos electrónicos — el núcleo de la integración con Sifende.
Endpoint único y polimórfico
Diseño importante: Sifende usa un solo endpoint para todos los tipos de documento electrónico. El campo tipoDocumento en el body determina qué tipo emitís. No hay endpoints separados para facturas, notas de crédito, etc.
POST /api/v1/documento-electronicotipoDocumento | Tipo de documento | Estado |
|---|---|---|
FACTURA_ELECTRONICA | Factura Electrónica (FE) | ✅ Disponible |
NOTA_DE_CREDITO_ELECTRONICA | Nota de Crédito (NCE) | ✅ Disponible |
NOTA_DE_DEBITO_ELECTRONICA | Nota de Débito (NDE) | ✅ Disponible |
AUTOFACTURA_ELECTRONICA | Autofactura (AFE) | 🚧 En desarrollo |
NOTA_DE_REMISION_ELECTRONICA | Nota de Remisión (NRE) | 🚧 En desarrollo |
Cada tipo tiene su propio schema de request. Ver Modelos de Datos.
Autenticación
Todos los endpoints de esta sección requieren API key:
Authorization: Bearer {tu-api-key}URL base
https://api.sifende.com.py/api/v1/documento-electronicoEndpoints
| Método | Path | Descripción |
|---|---|---|
POST | / | Emitir un documento electrónico |
GET | /status/:cdc | Consultar estado por CDC |
GET | /:cdc/kude | Descargar KuDE PDF |
POST | /:cdc/cancelar | Cancelar un documento |
POST | /inutilizar | Inutilizar numeración |
¿Tu documento fue rechazado?
Si emitís un documento y queda en estado RECHAZADO, la mayoría de los rechazos durante el onboarding se deben a que un dato no coincide con lo que SET tiene registrado para tu RUC (timbrado, actividades económicas, CSC, establecimiento / punto). Mirá Rechazos comunes de SIFEN para el diagnóstico paso a paso, o la tabla completa de códigos.