República Dominicana: Recepción de documentos (MS)

1. PROCESO DE RECEPCIÓN DE UN XML

Este proceso permite recibir diferentes tipos de comprobantes de clientes y proveedores a través de los canales que ofrece Gosocket. Una vez recibidos, tanto el emisor como el receptor podrán consultar los documentos en la bandeja de Recibidos de Inbox, junto con su respectiva representación gráfica y archivos adjuntos.

Asi mismo, nuestro sistema realiza una serie de validaciones automáticas para garantizar que la estructura e integridad de la información cumplan estrictamente con las exigencias de las entidades tributarias.

En la siguiente imagen se describe, paso a paso, el flujo de recepción de documentos dentro de la plataforma Inbox:

Proceso de recepción República Dominicana

1. Métodos de envío del documento XML en Gosocket:

El proveedor carga el documento XML a través del API definida para RD. Los requisitos y condiciones para este proceso se detallan en los siguientes puntos.

2. Recepción y validación de documentos en Gosocket

El portal de Gosocket descarga y procesa el XML. Cuando se trata de un documento tributario, entra a un proceso de validación de recepción.

3. Validación de esquema del documento

En primer lugar, se realiza una validación de esquema al documento XML para garantizar que cumpla con el formato establecido por la entidad tributaria. Dependiendo del resultado de esta validación, el proceso puede derivar en uno de los siguientes escenarios:

a. Fallido: El documento no cumple con el formato fiscal, el flujo de recepción del documento quedará detenido por el error de esquema, se registrará en Gosocket con estado Error de esquema y en la interfaz se mostrará el ícono y en las notas del documento se detallará el motivo del rechazo, asi:

Icono error de esquema en inbox

Detalle del documento sección Notas - Error de Esquema

Detalle del procesamiento del XML del error de esquema

b. Exitoso: Si la validación del esquema del XML es correcta, el documento continuará con el flujo de recepción.

Detalle del documento sección Notas - Validación de esquema exitosa

información

Configuración especial: El XML presenta error de esquema, pero si se activa la configuración, esta opción permite continuar el flujo de recepción:

Esta característica se puede activar de forma independiente por cada empresa. Su objetivo es que, si se detecta un error de esquema en el XML al recibir el documento en Gosocket, el detalle del error puntual se registrará automáticamente en la sección de "Notas" del documento.

A pesar de este hallazgo, el documento continuará con su flujo normal hacia las siguientes validaciones de recepción, tales como la verificación de la firma y de la entidad tributaria.

El documento quedará en Inbox de la siguiente manera:

• En Gosocket el documento quedará en estado Validado ET con error esquema y se mostrará el icono naranja, así:

Para obtener más detalles sobre cómo configurar esta funcionalidad, consulte el siguiente apartado: Configuración XML presentan errores de esquema y continua el flujo de recepción. / XML Configuration Presents Schema Errors and Reception Flow Continues

4. Validación de firma electrónica del documento

En segundo lugar, se realiza una validación de firma electrónica del documento para garantizar que la información no haya sido alterada. De esta validación se puede obtener uno de los siguientes resultados:

c. Fallido: Significa que el documento ha sido alterado, el flujo de recepción del documento quedará detenido por el error de firma por lo que se registrará en Gosocket con estado Error de Firma, en la interfaz se mostrará un ícono y en las notas de la vista previa se indicará el motivo del rechazo, así:

Icono errror de firma en Inbox

Detalle del documento sección Notas - Error de Firma

Detalle del procesamiento del XML del error de firma

d. Exitoso: Si la validación de la firma electrónica del XML es correcta, el documento continuará con el flujo de recepción.

Detalle del documento sección Notas - Validación de firma exitosa

5.Validación del documento ante la Entidad Tributaría

En tercer lugar, se realiza la validación de consulta ante la Entidad Tributaria. De esta validación, se puede obtener varios resultados:

e. 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 ❗.

Icono Error en inbox: No hubo comunicación con la ET.

Detalle del documento sección Notas - Validación del documento ante la ET con error en la comunicación.

f. Validación previa del certificado de firma en Gosocket Activo

Gosocket realiza una validación previa en verificar si la empresa receptora tiene el certificado de firma cargado y activo en la plataforma de Gosocket, par a lo cual se derivan dos respuestas:

g. La empresa rceptora NO cuenta con el certificado vigente: para este escenario el documento no se recibe ni se almacena en inbox.

h. La empresa receptora SI cuenta con el certificado vigente: para este escenario, continua la validación del documento ante la Entidad Tributaría.

i. Al realizar la validación del documento ante la Entidad tributaria, se generan dos respuestas:

• Si existe el documento en la Entidad tributaria (Para más detalle en el literal j)
• No existe el documento en la Entidad Tributaria (Para más detalle en el literal m)

j. En este punto del proceso cuando el documento si existe en la entidad tributaria , se derivan dos respuestas:

• Si existe el documento, pero este tiene un estado Rechazado (Para más detalle en el literal k)
• Si existe el documento, pero este tiene un estado Aceptado (Para más detalle en el literal L)

k. Documento Rechazado por la Entidad Tributaria

En caso de que el documento presente alguno de los siguientes errores:

Códigos de motivo “No Recibido”:

1: Error de especificación (Esquema no válido).

2: Error de firma digital.

4: RNC comprador no corresponde.

Si el documento existe en la ET, pero hay algún motivo de rechazo en la Entidad Tributaria, su estado será Rechazado y se le asignara el icono .

Icono Rechazada en inbox: Validación del documento ante la ET rechazada

Detalle del documento sección Notas - Validación del documento ante la ET rechazado

L. Documento Aceptado por la Entidad Tributaria

Para lo anterior, el documento se gestiona de la siguiente manera en la plataforma de Gosocket:

• Se almacena en la plataforma.
• Se registra el error correspondiente.
• Se genera el acuse de recibo (ARECF).
• Se asigna el estado 1: e-CF No Recibido.

Si el resultado de las validaciones anteriores es satisfactorio y la consulta ante la entidad tributaria es exitosa, el documento se registrará en Gosocket con el estado Aceptado. En la interfaz, este estado se identificará con un ícono de verificación (check) verde.

Icono Aceptado en inbox: Validación del documento ante la ET exitosa

Detalle del documento sección Notas - Validación del documento ante la ET exitosa

m. Para el caso cuando el documento NO existe en la entidad tributaria , se realizará un proceso de reintento automatico:

• Indica que el documento recibido no se encuentra registrado en la ET.
• En Gosocket quedará con estado No Disponible en ET y al documento se le asignará 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.

Nota: Por cada reintento de consulta en la ET, se genera un registro en la sección Notas.

Detalle del documento sección Notas - Validación del documento ante la ET: No disponible

y posterior a estos reintentos se derivan dos respuestas:

n. 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.

Icono Rechazada en inbox: Validación del documento ante la ET

o. Si durante estos reintentos el documento es encontrado en la ET, se actualiza su estado donde el proceso continúa y se derivan dos respuestas:

• Si existe el documento, pero este tiene un estado Rechazado (Para más detalle en el literal k)
• Si existe el documento, pero este tiene un estado Aceptado (Para más detalle en el literal L)

6. Iconografía en inbox del resultado de las validaciones de recepción

Por último, tanto el emisor como el receptor podrán consultar los resultados de las validaciones del documento XML en Inbox, así:

No.	Estado	Icono en la interfaz de inbox
p	Documento tiene error de esquema
q	Documento tiene error de firma
r	Error de comunicación con la Entidad Tributaría
s	Documento quedó Rechazado por la Entidad Tributaría
t	Documento quedó Aceptado por la Entidad Tributaría
u	Documento no disponible o no existe en la Entidad Tributaría

7. Emisión de los acuses comerciales

Una vez que el documento fue recibido y validado, pueden emitirse los acuses mercantiles o comerciales que sean necesarios según su criterio desde la plataforma de inbox o en su defecto pueden ser enviados por la casilla de intercambio. Esto se explica con mayor detalle en el apartado Acuses comerciales

2. REPROCESAMIENTO DE DOCUMENTOS MANUALMENTE

Adicional, en Inbox se implementó un botón que permite reprocesar manualmente los documentos tributarios, que tengan estado “ERROR” ❗, “No Disponible en ET” .

información

Nota: Esta opción solo permite reprocesar documentos que hayan sido enviados por la casilla de intercambio, la API de recepción o la carga manual (upload).

Esta opción de reprocesamiento la encontraremos en la siguiente ruta según corresponda:

• 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.

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á baner en la parte superiro de la pagina que indicará que el o los documento se enviaron a reprocesar:

y finalmente, para cualquiera de los tres reprocesamientos que se genere por medio de esta opción en la sección notas se indicará:

• Registra el correo del usuario que realizo el reprocesamiento del documento.
• Genera una nota “Reprocesamiento del documento ejecutado por: correo@correo.com
• El documento continua el flujo de validación de recepción.

Este botón permite realizar un reprocesamiento de las diferentes validaciones del proceso de recepción:

2.1. Reprocesar documento:

Permite reprocesar el documento desde cero y realiza nuevamente las validaciones de recepción sin omitir ninunga validación, sin embargo, al seleccionar el documento y aplicarle este reporcesamiento, el sistema:

• Registra el correo del usuario que realizo el reprocesamiento del documento.
• Realiza las validaciones de recepción sin omitir ninguna de ellas.

---

3. MÉTODOS DE ENVÍO DE UN XML

Actualmente, existen tres métodos para la recepción de documentos al sistema:

• API : Conexión vía API para procesamiento integrado.

3.1. API

En el proceso de recepción hay tres APIs involucradas:

3.1.1. Autenticación

Su uso es opcional entre contribuyentes, no obstante, es recomendado para validar la identidad entre los mismos y la autoridad tributaria. A partir de ello se genera una sesión, dentro de la dirección hay dos endpoint:

3.1.2. Obtener Semilla

Se genera y entrega un archivo xml semilla para que posteriormente sea firmado digitalmente con un certificado y enviado al segundo endpoint para obtener el token.

• Sandbox: https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/autenticacion/api/semilla
• Producción: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/autenticacion/api/semilla

Método	GET
Parámetros	N/A
Respuesta	UN XML que posteriormente tendrá que ser firmado con un certificado digital para ser intercambiado por un token mediante el endpoint de ValidacionCertificado
Ejemplo	curl -X GET "https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/autenticacion/api/semilla" -H "accept: application/json"

3.1.3. Validación de Semilla y obtención de token

Se verifica la semilla y su firma teniendo como resultado la obtención de un token que emite el receptor para la autenticación.

• Sandbox: https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/autenticacion/api/validacioncertificado
• Producción: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/autenticacion/api/validacioncertificado

Método	POST
Parámetros	XML de semilla firmada, obtenida en URL anterior.
Respuesta	Un token con su fecha de expiración y expedición.
Ejemplo	curl -X POST "https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/autenticacion/api/validacioncertificado" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "xml=@semillaFimada.xml;type=text/xml"

3.1.4. URL de Recepción de documentos tributarios

URL de recepción de documentos tributarios, donde se encontrará el servicio web que recibirá los ECF que le sean emitidos.

• Sandbox: https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/recepcion/api/ecf
• Producción: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/recepcion/api/ecf

Método	POST
Parámetros	e-CF (XML)
Condicional a que se haya declarado autenticación	Un header  Authorization con el esquema Bearer y el valor del token obtenido en la autenticación (en caso de que se utilice).
Respuesta	Un XML que contiene la información de acuse de recibo (firmado con certificado digital)
Ejemplo	curl -X POST "https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/recepcion/api/ecf" -H "accept: application/xml" -H "Content-Type: multipart/form-data" -F "xml=Factura.xml;type=text/xml"

nota

Nota: Es necesario tener un certificado digital válido para firmar el Acuse de Recibo y emitir una respuesta a través de la API de Recepción. De esta forma se garantiza la recepción correcta de los e-CF.

El certificado debe estar configurado en Inbox y tener encendido el interruptor de Firma como se muestra a continuación:

3.1.5. Consideraciones para el envío de un XML por el API

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.

• En una sola carga se podrá cargar hasta n archivos XML.
• Se realizarán las mismas validaciones de esquema, firma, disponibilidad en la Entidad Tributaria y certificado que se hacen por el API.
• Deberán enviarse los documentos tributarios estipulados por la entidad tributaria en un formato XML. Estos documentos son:
  • Factura de Crédito Fiscal Electrónica
  • Factura de Consumo Electrónica
  • Nota de Débito Electrónica
  • Nota de Crédito Electrónica
  • Compras Electrónico
  • Gastos Menores Electrónico
  • Regímenes Especiales Electrónica
  • Gubernamental Electrónico
  • Comprobante para Exportaciones Electrónico
  • Comprobante para Pagos al Exterior Electrónico
  • Resumen de factura de consumo

---

4. ACUSES COMERCIALES

El acuse comercial tiene la finalidad de validar los documentos tributarios ante la Entidad Tributaria y como resultado, tendremos un cambio de estado dentro de nuestra bandeja de documentos recibidos en el Inbox de Gosocket.

Mediante el uso de estos eventos el receptor informa la recepción, aceptación o rechazo de cada documento.

Estos eventos se pueden generar desde dos puntos diferentes de Inbox que exploraremos a continuación.

4.1. URL aprobación comercial

URL de aprobación comercial, donde se encontrará el servicio web que recibirá los acuses comerciales del receptor del documento.

• Sandbox: https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/aprobacioncomercial/api/ecf
• Producción: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/aprobacioncomercial/api/ecf

Método	POST
Parámetros	ACECF (XML con el acuse comercial firmado con certificado digital)
Condicional a que se haya declarado autenticación	Un header  Authorization con el esquema Bearer y el valor del token obtenido en la autenticación (en caso que se utilice).
Respuesta	HTTP 200
Ejemplo	curl -X POST "https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/aprobacioncomercial/api/ecf" -H "accept: application/json" -H "Content-Type: multipart/form-data" -F "xml=ACECF.xml;type=text/xml"

nota

Nota: Para garantizar la correcta emisión del Acuse Comercial de los e-CF (ACECF), es obligatorio contar con un certificado digital válido, ya que este es necesario para firmar el ACECF.

El certificado debe estar configurado en Inbox y tener encendido el interruptor de Firma como se muestra a continuación:

4.2. Emitir manualmente el acuse comercial para estos documentos.

Estos eventos comerciales se pueden generar manualmente desde dos puntos diferentes de Inbox que exploraremos a continuación:

4.2.1. Botón Opciones (Documentos Recibidos)

1. Para acceder a esta opción y generar manualmente el acuse comercial que se requiere para el o los documentos, en inbox se debe seleccionar por medio del checkbox o selector los documentos que se requieren gestionar.

2. Ahora, se deberá seleccionar el boton “Opciones” y buscar la sección “Acuse comercial” que se encuentra ubicado: Inbox / Bandeja Recibidos / Boton Opciones / Sección: acuse comercial, Dentro de este menú, encontrará las siguientes opciones de Acuse Comercial:

1. Al seleccionar Aceptado se muestra la ventana emergente:
   1. Al Enviar se emite una aprobación comercial.

2. Al seleccionar Rechazado se muestra la ventana emergente:
   1. Ingrese el motivo del rechazo.
   2. Al enviar se emite el rechazo comercial del documento, que se envía al emisor.

Este evento se mostrará dentro de la vista previa del documento en el apartado de notas y se mostrará el XML del evento enviado a la Entidad Tributaria:

y en la parte de adjuntos como se muestra a continuación:

---

4.2.2. Aplicar acuses comerciales desde la previsualización del documento

Estos eventos se pueden generar también desde la previsualización del documento de Inbox que exploraremos a continuación.

Esta acción también se puede realizar desde la vista previa del documento a través del botón Acuse comercial.

4.2.3. Iconografía según el acuse comercial

Al ingresar a ver los documentos recibidos a través de la opción Recibidos de Inbox, se pueden observar los íconos que indican los tipos de acuses que se han generado para cada documento.

Aprobación comercial: Aceptación o Rechazo: Este estado informa acerca de la emisión del acuse sobre un documento que se puede mostrar en dos escenarios:

a. Gris, indica que el documento aún no tiene un acuse de recibo.

b. Verde, indica que el acuse se emitió Aceptado.

c. Rojo, indica que el acuse se emitió Rechazado.

aviso

Para obtener más detalles sobre la ejecución de acuses comerciales desde la API disponibles en esta sección, consulte el Manual de Inbox y API.

---

5. 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:

1. Sección de filtros para optimizar el resultado de la búsqueda. **
2. Control de orden de despliegue, con el que podrá modificar la forma en que se presentarán los resultados de la búsqueda. **
3. Lista de opciones vinculadas con la exportación, respuestas comerciales y movimientos internos de los Comprobantes Electrónicos. **
4. 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. **

aviso

* 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.

**1.**Validación de la entidad tributaria.

**2.**Validación de distribución.

**3.**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 Proceso de recepción de un XML.

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
	Error de Firma	Documento con error de firma
	Error de esquema	Documento con error de esquema
	Error de esquema pero continua el flujo *	El XML presenta error de esquema, pero si se activa la configuración, esta opción permite continuar el flujo de recepción.

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, firma o ET. Este proceso se explica a detalle en el apartado Reprocesamiento.

* Nota: Configuración especial: El XML presenta error de esquema, pero si se activa la configuración, esta opción permite continuar el flujo de recepción:

Esta característica se puede activar de forma independiente por cada empresa. Su objetivo es que, si se detecta un error de esquema en el XML al recibir el documento en Gosocket, el detalle del error puntual se registrará automáticamente en la sección de "Notas" del documento.

A pesar de este hallazgo, el documento continuará con su flujo normal hacia las siguientes validaciones de recepción, tales como la verificación de la firma y de la entidad tributaria.

El documento quedará en Inbox de la siguiente manera:

• En Gosocket el documento quedará en estado Validado ET con error esquema y se mostrará el icono naranja, así:

Para obtener más detalles sobre cómo configurar esta funcionalidad, consulte el siguiente apartado: Configuración XML presentan errores de esquema y continua el flujo de recepción. / XML Configuration Presents Schema Errors and Reception Flow Continues

---