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.
| iTiDE | Tipo | Codigo en codigo |
|---|---|---|
| 1 | Factura electronica | FACTURA_ELECTRONICA |
| 2 | Factura electronica de exportacion | FACTURA_ELECTRONICA_EXPORTACION |
| 3 | Factura electronica de importacion | FACTURA_ELECTRONICA_IMPORTACION |
| 4 | Autofactura electronica | AUTOFACTURA_ELECTRONICA |
| 5 | Nota de credito electronica | NOTA_DE_CREDITO_ELECTRONICA |
| 6 | Nota de debito electronica | NOTA_DE_DEBITO_ELECTRONICA |
| 7 | Nota de remision electronica | NOTA_DE_REMISION_ELECTRONICA |
| 8 | Comprobante de retencion electronico | COMPROBANTE_RETENCION_ELECTRONICO |
Campos comunes a TODOS los tipos
Independientemente del tipo, todo DE requiere estos grupos:
Cabecera del documento
| Grupo | Descripcion |
|---|---|
| A | Campos firmados del Documento Electronico (CDC, DV, fecha firma) |
| B | Campos inherentes a la operacion comercial (tipo emision, codigo seguridad) |
| C | Campos de datos del Timbrado (numero timbrado, establecimiento, punto expedicion, numero documento, fecha inicio vigencia) |
| D | Campos generales del DE (fecha emision, datos emisor, datos receptor) |
Datos del emisor (D100-D129)
Todos los tipos requieren:
dRucEm— RUC del emisordDVEmi— Digito verificadoriTipCont— Tipo de contribuyentedNomEmi— Razon socialdDirEmi— DirecciondNumCas— Numero de casacDepEmi— Codigo departamentocDisEmi— Codigo distritocCiuEmi— Codigo ciudaddTelEmi— TelefonodEmailE— EmailgActEcoList— 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
| Campo | Descripcion | Obligatorio |
|---|---|---|
iIndPres | Indicador de presencia (1=Operacion presencial, 2=Op. electronica, 3=Op. telemarketing, ...) | SI |
dDesIndPres | Descripcion del indicador de presencia | SI |
dFecEmNR | Fecha 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 receptoriTipIDRec— Tipo de documento del receptordNumIDRec— Numero de documentodNomRec— 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)
| Campo | Descripcion | Obligatorio |
|---|---|---|
iCondNeg | Condicion de negociacion (Incoterm: FOB, CIF, EXW, etc.) | SI |
dCondNeg | Descripcion de la condicion | SI |
cPaisDest | Codigo del pais de destino | SI |
dDesPaisDest | Descripcion del pais de destino | SI |
dNumManif | Numero del manifiesto | NO |
dDespImp | Numero de despacho de importacion | NO |
dKMRecorr | Kilometros recorridos | NO |
dRecepLoc | Ciudad de recepcion local | NO |
Receptor
iTiOpe= 4 (Business to Foreign — B2F) — obligatorio.cPaisRecdistinto dePRY— obligatorio.
Items
iAfecIVAdebe ser 2 (No exonerada) o 4 (No alcanzada) — la exportacion no genera IVA.dTotalGralOpedebe 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)
| Campo | Descripcion | Obligatorio |
|---|---|---|
dNroDespacho | Numero del despacho aduanero | SI |
dFecDespacho | Fecha del despacho aduanero | SI |
dPaisOrigen | Pais de origen de la mercaderia | SI |
dDesPaisOrigen | Descripcion del pais de origen | SI |
Emisor
- El emisor es el contribuyente paraguayo importador (no el proveedor extranjero).
Receptor
- El "receptor" es el proveedor extranjero (vendedor).
iNatRec= 3 (Extranjero),cPaisRecdistinto 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)
| Campo | Descripcion | Obligatorio |
|---|---|---|
iNatVend | Naturaleza del vendedor (1=No contribuyente, 2=Extranjero) | SI |
iTipIDVend | Tipo de documento del vendedor | SI |
dNumIDVend | Numero de documento del vendedor | SI |
dNomVend | Nombre del vendedor | SI |
dDirVend | Direccion del vendedor | SI |
dNumCasVen | Numero de casa del vendedor | NO |
cDepVen | Codigo departamento vendedor | SI |
cDisVen | Codigo distrito vendedor | NO |
cCiuVen | Codigo ciudad vendedor | SI |
dDesCiuVen | Descripcion ciudad vendedor | SI |
Receptor
iNatRec= 1 (Contribuyente) obligatorio (es quien emite la autofactura).iTiOpedistinto de 2 (B2C) — la autofactura no aplica para B2C.
Items
iAfecIVApuede 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)
| Campo | Descripcion | Obligatorio |
|---|---|---|
iMotEmi | Motivo de emision (1=Devolucion, 2=Descuento, 3=Bonificacion, 4=Credito incobrable, 5=Recupero costo, 6=Recupero gasto, 7=Ajuste precio) | SI |
dDesMotEmi | Descripcion del motivo | SI |
Documento asociado (Grupo H — H001-H049)
Toda NCE/NDE debe referenciar el documento original (FE):
| Campo | Descripcion | Obligatorio |
|---|---|---|
iTipDocAso | Tipo del documento asociado (1=Electronico, 2=Impreso, 3=Constancia administrativa) | SI |
dCdCDERef | CDC del DE de referencia (44 digitos de la FE original) | SI si tipo=1 |
dNTimDI | Numero timbrado del impreso | SI si tipo=2 |
dEstDocImp | Establecimiento | SI si tipo=2 |
dPExpDocImp | Punto expedicion | SI si tipo=2 |
dNumDocImp | Numero documento | SI si tipo=2 |
dFecEmiDI | Fecha emision DI | SI 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
| Campo | Descripcion | Obligatorio |
|---|---|---|
iMotEmiNR | Motivo emision NR (1=Traslado entre locales, 2=Traslado por venta, 3=Traslado por compra, 4=Devolucion, 5=Traslado por consignacion, 6=Exportacion, ...) | SI |
iRespEmisNR | Responsable de emision (1=Emisor de la factura, 2=Poseedor del bien, 3=Empresa transportista) | SI |
dKmR | Kilometros recorridos | SI |
dFecEm | Fecha de inicio del traslado | SI |
dFecEmFin | Fecha de fin del traslado | NO |
iCondNeg | Condicion del traslado | NO |
Grupo E920-E930 — Local de salida
| Campo | Descripcion | Obligatorio |
|---|---|---|
dDirLocSal | Direccion del local de salida | SI |
cDepSal | Codigo departamento salida | SI |
dDesDepSal | Descripcion departamento | SI |
cCiuSal | Codigo ciudad salida | SI |
Grupo E940-E950 — Local de entrega
| Campo | Descripcion | Obligatorio |
|---|---|---|
dDirLocEnt | Direccion local entrega | SI |
cDepEnt | Codigo departamento entrega | SI |
cCiuEnt | Codigo ciudad entrega | SI |
Grupo E960-E966 — Vehiculo
| Campo | Descripcion | Obligatorio |
|---|---|---|
dTiVehTras | Tipo de vehiculo | SI |
dMarVeh | Marca del vehiculo | SI |
dTipIdenVeh | Tipo identificacion (placa, RUC, etc.) | SI |
dNroIDVeh | Numero de identificacion (placa) | SI |
dAdicVeh | Datos adicionales | NO |
Grupo E980-E989 — Transportista (si E912 = 3 = empresa transportista)
| Campo | Descripcion | Obligatorio |
|---|---|---|
iNatTrans | Naturaleza transportista | SI |
dNomTrans | Nombre transportista | SI |
dRucTrans | RUC transportista | SI si nat=1 |
dDVTrans | DV del RUC | SI si nat=1 |
iTipIDTrans | Tipo documento conductor | NO |
dNumIDTrans | Numero documento conductor | NO |
dNomConductor | Nombre del conductor | NO |
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)
| Campo | Descripcion | Obligatorio |
|---|---|---|
iTipReg | Tipo de regimen de retencion (1=Renta, 2=IVA) | SI |
dPorReg | Porcentaje de regimen | SI |
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
| Campo | FE | FEE | FEI | AFE | NCE | NDE | NRE | CRE |
|---|---|---|---|---|---|---|---|---|
| Datos emisor (D100-D129) | OBL | OBL | OBL | OBL | OBL | OBL | OBL | OBL |
| Datos receptor (D200-D299) | OBL | OBL | OBL | OBL | OBL | OBL | OBL | OBL |
| Items (E700-E799) | OBL | OBL | OBL | OBL | OBL | OBL | OBL | OBL |
| Totales (F001-F099) | OBL | OBL | OBL | OBL | OBL | OBL | OBL | OBL |
| Condicion operacion (E600+) | OBL | OBL | NO | OBL | OBL | OBL | NO | NO |
iIndPres | OBL | OBL | OBL | OBL | OBL | OBL | NO | NO |
| Datos exportacion (E100+) | NO | OBL | NO | NO | NO | NO | NO | NO |
| Datos despacho aduanero (E200+) | NO | NO | OBL | NO | NO | NO | NO | NO |
| Datos del vendedor (E300+) | NO | NO | NO | OBL | NO | NO | NO | NO |
| Motivo emision NCE/NDE | NO | NO | NO | NO | OBL | OBL | NO | NO |
| Documento asociado (H) | NO | NO | NO | NO | OBL | OBL | NO | OBL |
| Caracteristicas transporte (E900+) | NO | NO | NO | NO | NO | NO | OBL | NO |
| Local salida/entrega (E920-E950) | NO | NO | NO | NO | NO | NO | OBL | NO |
| Vehiculo (E960+) | NO | NO | NO | NO | NO | NO | OBL | NO |
| Datos de retencion | NO | NO | NO | NO | NO | NO | NO | OBL |
Leyenda: OBL = Obligatorio, NO = No aplica.
Plan de implementacion en OnnixConnect
| Tipo | Estado actual | Falta | Esfuerzo |
|---|---|---|---|
| FE | Listo | — | — |
| NCE | Enum OK | DocumentoAsociadoData DTO + Builder | 4h |
| NDE | Enum OK | Mismo que NCE (reutilizable) | 1h |
| AFE | Enum OK | VendedorData DTO + Builder + Validacion | 6h |
| FEE | Enum OK | DTO de exportacion (Incoterm, pais destino) | 4h |
| FEI | Enum OK | DTO de despacho aduanero | 4h |
| CRE | Enum OK | RetencionData DTO + Builder + Grupo H | 6h |
| NRE | Enum OK | 4 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:
| Codigo | Significado | Aplica a |
|---|---|---|
| 0260 | Aprobado | Todos |
| 0300 | Lote recibido | Todos (envio async) |
| 0600 | Evento registrado | Cancelacion/Inutilizacion |
| 1001 | CDC duplicado | Todos |
| 1002 | DE duplicado | Todos |
| 1101 | Numero de timbrado invalido | Todos |
| 1107 | Fecha inicio vigencia incorrecta | Todos |
| 4050-4099 | Validaciones de Inutilizacion | Solo 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 convertidoapp/Domains/Sifen/Enums/TipoDocumentoElectronico.php— enum en codigoapp/Domains/Sifen/DTOs/DteData.php— DTO actual (solo soporta FE completo)