githubEditar

Archivo

Introducción

Una consulta de estado de documento electrónico es un servicio que permite verificar el estado actual de un documento, como una factura electrónica, y tiene la misma validez legal que una verificación de estado realizada de manera tradicional. Este servicio es crucial para asegurar que el documento se ha creado, enviado y almacenado digitalmente. Además, este procedimiento electrónico debe contener todos los datos fiscales necesarios que permitan confirmar el estado del documento entre el emisor y el receptor, garantizando así la transparencia y la correcta gestión de las transacciones electrónicas.

Beneficios de la Facturación Electrónica

  • Eficiencia Operativa: La automatización del proceso de facturación reduce la carga administrativa, disminuyendo los errores humanos y acelerando las transacciones.

  • Reducción de Costos: Menores gastos en papel, impresión, envío y almacenamiento de documentos físicos.

  • Acceso y Gestión Simplificados: El almacenamiento digital facilita la búsqueda y gestión de documentos, lo que es especialmente útil para auditorías y cumplimiento fiscal.

Autenticación

Para acceder al servicio de facturación electrónica a través de nuestra API SOAP deben de identificarse y autenticarse usando una credencial única denominada Clave.

La autenticación se realiza incluyendo la credencial en el cuerpo del mensaje SOAP, dentro del nodo <Clave>. A continuación, se describe la estructura de la solicitud.

Ejemplo:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:emis="https://ec.edocnube.com/api/emision" xmlns:com="https://ec.edocnube.com/api/emision/compretencion" xmlns:ext="https://ec.edocnube.com/api/emision/extensiones">
   <soapenv:Header/>
   <soapenv:Body>
      <emis:EmitirFactura>
         <emis:Clave>{CLAVE_VALOR}</Clave>
         <emis:Factura/>
      </emis:EmitirFactura>
   </soapenv:Body>
</soapenv:Envelope>
Elemento
Descripción

Clave

Requerido. Credencial única proporcionada a la empresa para autenticarse. Esta clave es específica y debe mantenerse confidencial.

Consulta el archivo del documento electrónico

En esta sección, abordaremos los detalles técnicos específicos del proceso de consulta de archivo de documentos electrónicos utilizando la tecnología SOAP. Exploraremos cómo este enfoque facilita la integración eficiente y segura de los sistemas de gestión documental dentro de las infraestructuras empresariales existentes, asegurando la conformidad con los estándares legales y fiscales relevantes. Nos centraremos en la implementación de SOAP para describir las interacciones entre los sistemas y los métodos empleados para la recuperación y visualización de documentos electrónicos.

Estados eDoc

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.

Valor
Descripción
Causa
Solución

2

Documento autorizado por el ente tributario

Documento autorizado por el SRI

Ninguna

3

Documento no autorizado por el ente tributario

Documento no superó la validación debido al incumplimiento de las reglas de negocio establecidas por el SRI

Realizar la corrección de los datos del documento y emitirlo nuevamente

4

Error al emitir o consultar el documento en eDoc

Ha ocurrido un error en eDoc, el cual ha sido identificado con un código para su seguimiento y solución

Levantar un ticket de atención en el portal de soporte técnico de GuruSoft

5

Documento en espera de autorización por parte del ente tributario

eDoc no pudo establecer una conexión con el SRI para consultar la autorización del documento, se realizará una reconsulta automática posteriormente

Realizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado

6

Documento rechazado por el ente tributario

Documento no cumplió con las validaciones de estructura y/o formato XML requeridas por el SRI

Realizar la corrección de los datos del documento y emitirlo nuevamente

7

Documento en espera de recepción por parte del ente tributario

eDoc no pudo establecer una conexión con el SRI para transmitir el documento, se realizará un reenvío automático posteriormente

Realizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado

11

Documento anulado en eDoc

Documento ha sido anulado por el emisor mediante el portal web del SRI

Una vez alcanzado este estado, el documento no puede ser modificado ni revertido

15

Solicitud de emisión o consulta rechazada por eDoc

Solicitud de emisión o consulta no cumplió con las validaciones de estructura y/o formato XML requeridas por eDoc

Realizar la corrección de los datos del documento y emitirlo nuevamente

18

Documento no encontrado en eDoc

Documento consultado no fue encontrando en eDoc

Realizar la corrección de los parámetros de la consulta y repetir el proceso

Diccionario de datos

Consumo

Request

Response

En una comunicación SOAP, las respuestas HTTP pueden variar según el estado y el contenido de la comunicación:

  • 200 (OK): La solicitud se procesó correctamente y devuelve un mensaje SOAP en XML con los detalles de la respuesta.

Estas respuestas permiten manejar adecuadamente los distintos escenarios de comunicación.

Última actualización

¿Te fue útil?