Estado Documento

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.

Consulta el archivo del documento electronico

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

Estado

Descripción del Estado

Reenviar

Consultar

Acción Recomendada

Documento autorizado, cumple con todo lo requerido por la DGII y el ente tributario.

No se requieren acciones adicionales.

Error de procesamiento en eDoc, se debe radicar un ticket de atención en nuestra mesa de ayuda.

Notificar a soporte técnico. No reenviar automáticamente.

El documento fue recibido, pero no hubo respuesta a la consulta del estado hacia la entidad tributaria.

No reenviar. Consultar el estado del documento nuevamente.

Documento devuelto por el ente tributario, no cumple con las especificaciones del XML en campos obligatorios. Se debe corregir datos y volver a enviar con el mismo secuencial del documento rechazado.

Corregir según indicaciones y luego reenviar manualmente.

El documento no fue recibido por la entidad tributaria.

No reenviar. Consultar el estado del documento.

Documento anulado en el ente tributario.

No se requieren acciones adicionales.

Documento devuelto por eDoc previo a generación del XML por posible duplicidad, credenciales inválidas o Tipo de Documento no reconocido.

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

Documento no encontrado en Edoc

Verificar que se esté enviando la información correcta

eDoc no se puede contactar al PAC, se realiza un posterior envío automático

Consulta el estado final del documento

Estado Autorizado (2): 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.
Estados Transitorios (5, 7, 10, 20): 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.
Estados de Error y Corrección (4, 6, 15): 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.
Estado de Anulación (11): Este estado indica que el documento ha sido anulado 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.

Consideraciones Importantes

Consultas de Estado: 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.
Notificaciones a Soporte: 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.

Consumo

const url = '/URL_SOAP_EMISION/WSEDOC_CONSULTA.svc?wsdl';

// XML del mensaje SOAP
const soapRequest = `
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ConsultarProcesoSincronizado>
         <RucEmisor>?</RucEmisor>
         <TipoDocumento>?</TipoDocumento>
         <NumeroDocumento>?</NumeroDocumento>
         <SecuencialERP>?</SecuencialERP>
      </ConsultarProcesoSincronizado>
   </soapenv:Body>
</soapenv:Envelope>
`;

// Configuración de la solicitud HTTP
const headers = {
  'Content-Type': 'text/xml; charset=utf-8', // Tipo de contenido para SOAP
  SOAPAction: 'http://tempuri.org/IWSEDOC_CONSULTA/ConsultarProcesoSincronizado', // Acción SOAP específica
};

// Realizar la solicitud con fetch
fetch(url, {
  method: 'POST',
  headers: headers,
  body: soapRequest,
})
  .then((response) => {
    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }
    return response.text();
  })
  .then((data) => {
    console.log('Respuesta SOAP:', data);
  })
  .catch((error) => {
    console.error('Error en la solicitud SOAP:', error.message);
  });

<?php
// URL del servicio WSDL
$wsdl = "/URL_SOAP_EMISION/WSEDOC_CONSULTA.svc?wsdl";

try {
    // Crear un cliente SOAP
    $client = new SoapClient($wsdl, [
        'trace' => true,       // Habilitar trazas para depuración
        'cache_wsdl' => WSDL_CACHE_NONE, // No cachear el WSDL
        'exceptions' => true   // Lanzar excepciones en errores
    ]);

    // Parámetros para el método
    $params = [
        'RucEmisor' => '{RUC_EMISOR}',
        'TipoDocumento' => '{TIPO_DOCUMENTO}',
        'NumeroDocumento' => '{NUMERO_DOCUMENTO}',
        'SecuencialERP' => '{SECUENCIAL_ERP}'
    ];

    // Llamar al método
    $response = $client->__soapCall("ConsultarProcesoSincronizado", [$params]);

    // Mostrar la respuesta
    echo "Respuesta SOAP:\n";
    print_r($response);
} catch (SoapFault $fault) {
    // Manejo de errores
    echo "Error SOAP: " . $fault->getMessage() . "\n";
    echo "Código de error: " . $fault->faultcode . "\n";
    if (isset($fault->detail)) {
        echo "Detalles:\n" . $fault->detail . "\n";
    }
}
?>

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        string url = "/URL_SOAP_EMISION/WSEDOC_CONSULTA.svc";
        string soapAction = "http://tempuri.org/IWSEDOC_CONSULTA/ConsultarProcesoSincronizado";
        
        string soapEnvelope = @"<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
			   <soapenv:Header/>
			   <soapenv:Body>
				  <ConsultarProcesoSincronizado>
					 <RucEmisor>?</RucEmisor>
					 <TipoDocumento>?</TipoDocumento>
					 <NumeroDocumento>?</NumeroDocumento>
					 <SecuencialERP>?</SecuencialERP>
				  </ConsultarProcesoSincronizado>
			   </soapenv:Body>
			</soapenv:Envelope>";

        using (HttpClient client = new HttpClient())
        {
            var request = new HttpRequestMessage(HttpMethod.Post, url)
            {
                Content = new StringContent(soapEnvelope, Encoding.UTF8, "text/xml")
            };
            request.Headers.Add("SOAPAction", soapAction);

            HttpResponseMessage response = await client.SendAsync(request);
            string responseContent = await response.Content.ReadAsStringAsync();

            Console.WriteLine("Respuesta del servidor:");
            Console.WriteLine(responseContent);
        }
    }
}

import requests

# URL del servicio SOAP
url = "/URL_SOAP_EMISION/WSEDOC_CONSULTA.svc"

# Cabeceras HTTP
headers = {
    "Content-Type": "text/xml; charset=utf-8",
    "SOAPAction": "http://tempuri.org/IWSEDOC_CONSULTA/ConsultarProcesoSincronizado"
}

# Cuerpo del mensaje SOAP
soap_body = """<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ConsultarProcesoSincronizado>
         <RucEmisor>?</RucEmisor>
         <TipoDocumento>?</TipoDocumento>
         <NumeroDocumento>?</NumeroDocumento>
         <SecuencialERP>?</SecuencialERP>
      </ConsultarProcesoSincronizado>
   </soapenv:Body>
</soapenv:Envelope>"""

try:
    # Enviar la solicitud POST
    response = requests.post(url, data=soap_body, headers=headers)

    # Verificar el estado de la respuesta
    if response.status_code == 200:
        print("Respuesta del servidor:")
        print(response.text)
    else:
        print(f"Error en la solicitud: {response.status_code}")
        print(response.text)

except requests.exceptions.RequestException as e:
    print(f"Error al realizar la solicitud: {e}")

curl -X POST "/URL_SOAP_EMISION/WSEDOC_CONSULTA.svc" \
-H "Content-Type: text/xml; charset=utf-8" \
-H "SOAPAction: http://tempuri.org/IWSEDOC_CONSULTA/ConsultarProcesoSincronizado" \
-d '<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ConsultarProcesoSincronizado>
         <RucEmisor>?</RucEmisor>
         <TipoDocumento>?</TipoDocumento>
         <NumeroDocumento>?</NumeroDocumento>
         <SecuencialERP>?</SecuencialERP>
      </ConsultarProcesoSincronizado>
   </soapenv:Body>
</soapenv:Envelope>'

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.
401 (Unauthorized): Las credenciales proporcionadas son inválidas. Verifique las credenciales antes de volver a intentar.
500 (Internal Server Error): Se produjo un error en el servidor. Revise los mensajes de excepción y comuníquese con soporte.

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

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <ConsultarProcesoSincronizadoResponse>
         <ConsultarProcesoSincronizadoResult>
            <UrlCodeQR>https://dgi-fep-test.mef.gob.pa:40001/Consultas/FacturasPorQR?chFE=FE0120000155668001-2-2018-3707892025012700000000957860120012002280&amp;iAmb=2&amp;digestValue=jSOM9+Y1qlcMBNY2hdiX2x3ZOCjGJ7VQUXMZQPqY+o4=&amp;jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaEZFIjoiRkUwMTIwMDAwMTU1NjY4MDAxLTItMjAxOC0zNzA3ODkyMDI1MDEyNzAwMDAwMDAwOTU3ODYwMTIwMDEyMDAyMjgwIiwiaUFtYiI6IjIiLCJkaWdlc3RWYWx1ZSI6ImpTT005K1kxcWxjTUJOWTJoZGlYMngzWk9DakdKN1ZRVVhNWlFQcVkrbzQ9In0.TC4OsGVQfE3S-izfeM6OUgWTS-mnwPukFSrX4DhhHKU</UrlCodeQR>
            <Cufe>FE0120000155668001-2-2018-3707892025012700000000957860120012002280</Cufe>
            <Estado>AUTORIZADO</Estado>
            <FechaAutorizacion>2025-01-27T15:12:04</FechaAutorizacion>
            <EstadoEDOC>2</EstadoEDOC>
            <ErrorEDOC>0260:Autorizado el uso de la FE</ErrorEDOC>
            <CodigoError>0260</CodigoError>
            <NumAutorizacion>155668001-2-2018202500000000000000061730</NumAutorizacion>
            <SecuencialERP>930054013130000002</SecuencialERP>
            <TipoDocumento>1</TipoDocumento>
         </ConsultarProcesoSincronizadoResult>
      </ConsultarProcesoSincronizadoResponse>
   </s:Body>
</s:Envelope>

Pruebas

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ConsultarProcesoSincronizado>
         <RucEmisor>155668001-2-2018</RucEmisor>
         <TipoDocumento>1</TipoDocumento>
         <NumeroDocumento>0789-786-0000000095</NumeroDocumento>
         <SecuencialERP>930054013130000002</SecuencialERP>
      </ConsultarProcesoSincronizado>
   </soapenv:Body>
</soapenv:Envelope>

Última actualización hace 10 meses

¿Te fue útil?