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.
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
📋 Planificado — la especificación OpenAPI estará disponible próximamente para facilitar la generación de clientes.
SDKs
📋 Planificado — no hay SDKs oficiales disponibles actualmente. Se recomienda implementar un cliente HTTP propio usando los ejemplos de esta documentación.