Saltar al contenido principal

SIFEN — Tipos de Documentos Electronicos (DE)

Fecha: 2026-04-14 Fuente: Manual Tecnico v150 — Capitulo 7 (Estructura XML del DE) Referencia codigo: app/Domains/Sifen/Enums/TipoDocumentoElectronico.php


Resumen

SIFEN soporta 8 tipos de Documentos Electronicos (DE). Cada tipo tiene su propio grupo de campos especificos en el XML, ademas de los campos comunes de todo DE.

Campo XML que identifica el tipo: iTiDE (Tipo de Documento Electronico) — codigo C002 del Manual.

iTiDETipoCodigo en codigo
1Factura electronicaFACTURA_ELECTRONICA
2Factura electronica de exportacionFACTURA_ELECTRONICA_EXPORTACION
3Factura electronica de importacionFACTURA_ELECTRONICA_IMPORTACION
4Autofactura electronicaAUTOFACTURA_ELECTRONICA
5Nota de credito electronicaNOTA_DE_CREDITO_ELECTRONICA
6Nota de debito electronicaNOTA_DE_DEBITO_ELECTRONICA
7Nota de remision electronicaNOTA_DE_REMISION_ELECTRONICA
8Comprobante de retencion electronicoCOMPROBANTE_RETENCION_ELECTRONICO

Campos comunes a TODOS los tipos

Independientemente del tipo, todo DE requiere estos grupos:

Cabecera del documento

GrupoDescripcion
ACampos firmados del Documento Electronico (CDC, DV, fecha firma)
BCampos inherentes a la operacion comercial (tipo emision, codigo seguridad)
CCampos de datos del Timbrado (numero timbrado, establecimiento, punto expedicion, numero documento, fecha inicio vigencia)
DCampos generales del DE (fecha emision, datos emisor, datos receptor)

Datos del emisor (D100-D129)

Todos los tipos requieren:

  • dRucEm — RUC del emisor
  • dDVEmi — Digito verificador
  • iTipCont — Tipo de contribuyente
  • dNomEmi — Razon social
  • dDirEmi — Direccion
  • dNumCas — Numero de casa
  • cDepEmi — Codigo departamento
  • cDisEmi — Codigo distrito
  • cCiuEmi — Codigo ciudad
  • dTelEmi — Telefono
  • dEmailE — Email
  • gActEcoList — Actividades economicas

Items y totales

  • Grupo E700-E799 — Items de la operacion (descripcion, cantidad, precio, IVA)
  • Grupo F001-F099 — Subtotales y totales

Firma digital

  • Grupo I001-I049 — Firma XMLDSig

QR

  • Grupo G050-G099 — Codigo QR para consulta

1. Factura Electronica (FE) — iTiDE = 1

Manual: cap 7, seccion E1 (E010-E099)

Cuando se usa

Operacion comercial estandar: B2B, B2C, B2G, B2F.

Campos especificos requeridos

CampoDescripcionObligatorio
iIndPresIndicador de presencia (1=Operacion presencial, 2=Op. electronica, 3=Op. telemarketing, ...)SI
dDesIndPresDescripcion del indicador de presenciaSI
dFecEmNRFecha de emision NR (solo si es ND, NC, NR)NO

Datos del receptor (D200-D299)

  • iNatRec — Naturaleza del receptor (1=Contribuyente, 2=No contribuyente, 3=Extranjero)
  • iTiOpe — Tipo de operacion (1=B2B, 2=B2C, 3=B2G, 4=B2F)
  • cPaisRec — Pais del receptor
  • iTipIDRec — Tipo de documento del receptor
  • dNumIDRec — Numero de documento
  • dNomRec — Nombre o razon social del receptor

Condicion de la operacion (E600+)

Para FE es obligatorio informar la condicion de venta:

  • iCondOpe — 1=Contado, 2=Credito
  • Si iCondOpe=1: gPaConEIni (forma de pago al contado)
  • Si iCondOpe=2: gPagCred (datos de credito + cuotas)

Estado en OnnixConnect

[OK] Implementado y probado. Endpoint: POST /api/sifen/dtes/sync o POST /api/sifen/dtes.

Ejemplo minimo (JSON)

{
"tipoDocumento": 1,
"tipoEmision": 1,
"fechaEmision": "2026-04-14T12:00:00",
"tipoOperacion": 2,
"tipoImpuesto": 1,
"establecimiento": "001",
"puntoExpedicion": "001",
"numeroDocumento": "0001234",
"timbrado": 80126006,
"tipoContribuyente": 2,
"emisor": { "ruc": "80126006", "dv": "0", "razonSocial": "...", ... },
"receptor": { "naturaleza": 2, "tipoDoc": 1, "numeroDocumento": "...", "nombre": "..." },
"items": [ { "descripcion": "...", "cantidad": 1, "precioUnitario": 100000, "tasaIva": 10 } ],
"totales": { "subtotalGravado10": 100000, "iva10": 9091, "totalOperacion": 100000 },
"condicionPago": { "condicion": 1 }
}

2. Factura Electronica de Exportacion (FEE) — iTiDE = 2

Manual: cap 7, seccion E2 (E100-E199)

Cuando se usa

Venta de bienes o servicios al exterior (exportacion).

Campos especificos requeridos (ADICIONAL a los de FE)

CampoDescripcionObligatorio
iCondNegCondicion de negociacion (Incoterm: FOB, CIF, EXW, etc.)SI
dCondNegDescripcion de la condicionSI
cPaisDestCodigo del pais de destinoSI
dDesPaisDestDescripcion del pais de destinoSI
dNumManifNumero del manifiestoNO
dDespImpNumero de despacho de importacionNO
dKMRecorrKilometros recorridosNO
dRecepLocCiudad de recepcion localNO

Receptor

  • iTiOpe = 4 (Business to Foreign — B2F) — obligatorio.
  • cPaisRec distinto de PRYobligatorio.

Items

  • iAfecIVA debe ser 2 (No exonerada) o 4 (No alcanzada) — la exportacion no genera IVA.
  • dTotalGralOpe debe ser en moneda extranjera generalmente.

Estado en OnnixConnect

[Pendiente probar]. El codigo soporta el enum, falta DTO especifico para campos de exportacion.


3. Factura Electronica de Importacion (FEI) — iTiDE = 3

Manual: cap 7, seccion E3 (E200-E299)

Cuando se usa

Compra de bienes/servicios del exterior. Es el comprador (importador) quien la emite para tributar el IVA en aduana.

Campos especificos requeridos (ADICIONAL a los de FE)

CampoDescripcionObligatorio
dNroDespachoNumero del despacho aduaneroSI
dFecDespachoFecha del despacho aduaneroSI
dPaisOrigenPais de origen de la mercaderiaSI
dDesPaisOrigenDescripcion del pais de origenSI

Emisor

  • El emisor es el contribuyente paraguayo importador (no el proveedor extranjero).

Receptor

  • El "receptor" es el proveedor extranjero (vendedor).
  • iNatRec = 3 (Extranjero), cPaisRec distinto de PRY.

Estado en OnnixConnect

[Pendiente probar]. Falta DTO para datos de despacho aduanero.


4. Autofactura Electronica (AFE) — iTiDE = 4

Manual: cap 7, seccion E4 (E300-E399)

Cuando se usa

Cuando un contribuyente le compra a un no contribuyente (ej. agricultor sin RUC). El comprador autoemite la factura para tributar.

Campos especificos requeridos (ADICIONAL a los de FE)

CampoDescripcionObligatorio
iNatVendNaturaleza del vendedor (1=No contribuyente, 2=Extranjero)SI
iTipIDVendTipo de documento del vendedorSI
dNumIDVendNumero de documento del vendedorSI
dNomVendNombre del vendedorSI
dDirVendDireccion del vendedorSI
dNumCasVenNumero de casa del vendedorNO
cDepVenCodigo departamento vendedorSI
cDisVenCodigo distrito vendedorNO
cCiuVenCodigo ciudad vendedorSI
dDesCiuVenDescripcion ciudad vendedorSI

Receptor

  • iNatRec = 1 (Contribuyente) obligatorio (es quien emite la autofactura).
  • iTiOpe distinto de 2 (B2C) — la autofactura no aplica para B2C.

Items

  • iAfecIVA puede ser cualquiera (gravada, exenta, etc.).

Estado en OnnixConnect

[Pendiente probar]. Falta DTO para datos del vendedor (no contribuyente).


5. Nota de Credito Electronica (NCE) — iTiDE = 5

Manual: cap 7, seccion E5 (E400-E499)

Cuando se usa

Anular total/parcialmente una FE, descontar de una FE, o devolucion de mercaderia.

Campos especificos requeridos (ADICIONAL a los de FE)

CampoDescripcionObligatorio
iMotEmiMotivo de emision (1=Devolucion, 2=Descuento, 3=Bonificacion, 4=Credito incobrable, 5=Recupero costo, 6=Recupero gasto, 7=Ajuste precio)SI
dDesMotEmiDescripcion del motivoSI

Documento asociado (Grupo H — H001-H049)

Toda NCE/NDE debe referenciar el documento original (FE):

CampoDescripcionObligatorio
iTipDocAsoTipo del documento asociado (1=Electronico, 2=Impreso, 3=Constancia administrativa)SI
dCdCDERefCDC del DE de referencia (44 digitos de la FE original)SI si tipo=1
dNTimDINumero timbrado del impresoSI si tipo=2
dEstDocImpEstablecimientoSI si tipo=2
dPExpDocImpPunto expedicionSI si tipo=2
dNumDocImpNumero documentoSI si tipo=2
dFecEmiDIFecha emision DISI si tipo=2

Estado en OnnixConnect

[Pendiente probar]. Soporta el enum, falta DTO DocumentoAsociadoData.


6. Nota de Debito Electronica (NDE) — iTiDE = 6

Manual: cap 7, seccion E5 (E400-E499) — comparte estructura con NCE

Cuando se usa

Adicionar un cargo a una FE ya emitida (intereses, ajustes a favor del emisor).

Campos especificos requeridos

Mismos que NCE: iMotEmi, dDesMotEmi, + Grupo H (documento asociado).

Diferencia con NCE

Solo cambia iMotEmi:

  • NDE: 1=Intereses por mora, 2=Ajuste de precio, etc. (consultar tabla del Manual)

Estado en OnnixConnect

[Pendiente probar]. Igual que NCE.


7. Nota de Remision Electronica (NRE) — iTiDE = 7

Manual: cap 7, seccion E9 (E900-E999) + secciones E920-E999

Cuando se usa

Traslado fisico de mercaderia (sin que sea venta inmediata). Ej: traslado entre sucursales, envio a un cliente, etc.

Campos especificos requeridos (ADICIONAL a los de FE)

Grupo E900-E912 — Caracteristicas del transporte

CampoDescripcionObligatorio
iMotEmiNRMotivo emision NR (1=Traslado entre locales, 2=Traslado por venta, 3=Traslado por compra, 4=Devolucion, 5=Traslado por consignacion, 6=Exportacion, ...)SI
iRespEmisNRResponsable de emision (1=Emisor de la factura, 2=Poseedor del bien, 3=Empresa transportista)SI
dKmRKilometros recorridosSI
dFecEmFecha de inicio del trasladoSI
dFecEmFinFecha de fin del trasladoNO
iCondNegCondicion del trasladoNO

Grupo E920-E930 — Local de salida

CampoDescripcionObligatorio
dDirLocSalDireccion del local de salidaSI
cDepSalCodigo departamento salidaSI
dDesDepSalDescripcion departamentoSI
cCiuSalCodigo ciudad salidaSI

Grupo E940-E950 — Local de entrega

CampoDescripcionObligatorio
dDirLocEntDireccion local entregaSI
cDepEntCodigo departamento entregaSI
cCiuEntCodigo ciudad entregaSI

Grupo E960-E966 — Vehiculo

CampoDescripcionObligatorio
dTiVehTrasTipo de vehiculoSI
dMarVehMarca del vehiculoSI
dTipIdenVehTipo identificacion (placa, RUC, etc.)SI
dNroIDVehNumero de identificacion (placa)SI
dAdicVehDatos adicionalesNO

Grupo E980-E989 — Transportista (si E912 = 3 = empresa transportista)

CampoDescripcionObligatorio
iNatTransNaturaleza transportistaSI
dNomTransNombre transportistaSI
dRucTransRUC transportistaSI si nat=1
dDVTransDV del RUCSI si nat=1
iTipIDTransTipo documento conductorNO
dNumIDTransNumero documento conductorNO
dNomConductorNombre del conductorNO

Estado en OnnixConnect

[Pendiente probar]. Es el tipo mas complejo (5+ grupos de campos especificos). Necesita DTOs TransporteData, VehiculoData, TransportistaData.


8. Comprobante de Retencion Electronico (CRE) — iTiDE = 8

Manual: cap 7, seccion E5 (E400-E499) — pero con grupo de retenciones

Cuando se usa

Emitido por el agente de retencion (comprador) para documentar las retenciones de IVA y/o renta efectuadas a un proveedor.

Campos especificos requeridos (ADICIONAL a los de FE)

Grupo de retencion (variable)

CampoDescripcionObligatorio
iTipRegTipo de regimen de retencion (1=Renta, 2=IVA)SI
dPorRegPorcentaje de regimenSI

Documento asociado (Grupo H)

Igual que NCE/NDE: debe referenciar el CDC de la FE original sobre la que se hace la retencion.

Estado en OnnixConnect

[Pendiente probar]. Falta DTO RetencionData.


Matriz consolidada de campos obligatorios por tipo

CampoFEFEEFEIAFENCENDENRECRE
Datos emisor (D100-D129)OBLOBLOBLOBLOBLOBLOBLOBL
Datos receptor (D200-D299)OBLOBLOBLOBLOBLOBLOBLOBL
Items (E700-E799)OBLOBLOBLOBLOBLOBLOBLOBL
Totales (F001-F099)OBLOBLOBLOBLOBLOBLOBLOBL
Condicion operacion (E600+)OBLOBLNOOBLOBLOBLNONO
iIndPresOBLOBLOBLOBLOBLOBLNONO
Datos exportacion (E100+)NOOBLNONONONONONO
Datos despacho aduanero (E200+)NONOOBLNONONONONO
Datos del vendedor (E300+)NONONOOBLNONONONO
Motivo emision NCE/NDENONONONOOBLOBLNONO
Documento asociado (H)NONONONOOBLOBLNOOBL
Caracteristicas transporte (E900+)NONONONONONOOBLNO
Local salida/entrega (E920-E950)NONONONONONOOBLNO
Vehiculo (E960+)NONONONONONOOBLNO
Datos de retencionNONONONONONONOOBL

Leyenda: OBL = Obligatorio, NO = No aplica.


Plan de implementacion en OnnixConnect

TipoEstado actualFaltaEsfuerzo
FEListo
NCEEnum OKDocumentoAsociadoData DTO + Builder4h
NDEEnum OKMismo que NCE (reutilizable)1h
AFEEnum OKVendedorData DTO + Builder + Validacion6h
FEEEnum OKDTO de exportacion (Incoterm, pais destino)4h
FEIEnum OKDTO de despacho aduanero4h
CREEnum OKRetencionData DTO + Builder + Grupo H6h
NREEnum OK4 DTOs nuevos (Transporte, Vehiculo, Transportista, Locales)12h

Total estimado: 37h (4 dias a 9hs/dia) para soportar los 8 tipos completos.


Codigos de respuesta SIFEN especificos por tipo

Estos codigos del Manual cap 12 son comunes:

CodigoSignificadoAplica a
0260AprobadoTodos
0300Lote recibidoTodos (envio async)
0600Evento registradoCancelacion/Inutilizacion
1001CDC duplicadoTodos
1002DE duplicadoTodos
1101Numero de timbrado invalidoTodos
1107Fecha inicio vigencia incorrectaTodos
4050-4099Validaciones de InutilizacionSolo eventos

Referencias

  • Manual Tecnico v150 — Capitulo 7 (Estructura XML del DE)
    • docs/manuales-md/manual150cap7.md (formato MD)
    • docs/pdf/Manual Tecnico Version 150.pdf (217 paginas, oficial)
  • docs/manuales-md/Manual_SIFEN_v150_completo.md — manual completo convertido
  • app/Domains/Sifen/Enums/TipoDocumentoElectronico.php — enum en codigo
  • app/Domains/Sifen/DTOs/DteData.php — DTO actual (solo soporta FE completo)