El Salvador: Recepción de documentos
1. FUNCIONAMIENTO

- El proveedor tiene la posibilidad de emitir el documento de dos maneras:
- El proveedor carga manualmente el JSON a través del Upload de Gosocket (En el apartado Forma de Envío - Carga manual JSON se explican las condiciones que se deben considerar en el envío).
- El proveedor envía el archivo JSON por la casilla de intercambio (En el apartado Forma de Envío - Casilla de Intercambio se explican las condiciones que se deben considerar para el envío).
Nota: Cuando se utilizan los canales de recepción de documentos, tanto la casilla de intercambio como la carga manual del JSON mediante la opción Upload, ambos procesos ejecutan las validaciones de esquema y validación ante la ET (Entidad Tributaria).
-
El portal de Gosocket descarga y procesa este documento. Cuando se trata de un documento tributario, entra a un flujo de validación.
-
Primero se realiza una validación de esquema al documento para garantizar que cumple con el formato establecido por la entidad tributaria.
Según la validación realizada se puede obtener uno de los siguientes resultados:
a. Fallido: El documento no cumple con el formato fiscal por lo que será registrado en Gosocket con estado rechazado y se muestra en la iconografía el símbolo de exclamación rojo
, adicional, en las notas del documento se indica el motivo del rechazo.
b. Exitoso: El documento cumple con el formato fiscal, en ese caso continúa con la siguiente validación.
- Después, se consulta en la Entidad Tributaria si el documento existe. De esta validación, se puede obtener uno de los siguientes resultados:
a. Documento no encontrado en la ET (Fallido) ![]()
- Indica que el documento recibido no se encuentra registrado en la ET.
- En Gosocket quedará con estado No Disponible en ET.
- En la pantalla de consulta de documentos recibidos (Inbox) se mostrará el icono
.
Si el documento aún no está registrado en la ET o hay indisponibilidad del servicio de consulta, se realiza los Reintentos automáticos de la siguiente manera:
- El sistema realiza 30 intentos automáticos cada 10 minutos.
- Si después de los 30 intentos el documento sigue sin encontrarse, quedará definitivamente en estado No Disponible en ET mostrando el siguiente icono
en el Inbox. - Si durante estos reintentos el documento es encontrado, se actualiza su estado y el proceso continúa.
b. Documento Rechazado ![]()
Si el documento existe en la ET, pero hay algún motivo de rechazo en la Entidad Tributaria, su estado cambia a Rechazado
.
c. Documento tiene una excepción interna por Gosocket ❗
Al realizar la consulta de validación ante la Entidad Tributaria del documento y Gosocket no logra conectarse con el servicio de la ET o hay errores de comunicación con el servicio, el documento cambia su estado a ERROR y se le asignara el icono ❗.
d. Documento encontrado en la ET
Si el documento existe en la Entidad Tributaria, continúa el flujo de recepción.
- Si el resultado de las validaciones anteriores es satisfactorio, el documento se registra en Gosocket con estado Aceptado y en la iconografía se muestra el símbolo
.
a. Configuración especial (Errores de Esquema)
Algunos clientes, tienen una opción particular que les permite configurar el no rechazo de documentos recibidos a pesar de presentar errores en el esquema, y así, continuar el flujo de validación ante la Entidad Tributaria. Esta opción se puede activar por medio de una solicitud al equipo de Producto.
En caso de tener habilitada esta configuración, cuando se hace la validación de esquema y ésta resulta fallida, se agrega una nota al documento como la que se muestra a continuación y se sigue con el flujo de validación ante la Entidad Tributaria:

Si el documento está Aceptado por la Entidad Tributaria se muestra con ese mismo estado. Sin embargo, si previamente arrojó un error en la validación de esquema, en su estado se mostrará el ícono
en lugar de
y, al colocar el cursor sobre el icono
se mostrará el mensaje ALERTA, para indicar que este documento está validado ante la Entidad Tributaria, pero tiene alguna observación por validación de esquema.
Dentro de la consulta de documentos recibidos en Inbox, se muestra como vemos a continuación:
Dentro de la vista previa del documento, podemos ver este cambio de estado dentro del apartado Notas:

b. Botón Opciones (Reprocesar documento manualmente)
Adicional, en Inbox se implementó un botón que permite reprocesar manualmente los documentos tributarios, que tengan estado “ERROR” ❗ y “No Disponible en ET”
.
Este botón permite realizar un reprocesamiento de las diferentes validaciones del proceso de recepción y lo encontraremos en la siguiente ruta según corresponda:
- Inbox/Recibido/Opciones/Acciones/Reprocesar documento sin validar esquema.
- Inbox/Recibido/Opciones/Acciones/Reprocesar documento.

Acompañado de un selector que, como su nombre lo indica, permitirá seleccionar de manera independiente un Comprobante Electrónico o un conjunto de ellos.

Dentro de este menú encontrará la opción Reprocesar documento, que le permitirá al usuario iniciar el reprocesamiento a documentos que quedaron en estado No Disponible en ET
o ERROR ❗ .
Seguido, se mostrará una ventana emergente en la cual, el usuario debe confirmar que desea revalidar los documentos previamente seleccionados.
Una vez que se generó el reprocesamiento, se mostrará un registro por cada reintento que se obtenga de la entidad tributaria y su registro quedará en la vista previa del documento en el apartado de notas como lo vemos a continuación:

Cuando el documento cambia de estado en la entidad tributaria, el icono de estado en la grilla de documentos recibidos refleja este cambio:

2. FORMA DE ENVÍO
Como ya se indicó, la solución realiza el procesamiento de los documentos, donde una vez recibido el documento se inicia con el proceso de validación.
Existen dos formas de realizar el proceso de recepción de documentos:
a. Carga manual del JSON a través del Upload de Gosocket
b. Casilla de intercambio
a. Carga manual del JSON a través del Upload de Gosocket
Gosocket cuenta con una herramienta dentro de la plataforma de Inbox, a través de la cual el proveedor puede cargar el archivo JSON del documento.
La ruta de acceso es la siguiente: Menú principal > Upload > Carga Manual.
En esta opción, el usuario puede seleccionar el archivo JSON manualmente desde el explorador de archivos o, si lo prefiere, arrastrarlo directamente a la interfaz de Carga Manual.
Como ya se indicó, la solución realiza el procesamiento de los documentos, donde, una vez recibido el documento, empieza con el proceso de validación.

Una vez se reciba el archivo JSON por la opción carga manual, se identificará:
- Cuantos archivos en total JSON se recibieron, cuantos procesados con éxito y cuantos tienen error.

- Al dar clic en el botón “Detalles” se mostrará un popup con el “Detalle de Errores” identificando los posibles errores que puede contener el archivo JSON cargado manualmente por esta opción y en caso contrario que el documento no tenga errores, se mostrará un detalle que se cargó en la plataforma de Gosocket con éxito:

- Finalmente, el documento se visualizará en la bandeja de recibidos de inbox, con todas las validaciones realizadas.

i. Consideraciones para la carga manual del JSON
- En una sola carga se podrá cargar hasta n archivos JSON.
- Se realizarán las mismas validaciones de esquema, firma, disponibilidad en la Entidad Tributaria y certificado que se hacen por la casilla de intercambio.
- Deberán enviarse los documentos tributarios estipulados por la Entidad Tributaria en un formato JSON.
Los documentos tributarios que se pueden recibir son:
- Factura
- Comprobante de Liquidación
- Comprobante de Retención
- Factura de Exportación
- Documento Contable de Liquidación
- Nota de Remisión
- Nota de Débito
- Nota de Crédito
- Comprobante de Crédito Fiscal
- Factura Sujeto Excluido
- Comprobante de Donación.
b. Casilla de intercambio
Las casillas que deben utilizarse son:
- Sandbox: sv_sbx@inbound.gosocket.com
- Productivo: sv@recepcionprd.gosocket.net
i. Consideraciones para la casilla de intercambio
Es importante tener en cuenta los siguientes puntos para el envío de documentos ya que esto evitará que sean rechazados por la aplicación.
- Deberán enviarse los documentos tributarios estipulados por la Entidad Tributaria en un formato JSON.
- Los documentos tributarios que se pueden recibir son:
- Factura
- Comprobante de Liquidación
- Comprobante de Retención
- Factura de Exportación
- Documento Contable de Liquidación
- Nota de Remisión
- Nota de Débito
- Nota de Crédito
- Comprobante de Crédito Fiscal
- Factura Sujeto Excluido
- Comprobante de Donación
La estructura del DTE recibido debe cumplir con las especificaciones de la Entidad Tributaria, que puede ser consultada en el capítulo XXIII del Manual funcional del Sistema de Transmisión, donde se incluye un ejemplo de un Json DTE firmado y con sello de recepción. https://factura.gob.sv/download/3-manual-funcional-del-sistema-de-transmision-amplia-la-aplicacion-de-las-estructuras-de-los-dte-y-los-eventos-asi-como-contiene-las-pruebas-minimas-requeridas/?wpdmdl=4726&refresh=67c8da4a294841741216330
- Pueden enviarse de forma individual o varios JSON en un mismo correo.
- Pueden enviarse varios JSON comprimidos (.zip, .rar)
- Los archivos JSON o comprimidos debe estar adjuntos al correo principal.
- Pueden enviarse documentos adjuntos, como el PDF de la factura.
La solución tiene la posibilidad de realizar el procesamiento de los PDF de representación gráfica en caso tal de que esta venga y documentos adjuntos que lleguen a la casilla de correo donde una vez recibido se almacenan asociándolos a su respectivo documento permitiendo la descarga dentro de Inbox.
El proceso debe funcionar de la siguiente manera:
- Si a la casilla llega un documento JSON y adicional un archivo PDF con el mismo nombre, por ejemplo: Factura12345.json, Factura12345.pdf, se entiende que el archivo .pdf es la representación gráfica del DTE por lo que se sincroniza de esa forma en Gosocket y está disponible para su consulta.
- Si a la casilla llega un documento JSON con más de un archivo adjunto de cualquier extensión se asocian como documentos adjuntos.
Nota: Si hay archivos PDFs con un nombre diferente al del JSON se considerarán como documentos adjuntos.
- Para el envío de adjuntos se recomienda enviar cada DTE con sus adjuntos de forma separada ya que en el caso de que llegue más de un documento JSON solo se realizará el almacenamiento de la representación gráfica siempre y cuando el archivo PDF contenga el mismo nombre de cada JSON correspondiente, el resto de los archivos adjuntos no se procesarán puesto que no hay forma de saber a qué documento asociarlos.
- También se pueden asociar adjuntos después del envío del JSON, por ejemplo, si se realiza el envío del JSON sin adjuntos, se puede enviar posteriormente otro mail con documentos adjuntos (PDF, Excel, Word, etc.) y estos serán asociados el documento previamente enviado, siempre y cuando en el segundo mail se incluya también el JSON.
3. CONSULTA DE DOCUMENTOS RECIBIDOS DESDE GOSOCKET
Una vez que los documentos fueron procesados por el servicio de recepción, estos podrán ser consultados desde el portal de Gosocket en el apartado Inbox/Recibidos. **

En este apartado se muestra la siguiente pantalla:
- Sección de filtros para optimizar el resultado de la búsqueda. **
- Control de orden de despliegue, con el que podrá modificar la forma en que se presentarán los resultados de la búsqueda. **
- Lista de opciones vinculadas con la exportación, respuestas comerciales y movimientos internos de los Comprobantes Electrónicos. **
- Sección de visualización con el detalle del resultado de la búsqueda e iconografía representativa de los cambios de estado más relevantes. **
* Para más información sobre estos puntos, consulte la documentación de Inbox.**
Una vez realizada la búsqueda de documentos en el grid principal se mostrará la lista de documentos recibidos que cumplieron con los criterios de búsqueda establecidos, en este grid además de información relevante del documento se puede observar el estado del documento.

- Validación de la entidad tributaria.
- Validación de distribución.
- Validación estado Smart Supply.
En la columna de estado (1) se mostrará el resultado de las validaciones aplicadas, tal como se explicó en el apartado Funcionamiento.

| Icono | Estado | Validación |
|---|---|---|
| VALIDADA | Documento aprobado por la ET | |
| RECHAZADA* | Documento rechazado por la ET | |
| No Disponible en ET | Documento no existe en la ET | |
| ❗ | ERROR* | Documento Rechazado o excepción interna por Gosocket |
| ALERTA | Documento está validado ante la ET, pero tiene alguna observación por validación de esquema. |
Nota: Al dar clic en el documento se abrirá la previsualización del documento donde podrá revisar las notas relacionadas al motivo de rechazo.
Nota: para el caso en el que el documento quede en estado “ERROR”, el usuario podrá reprocesarlo a través de las acciones, con el objetivo de realizar nuevamente las validaciones de esquema o ET. Este proceso se explica a detalle en el apartado “Botón Opciones (Reprocesar documento manualmente)”.
Finalmente, si se enviaron documentos adicionales en el mail, estos se verán reflejados en el apartado “Adjuntos” dentro de la previsualización del documento.
Para más información sobre las opciones disponibles en este apartado, consulte el manual de Inbox.