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

La respuesta es un objeto cuyas claves identifican las categorías. Este extracto muestra dos de ellas:

{
  "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_DE_REMISION_ELECTRONICA", "label": "Nota de Remisión Electrónica", "val": 7 }
  ],
  "tipoEmision": [
    { "name": "NORMAL", "label": "Normal", "val": 1 },
    { "name": "CONTINGENCIA", "label": "Contingencia", "val": 2 }
  ]
}

Campos de cada valor

Campo	Tipo	Descripción
`name`	`string`	Identificador en mayúsculas usado al enviar solicitudes
`label`	`string`	Texto legible para mostrar en UI
`val`	`integer \| null`	Código numérico SIFEN, o `null` cuando no aplica

extra contiene la abreviatura en la categoría unidadMedida; puede ser null.

Para los campos de tipo enum, enviá name como texto. Los campos numéricos conservan su tipo: por ejemplo, transporte.vehiculos[].tipoIdentificacion usa 1 o 2, y tipoDocumento en una inutilización usa el código numérico. Consultá el modelo de la operación.

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`
`condicionCredito`	Modalidad de crédito	`condicionPago.condicionCredito`
`unidadPlazoCredito`	Días o meses	`condicionPago.plazoEstructurado.unidad`
`tipoPago`	Tipo de pago	Campo `condicionPago.tipoPago`
`naturalezaReceptor`	Naturaleza del receptor	Campo `receptor.tipoContribuyente`
`tipoContribuyenteReceptor`	Persona física o jurídica	Campo `receptor.tipoContribuyenteReceptor` (sólo receptores contribuyentes)
`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`
`tipoDocumentoImpreso`	Tipo de comprobante impreso	Documentos asociados no electrónicos
`departamento`	Departamentos del Paraguay	Campo `receptor.departamento`
`moneda`	Monedas comunes (15 valores)	Campo `monedaOperacion`
`monedaCompleta`	Catálogo completo de monedas ISO 4217	Campo `monedaOperacion`
`pais`	Países comunes (16 valores)	Campo `receptor.pais`
`paisCompleto`	Catálogo completo de países ISO 3166	Campo `receptor.pais`

Las categorías de remisión son caracteristicaCarga, motivoTraslado, responsableEmision, tipoTransporte, modalidadTransporte, responsableFlete, incoterm, tipoDocumentoImpresoRemision, relevanciaMercaderia, tipoDocumentoTransportista, tipoDocumentoAsociadoRemision y tipoIdentificacionVehiculo. También se devuelve obligacionAfectada.

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'