Convenciones
Convenciones específicas de Paraguay en la API de Sifende — formato de RUC, montos en guaraníes, fechas, CDC y numeración de documentos.
Esta página documenta las convenciones de datos específicas de Paraguay que aplican a toda la API de Sifende.
RUC (Registro Único de Contribuyente)
El RUC es el número de identificación tributaria paraguayo.
Formato: número + guión + dígito verificador
80012345-1En la API, el RUC se envía en dos campos separados:
numeroDocumentooruc— solo la parte numérica:"80012345"dvodigitoVerificador— el dígito verificador:"1"
Validación: Sifende valida el RUC contra el registro de SIFEN. Un RUC inválido o inexistente retorna 404 ruc-not-found.
Moneda — Guaraníes (PYG)
El guaraní paraguayo no tiene decimales — todos los montos en PYG son enteros.
// Correcto
"precioUnitario": 150000
// Incorrecto — no uses decimales en PYG
"precioUnitario": 150000.00Para otras monedas (USD, BRL, etc.), sí se permiten decimales según la cantidad de decimales de la moneda.
Campos monetarios afectados: precioUnitario, montoPago, montoDescuento, montoTotal y todos los sub-totales cuando monedaOperacion es PYG.
Moneda extranjera y tipos de cambio
Los tipos de cambio son valores decimales expresados como PYG por una unidad de moneda extranjera. Admiten hasta 5 enteros y 4 decimales, deben ser mayores que cero y menores que 99999.9999.
tipoCambioen la factura: modalidad GLOBAL (D018).items[].tipoCambio: modalidad POR_ITEM (E725), obligatorio en todos los ítems.condicionPago.tipoCambio: cotización de la moneda extranjera del pago (E611), independiente de la modalidad de la operación.
La cotización comprador o vendedor del BCP es una decisión contable. Sifende valida la estructura y el formato, no que el valor coincida con una cotización específica del BCP. Ver Facturar en Moneda Extranjera.
Fechas y Timestamps
| Uso | Formato | Ejemplo |
|---|---|---|
| Fecha y hora | ISO 8601 sin timezone | 2026-04-15T10:30:00 |
| Solo fecha | ISO 8601 date | 2026-04-15 |
No incluyas información de zona horaria en los timestamps. La API espera LocalDateTime de Paraguay (GMT-4).
CDC (Código de Control del Documento Electrónico)
El CDC es un identificador numérico de 44 dígitos que identifica unívocamente cada documento en SIFEN.
Estructura del CDC (44 dígitos, 11 campos):
| Pos. | Largo | Campo | Descripción |
|---|---|---|---|
| 1–2 | 2 | iTiDE | Tipo de documento (01=FE, 04=AFE, 05=NCE, 06=NDE, 07=NRE) |
| 3–10 | 8 | RUC emisor | Parte numérica del RUC |
| 11 | 1 | DV emisor | Dígito verificador del RUC |
| 12–14 | 3 | Establecimiento | Código del establecimiento (001–999) |
| 15–17 | 3 | Punto de expedición | Código del punto de expedición (001–999) |
| 18–24 | 7 | Número de documento | Correlativo (0000001–9999999) |
| 25 | 1 | iTipCont | Tipo de contribuyente emisor (1=persona física, 2=jurídica) |
| 26–33 | 8 | Fecha emisión | AAAAMMDD |
| 34 | 1 | iTipEmi | Tipo de emisión (1=Normal, 2=Contingencia) |
| 35–43 | 9 | Código de seguridad | Aleatorio generado al firmar |
| 44 | 1 | DV CDC | Dígito verificador del CDC completo |
Ejemplo:
01800123451001001000000122026042710000000006El CDC es generado por Sifende y retornado como respuesta al emitir un documento. Guardalo en tu sistema — es el identificador principal para todas las operaciones posteriores.
Numeración de Documentos
El número de documento se forma con tres componentes:
{establecimiento}-{puntoExpedicion}-{número}
001-001-0000001- Establecimiento: 3 dígitos, identifica la sucursal
- Punto de expedición: 3 dígitos, identifica el punto de venta dentro del establecimiento
- Número: 7 dígitos, auto-incremental por establecimiento/punto
Sifende asigna los números automáticamente según tu timbrado.
Enumeraciones SIFEN
Los campos de tipo enumeración usan valores de cadena descriptivos en la API (no los códigos numéricos internos de SIFEN):
// En la API de Sifende
"tipoDocumento": "FACTURA_ELECTRONICA"
// Código numérico de SIFEN (no usar en la API)
// iTiDE = 1Para ver todos los valores disponibles, consultá Enumeraciones o llamá a GET /api/v1/public/enums.
Especificación OpenAPI
La especificación OpenAPI 3.1 está disponible en https://sifende.com.py/openapi/v1.json. Consultá OpenAPI y JSON Schema para generar clientes y validar requests.
SDKs
📋 Planificado — no hay SDKs oficiales disponibles actualmente. Se recomienda implementar un cliente HTTP propio usando los ejemplos de esta documentación.