Crear (y certificar) un DTE

curl --request POST \
  --url https://api.fegora.com/dte \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "descripcion": "Audifonos Bose NB-75",
      "precioUnitario": 500
    }
  ]
}
'

{
  "id": "2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220",
  "serie": "2AF7AD7C",
  "numero": 1237666796,
  "tipo": "factura",
  "fechaEmision": "2026-03-01T01:26:44.749",
  "fechaCertificacion": "2026-03-01T07:26:56",
  "estado": "Certificado",
  "anulado": false,
  "esExentoIva": false,
  "total": 500,
  "moneda": "GTQ",
  "estaEnAmbienteDePruebas": true,
  "idCuenta": "12345678",
  "idCanal": 1,
  "canal": {
    "id": 1,
    "nombre": "API",
    "nombreCorto": "api"
  },
  "emisor": {
    "id": "12345678",
    "nombre": "PRUEBAS FEL -SAN MIGUEL, S.A.",
    "nombreComercial": "PRUEBAS FEL",
    "esExentoIva": false,
    "esRetenedorIva": false,
    "afiliacionIva": "GENERAL",
    "afiliacionIsr": "ISR_OPCIONAL_SIMPLIFICADO_SOBRE_INGRESOS_ACTIVIDADES_LUCRATIVAS",
    "codigoEstablecimiento": "1",
    "direccion": {
      "direccion": "Ruta 8 3-65 Zona 4 Guatemala",
      "municipio": "Guatemala",
      "departamento": "Guatemala",
      "codigoPostal": "01004",
      "pais": "GT"
    }
  },
  "receptor": {
    "id": "CF",
    "nombre": "DISTRIBUIDORA DETODO 3-51, SOCIEDAD ANONIMA",
    "direccion": {
      "direccion": "2a CALLE 3-51 ZONA 9 GUATEMALA",
      "municipio": "Guatemala",
      "departamento": "Guatemala",
      "codigoPostal": "00100",
      "pais": "GT"
    }
  },
  "items": [
    {
      "cantidad": 1,
      "descripcion": "Audifonos Bose NB-75",
      "tipo": "bien",
      "unidadMedida": "uni",
      "precioUnitario": 500,
      "precio": 500,
      "descuento": 0,
      "otroDescuento": 0,
      "total": 500,
      "impuestos": [
        {
          "nombreCorto": "IVA",
          "codigoUnidadGravable": 1,
          "cantidadUnidadesGravables": 0,
          "montoGravable": 446.4286,
          "montoImpuesto": 53.5714
        }
      ]
    }
  ],
  "datosAdicionales": [
    {
      "nombre": "SAT-1-2",
      "valor": "Sujeto a retención definitiva ISR",
      "etiqueta": "",
      "visible": true
    }
  ],
  "certificador": {
    "id": "12345678",
    "nombre": "Certificador de Pruebas, S.A.",
    "nombreComercial": "Certificador de Pruebas"
  },
  "archivoPdfUri": "https://cdn.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220.pdf",
  "archivoXmlUri": "https://cdn.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220.xml",
  "dteUri": "https://www.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220"
}

POST

https://api.fegora.com

dte

curl --request POST \
  --url https://api.fegora.com/dte \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "descripcion": "Audifonos Bose NB-75",
      "precioUnitario": 500
    }
  ]
}
'

{
  "id": "2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220",
  "serie": "2AF7AD7C",
  "numero": 1237666796,
  "tipo": "factura",
  "fechaEmision": "2026-03-01T01:26:44.749",
  "fechaCertificacion": "2026-03-01T07:26:56",
  "estado": "Certificado",
  "anulado": false,
  "esExentoIva": false,
  "total": 500,
  "moneda": "GTQ",
  "estaEnAmbienteDePruebas": true,
  "idCuenta": "12345678",
  "idCanal": 1,
  "canal": {
    "id": 1,
    "nombre": "API",
    "nombreCorto": "api"
  },
  "emisor": {
    "id": "12345678",
    "nombre": "PRUEBAS FEL -SAN MIGUEL, S.A.",
    "nombreComercial": "PRUEBAS FEL",
    "esExentoIva": false,
    "esRetenedorIva": false,
    "afiliacionIva": "GENERAL",
    "afiliacionIsr": "ISR_OPCIONAL_SIMPLIFICADO_SOBRE_INGRESOS_ACTIVIDADES_LUCRATIVAS",
    "codigoEstablecimiento": "1",
    "direccion": {
      "direccion": "Ruta 8 3-65 Zona 4 Guatemala",
      "municipio": "Guatemala",
      "departamento": "Guatemala",
      "codigoPostal": "01004",
      "pais": "GT"
    }
  },
  "receptor": {
    "id": "CF",
    "nombre": "DISTRIBUIDORA DETODO 3-51, SOCIEDAD ANONIMA",
    "direccion": {
      "direccion": "2a CALLE 3-51 ZONA 9 GUATEMALA",
      "municipio": "Guatemala",
      "departamento": "Guatemala",
      "codigoPostal": "00100",
      "pais": "GT"
    }
  },
  "items": [
    {
      "cantidad": 1,
      "descripcion": "Audifonos Bose NB-75",
      "tipo": "bien",
      "unidadMedida": "uni",
      "precioUnitario": 500,
      "precio": 500,
      "descuento": 0,
      "otroDescuento": 0,
      "total": 500,
      "impuestos": [
        {
          "nombreCorto": "IVA",
          "codigoUnidadGravable": 1,
          "cantidadUnidadesGravables": 0,
          "montoGravable": 446.4286,
          "montoImpuesto": 53.5714
        }
      ]
    }
  ],
  "datosAdicionales": [
    {
      "nombre": "SAT-1-2",
      "valor": "Sujeto a retención definitiva ISR",
      "etiqueta": "",
      "visible": true
    }
  ],
  "certificador": {
    "id": "12345678",
    "nombre": "Certificador de Pruebas, S.A.",
    "nombreComercial": "Certificador de Pruebas"
  },
  "archivoPdfUri": "https://cdn.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220.pdf",
  "archivoXmlUri": "https://cdn.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220.xml",
  "dteUri": "https://www.fegora.com/dtes/2AF7AD7C-49C5-4BEC-95CD-BCD04BECE220"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Cuerpo de la solicitud para crear (y, por defecto, certificar) un DTE. La cuenta emisora determina el país y la mayoría de los datos fiscales — sólo se envían los campos estrictamente necesarios para la operación comercial.

items

object[]

required

Debe incluir al menos un item.

Minimum array length: 1

Show child attributes

idCuenta

string

NIT de la cuenta emisora. Opcional si el usuario autenticado tiene una sola cuenta asignada; en ese caso se infiere. Requerido si tiene varias.

tipo

enum<string>

default:factura

Tipo de documento. No distingue mayúsculas/minúsculas. ticket sólo es válido para cuentas de El Salvador o República Dominicana (Guatemala lo rechaza). Una factura con abonosPactados se certifica automáticamente como factura cambiaria. Correspondencia por país — El Salvador: ticket → Factura (DTE-01), factura → Comprobante de Crédito Fiscal / CCF (DTE-03), notaCredito → DTE-05, notaDebito → DTE-06, facturaExportacion → FEX (DTE-11), facturaEspecial → Factura de Sujeto Excluido / FSE (DTE-14). República Dominicana: factura → Factura de Crédito Fiscal Electrónica (e-CF 31), ticket → Factura de Consumo Electrónica (e-CF 32), notaDebito → e-CF 33, notaCredito → e-CF 34, facturaExportacion → Comprobante de Exportaciones (e-CF 46).

Available options:

factura,

ticket,

facturaEspecial,

facturaCambiaria,

facturaExportacion,

notaCredito,

notaDebito,

notaAbono,

recibo,

reciboDonacion

serie

string

Ignorado en la práctica: la serie la asigna el certificador. Sólo tiene efecto al importar documentos ya certificados.

Maximum string length: 10

numero

integer<int64>

Ignorado en la práctica: el número lo asigna el certificador.

numeroAcceso

integer

Número de acceso de contingencia (9 dígitos), sólo para documentos emitidos originalmente sin conexión. Ver la guía de casos especiales.

fechaEmision

string

Fecha (y opcionalmente hora) de emisión. Formatos: 2026-03-06, 2026-03-06T08:22, 2026-03-06T08:22:26. Por defecto, la fecha/hora actual.

Examples:

"2026-03-06"

"2026-03-06T08:22:26"

emisor

object

Emisor del documento. Es opcional y normalmente NO se envía: Fegora completa todos los datos fiscales desde la configuración de la cuenta emisora. Sólo codigoEstablecimiento y codigoPuntoVenta pueden sobrescribirse por solicitud.

Show child attributes

receptor

object

Receptor del documento, enviado en la solicitud. Es opcional: si se omite (o se omiten nit/nombre), Fegora asume Consumidor Final (CF / CONSUMIDOR FINAL). En notas de crédito/débito sin receptor explícito, se hereda el receptor del documento original. El campo de identificación se llama nit por razones históricas, pero admite el identificador fiscal que corresponda por país: NIT (GT/SV), RNC (DO), DUI/pasaporte/carné de residente (SV). También se acepta id como alias de nit.

Show child attributes

moneda

enum<string>

default:GTQ

Código ISO 4217. No distingue mayúsculas/minúsculas en la solicitud (se normaliza a mayúsculas). Si se omite, se usa la moneda por defecto de la cuenta (GTQ en Guatemala, USD en El Salvador, DOP en República Dominicana) — por eso las cuentas dominicanas normalmente NO envían este campo: DOP llega por el valor por defecto de la cuenta.

Available options:

GTQ,

USD,

EUR,

MXN,

HNL,

SVC,

NIO,

CRC,

PAB,

BZD

forzarAmbientePruebas

boolean

Si no se envía, se usa el ambiente configurado en la cuenta.

numeroTransaccion

string

Identificador de idempotencia propio del cliente. Un valor repetido para la misma cuenta produce FEG_DTE_CREA_001.

idDteOriginal

string<uuid>

Id de Fegora del documento original. En notaCredito/notaDebito se exige este campo o dteOriginal; si se envía y no existe se rechaza con FEG_DTE_CREA_010. En notaAbono es opcional: si no se encuentra no es error y se usa el bloque dteOriginal enviado (si lo hay).

motivoAjuste

string

Motivo del ajuste. Requerido en notas de crédito/débito; opcional en notaAbono (se conserva aunque no haya referencia).

dteOriginal

object

Documento original de referencia enviado en la solicitud. Se usa tal cual, sin búsqueda en Fegora (para originales que no están en Fegora o de régimen antiguo). En notaCredito/notaDebito alimenta el complemento ReferenciasNota; en notaAbono es informativo (respuesta JSON y PDF). Los números y booleanos se aceptan también como texto.

Show child attributes

motivoExencionIva

enum<string>

Código de motivo de exención de IVA (catálogo SAT). Ver la guía de impuestos para la tabla completa de motivos y sus frases asociadas.

Available options:

LEY_IVA_ART7_NUM2,

LEY_IVA_ART7_NUM3,

LEY_IVA_ART7_NUM4,

LEY_IVA_ART7_NUM5,

LEY_IVA_ART7_NUM6,

LEY_IVA_ART7_NUM9,

LEY_IVA_ART7_NUM10,

LEY_IVA_ART7_NUM11,

LEY_IVA_ART7_NUM12,

LEY_IVA_ART7_NUM13,

LEY_IVA_ART7_NUM14,

LEY_IVA_ART7_NUM15,

LEY_IVA_ART7_A,

LEY_IVA_ART7_C,

LEY_IVA_ART7_D,

LEY_IVA_ART7_G,

LEY_IVA_ART7_H_I,

LEY_IVA_ART8,

LEY_IVA_ART8_NUM1,

LEY_IVA_ART8_NUM2,

LEY_IVA_ART55,

LEY_IVA_ART3_NUM7,

LEY_IVA_ART4,

DEC_29_89,

DEC_65_89,

LEY_ZOLIC_ART31,

LEY_ZOLIC_ART32_C,

LEY_FORT_EMPRE_ART35,

CONTRIBUYENTE_EXENTO,

OTROS_CARGOS_NO_SUJETOS_IVA,

FACT_ORIGEN_NO_INC_IVA,

SERVICIOS_NO_AFECTOS

esExentoIva

boolean

Si se omite, hereda el valor de exención configurado en la cuenta emisora.

esExportacion

boolean

Marca el documento como factura de exportación. Requiere datosExportacion. La exención de IVA se calcula automáticamente.

datosExportacion

object

Datos de exportación (Guatemala). Obligatorio cuando esExportacion: true o tipo: "facturaExportacion". Una factura de exportación queda exenta de IVA automáticamente (frase 4-1, LEY_IVA_ART7_NUM2) — no debe enviarse motivoExencionIva ni calcular el IVA manualmente.

Show child attributes

abonosPactados

object[]

Plan de abonos (factura cambiaria en Guatemala; formas de pago en El Salvador/República Dominicana).

Show child attributes

datosAdicionales

object[]

Pares nombre/valor de paso libre, específicos por país. El Salvador y República Dominicana: NUMERO_SECUENCIAL (obligatorio — número correlativo del rango autorizado por MH/DGII). República Dominicana adicionalmente: VENCIMIENTO_NUMERO_SECUENCIAL (fecha de vencimiento del rango NCF, formato yyyy-MM-dd). Guatemala: cualquier leyenda propia del emisor (garantías, condiciones de pago, etc.).

Show child attributes

autoCertify

boolean

default:true

Si es false, Fegora NO certifica el documento — y por lo tanto tampoco lo persiste (no hay DTE que consultar luego). En la práctica, se deja siempre en true.

autoSign

boolean

default:true

generateFiles

boolean

default:true

Response

DTE creado y certificado.

Documento certificado, tal como lo devuelve Fegora al crear, consultar o anular un DTE. Los campos de fecha se devuelven generalmente en hora local del país del emisor, sin offset de zona horaria (formato yyyy-MM-ddTHH:mm:ss[.fffffff]); algunos campos puntuales (bitácora, fechas de certificación en ciertos países) pueden llevar sufijo Z u offset explícito.

string<uuid>

required

Identificador del documento. Es el número de autorización asignado por el certificador (SAT en Guatemala; codigoGeneracion en El Salvador; identificador Digifact en República Dominicana).

serie

string

required

numero

integer<int64>

required

tipo

enum<string>

required

Available options:

factura,

ticket,

facturaEspecial,

facturaCambiaria,

facturaExportacion,

notaCredito,

notaDebito,

notaAbono,

recibo,

reciboDonacion

fechaEmision

string

required

estado

enum<string>

required

Available options:

Certificado,

Anulado

total

number<double>

required

moneda

string

required

emisor

object

required

Representación de emisor o receptor tal como aparece en la respuesta de un DTE, con los datos fiscales resueltos por Fegora.

Show child attributes

receptor

object

required

Representación de emisor o receptor tal como aparece en la respuesta de un DTE, con los datos fiscales resueltos por Fegora.

Show child attributes

idCuenta

string

required

items

object[]

required

Show child attributes

fechaCertificacion

string

numeroAcceso

integer

Número de acceso de contingencia. Omitido salvo que el documento se haya emitido en contingencia — no confundir con el id (número de autorización).

anulado

boolean

esExentoIva

boolean

motivoExencionIva

string

esExportacion

boolean

Omitido cuando es false.

estaEnAmbienteDePruebas

boolean

idCanal

integer

canal

object

Canal de emisión de la cuenta (por defecto, canal API).

Show child attributes

idDteOriginal

string<uuid>

motivoAjuste

string

numeroTransaccion

string

dteOriginal

object

Resumen del documento original referenciado por una nota de crédito/débito/abono. Fechas en hora local del emisor, sin offset de zona horaria.

Show child attributes

certificador

object

Show child attributes

selloEntidadFiscal

string

Sello/firma visual del certificador.

verificacionCertificadorUri

string

verificacionCertificadorQrBase64

string

datosExportacion

object

Show child attributes

retencionesFacturaEspecial

object

Retenciones de Factura Especial (Guatemala): ISR 5% + IVA retenido. Sólo presente para tipo: "facturaEspecial".

Show child attributes

abonosPactados

object[]

Show child attributes

datosAnulacion

object

Bloque de anulación que se incluye en la respuesta de un DTE anulado. Fechas en hora local del emisor, sin offset de zona horaria.

Show child attributes

archivoPdfUri

string

Se genera de forma diferida — puede estar ausente hasta el primer GET /dte/{id}/pdf.

archivoXmlUri

string

archivoJsonUri

string

Presente sólo para certificadores que devuelven el documento certificado en JSON (El Salvador).

dteUri

string

datosAdicionales

object[]

Show child attributes

recursos

object[]

Show child attributes

bitacora

object[]

Show child attributes

fechaCreacion

string

Comenzar

Endpoints

Crear (y certificar) un DTE

Authorizations

Body

Response