{
"codigo": "FEG_NOT_FOUND",
"mensaje": "Entity \"Dte\" (2AF7AD7C-...) was not found.",
"masInformacion": "https://developer.fegora.com",
"severidad": 2
}
DTE
Obtener un DTE por id
El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.
GET
https://api.fegora.com
/
dte
/
{id}
Obtener un DTE por id
curl --request GET \ --url https://api.fegora.com/dte/{id}
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.
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).
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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Fegora","description":"Documentación de Fegora — facturación electrónica para Guatemala, El Salvador y República Dominicana","colors":{"primary":"#df6200","light":"#f77f20","dark":"#ba4b00"},"logo":{"light":"https://mintcdn.com/fegora/SKovB_knYtaf-5od/logo/light.svg?fit=max\u0026auto=format\u0026n=SKovB_knYtaf-5od\u0026q=85\u0026s=2bf68866cce62cdff1a18262d62675f2","dark":"https://mintcdn.com/fegora/SKovB_knYtaf-5od/logo/dark.svg?fit=max\u0026auto=format\u0026n=SKovB_knYtaf-5od\u0026q=85\u0026s=f0365453151d88decd5bb6e772933cee","href":"https://www.fegora.com"},"favicon":"https://mintcdn.com/fegora/SKovB_knYtaf-5od/favicon.svg?fit=max\u0026auto=format\u0026n=SKovB_knYtaf-5od\u0026q=85\u0026s=caf73665261e415f66c35e28ddfd9a0c","api":{"openapi":"api-reference/openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python"]},"url":"full"},"appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Iniciar sesión","href":"https://www.fegora.com/login"}},"footer":{"socials":{"website":"https://www.fegora.com"}},"search":{"prompt":"Buscar en la documentación..."},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","claude","chatgpt"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fegora","hasAudioNarration":false,"actualSubdomain":"fegora","customDomains":["docs.fegora.com"],"gitSource":{"type":"github","owner":"tostil","repo":"fegora-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adff3aaa4ee73f0fec772ba","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":41},{"language":"default","tag":"Endpoints","count":40},{"language":"default","tag":"Documentación","count":18},{"language":"default","tag":"DTE","count":14},{"language":"default","tag":"Documentos DTE","count":10},{"language":"default","tag":"Guía de usuario","count":8},{"language":"default","tag":"Catálogos","count":6},{"language":"default","tag":"Cuentas","count":6},{"language":"default","tag":"DTE Recibidos","count":6},{"language":"default","tag":"Introducción","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/dte/obtener-un-dte-por-id","slug":"/api-reference/dte/obtener-un-dte-por-id","pageMetadata":{"title":"Obtener un DTE por id","description":"El `{id}` es el número de autorización del documento (el mismo `id` devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/{id}","href":"/api-reference/dte/obtener-un-dte-por-id","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"El \", _jsx(_components.code, {\n children: \"{id}\"\n }), \" es el número de autorización del documento (el mismo \", _jsx(_components.code, {\n children: \"id\"\n }), \" devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Obtener un DTE por id","description":"El `{id}` es el número de autorización del documento (el mismo `id` devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/{id}","href":"/api-reference/dte/obtener-un-dte-por-id","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["DTE"],"summary":"Obtener un DTE por id","description":"El `{id}` es el número de autorización del documento (el mismo `id` devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.","security":[],"parameters":["697a8ac9-dd72-46b4-a7ba-aa7f16fcf9f9"],"responses":{"200":"dcf1c623-199d-4a6d-aa4a-82094393c6b5","404":"e788da48-e514-4b27-b14b-5464e8ce46f6"},"operationId":"getDteByid","method":"get","type":"path","servers":["1691aec7-6ffa-4b59-848f-39766da40a49"],"path":"/dte/{id}","baseUrlOptions":["https://api.fegora.com"],"title":"Obtener un DTE por id","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"697a8ac9-dd72-46b4-a7ba-aa7f16fcf9f9":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"dcf1c623-199d-4a6d-aa4a-82094393c6b5":{"description":"Documento encontrado.","content":{"application/json":{"schema":{"type":"object","description":"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.","properties":{"id":{"type":"string","format":"uuid","description":"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).","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"serie":{"type":"string","isRequired":true,"uniqueKey":"serie","typeLabel":"string"},"numero":{"type":"integer","format":"int64","isRequired":true,"uniqueKey":"numero","typeLabel":"integer\u003cint64>"},"tipo":{"type":"string","enum":["factura","ticket","facturaEspecial","facturaCambiaria","facturaExportacion","notaCredito","notaDebito","notaAbono","recibo","reciboDonacion"],"isRequired":true,"uniqueKey":"tipo","typeLabel":"enum\u003cstring>"},"fechaEmision":{"type":"string","isRequired":true,"uniqueKey":"fechaEmision","typeLabel":"string"},"estado":{"type":"string","enum":["Certificado","Anulado"],"isRequired":true,"uniqueKey":"estado","typeLabel":"enum\u003cstring>"},"total":{"type":"number","format":"double","isRequired":true,"uniqueKey":"total","typeLabel":"number\u003cdouble>"},"moneda":{"type":"string","isRequired":true,"uniqueKey":"moneda","typeLabel":"string"},"emisor":{"type":"object","description":"Representación de emisor o receptor tal como aparece en la respuesta de un DTE, con los datos fiscales resueltos por Fegora.","properties":{"id":{"type":"string","description":"NIT / RNC / identificador fiscal.","isRequired":true,"uniqueKey":"emisor.id","typeLabel":"string"},"nombre":{"type":"string","isRequired":true,"uniqueKey":"emisor.nombre","typeLabel":"string"},"nombreComercial":{"type":"string","uniqueKey":"emisor.nombreComercial","typeLabel":"string"},"tipoId":{"type":"string","uniqueKey":"emisor.tipoId","typeLabel":"string"},"tipoEstablecimiento":{"type":"string","uniqueKey":"emisor.tipoEstablecimiento","typeLabel":"string"},"esExentoIva":{"type":"boolean","uniqueKey":"emisor.esExentoIva","typeLabel":"boolean"},"esRetenedorIva":{"type":"boolean","uniqueKey":"emisor.esRetenedorIva","typeLabel":"boolean"},"direccion":{"type":"object","description":"Dirección física. Se usa tanto para el emisor/establecimiento como para el receptor. `pais` acepta el código ISO 3166-1 alfa-2 (`GT`, `SV`, `DO`); por compatibilidad legacy el valor por defecto interno es la cadena literal `GUATEMALA`, pero se recomienda enviar siempre el código de 2 letras.","properties":{"direccion":{"type":"string","maxLength":500,"description":"Dirección en texto libre. Opcional — un receptor Consumidor Final típicamente no la incluye.","uniqueKey":"emisor.direccion.direccion","typeLabel":"string"},"municipio":{"type":"string","uniqueKey":"emisor.direccion.municipio","typeLabel":"string"},"departamento":{"type":"string","uniqueKey":"emisor.direccion.departamento","typeLabel":"string"},"idMunicipio":{"type":"string","description":"Código de localidad del municipio (ver `GET /localidad`). En El Salvador usa el formato `SV.\u003cdepartamento>.\u003cmunicipio>`, p. ej. `SV.SS.23` (San Salvador).","uniqueKey":"emisor.direccion.idMunicipio","typeLabel":"string"},"idDepartamento":{"type":"string","description":"Código de localidad del departamento (ver `GET /localidad`).","uniqueKey":"emisor.direccion.idDepartamento","typeLabel":"string"},"codigoPostal":{"type":"string","description":"Para Guatemala, cuando `pais` es exactamente `GUATEMALA`, debe tener 5 dígitos. Si se omite en el receptor, Fegora usa `01001` por defecto.","uniqueKey":"emisor.direccion.codigoPostal","typeLabel":"string"},"pais":{"type":"string","description":"Código o nombre de país.","examples":["GT","SV","DO"],"uniqueKey":"emisor.direccion.pais","typeLabel":"string"}},"uniqueKey":"emisor.direccion","typeLabel":"object"},"direccionCorreoElectronico":{"type":"string","uniqueKey":"emisor.direccionCorreoElectronico","typeLabel":"string"},"afiliacionIva":{"type":"string","uniqueKey":"emisor.afiliacionIva","typeLabel":"string"},"afiliacionIsr":{"type":"string","uniqueKey":"emisor.afiliacionIsr","typeLabel":"string"},"codigoEstablecimiento":{"type":"string","uniqueKey":"emisor.codigoEstablecimiento","typeLabel":"string"},"codigoPuntoVenta":{"type":"string","description":"Código de punto de venta (El Salvador).","uniqueKey":"emisor.codigoPuntoVenta","typeLabel":"string"},"datosAdicionales":{"type":"array","items":{"type":"object","description":"Dato adicional tal como se refleja en la respuesta: incluye `etiqueta` (para representación gráfica) y `visible`, calculados por Fegora a partir de lo enviado y de las frases/legales automáticas (p. ej. `SAT-4-1`).","properties":{"nombre":{"type":"string","isRequired":true,"uniqueKey":"emisor.datosAdicionales.items.[INDEX].nombre","typeLabel":"string"},"valor":{"oneOf":[{"type":"string","uniqueKey":"emisor.datosAdicionales.items.[INDEX].valor.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"emisor.datosAdicionales.items.[INDEX].valor.oneOf.1","typeLabel":"null"}],"uniqueKey":"emisor.datosAdicionales.items.[INDEX].valor","typeLabel":"string | null"},"etiqueta":{"type":"string","description":"Etiqueta sugerida para mostrar en una representación gráfica (PDF). Vacía para frases SAT y leyendas automáticas.","uniqueKey":"emisor.datosAdicionales.items.[INDEX].etiqueta","typeLabel":"string"},"visible":{"type":"boolean","description":"Si debe mostrarse en una representación gráfica (PDF).","uniqueKey":"emisor.datosAdicionales.items.[INDEX].visible","typeLabel":"boolean"}},"required":["nombre"],"uniqueKey":"emisor.datosAdicionales.items.[INDEX]","typeLabel":"object"},"description":"Omitido cuando no hay datos adicionales.","uniqueKey":"emisor.datosAdicionales","typeLabel":"object[]"}},"required":["id","nombre"],"isRequired":true,"uniqueKey":"emisor","typeLabel":"object"},"receptor":{"type":"object","description":"Representación de emisor o receptor tal como aparece en la respuesta de un DTE, con los datos fiscales resueltos por Fegora.","properties":{"id":{"type":"string","description":"NIT / RNC / identificador fiscal.","isRequired":true,"uniqueKey":"receptor.id","typeLabel":"string"},"nombre":{"type":"string","isRequired":true,"uniqueKey":"receptor.nombre","typeLabel":"string"},"nombreComercial":{"type":"string","uniqueKey":"receptor.nombreComercial","typeLabel":"string"},"tipoId":{"type":"string","uniqueKey":"receptor.tipoId","typeLabel":"string"},"tipoEstablecimiento":{"type":"string","uniqueKey":"receptor.tipoEstablecimiento","typeLabel":"string"},"esExentoIva":{"type":"boolean","uniqueKey":"receptor.esExentoIva","typeLabel":"boolean"},"esRetenedorIva":{"type":"boolean","uniqueKey":"receptor.esRetenedorIva","typeLabel":"boolean"},"direccion":{"type":"object","description":"Dirección física. Se usa tanto para el emisor/establecimiento como para el receptor. `pais` acepta el código ISO 3166-1 alfa-2 (`GT`, `SV`, `DO`); por compatibilidad legacy el valor por defecto interno es la cadena literal `GUATEMALA`, pero se recomienda enviar siempre el código de 2 letras.","properties":{"direccion":{"type":"string","maxLength":500,"description":"Dirección en texto libre. Opcional — un receptor Consumidor Final típicamente no la incluye.","uniqueKey":"receptor.direccion.direccion","typeLabel":"string"},"municipio":{"type":"string","uniqueKey":"receptor.direccion.municipio","typeLabel":"string"},"departamento":{"type":"string","uniqueKey":"receptor.direccion.departamento","typeLabel":"string"},"idMunicipio":{"type":"string","description":"Código de localidad del municipio (ver `GET /localidad`). En El Salvador usa el formato `SV.\u003cdepartamento>.\u003cmunicipio>`, p. ej. `SV.SS.23` (San Salvador).","uniqueKey":"receptor.direccion.idMunicipio","typeLabel":"string"},"idDepartamento":{"type":"string","description":"Código de localidad del departamento (ver `GET /localidad`).","uniqueKey":"receptor.direccion.idDepartamento","typeLabel":"string"},"codigoPostal":{"type":"string","description":"Para Guatemala, cuando `pais` es exactamente `GUATEMALA`, debe tener 5 dígitos. Si se omite en el receptor, Fegora usa `01001` por defecto.","uniqueKey":"receptor.direccion.codigoPostal","typeLabel":"string"},"pais":{"type":"string","description":"Código o nombre de país.","examples":["GT","SV","DO"],"uniqueKey":"receptor.direccion.pais","typeLabel":"string"}},"uniqueKey":"receptor.direccion","typeLabel":"object"},"direccionCorreoElectronico":{"type":"string","uniqueKey":"receptor.direccionCorreoElectronico","typeLabel":"string"},"afiliacionIva":{"type":"string","uniqueKey":"receptor.afiliacionIva","typeLabel":"string"},"afiliacionIsr":{"type":"string","uniqueKey":"receptor.afiliacionIsr","typeLabel":"string"},"codigoEstablecimiento":{"type":"string","uniqueKey":"receptor.codigoEstablecimiento","typeLabel":"string"},"codigoPuntoVenta":{"type":"string","description":"Código de punto de venta (El Salvador).","uniqueKey":"receptor.codigoPuntoVenta","typeLabel":"string"},"datosAdicionales":{"type":"array","items":{"type":"object","description":"Dato adicional tal como se refleja en la respuesta: incluye `etiqueta` (para representación gráfica) y `visible`, calculados por Fegora a partir de lo enviado y de las frases/legales automáticas (p. ej. `SAT-4-1`).","properties":{"nombre":{"type":"string","isRequired":true,"uniqueKey":"receptor.datosAdicionales.items.[INDEX].nombre","typeLabel":"string"},"valor":{"oneOf":[{"type":"string","uniqueKey":"receptor.datosAdicionales.items.[INDEX].valor.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"receptor.datosAdicionales.items.[INDEX].valor.oneOf.1","typeLabel":"null"}],"uniqueKey":"receptor.datosAdicionales.items.[INDEX].valor","typeLabel":"string | null"},"etiqueta":{"type":"string","description":"Etiqueta sugerida para mostrar en una representación gráfica (PDF). Vacía para frases SAT y leyendas automáticas.","uniqueKey":"receptor.datosAdicionales.items.[INDEX].etiqueta","typeLabel":"string"},"visible":{"type":"boolean","description":"Si debe mostrarse en una representación gráfica (PDF).","uniqueKey":"receptor.datosAdicionales.items.[INDEX].visible","typeLabel":"boolean"}},"required":["nombre"],"uniqueKey":"receptor.datosAdicionales.items.[INDEX]","typeLabel":"object"},"description":"Omitido cuando no hay datos adicionales.","uniqueKey":"receptor.datosAdicionales","typeLabel":"object[]"}},"required":["id","nombre"],"isRequired":true,"uniqueKey":"receptor","typeLabel":"object"},"idCuenta":{"type":"string","isRequired":true,"uniqueKey":"idCuenta","typeLabel":"string"},"items":{"type":"array","items":{"type":"object","description":"Item (línea de detalle) tal como se refleja en la respuesta, con los impuestos ya resueltos.","properties":{"cantidad":{"type":"number","format":"double","isRequired":true,"uniqueKey":"\\items.items.[INDEX].cantidad","typeLabel":"number\u003cdouble>"},"descripcion":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].descripcion","typeLabel":"string"},"unidadMedida":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].unidadMedida","typeLabel":"string"},"precioUnitario":{"type":"number","format":"double","isRequired":true,"uniqueKey":"\\items.items.[INDEX].precioUnitario","typeLabel":"number\u003cdouble>"},"total":{"type":"number","format":"double","isRequired":true,"uniqueKey":"\\items.items.[INDEX].total","typeLabel":"number\u003cdouble>"},"tipo":{"type":"string","enum":["bien","servicio"],"uniqueKey":"\\items.items.[INDEX].tipo","typeLabel":"enum\u003cstring>"},"precio":{"type":"number","format":"double","description":"Total de línea antes de descuento (precioUnitario × cantidad).","uniqueKey":"\\items.items.[INDEX].precio","typeLabel":"number\u003cdouble>"},"descuento":{"type":"number","format":"double","uniqueKey":"\\items.items.[INDEX].descuento","typeLabel":"number\u003cdouble>"},"otroDescuento":{"type":"number","format":"double","uniqueKey":"\\items.items.[INDEX].otroDescuento","typeLabel":"number\u003cdouble>"},"impuestos":{"type":"array","items":{"type":"object","description":"Línea de impuesto tal como se refleja en la respuesta (calculada o completada por Fegora a partir de lo enviado).","properties":{"nombreCorto":{"type":"string","enum":["IVA","ISR","IDP","ITH","ITP","TDP","IFB","MUN","IDB","OTRO"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX].nombreCorto","typeLabel":"enum\u003cstring>"},"montoGravable":{"type":"number","format":"double","isRequired":true,"uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX].montoGravable","typeLabel":"number\u003cdouble>"},"montoImpuesto":{"type":"number","format":"double","isRequired":true,"uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX].montoImpuesto","typeLabel":"number\u003cdouble>"},"codigoUnidadGravable":{"type":"integer","description":"Ver la nota de variación por país en `ImpuestoInput.codigoUnidadGravable`.","uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX].codigoUnidadGravable","typeLabel":"integer"},"cantidadUnidadesGravables":{"type":"number","format":"double","uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX].cantidadUnidadesGravables","typeLabel":"number\u003cdouble>"}},"required":["nombreCorto","montoGravable","montoImpuesto"],"uniqueKey":"\\items.items.[INDEX].impuestos.items.[INDEX]","typeLabel":"object"},"uniqueKey":"\\items.items.[INDEX].impuestos","typeLabel":"object[]"},"datosAdicionales":{"type":"array","items":{"type":"object","description":"Dato adicional tal como se refleja en la respuesta: incluye `etiqueta` (para representación gráfica) y `visible`, calculados por Fegora a partir de lo enviado y de las frases/legales automáticas (p. ej. `SAT-4-1`).","properties":{"nombre":{"type":"string","isRequired":true,"uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].nombre","typeLabel":"string"},"valor":{"oneOf":[{"type":"string","uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].valor.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].valor.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].valor","typeLabel":"string | null"},"etiqueta":{"type":"string","description":"Etiqueta sugerida para mostrar en una representación gráfica (PDF). Vacía para frases SAT y leyendas automáticas.","uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].etiqueta","typeLabel":"string"},"visible":{"type":"boolean","description":"Si debe mostrarse en una representación gráfica (PDF).","uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX].visible","typeLabel":"boolean"}},"required":["nombre"],"uniqueKey":"\\items.items.[INDEX].datosAdicionales.items.[INDEX]","typeLabel":"object"},"description":"Omitido cuando el item no tiene datos adicionales.","uniqueKey":"\\items.items.[INDEX].datosAdicionales","typeLabel":"object[]"}},"required":["cantidad","descripcion","unidadMedida","precioUnitario","total"],"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"fechaCertificacion":{"type":"string","uniqueKey":"fechaCertificacion","typeLabel":"string"},"numeroAcceso":{"type":"integer","description":"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).","uniqueKey":"numeroAcceso","typeLabel":"integer"},"anulado":{"type":"boolean","uniqueKey":"anulado","typeLabel":"boolean"},"esExentoIva":{"type":"boolean","uniqueKey":"esExentoIva","typeLabel":"boolean"},"motivoExencionIva":{"type":"string","uniqueKey":"motivoExencionIva","typeLabel":"string"},"esExportacion":{"type":"boolean","description":"Omitido cuando es `false`.","uniqueKey":"esExportacion","typeLabel":"boolean"},"estaEnAmbienteDePruebas":{"type":"boolean","uniqueKey":"estaEnAmbienteDePruebas","typeLabel":"boolean"},"idCanal":{"type":"integer","uniqueKey":"idCanal","typeLabel":"integer"},"canal":{"type":"object","description":"Canal de emisión de la cuenta (por defecto, canal API).","properties":{"id":{"type":"integer","uniqueKey":"canal.id","typeLabel":"integer"},"nombre":{"type":"string","uniqueKey":"canal.nombre","typeLabel":"string"},"nombreCorto":{"type":"string","uniqueKey":"canal.nombreCorto","typeLabel":"string"}},"uniqueKey":"canal","typeLabel":"object"},"idDteOriginal":{"type":"string","format":"uuid","uniqueKey":"idDteOriginal","typeLabel":"string\u003cuuid>"},"motivoAjuste":{"type":"string","uniqueKey":"motivoAjuste","typeLabel":"string"},"numeroTransaccion":{"type":"string","uniqueKey":"numeroTransaccion","typeLabel":"string"},"dteOriginal":{"type":"object","description":"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.","properties":{"id":{"type":"string","uniqueKey":"dteOriginal.id","typeLabel":"string"},"serie":{"type":"string","uniqueKey":"dteOriginal.serie","typeLabel":"string"},"numero":{"type":"integer","format":"int64","uniqueKey":"dteOriginal.numero","typeLabel":"integer\u003cint64>"},"fechaEmision":{"type":"string","uniqueKey":"dteOriginal.fechaEmision","typeLabel":"string"},"fechaCertificacion":{"type":"string","uniqueKey":"dteOriginal.fechaCertificacion","typeLabel":"string"},"tipo":{"type":"string","uniqueKey":"dteOriginal.tipo","typeLabel":"string"},"total":{"type":"number","format":"double","uniqueKey":"dteOriginal.total","typeLabel":"number\u003cdouble>"}},"uniqueKey":"dteOriginal","typeLabel":"object"},"certificador":{"type":"object","properties":{"id":{"type":"string","description":"NIT del certificador autorizado (Digifact, Infile, etc. en Guatemala; NUC en El Salvador/RD).","uniqueKey":"certificador.id","typeLabel":"string"},"nombre":{"type":"string","uniqueKey":"certificador.nombre","typeLabel":"string"},"nombreComercial":{"type":"string","uniqueKey":"certificador.nombreComercial","typeLabel":"string"},"esExentoIva":{"type":"boolean","uniqueKey":"certificador.esExentoIva","typeLabel":"boolean"},"esRetenedorIva":{"type":"boolean","uniqueKey":"certificador.esRetenedorIva","typeLabel":"boolean"}},"uniqueKey":"certificador","typeLabel":"object"},"selloEntidadFiscal":{"type":"string","description":"Sello/firma visual del certificador.","uniqueKey":"selloEntidadFiscal","typeLabel":"string"},"verificacionCertificadorUri":{"type":"string","uniqueKey":"verificacionCertificadorUri","typeLabel":"string"},"verificacionCertificadorQrBase64":{"type":"string","uniqueKey":"verificacionCertificadorQrBase64","typeLabel":"string"},"datosExportacion":{"type":"object","description":"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.","properties":{"nombreConsignatario":{"type":"string","isRequired":true,"uniqueKey":"datosExportacion.nombreConsignatario","typeLabel":"string"},"direccionConsignatario":{"type":"string","isRequired":true,"uniqueKey":"datosExportacion.direccionConsignatario","typeLabel":"string"},"codigoConsignatario":{"type":"string","uniqueKey":"datosExportacion.codigoConsignatario","typeLabel":"string"},"nombreComprador":{"type":"string","uniqueKey":"datosExportacion.nombreComprador","typeLabel":"string"},"direccionComprador":{"type":"string","uniqueKey":"datosExportacion.direccionComprador","typeLabel":"string"},"codigoComprador":{"type":"string","uniqueKey":"datosExportacion.codigoComprador","typeLabel":"string"},"otraReferencia":{"type":"string","uniqueKey":"datosExportacion.otraReferencia","typeLabel":"string"},"incoterm":{"type":"string","description":"Incoterm 2020. Ver https://www.tibagroup.com/mx/incoterms","enum":["EXW","FCA","CPT","CIP","DAP","DPU","DDP","FAS","FOB","CFR","CIF"],"uniqueKey":"datosExportacion.incoterm","typeLabel":"enum\u003cstring>"},"codigoExportador":{"type":"string","uniqueKey":"datosExportacion.codigoExportador","typeLabel":"string"},"nombreExportador":{"type":"string","uniqueKey":"datosExportacion.nombreExportador","typeLabel":"string"}},"required":["nombreConsignatario","direccionConsignatario"],"uniqueKey":"datosExportacion","typeLabel":"object"},"retencionesFacturaEspecial":{"type":"object","description":"Retenciones de Factura Especial (Guatemala): ISR 5% + IVA retenido. Sólo presente para `tipo: \"facturaEspecial\"`.","properties":{"retencionIsr":{"type":"number","format":"double","uniqueKey":"retencionesFacturaEspecial.retencionIsr","typeLabel":"number\u003cdouble>"},"retencionIva":{"type":"number","format":"double","uniqueKey":"retencionesFacturaEspecial.retencionIva","typeLabel":"number\u003cdouble>"},"totalMenosRetenciones":{"type":"number","format":"double","uniqueKey":"retencionesFacturaEspecial.totalMenosRetenciones","typeLabel":"number\u003cdouble>"}},"uniqueKey":"retencionesFacturaEspecial","typeLabel":"object"},"abonosPactados":{"type":"array","items":{"type":"object","description":"Abono pactado (plan de pagos). Usado en factura cambiaria (Guatemala) y formas de pago (El Salvador/República Dominicana). Una `factura` con `abonosPactados` se certifica automáticamente como factura cambiaria; también puede indicarse explícitamente `tipo: \"facturaCambiaria\"`.","properties":{"numero":{"type":"integer","description":"Número correlativo del abono (1..n). Lo asigna Fegora ordenando por `fecha`; se ignora si se envía en la solicitud.","uniqueKey":"abonosPactados.items.[INDEX].numero","typeLabel":"integer"},"fecha":{"type":"string","uniqueKey":"abonosPactados.items.[INDEX].fecha","typeLabel":"string"},"monto":{"type":"number","format":"double","uniqueKey":"abonosPactados.items.[INDEX].monto","typeLabel":"number\u003cdouble>"},"metodoPago":{"type":"string","uniqueKey":"abonosPactados.items.[INDEX].metodoPago","typeLabel":"string"},"duracion":{"type":"string","description":"Duración en formato ISO-8601 (p. ej. `P1M`, `P1Y6M`).","uniqueKey":"abonosPactados.items.[INDEX].duracion","typeLabel":"string"}},"uniqueKey":"abonosPactados.items.[INDEX]","typeLabel":"object"},"uniqueKey":"abonosPactados","typeLabel":"object[]"},"datosAnulacion":{"type":"object","description":"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.","properties":{"motivoAnulacion":{"type":"string","isRequired":true,"uniqueKey":"datosAnulacion.motivoAnulacion","typeLabel":"string"},"fechaAnulacion":{"type":"string","isRequired":true,"uniqueKey":"datosAnulacion.fechaAnulacion","typeLabel":"string"},"fechaCertificacion":{"type":"string","description":"Fecha en que el certificador confirmó la anulación.","uniqueKey":"datosAnulacion.fechaCertificacion","typeLabel":"string"}},"required":["motivoAnulacion","fechaAnulacion"],"uniqueKey":"datosAnulacion","typeLabel":"object"},"archivoPdfUri":{"type":"string","description":"Se genera de forma diferida — puede estar ausente hasta el primer `GET /dte/{id}/pdf`.","uniqueKey":"archivoPdfUri","typeLabel":"string"},"archivoXmlUri":{"type":"string","uniqueKey":"archivoXmlUri","typeLabel":"string"},"archivoJsonUri":{"type":"string","description":"Presente sólo para certificadores que devuelven el documento certificado en JSON (El Salvador).","uniqueKey":"archivoJsonUri","typeLabel":"string"},"dteUri":{"type":"string","uniqueKey":"dteUri","typeLabel":"string"},"datosAdicionales":{"type":"array","items":{"type":"object","description":"Dato adicional tal como se refleja en la respuesta: incluye `etiqueta` (para representación gráfica) y `visible`, calculados por Fegora a partir de lo enviado y de las frases/legales automáticas (p. ej. `SAT-4-1`).","properties":{"nombre":{"type":"string","isRequired":true,"uniqueKey":"datosAdicionales.items.[INDEX].nombre","typeLabel":"string"},"valor":{"oneOf":[{"type":"string","uniqueKey":"datosAdicionales.items.[INDEX].valor.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"datosAdicionales.items.[INDEX].valor.oneOf.1","typeLabel":"null"}],"uniqueKey":"datosAdicionales.items.[INDEX].valor","typeLabel":"string | null"},"etiqueta":{"type":"string","description":"Etiqueta sugerida para mostrar en una representación gráfica (PDF). Vacía para frases SAT y leyendas automáticas.","uniqueKey":"datosAdicionales.items.[INDEX].etiqueta","typeLabel":"string"},"visible":{"type":"boolean","description":"Si debe mostrarse en una representación gráfica (PDF).","uniqueKey":"datosAdicionales.items.[INDEX].visible","typeLabel":"boolean"}},"required":["nombre"],"uniqueKey":"datosAdicionales.items.[INDEX]","typeLabel":"object"},"uniqueKey":"datosAdicionales","typeLabel":"object[]"},"recursos":{"type":"array","items":{"type":"object","description":"Recurso adjunto a un DTE (archivo, URL o referencia a otro DTE).","properties":{"tipo":{"type":"string","enum":["archivo","url","dte"],"uniqueKey":"recursos.items.[INDEX].tipo","typeLabel":"enum\u003cstring>"},"archivoUri":{"type":"string","uniqueKey":"recursos.items.[INDEX].archivoUri","typeLabel":"string"},"uri":{"type":"string","uniqueKey":"recursos.items.[INDEX].uri","typeLabel":"string"},"idDteRelacionado":{"type":"string","uniqueKey":"recursos.items.[INDEX].idDteRelacionado","typeLabel":"string"},"descripcion":{"type":"string","uniqueKey":"recursos.items.[INDEX].descripcion","typeLabel":"string"}},"uniqueKey":"recursos.items.[INDEX]","typeLabel":"object"},"uniqueKey":"recursos","typeLabel":"object[]"},"bitacora":{"type":"array","items":{"type":"object","description":"Entrada de la bitácora (auditoría) del documento. `fecha` en hora local del emisor, sin offset de zona horaria.","properties":{"evento":{"type":"string","enum":["creacion","modificacion","itemAgregado","itemEliminado","certificacion","anulacion","envio","impresion"],"uniqueKey":"bitacora.items.[INDEX].evento","typeLabel":"enum\u003cstring>"},"fecha":{"type":"string","uniqueKey":"bitacora.items.[INDEX].fecha","typeLabel":"string"},"ipOrigen":{"type":"string","uniqueKey":"bitacora.items.[INDEX].ipOrigen","typeLabel":"string"},"origen":{"type":"string","uniqueKey":"bitacora.items.[INDEX].origen","typeLabel":"string"},"usuario":{"type":"string","uniqueKey":"bitacora.items.[INDEX].usuario","typeLabel":"string"}},"uniqueKey":"bitacora.items.[INDEX]","typeLabel":"object"},"uniqueKey":"bitacora","typeLabel":"object[]"},"fechaCreacion":{"type":"string","uniqueKey":"fechaCreacion","typeLabel":"string"}},"required":["id","serie","numero","tipo","fechaEmision","estado","total","moneda","emisor","receptor","idCuenta","items"],"uniqueKey":"","typeLabel":"object"},"examples":{"ok":{"title":"ok","value":{"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"}}},"exampleType":"examples"}},"exampleType":"examples"},"e788da48-e514-4b27-b14b-5464e8ce46f6":{"description":"El documento no existe. TODO(review): el texto exacto de `mensaje` no pudo confirmarse en el código fuente (proviene de una excepción genérica `NotFoundException` sin clase localizada en el repositorio); `codigo` sí está confirmado.","content":{"application/json":{"schema":{"type":"object","description":"Formato estándar de error de Fegora. Se usa en toda respuesta 4xx.","properties":{"codigo":{"type":"string","description":"Código de error interno de Fegora (p. ej. `FEG_VALIDATION_ERROR`, `FEG_DTE_CREA_001`). Ver la tabla de códigos de error en la guía de introducción.","examples":["FEG_VALIDATION_ERROR"],"isRequired":true,"uniqueKey":"codigo","typeLabel":"string"},"mensaje":{"type":"string","description":"Mensaje descriptivo del error, en español.","isRequired":true,"uniqueKey":"mensaje","typeLabel":"string"},"masInformacion":{"type":"string","format":"uri","description":"Enlace a documentación adicional sobre el error.","examples":["https://developer.fegora.com"],"uniqueKey":"masInformacion","typeLabel":"string\u003curi>"},"severidad":{"type":"integer","enum":[0,1,2,3],"description":"0 = Sugerencia, 1 = Advertencia, 2 = Error, 3 = Fatal.","uniqueKey":"severidad","typeLabel":"enum\u003cinteger>"}},"required":["codigo","mensaje"],"uniqueKey":"","typeLabel":"object"},"examples":{"noEncontrado":{"title":"noEncontrado","value":{"codigo":"FEG_NOT_FOUND","mensaje":"Entity \"Dte\" (2AF7AD7C-...) was not found.","masInformacion":"https://developer.fegora.com","severidad":2}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"1691aec7-6ffa-4b59-848f-39766da40a49":{"url":"https://api.fegora.com"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"fegora","siteName":"Fegora","title":"Obtener un DTE por id - Fegora","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T00:43:26.891Z","originalFileLocation":"api-reference/dte/obtener-un-dte-por-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Fegora\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Obtener un DTE por id - Fegora\">\u003cmeta data-mint-head property=\"og:description\" content=\"El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Fegora\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fegora.mintlify.site/_mintlify/api/og/v2?division=DTE\u0026amp;title=Obtener+un+DTE+por+id\u0026amp;description=El+%60%7Bid%7D%60+es+el+n%C3%BAmero+de+autorizaci%C3%B3n+del+documento+%28el+mismo+%60id%60+devuelto+al+crearlo%29.+Endpoint+p%C3%BAblico%3A+el+id+no+es+adivinable+y+suele+imprimirse+en+la+repr\u0026amp;theme=deff290d94ca2c2dc88a2fc6\u0026amp;signature=0d1d51b211675a5090ec8df5a65a9d7f9d0d5a640a827b315ce6c35b84eaebd7\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Obtener un DTE por id - Fegora\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fegora.mintlify.site/_mintlify/api/og/v2?division=DTE\u0026amp;title=Obtener+un+DTE+por+id\u0026amp;description=El+%60%7Bid%7D%60+es+el+n%C3%BAmero+de+autorizaci%C3%B3n+del+documento+%28el+mismo+%60id%60+devuelto+al+crearlo%29.+Endpoint+p%C3%BAblico%3A+el+id+no+es+adivinable+y+suele+imprimirse+en+la+repr\u0026amp;theme=deff290d94ca2c2dc88a2fc6\u0026amp;signature=0d1d51b211675a5090ec8df5a65a9d7f9d0d5a640a827b315ce6c35b84eaebd7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/fegora/Yv2gMmF85Ys3YW5R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Fegora\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#df6200\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/dte/obtener-un-dte-por-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fegora.com/#organization\",\"name\":\"Fegora\",\"url\":\"https://docs.fegora.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fegora/SKovB_knYtaf-5od/logo/light.svg?fit=max\u0026auto=format\u0026n=SKovB_knYtaf-5od\u0026q=85\u0026s=2bf68866cce62cdff1a18262d62675f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fegora.com#website\",\"name\":\"Fegora\",\"url\":\"https://docs.fegora.com\",\"publisher\":{\"@id\":\"https://docs.fegora.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id#webpage\",\"url\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id\",\"name\":\"Obtener un DTE por id\",\"description\":\"El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\",\"dateModified\":\"2026-10-27T00:43:26.891Z\",\"isPartOf\":{\"@id\":\"https://docs.fegora.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.fegora.com/api-reference/autenticaci%C3%B3n/obtener-u-renovar-un-token-de-acceso\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DTE\",\"item\":\"https://docs.fegora.com/api-reference/dte/buscar-dtes-emitidos\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Obtener un DTE por id\",\"item\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id#apireference\",\"headline\":\"Obtener un DTE por id\",\"name\":\"Obtener un DTE por id\",\"description\":\"El {id} es el número de autorización del documento (el mismo id devuelto al crearlo). Endpoint público: el id no es adivinable y suele imprimirse en la representación gráfica.\",\"url\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fegora.com/api-reference/dte/obtener-un-dte-por-id#webpage\"},\"dateModified\":\"2026-10-27T00:43:26.891Z\",\"publisher\":{\"@id\":\"https://docs.fegora.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fegora.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Fegora\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Fegora","nav":{"global":null,"tabs":[{"tab":"Documentación","icon":"book-open","pages":[{"title":"Documentación","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Comenzar","pages":[{"title":"Introducción al API","icon":"plug","href":"/api-reference/introduccion"}]},{"group":"Endpoints","pages":[{"group":"Autenticación","pages":[{"title":"Obtener u renovar un token de acceso","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /token","href":"/api-reference/autenticación/obtener-u-renovar-un-token-de-acceso"}]},{"group":"DTE","pages":[{"title":"Buscar DTEs emitidos","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte","href":"/api-reference/dte/buscar-dtes-emitidos"},{"title":"Crear (y certificar) un DTE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte","href":"/api-reference/dte/crear-y-certificar-un-dte"},{"title":"Anular o restaurar un DTE (legacy)","description":"Endpoint legacy para anular (`anulado: true`) o restaurar (`anulado: false`) un documento. El header `x-force: true` omite la validación de \"ya anulado\" y fuerza la actualización incluso si el certificador de prueba rechaza la anulación.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /dte","href":"/api-reference/dte/anular-o-restaurar-un-dte-legacy"},{"title":"Obtener un DTE por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/{id}","href":"/api-reference/dte/obtener-un-dte-por-id"},{"title":"Obtener un DTE por número de transacción","description":"Busca el documento por el `numeroTransaccion` (identificador de idempotencia) que el cliente envió al crearlo.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/transaction/{numeroTransaccion}","href":"/api-reference/dte/obtener-un-dte-por-número-de-transacción"},{"title":"Registrar la certificación de un DTE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte/{id}/certify","href":"/api-reference/dte/registrar-la-certificación-de-un-dte"},{"title":"Anular un DTE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte/{id}/anular","href":"/api-reference/dte/anular-un-dte"},{"title":"Obtener el PDF de un DTE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/{id}/pdf","href":"/api-reference/dte/obtener-el-pdf-de-un-dte"},{"title":"Reenviar un DTE por correo","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte/{id}/email","href":"/api-reference/dte/reenviar-un-dte-por-correo"},{"title":"Ingresar un DTE emitido a partir de su XML (resguardo)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte/xml","href":"/api-reference/dte/ingresar-un-dte-emitido-a-partir-de-su-xml-resguardo"},{"title":"Resumen de DTEs por cuenta y mes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/resumen","href":"/api-reference/dte/resumen-de-dtes-por-cuenta-y-mes"},{"title":"Exportar DTEs a Excel","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/xls","href":"/api-reference/dte/exportar-dtes-a-excel"},{"title":"Exportar el resumen de DTEs a Excel","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /dte/resumen/xls","href":"/api-reference/dte/exportar-el-resumen-de-dtes-a-excel"},{"title":"Agregar un recurso a un DTE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /dte/{id}/recurso","href":"/api-reference/dte/agregar-un-recurso-a-un-dte"}]},{"group":"DTE Recibidos","pages":[{"title":"Buscar DTEs recibidos","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /recibidos/dte","href":"/api-reference/dte-recibidos/buscar-dtes-recibidos"},{"title":"Obtener un DTE recibido por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /recibidos/dte/{id}","href":"/api-reference/dte-recibidos/obtener-un-dte-recibido-por-id"},{"title":"Registrar un DTE recibido a partir de su XML","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /recibidos/dte/xml","href":"/api-reference/dte-recibidos/registrar-un-dte-recibido-a-partir-de-su-xml"},{"title":"Marcar un DTE recibido como anulado","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /recibidos/dte/{id}/anular","href":"/api-reference/dte-recibidos/marcar-un-dte-recibido-como-anulado"},{"title":"Obtener el PDF de un DTE recibido","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /recibidos/dte/{id}/pdf","href":"/api-reference/dte-recibidos/obtener-el-pdf-de-un-dte-recibido"},{"title":"Agregar un recurso a un DTE recibido","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /recibidos/dte/{id}/recurso","href":"/api-reference/dte-recibidos/agregar-un-recurso-a-un-dte-recibido"}]},{"group":"Lotes","pages":[{"title":"Listar lotes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lote","href":"/api-reference/lotes/listar-lotes"},{"title":"Crear un lote de carga masiva","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /lote","href":"/api-reference/lotes/crear-un-lote-de-carga-masiva"},{"title":"Obtener un lote por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lote/{id}","href":"/api-reference/lotes/obtener-un-lote-por-id"},{"title":"Actualizar el estado/avance de un lote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /lote/{id}","href":"/api-reference/lotes/actualizar-el-estadoavance-de-un-lote"},{"title":"Descargar el archivo de un lote","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /lote/{id}/archivo","href":"/api-reference/lotes/descargar-el-archivo-de-un-lote"}]},{"group":"Cuentas","pages":[{"title":"Listar cuentas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cuenta","href":"/api-reference/cuentas/listar-cuentas"},{"title":"Crear una cuenta","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /cuenta","href":"/api-reference/cuentas/crear-una-cuenta"},{"title":"Obtener una cuenta por NIT","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /cuenta/{id}","href":"/api-reference/cuentas/obtener-una-cuenta-por-nit"},{"title":"Actualizar una cuenta (reemplazo completo)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /cuenta/{id}","href":"/api-reference/cuentas/actualizar-una-cuenta-reemplazo-completo"},{"title":"Eliminar una cuenta","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /cuenta/{id}","href":"/api-reference/cuentas/eliminar-una-cuenta"},{"title":"Actualizar parcialmente una cuenta","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /cuenta/{id}","href":"/api-reference/cuentas/actualizar-parcialmente-una-cuenta"}]},{"group":"Otros","pages":[{"title":"Obtener el usuario autenticado","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /usuario/me","href":"/api-reference/otros/obtener-el-usuario-autenticado"},{"title":"Obtener un usuario por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /usuario/{id}","href":"/api-reference/otros/obtener-un-usuario-por-id"}]},{"group":"Catálogos","pages":[{"title":"Obtener un producto por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /producto/{id}","href":"/api-reference/catálogos/obtener-un-producto-por-id"},{"title":"Buscar productos de una cuenta","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /producto/buscar","href":"/api-reference/catálogos/buscar-productos-de-una-cuenta"},{"title":"Listar plantillas de DTE de una cuenta","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /plantilla/dte","href":"/api-reference/catálogos/listar-plantillas-de-dte-de-una-cuenta"},{"title":"Listar localidades","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /localidad","href":"/api-reference/catálogos/listar-localidades"},{"title":"Obtener una localidad por id","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /localidad/{id}","href":"/api-reference/catálogos/obtener-una-localidad-por-id"},{"title":"Consultar un contribuyente por NIT/CUI","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /contribuyente/{id}","href":"/api-reference/catálogos/consultar-un-contribuyente-por-nitcui"}]}]}]},{"tab":"Guía de usuario","icon":"monitor","pages":[{"title":"Guía de usuario","href":"/guia-web/introduccion"}]}]},"basePath":"","title":"Obtener un DTE por id - Fegora","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}