Tipos de documento

El campo tipo del cuerpo de POST /dte determina qué clase de documento se emite. El mismo API se usa para los tres países soportados — Guatemala, El Salvador y República Dominicana — pero no todos los tipos están disponibles en todos los países, y cada uno mapea a un código distinto del catálogo de la autoridad fiscal local (SAT, MH o DGII). Esta página cubre el catálogo compartido; el detalle de identificación del receptor y de impuestos por país vive en Guatemala, El Salvador y República Dominicana.

Para la forma completa del JSON (campos comunes a todos los tipos) vea Estructura del DTE. Esta página se enfoca en qué cambia según tipo.

Catálogo por país

`tipo`	Documento	🇬🇹 Guatemala	🇸🇻 El Salvador	🇩🇴 República Dominicana
`factura` (por defecto)	Factura / Comprobante de Crédito Fiscal / Factura Crédito Fiscal	✅ `FACT` (o variante por régimen, ver nota)	✅ CCF, tipo MH `03`	✅ FCFE, tipo DGII `31` (o `44` CERP, ver nota)
`ticket`	Factura de Consumidor Final	❌ no soportado — se rechaza la solicitud	✅ FCF, tipo MH `01`	✅ FCE, tipo DGII `32`
`facturaCambiaria`	Factura Cambiaria (venta a crédito con abonos)	✅ `FCAM` (o variante por régimen)	❌	❌
`facturaEspecial`	Factura Especial / Factura de Sujeto Excluido	✅ `FESP`	✅ FSE, tipo MH `14`	❌
`facturaExportacion` (o `esExportacion: true`)	Factura de Exportación	✅ misma familia `FACT` + complemento de exportación	✅ FEX, tipo MH `11`	✅ CEXP, tipo DGII `46`
`notaCredito`	Nota de Crédito	✅ `NCRE`	✅ tipo MH `05`	✅ NCRE, tipo DGII `34`
`notaDebito`	Nota de Débito	✅ `NDEB`	✅ tipo MH `06`	✅ NDEB, tipo DGII `33`
`notaAbono`	Nota de Abono	✅ `NABN`	❌	❌
`recibo`	Recibo	✅ `RECI`	❌	❌
`reciboDonacion`	Recibo de Donación	✅ `RDON`	❌	❌

El código de tres/cuatro letras entre paréntesis (FACT, NCRE, etc.) es el que Fegora escribe en el atributo Tipo del XML certificado guatemalteco; para El Salvador y República Dominicana la autoridad fiscal identifica el tipo con un código numérico (DocType/eNCF de dos dígitos), no una sigla.

ticket no existe en Guatemala. Es un concepto propio de El Salvador (Factura Consumidor Final) y República Dominicana (Factura de Consumo). Una cuenta emisora guatemalteca que envíe tipo: "ticket" recibe un rechazo explícito (codigo: "FEG_BUSINESS_RULE_VIOLATION", mensaje “El tipo de documento ‘ticket’ no es válido para Guatemala.”) en lugar de emitirse silenciosamente como factura.

Facturas

factura (por defecto)

Venta general de bienes o servicios. Es el tipo por defecto si se omite tipo.

🇬🇹 Guatemala
🇸🇻 El Salvador
🇩🇴 República Dominicana

El código SAT exacto (FACT u otro) depende de la afiliación de IVA de la cuenta emisora, no de un campo que el cliente controle por solicitud: cuentas de régimen general emiten FACT; cuentas de contribuyente agropecuario emiten FACA; cuentas de pequeño contribuyente emiten FPEQ, FAPE o FAAE según el régimen electrónico específico. Este mapeo lo resuelve Fegora automáticamente a partir de la configuración de la cuenta.

Se emite como Comprobante de Crédito Fiscal (CCF), tipo MH 03 — venta entre contribuyentes (B2B) con derecho a crédito fiscal. El receptor debe declarar MH_NRC y MH_CODIGO_ACTIVIDAD en receptor.datosAdicionales, y el documento debe incluir NUMERO_SECUENCIAL en datosAdicionales de nivel raíz. Vea El Salvador.

Se emite como Factura de Crédito Fiscal Electrónica (FCFE), tipo DGII 31 — a menos que receptor.afiliacionIva sea "REGIMEN_ESPECIAL", en cuyo caso se emite como Comprobante de Régimen Especial (CERP), tipo DGII 44.

facturaCambiaria

Venta a crédito con un calendario de abonos pactados. Sólo existe en Guatemala. Se activa de dos formas equivalentes: enviando tipo: "facturaCambiaria" explícitamente, o enviando tipo: "factura" (o el valor por defecto) junto con abonosPactados[] no vacío — Fegora la reconoce igual como cambiaria en ambos casos. El código SAT exacto también varía por régimen de la cuenta (FCAM, o FCCA/FCAP/FCPE/FCAE para agropecuario/pequeño contribuyente), igual que con factura.

{
  "receptor": { "id": "12345678", "nombre": "Comercial Ejemplo, S.A." },
  "items": [
    { "descripcion": "Mobiliario de oficina", "precioUnitario": 4500.00 }
  ],
  "abonosPactados": [
    { "fecha": "2026-08-15", "monto": 1500.00 },
    { "fecha": "2026-09-15", "monto": 1500.00 },
    { "fecha": "2026-10-15", "monto": 1500.00 }
  ]
}

En El Salvador y República Dominicana, abonosPactados[] también se acepta, pero se usa para describir formas de pago del documento — no activa un tipo de documento distinto (esos países no tienen un tipo “cambiaria” propio).

facturaEspecial

El emisor factura en nombre de un proveedor o prestador de servicios que se negó a emitir factura. Sólo Guatemala (FESP) y El Salvador (Factura de Sujeto Excluido, FSE, tipo MH 14) la soportan.

{
  "tipo": "facturaEspecial",
  "receptor": {
    "id": "87654321",
    "nombre": "Proveedor Informal Ejemplo"
  },
  "items": [
    { "tipo": "servicio", "descripcion": "Servicio de transporte de carga", "precioUnitario": 800.00 }
  ]
}

🇬🇹 Guatemala
🇸🇻 El Salvador

Fegora agrega automáticamente la leyenda legal exigida (Art. 52, Decreto 27-92 de la Ley del IVA) como un dato adicional del documento certificado; no es necesario declararla. La respuesta incluye además un bloque retencionesFacturaEspecial con las retenciones de ISR/IVA calculadas.

El receptor de una FSE no debe declarar MH_NRC ni usar receptor.tipoId: "NIT" — el Ministerio de Hacienda rechaza esa combinación. Use receptor.tipoId: "OTRO" con un identificador libre. Retenciones de renta (RETENCION_RENTA/MH_RENTA_RETENIDA) funcionan de forma consistente sólo en este tipo. Detalle en El Salvador.

facturaExportacion (o esExportacion: true)

Venta a un receptor en el extranjero. Requiere el bloque datosExportacion (ver Estructura del DTE) y está exenta de IVA automáticamente — no es necesario declarar esExentoIva ni motivoExencionIva.

{
  "tipo": "facturaExportacion",
  "receptor": {
    "id": "CF",
    "nombre": "Comprador Extranjero Ejemplo"
  },
  "items": [
    { "descripcion": "Artesanías variadas", "precioUnitario": 1200.00 }
  ],
  "datosExportacion": {
    "nombreConsignatario": "Importadora Ejemplo Ltda.",
    "direccionConsignatario": "Av. Principal 123, Ciudad Ejemplo",
    "incoterm": "FOB"
  }
}

Guatemala: exportación a Consumidor Final por Q2,500 o más. Por el Acuerdo Gubernativo 12-2023, una exportación con receptor Consumidor Final (receptor.id: "CF") no puede tener un monto total mayor o igual a Q2,500 (o su equivalente en la moneda del documento). Fegora rechaza la solicitud antes de enviarla a la SAT. Vea Guatemala.

Cada país mapea la exportación a un tipo/complemento distinto — vea la tabla de arriba (FACT + complemento en GT, FEX 11 en SV, CEXP 46 en DO).

Notas

notaCredito / notaDebito

Documentos que ajustan un documento previo: la nota de crédito reduce o anula su efecto (por ejemplo una devolución); la nota de débito lo incrementa (por ejemplo un cargo adicional). Campos obligatorios adicionales — a diferencia de la documentación histórica (que sólo mencionaba idDteOriginal), el validador actual exige motivoAjuste y además una referencia al original:

Campo	Obligatorio	Descripción
`idDteOriginal` o `dteOriginal`	Sí (uno de los dos)	`idDteOriginal`: el `id` (UUID) de Fegora del documento original; se busca y debe existir. `dteOriginal`: bloque con los datos del original, usado tal cual sin búsqueda (para originales que no están en Fegora o de régimen antiguo).
`motivoAjuste`	Sí	Motivo del ajuste, en texto libre (por ejemplo `"Devolución de producto"`).

{
  "tipo": "notaCredito",
  "idDteOriginal": "3FAAF95B-894E-4B80-8253-B32F9A85CBFF",
  "motivoAjuste": "Devolución de producto",
  "items": [
    { "descripcion": "Devolución parcial", "precioUnitario": 150.00 }
  ]
}

Si no se envía receptor, se hereda del documento original (incluyendo sus datosAdicionales país-específicos, como MH_NRC/MH_CODIGO_ACTIVIDAD en El Salvador). Si idDteOriginal no corresponde a un documento existente, se rechaza con codigo: "FEG_DTE_CREA_010" — vea Manejo de errores.

Para referenciar un original que no está en Fegora (por ejemplo, de régimen antiguo), envíe el bloque dteOriginal en lugar de idDteOriginal. Se usa tal cual, sin búsqueda, y alimenta el complemento ReferenciasNota del XML enviado a SAT:

{
  "tipo": "notaCredito",
  "motivoAjuste": "Devolución de producto",
  "dteOriginal": {
    "id": "12345",
    "serie": "A",
    "numero": 12345,
    "fechaEmision": "2019-06-15",
    "tipo": "factura",
    "total": 1500.00,
    "esRegimenAntiguo": true
  },
  "items": [
    { "descripcion": "Devolución parcial", "precioUnitario": 150.00 }
  ]
}

Los campos de dteOriginal se describen en Estructura del DTE. En id se envía el número de autorización SAT del original o, en régimen antiguo o papel, su número de documento.

notaAbono

Registra un abono/pago aplicado sobre una factura cambiaria. Sólo Guatemala.

{
  "tipo": "notaAbono",
  "receptor": {
    "id": "CF",
    "nombre": "Cliente Ejemplo, S.A."
  },
  "items": [
    { "descripcion": "Abono mensual", "precioUnitario": 500.00 }
  ]
}

La referencia a un documento original es opcional en notaAbono. Se aceptan todas las combinaciones y lo enviado se conserva, se devuelve en la respuesta y aparece en la sección de complemento “Documento original” del PDF:

idDteOriginal: se busca en Fegora y el bloque dteOriginal de la respuesta se llena con los datos del original. Si no se encuentra no es error: se usa el bloque dteOriginal enviado por el cliente (si lo hay) o, si no, la respuesta no trae bloque.
dteOriginal sin idDteOriginal: se usa tal cual (por ejemplo, un original fuera de Fegora o de régimen antiguo).
motivoAjuste: opcional; se conserva aunque no haya ninguna referencia.

Ejemplo con un original de régimen antiguo:

{
  "tipo": "notaAbono",
  "motivoAjuste": "Abono a factura cambiaria",
  "dteOriginal": {
    "id": "6789",
    "serie": "B",
    "numero": 6789,
    "fechaEmision": "2019-03-10",
    "tipo": "facturaCambiaria",
    "total": 5000.00,
    "esRegimenAntiguo": true
  },
  "items": [
    { "descripcion": "Abono mensual", "precioUnitario": 500.00 }
  ]
}

Fragmento de la respuesta:

{
  "tipo": "notaAbono",
  "motivoAjuste": "Abono a factura cambiaria",
  "dteOriginal": {
    "id": "6789",
    "serie": "B",
    "numero": 6789,
    "fechaEmision": "2019-03-10T00:00:00",
    "tipo": "facturaCambiaria",
    "total": 5000.00
  }
}

En la nota de abono la referencia es informativa (respuesta JSON y PDF). A diferencia de notaCredito/notaDebito, no agrega el complemento ReferenciasNota al XML enviado a SAT y la nota no hereda la condición de exención de IVA ni de exportación del original.

Los ítems de una nota de abono no llevan línea de IVA (items[].impuestos queda vacío) — igual que en recibo y reciboDonacion, ya que estos tres tipos no representan una venta gravada nueva.

Recibos

Ambos tipos de recibo son exclusivos de Guatemala; ni El Salvador ni República Dominicana los soportan.

recibo

Cobros exentos de IVA que no corresponden a venta de bienes/servicios — por ejemplo cuotas, colegiaturas o membresías.

{
  "tipo": "recibo",
  "motivoExencionIva": "LEY_IVA_ART8_NUM1",
  "receptor": {
    "id": "CF",
    "nombre": "Padre de Familia Ejemplo"
  },
  "items": [
    { "descripcion": "Colegiatura mensual", "precioUnitario": 850.00 }
  ]
}

Todo recibo necesita un motivoExencionIva: la SAT exige la frase de exención de IVA en este tipo y el motivo depende del emisor, así que Fegora no puede asignar uno fijo (a diferencia de reciboDonacion). Orden de resolución:

El motivoExencionIva enviado en el documento.
Si no se envía, el motivo por defecto de la cuenta (motivoExencionIva de su información fiscal), aunque la cuenta no esté marcada como exenta — así una cuenta que factura con IVA puede emitir recibos exentos.
Si no hay ninguno, la solicitud se rechaza antes de certificar con FEG_DTE_CREA_RECI_001.

En un recibo la SAT sólo acepta tres motivos: LEY_IVA_ART8_NUM1 (colegiaturas, 4-8), LEY_IVA_ART7_NUM10 (cuotas de asociaciones y colegios profesionales, 4-5) y LEY_IVA_ART7_NUM13 (servicios de entidades no lucrativas, 4-6). Cualquier otro lo rechaza el certificador con FEL_RCP328.

reciboDonacion

Donaciones recibidas, exentas de IVA por ley. Fegora asigna automáticamente motivoExencionIva: "LEY_IVA_ART7_NUM9" (frase SAT 4-4) sin que el cliente deba declararlo. Campo adicional requerido: el documento debe declarar el tipo de personería jurídica del donante en datosAdicionales:

{
  "tipo": "reciboDonacion",
  "receptor": {
    "id": "CF",
    "nombre": "Donante Ejemplo"
  },
  "datosAdicionales": [
    { "nombre": "TIPO_PERSONERIA", "valor": "719" }
  ],
  "items": [
    { "descripcion": "Donación recibida", "precioUnitario": 1000.00 }
  ]
}

TIPO_PERSONERIA usa un código numérico del catálogo de personerías jurídicas de la SAT (no un texto como "INDIVIDUAL"/"JURIDICA") — el código exacto depende de la personería registrada para la cuenta emisora. Vea Guatemala.

Campos obligatorios adicionales por tipo — resumen

`tipo`	Campos adicionales obligatorios
`notaCredito`, `notaDebito`	`motivoAjuste` y (`idDteOriginal` o `dteOriginal`)
`facturaExportacion` / `esExportacion: true`	`datosExportacion.nombreConsignatario`, `datosExportacion.direccionConsignatario`
`reciboDonacion`	`datosAdicionales[TIPO_PERSONERIA]`
`recibo`	`motivoExencionIva` explícito (recomendado; no forzado por el validador — ver advertencia arriba)
`factura` en El Salvador (CCF)	`receptor.datosAdicionales[MH_NRC]`, `receptor.datosAdicionales[MH_CODIGO_ACTIVIDAD]`, `datosAdicionales[NUMERO_SECUENCIAL]`

Para el detalle de impuestos y exenciones aplicables a cada tipo, vea Impuestos.

Introducción

Documentos DTE

Guías por país

Tipos de documento

Catálogo por país

Facturas

factura (por defecto)

facturaCambiaria

facturaEspecial

facturaExportacion (o esExportacion: true)

Notas

notaCredito / notaDebito

notaAbono

Recibos

recibo

reciboDonacion

Campos obligatorios adicionales por tipo — resumen

​Catálogo por país

​Facturas

​factura (por defecto)

​facturaCambiaria

​facturaEspecial

​facturaExportacion (o esExportacion: true)

​Notas

​notaCredito / notaDebito

​notaAbono

​Recibos

​recibo

​reciboDonacion

​Campos obligatorios adicionales por tipo — resumen

Catálogo por país

Facturas

factura (por defecto)

facturaCambiaria

facturaEspecial

facturaExportacion (o esExportacion: true)

Notas

notaCredito / notaDebito

notaAbono

Recibos

recibo

reciboDonacion

Campos obligatorios adicionales por tipo — resumen