> For the complete documentation index, see [llms.txt](https://wikiedoc.guru-soft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wikiedoc.guru-soft.com/gt/integraciones-y-servicios/rest/emision/emitir.md).

# Emitir

## Introducción

Este documento forma parte de la documentación técnica del Régimen de Factura Electrónica en Línea y tiene por objetivo describir las validaciones tanto aritméticas como reglas de negocio, que deben aplicarse a los Documentos Tributarios Electrónicos (DTE). Las validaciones se encuentran establecidas conforme a las características que la SAT ha definido para los diferentes tipos de DTE existentes, y se basan en el marco jurídico y normativo que corresponde al proceso de Factura Electrónica en Línea.

## Autenticación

Para acceder al servicio de facturación electrónica a través de nuestra API REST, los usuarios deben autenticarse utilizando el método de Authorization Bearer Token. Este proceso implica dos pasos principales:

1. **Autenticación Básica:** Los usuarios envían sus credenciales (usuario y contraseña) codificadas en base64 en el encabezado de la solicitud.
2. **Identificador del Servicio:** Junto con las credenciales, los usuarios deben especificar el identificador del servicio que desean utilizar.
3. **Generación del Token:** Los usuarios pueden generar el token enviando una solicitud \[GET] a `URL_API_AUTH/ServicioEDOC`, incluyendo el identificador del servicio deseado.

**Servicios Disponibles**

Cada servicio dentro de la plataforma tiene un identificador único que debe ser proporcionado durante la solicitud de autenticación. A continuación, se muestra una tabla con los identificadores y nombres de los servicios disponibles:

<table data-full-width="true"><thead><tr><th width="96">ID</th><th>Servicio	</th></tr></thead><tbody><tr><td>1</td><td>Emisión de Comprobante</td></tr><tr><td>2</td><td>Recepción de Comprobante</td></tr><tr><td>3</td><td>Consulta de Emisión</td></tr><tr><td>4</td><td>Consulta de Recepción</td></tr></tbody></table>

**Seguridad y Manejo del Token**

* **Almacenamiento Seguro:** Es esencial que el token se almacene de manera segura para evitar accesos no autorizados.
* **Caducidad y Renovación:** Los tokens tienen un período de validez limitado y deben ser renovados periódicamente.
* **Revocación de Tokens:** En caso de compromiso, el token debe ser revocado inmediatamente.

## GET /ServicioEDOC

> Genera un nuevo token de acuerdo a las credenciales de autorización enviadas.

```json
{"openapi":"3.1.1","info":{"title":"GSEDOCEMP_Api_Auth v1.0.0","version":"1.0.0"},"servers":[{"url":"/eDocGT/emp/api/Auth"}],"security":[{"basic":[]}],"components":{"securitySchemes":{"basic":{"type":"http","scheme":"basic"}},"schemas":{"TokenAppResultDto":{"type":"object","properties":{"valor":{"description":"Valor de sesión para consumo de los servicios web eDoc\t\r\nOrigen: `GS`","type":"string"},"expedido":{"format":"date-time","description":"Fecha de expedición del token\t\r\nOrigen: `GS`","type":"string"},"expira":{"format":"date-time","description":"Fecha de caducidad del token\t\r\nOrigen: `GS`","type":"string"},"codigoError":{"description":"Código de alerta o error en caso de ocurrir durante el procesamiento de la petición\t\r\nOrigen: `GS`","type":"string"},"mensajeRespuesta":{"description":"Mensaje de alerta o error en caso de ocurrir durante el procesamiento de la petición\t\r\nOrigen: `GS`","type":"string"}},"additionalProperties":false}}},"paths":{"/ServicioEDOC":{"get":{"tags":["AuthServicio"],"summary":"Genera un nuevo token de acuerdo a las credenciales de autorización enviadas.","parameters":[{"schema":{"type":"integer","format":"int64"},"in":"query","name":"Id","description":"Identificador del servicio: `1. Emisión documento`, `2. Recepción documento`, `3. Consulta emisión`, `4. Consulta recepción`"}],"responses":{"200":{"description":"OK. Procesado correctamente.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenAppResultDto"}}}},"401":{"description":"Credenciales inválidas"},"500":{"description":"Error. Verificar mensaje de excepción y comunicarse con soporte."}}}}}}
```

## Emisión de Factura

En esta sección, abordaremos los detalles técnicos específicos del proceso de emisión de Factura de Consumidor Final utilizando la tecnología REST. Exploraremos cómo este enfoque facilita la integración eficiente y segura de los sistemas de facturación dentro de las infraestructuras empresariales existentes, asegurando la conformidad con los estándares legales y fiscales relevantes. Nos centraremos en la implementación de REST para describir las interacciones entre los sistemas y los métodos empleados para la transmisión de datos de facturación electrónica.

## Estados eDoc

<table data-header-hidden data-full-width="false"><thead><tr><th></th></tr></thead><tbody><tr><td>La gestión adecuada de los estados eDoc es crucial en el sistema de facturación electrónica, ya que cada estado refleja una etapa específica en el proceso de validación y envío de documentos a la entidad tributaria. A continuación, se presenta una tabla que describe cada uno de los estados eDoc, proporcionando claridad sobre las acciones necesarias según el estado en que se encuentre el documento.</td></tr></tbody></table>

<table data-full-width="false"><thead><tr><th width="102">Estado </th><th width="266">Descripción</th><th width="232">Causa</th><th width="209">Solución</th><th data-hidden>Acción Recomendada</th></tr></thead><tbody><tr><td>2</td><td>Documento autorizado por el ente tributario</td><td>Documento autorizado por el SAT</td><td><p>No aplica</p><p></p></td><td>No se requieren acciones adicionales.</td></tr><tr><td>3</td><td>Documento no autorizado por el ente tributario</td><td>Documento no superó la validación debido al incumplimiento de las reglas de negocio establecidas por el SAT</td><td><p>Realizar la corrección de los datos del documento y emitirlo nuevamente</p><p></p></td><td>Notificar a soporte técnico. No reenviar automáticamente.</td></tr><tr><td>4</td><td>Error al emitir o consultar el documento en eDoc</td><td>Ha ocurrido un error en eDoc, el cual ha sido identificado con un código para su seguimiento y solución</td><td>Levantar un ticket de atención en el portal de soporte técnico de GuruSoft</td><td>Corregir según indicaciones y luego reenviar manualmente.</td></tr><tr><td>5</td><td>Documento en espera de autorización por parte del ente tributario</td><td>eDoc no pudo establecer una conexión con el SAT para consultar la autorización del documento, se realizará una reconsulta automática posteriormente</td><td>Realizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado</td><td>No reenviar. Consultar el estado final del DTE a partir de las 5AM del día siguiente.</td></tr><tr><td>6</td><td><p>Documento devuelto por el ente tributario.</p><p><br></p></td><td>Documento no cumplió con las validaciones de estructura y/o formato XML requeridas por el SAT</td><td>Realizar la corrección de los datos del documento y emitirlo nuevamente</td><td>No se requieren acciones adicionales.</td></tr><tr><td>7</td><td><p>Documento en espera de recepción por parte del ente tributario</p><p><br></p></td><td>eDoc no pudo establecer una conexión con el SAT para transmitir el documento, se realizará un reenvío automático posteriormente</td><td>Realizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado</td><td>Si el documento es duplicado consultar el documento si ha sido autorizado previamente; Si las credenciales son invalidas verificar que se esté enviando la información correcta; y Si envía el documento en la clase equivocada se debe corregir y volver a enviar el mismo documento</td></tr><tr><td>11</td><td><p>Documento anulado en eDoc</p><p><br></p></td><td>Documento ha sido anulado por el emisor mediante el portal web del SAT</td><td>Una vez alcanzado este estado, el documento no puede ser modificado ni revertido<br></td><td>No reenviar. Verificar el código de generación utilizado y luego volver a consultar.</td></tr><tr><td>15</td><td><p>Emisión o consulta del documento fue devuelta por eDoc.</p><p><br></p></td><td>Solicitud de emisión o consulta no cumplió con las validaciones de estructura y/o formato XML requeridas por eDoc</td><td>Realizar la corrección de los datos del documento y emitirlo nuevamente</td><td></td></tr></tbody></table>

<table data-header-hidden data-full-width="false"><thead><tr><th></th></tr></thead><tbody><tr><td><ul><li><strong>Estado Autorizado (2):</strong> Este estado indica que el documento ha sido autorizado por la entidad tributaria. En este punto, no se requiere ninguna acción adicional como reenvío o consulta del estado, pues el documento ya ha completado su proceso satisfactoriamente.</li><li><strong>Estado No autorizado (3):</strong> Este estado indica que el documento no ha sido aprobado y requiere <strong>corrección</strong> para poder ser autorizado en un nuevo intento. Se permite un máximo de tres envíos por documento (incluyendo el primero). En caso de que el documento permanezca en estado No autorizado, deberá esperar al siguiente día para realizar un nuevo envío.</li><li><strong>Estados Transitorios (5, 7):</strong> Estos estados reflejan las fases intermedias en el proceso de envío y recepción de documentos con la entidad tributaria. En todos estos casos, no se deben reenviar los documentos, sino consultar su estado hasta que cambien a una situación definitiva.</li><li><strong>Estados de Error y Corrección (4, 6, 15):</strong> El estado 4 indica un error en el proceso de envío o procesamiento, y no debe reenviarse automáticamente; es necesario revisar el error específico y corregirlo si es posible. El estado 6 se asigna a documentos rechazados por la entidad tributaria y requiere corrección manual antes de un reenvío. El estado 15 sugiere que el documento fue devuelto por eDoc empresarial y debe ser analizado para determinar la causa y decidir las acciones correctivas apropiadas. En estos casos, la corrección de errores es fundamental antes de cualquier intento de reenvío.</li><li><strong>Estado de Invalidación (11):</strong> Este estado indica que el documento ha sido invalidado y, por lo tanto, ya no tiene validez legal o administrativa. No se requieren acciones adicionales para documentos en este estado, ya que han sido efectivamente retirados del proceso.</li></ul><p></p><p><strong>Consideraciones Importantes</strong></p><ul><li><strong>Consultas de Estado:</strong> Para los estados que sugieren consultar el estado del documento, es recomendable establecer un intervalo regular de consultas para evitar la saturación del sistema y asegurar la actualización oportuna del estado del documento.</li><li><strong>Notificaciones a Soporte:</strong> En casos de errores que no pueden ser resueltos directamente por el usuario, como el estado 4, es fundamental notificar al soporte técnico proporcionando todos los detalles necesarios para una rápida resolución del problema.</li></ul></td></tr></tbody></table>

## Diccionario de datos

{% embed url="<https://wiki.edocnube.com/diccionario/Documentation/Swagger?p1=AJkuNFFcBIVQ1rJOkmBQQDMug5qnw8YUY1NhX7Snt2f4ZxeRNO1gZ6IorgKtybyox4O3fQdbFkUE3UHwWbVo1MF2QU7kJ5dIvW2YUrMKxM4=&p2=EoWbYb/FBQ7+HIWWn+AakOb+8h0FOP3K&p3=KEAKUnV+R4M=&p4=L5lbnPmTSNE=&p5=upCJtWBHYuI=&p6=0h6AVWZOsDA=>" %}

## Consumo

## POST /Emitir

> Recibe un XML con el formato definido por la SAT, que contiene una factura electrónica, para su transmisión al ente de autorización y posterior envío por correo electrónico al receptor.

```json
{"openapi":"3.1.1","info":{"title":"GSEDOCEMP_Api_Emision v1.7.0","version":"1.7.0"},"servers":[{"url":"/eDocGT/emp/api/Emision"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"apiKey","name":"Authorization","in":"header","description":"Ingrese cadena de autorización: `JWT-Token`"}},"schemas":{"DocumentoEmisionResultAppDto":{"type":"object","properties":{"codigoError":{"description":"Codigo del error en el proceso\t\r\nOrigen: `GS`","type":"string"},"fechaAutorizacion":{"format":"date-time","description":"Fecha del OK que Impuestos da al procesar el documento fiscal\t\r\nOrigen: `GS`","type":"string"},"estado":{"format":"int32","description":"Estado EDOC\t\r\nOrigen: `GS`","type":"integer"},"mensajeRespuesta":{"description":"Mensaje de respuesta del proceso.\t\r\nOrigen: `GS`","type":"string"},"secuencialERP":{"description":"Secuencial del documento procesado enviado por el ERP\t\r\nOrigen: `GS`","type":"string"},"nitEmisor":{"description":"NIT del emisor\t\r\nOrigen: `GS`","type":"string"},"nitReceptor":{"description":"NIT del receptor\t\r\nOrigen: `GS`","type":"string"},"fechaEmision":{"format":"date-time","description":"Fecha de emisión\r\nOrigen: `GS`","type":"string"},"numeroAutorizacion":{"description":"Número de autorización\t\r\nOrigen: `GS`","type":"string"},"serie":{"description":"Serie\r\nOrigen: `GS`","type":"string"},"numero":{"description":"Numero del documento\r\nOrigen: `GS`","type":"string"},"nitCertificador":{"description":"Nit del certificador\r\nOrigen: `GS`","type":"string"},"nombreCertificador":{"description":"Nombre del certificador\r\nOrigen: `GS`","type":"string"},"numDocumento":{"description":"Número interno del documento\r\nOrigen: `GS`","type":"string"},"numeroAcceso":{"format":"int32","description":"Número de acceso generado en contingencia\r\nOrigen: `GS`","type":"integer"},"urlQr":{"description":"Url para verificación del DTE\r\nOrigen: `SAT`","type":"string"}},"additionalProperties":false},"DocumentoEmisionAppDto":{"description":"Datos Documento Emision","type":"object","properties":{"numDocumento":{"description":"Número de documento interno alfanumérico\r\nOrigen: `GS/CERT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 70","type":"string"},"datosGenerales":{"$ref":"#/components/schemas/DatosGeneralesAppDto"},"emisor":{"$ref":"#/components/schemas/EmisorAppDto"},"receptor":{"$ref":"#/components/schemas/ReceptorAppDto"},"frases":{"description":"Frases\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"array","items":{"$ref":"#/components/schemas/FraseAppDto"}},"items":{"description":"Ítems del documento\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"array","items":{"$ref":"#/components/schemas/ItemAppDto"}},"totales":{"$ref":"#/components/schemas/TotalAppDto"},"abonosFacturaCambiaria":{"description":"Complementos de Factura Cambiaría\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"array","items":{"$ref":"#/components/schemas/AbonoFacturaCambiariaAppDto"}},"exportacion":{"$ref":"#/components/schemas/CompExportacionAppDto"},"retencionFacEspecial":{"$ref":"#/components/schemas/CompRetencionFacturaEspecialAppDto"},"referenciaNota":{"$ref":"#/components/schemas/CompReferenciaNotaAppDto"},"cobrosCuentaAjena":{"description":"Complemento Cobro x Cuenta Ajena\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"array","items":{"$ref":"#/components/schemas/CompCobroCuentaAjenaAppDto"}},"referenciaConstancia":{"$ref":"#/components/schemas/CompReferenciaConstanciaAppDto"},"mediosPago":{"description":"Complemento de medios de pago\r\nOrigen: ` `\r\n\r\n`Opcional`","type":"array","items":{"$ref":"#/components/schemas/CompMedioPagoAppDto"}},"decreto312022":{"$ref":"#/components/schemas/CompDecreto312022AppDto"},"organizacionesPoliticas":{"$ref":"#/components/schemas/CompOrganizacionesPoliticasAppDto"},"trasladoMercancia":{"$ref":"#/components/schemas/CompTrasladoMercanciaAppDto"},"espectactuloPublico":{"$ref":"#/components/schemas/CompEspectactuloPublicoAppDto"},"adendaDato1":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato2":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato3":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato4":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato5":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato6":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato7":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato8":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato9":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato10":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato11":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato12":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato13":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato14":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"adendaDato15":{"description":"Dato adicional para el certificador\r\nOrigen: `CERT`\r\n\r\n`Opcional`","type":"string"},"asincrono":{"description":"Indica si la emisión sera asincrono false: no o true: si\r\nOrigen: `GS`\r\n\r\n`Opcional`","type":"boolean"},"campo1":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo2":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo3":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo4":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo5":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo6":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo7":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo8":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo9":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"campo10":{"description":"Campo de información adicional eDoc\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 1000","type":"string"},"secuencialERP":{"description":"Código único del documento utilizado en ERP\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 50","type":"string"},"nombreIntegracion":{"description":"Nombre de la integración\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: 100","type":"string"},"emailResponsable":{"description":"Correo del responsable del documento\r\nOrigen: `GS`\r\n\r\n`Opcional`\r\n\r\nLongitud: MAX","type":"string"}},"additionalProperties":false},"DatosGeneralesAppDto":{"description":"Datos generales","type":"object","properties":{"codigoMoneda":{"description":"ISO Pais\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 3","type":"string"},"fechaHoraEmision":{"format":"date-time","description":"Debe de esta compuesto por Fecha/Hora/Zona Horaria\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"string"},"tipo":{"description":"Nombre resumido de tipo documento\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 4","type":"string"},"numeroAcceso":{"format":"int32","description":"Es un número generado por el sistema de facturación del Emisor en forma aleatoria, que va desde 100000000 hasta\r\n999999999 (9 dígitos)\r\nSolo si se genera contingencia.\r\nOrigen: `SAT`\r\n\r\n`Condicional`\r\n\r\nLongitud: 9","type":"integer"},"exp":{"description":"Indica si el documento es de exportación.\r\nLleva true, si es exportacion, de lo contrario no enviar.\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"boolean"},"tipoPersoneria":{"description":"Tipo de personeria.\r\nAplica solo si usa Recibo de Donacion.\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 3","type":"string"}},"additionalProperties":false},"EmisorAppDto":{"description":"Datos del emisor","type":"object","properties":{"direccionEmisor":{"$ref":"#/components/schemas/DireccionAppDto"},"afiliacionIVA":{"description":"Código postal del Emisor\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 3","type":"string"},"codigoEstablecimiento":{"format":"int32","description":"Código autorizado por sucursal\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 3","type":"integer"},"correoEmisor":{"description":"Correo Electrónico, si existen mas divido por punto y coma\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 255","type":"string"},"nitEmisor":{"description":"NIT Contribuyente\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 13","type":"string"},"nombreComercial":{"description":"Nombre Comercial\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 255","type":"string"},"nombreEmisor":{"description":"Razón Social\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 255","type":"string"}},"additionalProperties":false},"DireccionAppDto":{"description":"Datos Dirección","type":"object","properties":{"direccion":{"description":"Dirección Fiscal\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 200","type":"string"},"codigoPostal":{"description":"Codigo Postal\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 5","type":"string"},"municipio":{"description":"Municipio\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 100","type":"string"},"departamento":{"description":"Departamento\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 100","type":"string"},"pais":{"description":"Pais ISO de dos caracteres\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25","type":"string"}},"additionalProperties":false},"ReceptorAppDto":{"description":"Datos del receptor","type":"object","properties":{"direccionReceptor":{"$ref":"#/components/schemas/DireccionAppDto"},"correoReceptor":{"description":"Correo Electrónico, si existen mas divido por punto y coma\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 255","type":"string"},"idReceptor":{"description":"NIT Contribuyente/CUI/Pasaporte/Si no cuenta con ninguno anterior debe de ser CF\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 20","type":"string"},"nombreReceptor":{"description":"CF = Consumidor Final/ CUI= Nombre Receptor/NIT=Nombre Receptor\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 255","type":"string"},"tipoEspecial":{"description":"CUI  si es un DPI/ EXT si es un ID Extranjero/ vacio si es un NIT\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10","type":"string"}},"additionalProperties":false},"FraseAppDto":{"description":"Datos Frases","type":"object","properties":{"codigoEscenario":{"format":"int32","description":"Codigo del escenario\r\nDepende del tipo de documento a utilizar.\r\n\r\nOrigen: `SAT`\r\n\r\n`Condicional`","type":"integer"},"tipoFrase":{"format":"int32","description":"Tipo de frase\r\nDepende del tipo de documento a utilizar.\r\n\r\nOrigen: `SAT`\r\n\r\n`Condicional`","type":"integer"},"numeroResolucion":{"description":"Número de resolución\r\nAplica si pertenecen a SUJETO PAGO DIRECTO ISR\r\n\r\nOrigen: `SAT`\r\n\r\n`Condicional`\r\n\r\nLongitud: 50","type":"string"},"fechaResolucion":{"format":"date-time","description":"Fecha de resolución\r\nAplica si pertenecen a SUJETO PAGO DIRECTO ISR\r\n\r\nOrigen: `SAT`\r\n\r\n`Condicional`","type":"string"}},"additionalProperties":false},"ItemAppDto":{"description":"Datos Item","type":"object","properties":{"cantidad":{"format":"double","description":"Cantidad Detalle\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25, 10","type":"number"},"unidadMedida":{"description":"Unidad de Medida maximo 3 caracteres\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 3","type":"string"},"descripcion":{"description":"Descripcion Producto\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10000","type":"string"},"precioUnitario":{"format":"double","description":"Precio con IVA\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25, 10","type":"number"},"precio":{"format":"double","description":"Multiplicacion de Cantidad por PrecioUnitario\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25, 10","type":"number"},"descuento":{"format":"double","description":"Descuento aplicado\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"impuestos":{"description":"Lista de impuestos\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"array","items":{"$ref":"#/components/schemas/ImpuestoAppDto"}},"total":{"format":"double","description":"Total con Iva de linea de detalle\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25, 10","type":"number"},"bienOServicio":{"description":"B = Bien / S = Servicio\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 1","type":"string"},"numeroLinea":{"format":"int32","description":"No. de Linea detalle\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"integer"},"adendaItem1":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem2":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem3":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem4":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem5":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem6":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem7":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem8":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem9":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem10":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem11":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem12":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem13":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem14":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"adendaItem15":{"description":"Dato adicional para el certificador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"}},"additionalProperties":false},"ImpuestoAppDto":{"description":"Datos Impuesto","type":"object","properties":{"nombreCorto":{"description":"Nombre Corto\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"codigoUnidadGravable":{"format":"int32","description":"Codigo Unidad Gravable\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"integer"},"cantidadUnidadesGravables":{"format":"double","description":"Cantidad Unidades Gravables\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"number"},"montoGravable":{"format":"double","description":"Monto Gravable\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"number"},"montoImpuesto":{"format":"double","description":"Monto Impuesto\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"number"}},"additionalProperties":false},"TotalAppDto":{"description":"Datos Total","type":"object","properties":{"totalImpuestos":{"description":"Total Impuestos\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"array","items":{"$ref":"#/components/schemas/TotalImpuestoAppDto"}},"granTotal":{"format":"double","description":"GranTotal\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"}},"additionalProperties":false},"TotalImpuestoAppDto":{"description":"Datos Total Impuesto","type":"object","properties":{"nombreCorto":{"description":"Nombre de impuesto\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 17","type":"string"},"totalMontoImpuesto":{"format":"double","description":"Suma de impuesto, campo a sumar Monto Impuesto\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"}},"additionalProperties":false},"AbonoFacturaCambiariaAppDto":{"description":"Complementos de Factura Cambiaría","type":"object","properties":{"numeroAbono":{"format":"int32","description":"Tasa del ISC aplicable al ítem\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"integer"},"fechaVencimiento":{"format":"date-time","description":"Fecha de vencimiento\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"montoAbono":{"format":"double","description":"Monto total o Abono. \r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25, 10","type":"number"}},"additionalProperties":false},"CompExportacionAppDto":{"description":"Complementos de Facturas de Exportación","type":"object","properties":{"nombreConsignatarioODestinatario":{"description":"Nombre consignatario o destinatario\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 70","type":"string"},"direccionConsignatarioODestinatario":{"description":"Dirección consignatario o destinatario\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 70","type":"string"},"nombreComprador":{"description":"Nombre del comprador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 150","type":"string"},"direccionComprador":{"description":"Dirección del comprador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 150","type":"string"},"codigoComprador":{"description":"Código del comprador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 17","type":"string"},"otraReferencia":{"description":"Otra referencia\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 35","type":"string"},"incoterm":{"description":"INCOTERM\r\nEXW - Ex Works (En Fábrica)\r\nFCA - Free Carrier(Libre Transportista)\r\nFOB - Free On Board(Libre a Bordo)\r\nCFR - Cost and Freight(Costo y Flete)\r\nCIF - Cost, Insurance and Freight(Costo, Seguro y Flete)\r\nCPT - Carriage Paid To(Transporte Pagado Hasta)\r\nCIP - Carriage and Insurance Paid To(Transporte y Seguro Pagados Hasta)\r\nDDP - Delivered Duty Paid(Entregado Derechos Pagados)\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 3","type":"string"},"nombreExportador":{"description":"Nombre del exportador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 70","type":"string"},"codigoExportador":{"description":"Código del exportador\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 17","type":"string"}},"additionalProperties":false},"CompRetencionFacturaEspecialAppDto":{"description":"Complemento de Factura Especial","type":"object","properties":{"retencionISR":{"format":"double","description":"No permitido negativos, Valor ISR\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"retencionIVA":{"format":"double","description":"No permitido negativos, Valor IVA\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"totalMenosRetenciones":{"format":"double","description":"No permitido negativos, Total de la factura menos Retenciones\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"}},"additionalProperties":false},"CompReferenciaNotaAppDto":{"description":"Complemento de notas Crédito,Débito y Abono","type":"object","properties":{"regimenAntiguo":{"description":"Régimen antiguo\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: MAX","type":"string"},"numeroAutorizadoDocumento":{"description":"Valor Hexadecimal, código UUID o bien Resolución Régimen FACE1, Tipo TOKEN. Número de autorización del documento referenciado.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 36","type":"string"},"fechaEmisionDocumentoOrigen":{"format":"date-time","description":"Fecha de autorización del documento referenciado.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"string"},"motivoAjuste":{"description":"Motivo del ajuste\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 200","type":"string"},"serieDocumentoOrigen":{"description":"Serie del documento referenciado.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 20","type":"string"},"numeroDocumentoOrigen":{"description":"Información de interés del emisor con respeto al pedido comercial, relacionado con un ítem del comprobante\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10","type":"string"}},"additionalProperties":false},"CompCobroCuentaAjenaAppDto":{"description":"Complemento Cobro x Cuenta Ajena","type":"object","properties":{"niTtercero":{"description":"Nit del tercero\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 20","type":"string"},"numeroDocumento":{"description":"Número de documento\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 36","type":"string"},"fechaDocumento":{"format":"date-time","description":"Fecha del documento\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"descripcion":{"description":"Descripción\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 17","type":"string"},"baseImponible":{"format":"double","description":"Base imponible\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"montoCobroDAI":{"format":"double","description":"Monto cobro DAI\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"montoCobroIVA":{"format":"double","description":"Monto cobro IVA\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"montoCobroOtros":{"format":"double","description":"Monto cobro Otros\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"},"montoCobroTotal":{"format":"double","description":"Monto cobro Total\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 25, 10","type":"number"}},"additionalProperties":false},"CompReferenciaConstanciaAppDto":{"description":"Complemento de referencias constancia","type":"object","properties":{"regimenAntiguo":{"description":"Indica si la constancia se aplica a un DTE del Régimen FEL(no se incluye la casilla) o bien a uno antiguo(facturas de papel), éste último si incluye la casilla con el valor “Antiguo”.\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 10","type":"string"},"numeroAutorizadoDocumentoOrigen":{"description":"Describe el número de autorización del documento original, al que se le aplica la constancia que se está emitiendo.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 36","type":"string"},"fechaEmisionDocumentoOrigen":{"format":"date-time","description":"Fecha de emisión del documento al cual se le está aplicando la constancia.\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`","type":"string"},"serieDocumentoOrigen":{"description":"Serie del documento al cual se le emite la constancia.\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 20","type":"string"},"numeroDocumentoOrigen":{"description":"Número del documento al cual se le emite la constancia.\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 15","type":"string"},"montoIVAExento":{"format":"double","description":"El monto total del IVA que ampara el documento, cuando el complemento corresponde a una Constancia de Exención del IVA(CIVA). Dicho monto debe ser menor o igual al total de IVA del DTE al que se hace referencia.\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 22, 10","type":"number"},"tipoDTEReferenciado":{"description":"Cuando se incluya dicha casilla deberá de contener el valor:\r\n• FYDUCA\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 25","type":"string"}},"additionalProperties":false},"CompMedioPagoAppDto":{"description":"Complemento de medios de pago","type":"object","properties":{"tipoFormaPago":{"description":"Indica que medio de pago fue utilizado para cancelar el Gran Total del DTE, pueden ser utilizados varios en el complemento.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 2","type":"string"},"numeroTransaccion":{"description":"Describe el número de autorización del documento original, al que se le aplica la constancia que se está emitiendo.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 36","type":"string"},"fechaTransaccion":{"format":"date-time","description":"Fecha de transacción del pago del documento al cual se le está pagando.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10","type":"string"},"monto":{"format":"double","description":"Monto pagado con ese medio seleccionado.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 20","type":"number"}},"additionalProperties":false},"CompDecreto312022AppDto":{"description":"Complemento de decreto 312022","type":"object","properties":{"nitReclutadora":{"description":"El NIT del receptor del DTE.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 13","type":"string"},"cuiBeneficiario":{"description":"El CUI del contribuyente que está viajando.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 13","type":"string"},"nombreBeneficiario":{"description":"El número del documento relacionado con la transacción.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 50","type":"string"},"fechaViaje":{"format":"date-time","description":"La fecha del documento relacionado con la transacción.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"string"},"paisDestino":{"description":"ISO 3166-1 establece la codificación de las siglas del país.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 2","type":"string"}},"additionalProperties":false},"CompOrganizacionesPoliticasAppDto":{"description":"Complemento de organizaciones políticas","type":"object","properties":{"calidadAportante":{"description":"Deberá permitir únicamente los valores: \r\nAfiliado\r\nSimpatizante\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 18","type":"string"},"tipoAporte":{"description":"Deberá permitir únicamente los valores:\r\nDineraria\r\nNo dineraria o en especie\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 90","type":"string"},"declaracionProcedenciaAporte":{"description":"Texto libre\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 500","type":"string"},"valorEstimadoAporte":{"format":"double","description":"Debe mostrar de forma automático el valor: Gran Total del DTE.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 50","type":"number"}},"additionalProperties":false},"CompTrasladoMercanciaAppDto":{"description":"Complemento de traslado de mercancías","type":"object","properties":{"idTransportista":{"description":"Id de la persona que conduce el transporte el cual traslada la o las mercancías.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 18","type":"string"},"nombreTransportista":{"description":"Nombre de la persona que conduce el transporte el cual traslada la o las mercancías.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 100","type":"string"},"tipoDocumento":{"description":"El tipo de documento que registra.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10","type":"string"},"placa":{"description":"Placa del vehículo de transporte.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 10","type":"string"},"direccionProcedencia":{"description":"Dirección de donde proviene la mercancía.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 120","type":"string"},"idConsignatario":{"description":"NIT o CUI de la persona hacia donde se dirige la mercancía.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 13","type":"string"},"nombreConsignatario":{"description":"Nombre de la persona hacia donde se dirige la mercancía.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 100","type":"string"},"direccionDestino":{"description":"Dirección hacia donde se dirige la mercancía.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 120","type":"string"},"motivo":{"description":"La descripción y motivo por el cual se traslada la mercancía.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 500","type":"string"}},"additionalProperties":false},"CompEspectactuloPublicoAppDto":{"description":"Complemento de espectaculos publicos","type":"object","properties":{"codigoEvento":{"description":"Codigo Evento\r\n\r\nOrigen: `SAT`\r\n\r\n`Opcional`\r\n\r\nLongitud: 15","type":"string"},"nombreEvento":{"description":"Nombre del evento, según el código de evento indicado o según lo establezca el contribuyente.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 256","type":"string"},"nombreLocalidad":{"description":"Nombre de la localidad autorizada para el evento o que establezca el contribuyente.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 256","type":"string"},"precioAdmision":{"format":"double","description":"Precio de la admisión, según lo establezca el contribuyente.\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`\r\n\r\nLongitud: 22,6","type":"number"},"numeroBoleto":{"description":"Numero Boleto\r\n\r\nOrigen: `SAT`\r\n\r\n`Obligatorio`","type":"string"}},"additionalProperties":false}}},"paths":{"/Emitir":{"post":{"tags":["Rest"],"summary":"Recibe un XML con el formato definido por la SAT, que contiene una factura electrónica, para su transmisión al ente de autorización y posterior envío por correo electrónico al receptor.","responses":{"200":{"description":"La petición se ha procesado correctamente. No obstante, es necesario verificar el 'estado eDoc' para confirmar si el documento electrónico ha sido autorizado o rechazado, según los estados definidos.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionResultAppDto"}}}},"401":{"description":"Credenciales inválidas o la compañía no tiene autorización para acceder. o la compañía no tiene autorización para acceder. o la compañía no tiene autorización para acceder.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionResultAppDto"}}}},"500":{"description":"Verificar mensaje de excepción y comunicarse con soporte.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionResultAppDto"}}}}},"requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionAppDto"}},"application/json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionAppDto"}},"text/json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionAppDto"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/DocumentoEmisionAppDto"}}},"required":true}}}}}
```

## Pruebas

```json
{
    "numDocumento": "GS210000009",
    "datosGenerales": {
        "codigoMoneda": "GTQ",
        "fechaHoraEmision": "2026-04-10T08:00:41-06:00",
        "tipo": "FACT",
        "numeroAcceso": 210000009
    },
    "emisor": {
        "direccionEmisor": {
            "direccion": "Av de las americas",
            "codigoPostal": "04350",
            "municipio": "Guatemala",
            "departamento": "Guatemala",
            "pais": "GT"
        },
        "afiliacionIVA": "GEN",
        "codigoEstablecimiento": 1,
        "correoEmisor": "dhilan.torres@guru-soft.com",
        "nitEmisor": "11700521K",
        "nombreComercial": "Gurusoft (Infile)",
        "nombreEmisor": "Gurusoft (Infile)"
    },
    "receptor": {
        "direccionReceptor": {
            "direccion": "Av de las americas",
            "codigoPostal": "04350",
            "municipio": "Guatemala",
            "departamento": "Guatemala",
            "pais": "GT"
        },
        "correoReceptor": "dhilan.torres@guru-soft.com",
        "idReceptor": "50510231",
        "nombreReceptor": "MEGAPRINT, SOCIEDAD ANONIMA",
        "tipoEspecial": null
    },
    "frases": [
        {
            "codigoEscenario": 1,
            "tipoFrase": 1
        },
        {
            "codigoEscenario": 1,
            "tipoFrase": 2
        }
    ],
    "items": [
        {
            "cantidad": 1.0,
            "unidadMedida": "UNI",
            "descripcion": "PRUEBA",
            "precioUnitario": 1.0,
            "precio": 1.0,
            "descuento": 0.0,
            "impuestos": [
                {
                    "nombreCorto": "IVA",
                    "codigoUnidadGravable": 1,
                    "montoGravable": 0.89,
                    "montoImpuesto": 0.11
                }
            ],
            "total": 1.0,
            "bienOServicio": "B",
            "numeroLinea": 1
        }
    ],
    "totales": {
        "totalImpuestos": [
            {
                "nombreCorto": "IVA",
                "totalMontoImpuesto": 0.11
            }
        ],
        "granTotal": 1.0
    },
    "secuencialERP": null,
    "nombreIntegracion": "API rest",
    "emailResponsable": null
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wikiedoc.guru-soft.com/gt/integraciones-y-servicios/rest/emision/emitir.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
