> 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/pe/integraciones-y-servicios/soap/emision/factura.md). # Factura ## Introducción Es un comprobante de pago emitido por el vendedor o prestador de servicios en las operaciones de venta de bienes y prestación de servicios. **Características:** * Se utiliza para sustentar costos ó gastos para efectos del Impuesto a la Renta y el crédito fiscal del Impuesto General a las Ventas. * Tiene una serie alfanumérica, numeración correlativa y se genera a través de cualquiera de los sistemas de emisión electrónica. * No se puede utilizar para sustentar el traslado de bienes. * Se emite a favor del adquiriente que cuente con número de RUC, salvo en el caso de no domiciliados en el caso de las operaciones de exportación. * La autenticidad de los documentos electrónicos emitidos se pueden consultar en el portal web de la SUNAT. ## 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 ``. A continuación, se describe la estructura de la solicitud. Ejemplo: ```xml ------------- ```
ElementoDescripción
ClaveRequerido. Credencial única proporcionada a la empresa para autenticarse. Esta clave es específica y debe mantenerse confidencial.
{% tabs %} {% tab title="JavaScript" %} ```javascript url = '/URL_SOAP_EMISION/EmitirDocumentoService.svc?wsdl'; // XML del mensaje SOAP const soapRequest = ` ------------- `; // Configuración de la solicitud HTTP const headers = { 'Content-Type': 'text/xml; charset=utf-8', // Tipo de contenido para SOAP SOAPAction: 'http://tempuri.org/EmitirDocumentoService/EmitirFactura', // 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); }); ``` {% endtab %} {% tab title="PHP" %} ```php 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 = [ "Clave" => "{CLAVE_VALOR}", // Credencial única "Factura" => null ]; // Llamar al método $response = $client->__soapCall("EmitirFactura", [$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"; echo "Detalles:\n" . $fault->detail . "\n"; } ?> ``` {% endtab %} {% tab title="C#" %} ```csharp 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/EmitirDocumentoService.svc"; string soapAction = "http://tempuri.org/EmitirDocumentoService/EmitirFactura"; string soapEnvelope = @" ------------- "; 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); } } } ``` {% endtab %} {% tab title="Python" %} ```python import requests # URL del servicio SOAP url = "/URL_SOAP_EMISION/EmitirDocumentoService.svc" # Cabeceras HTTP headers = { "Content-Type": "text/xml; charset=utf-8", "SOAPAction": "http://tempuri.org/EmitirDocumentoService/EmitirFactura" } # Cuerpo del mensaje SOAP soap_body = """ ------------- """ 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}") ``` {% endtab %} {% tab title="Curl" %} ```bash curl -X POST "/URL_SOAP_EMISION/EmitirDocumentoService.svc" \ -H "Content-Type: text/xml; charset=utf-8" \ -H "SOAPAction: http://tempuri.org/EmitirDocumentoService/EmitirFactura" \ -d ' ------------- ' ``` {% endtab %} {% endtabs %} ## Emisión de Factura En esta sección, abordaremos los detalles técnicos específicos del proceso de emisión de facturas electrónicas utilizando la tecnología SOAP. 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 SOAP 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 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.
EstadoDescripciónCausaSolución
2Documento autorizado por el ente tributarioDocumento autorizado por la SUNATNo aplica
3Documento no autorizado por el ente tributarioDocumento no superó la validación debido al incumplimiento de las reglas de negocio establecidas por la SUNATRealizar la corrección de los datos del documento y emitirlo nuevamente
4Error al emitir o consultar el documento en eDocHa ocurrido un error en eDoc, el cual ha sido identificado con un código para su seguimiento y soluciónLevantar un ticket de atención en el portal de soporte técnico de GuruSoft
5Documento en espera de autorización por parte del ente tributarioeDoc no pudo establecer una conexión con la SUNAT para consultar la autorización del documento, se realizará una reconsulta automática posteriormenteRealizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado
6Documento devuelto por el ente tributario.Documento no cumplió con las validaciones de estructura y/o formato XML requeridas por la SUNATRealizar la corrección de los datos del documento y emitirlo nuevamente
7Documento en espera de recepción por parte del ente tributarioeDoc no pudo establecer una conexión con la SUNAT para transmitir el documento, se realizará un reenvío automático posteriormenteRealizar la consulta del estado del documento mediante la API correspondiente, una vez transcurrido un intervalo de tiempo adecuado
11Documento anulado en eDocDocumento ha sido anulado por el emisor mediante el portal web de la SUNATUna vez alcanzado este estado, el documento no puede ser modificado ni revertido
15Emisión o consulta del documento fue devuelta por eDoc.Solicitud de emisión o consulta no cumplió con las validaciones de estructura y/o formato XML requeridas por eDocRealizar la corrección de los datos del documento y emitirlo nuevamente
18Documento no encontrado en eDocDocumento consultado no fue encontrando en eDocRealizar la corrección de los parámetros de la consulta y repetir el proceso
* **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. * **Estado No autorizado (3):** Este estado indica que el documento no ha sido aprobado y requiere **corrección** 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. * **Estados Transitorios (5, 7):** 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. ## Diccionario de datos {% embed url="" %} ## Consumo ### Request {% tabs %} {% tab title="JavaScript" %} ```javascript url = '/URL_SOAP_EMISION/EmitirDocumentoService.svc?wsdl'; // XML del mensaje SOAP const soapRequest = ` ------------- `; // Configuración de la solicitud HTTP const headers = { 'Content-Type': 'text/xml; charset=utf-8', // Tipo de contenido para SOAP SOAPAction: 'http://tempuri.org/EmitirDocumentoService/EmitirFactura', // 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); }); ``` {% endtab %} {% tab title="PHP" %} ```php 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 = [ "Clave" => "{CLAVE_VALOR}", // Credencial única "Factura" => null ]; // Llamar al método $response = $client->__soapCall("EmitirFactura", [$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"; echo "Detalles:\n" . $fault->detail . "\n"; } ?> ``` {% endtab %} {% tab title="C#" %} ```csharp 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/EmitirDocumentoService.svc"; string soapAction = "http://tempuri.org/EmitirDocumentoService/EmitirFactura"; string soapEnvelope = @" ------------- "; 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); } } } ``` {% endtab %} {% tab title="Python" %} ```python import requests # URL del servicio SOAP url = "/URL_SOAP_EMISION/EmitirDocumentoService.svc" # Cabeceras HTTP headers = { "Content-Type": "text/xml; charset=utf-8", "SOAPAction": "http://tempuri.org/EmitirDocumentoService/EmitirFactura" } # Cuerpo del mensaje SOAP soap_body = """ ------------- """ 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}") ``` {% endtab %} {% tab title="Curl" %} ```bash curl -X POST "/URL_SOAP_EMISION/EmitirDocumentoService.svc" \ -H "Content-Type: text/xml; charset=utf-8" \ -H "SOAPAction: http://tempuri.org/EmitirDocumentoService/EmitirFactura" \ -d ' ------------- ' ``` {% endtab %} {% endtabs %} ### Response * **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. {% tabs %} {% tab title="Estado HTTP 200" %} ```xml 2 2026-05-13T11:11:54.000-05:00 La Factura numero F020-00001201, ha sido aceptada ``` {% endtab %} {% tab title="Estado HTTP 401" %} Credenciales inválidas {% endtab %} {% tab title="Estado HTTP 500" %} Error. Verificar mensaje de excepción y comunicarse con soporte. {% endtab %} {% endtabs %} --- # 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/pe/integraciones-y-servicios/soap/emision/factura.md?ask=&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.