Enumeraciones SIFEN (Endpoint)

GET /api/v1/public/enums — lista todos los valores válidos de las enumeraciones SIFEN en tiempo real.

GET /api/v1/public/enums

Devuelve todas las enumeraciones SIFEN soportadas con sus valores y etiquetas. Endpoint público — no requiere autenticación. CORS habilitado para uso desde cualquier frontend.

Respuesta exitosa

Status: 200 OK

Mapa de 18 categorías. Cada entrada es un array de EnumValueDTO:

{
  "tipoDocumento": [
    { "name": "FACTURA_ELECTRONICA", "label": "Factura Electrónica", "val": 1 },
    { "name": "AUTOFACTURA_ELECTRONICA", "label": "Autofactura Electrónica", "val": 4 },
    { "name": "NOTA_DE_CREDITO_ELECTRONICA", "label": "Nota de Crédito Electrónica", "val": 5 },
    { "name": "NOTA_DE_DEBITO_ELECTRONICA", "label": "Nota de Débito Electrónica", "val": 6 },
    { "name": "NOTA_REMISION_ELECTRONICA", "label": "Nota de Remisión Electrónica", "val": 7 }
  ],
  "tipoEmision": [
    { "name": "NORMAL", "label": "Normal", "val": 1 },
    { "name": "CONTINGENCIA", "label": "Contingencia", "val": 2 }
  ],
  "moneda": [...],
  "...": "..."
}

EnumValueDTO

Campo	Tipo	Descripción
`name`	`string`	Identificador en mayúsculas usado al enviar requests
`label`	`string`	Texto legible para mostrar en UI
`val`	`integer`	Código numérico SIFEN (cuando aplica)

Al enviar requests, usá siempre el valor del campo name (string), nunca el val numérico. El val se expone solo como referencia al código SIFEN — la API rechaza enums numéricos con 400 invalid-enum-value.

Categorías disponibles

Clave	Descripción	Uso
`tipoDocumento`	Tipo de documento electrónico	Campo `tipoDocumento`
`tipoEmision`	Tipo de emisión	Campo `tipoEmision`
`tipoTransaccion`	Tipo de transacción	Campo `tipoTransaccion` (solo FE)
`condicionOperacion`	Condición de operación	Campo `condicionOperacion`
`tipoPago`	Tipo de pago	Campo `condicionPago.tipoPago`
`naturalezaReceptor`	Naturaleza del receptor	Campo `receptor.tipoContribuyente`
`tipoOperacion`	Tipo de operación B2B/B2C	Campo `receptor.tipoOperacion`
`tipoDocumentoReceptor`	Tipo de documento del receptor	Campo `receptor.tipoDocumento`
`unidadMedida`	Unidades de medida (con abreviatura)	Campo `items[].unidadMedida`
`afectacionIVA`	Afectación tributaria	Campo `items[].afectacionTributaria`
`motivoEmision`	Motivo de emisión (NCE/NDE)	Campo `motivoEmision`
`tipoDocumentoAsociado`	Tipo de documento asociado	Campo `documentoAsociado.tipoDocumento`
`moneda`	Monedas comunes (15 valores)	Campo `monedaOperacion`
`pais`	Países comunes (16 valores)	Campo `receptor.pais`

Usá este endpoint para poblar dropdowns y selects en tu UI. Los valores se mantienen sincronizados con las versiones de SIFEN aceptadas por la API. Para la referencia estática completa, ver Enumeraciones.

Errores

Este endpoint no produce errores de autenticación. Solo 500 en caso de fallo del servidor.

Ejemplo

curl https://api.sifende.com.py/api/v1/public/enums

Filtrar una categoría específica con jq:

curl https://api.sifende.com.py/api/v1/public/enums | jq '.tipoDocumento'