República Dominicana: Recepción de documentos
1. FUNCIONAMIENTO
Flujo de recepción de documentos para República Dominicana
- El proveedor tiene la posibilidad de emitir el documento de dos maneras:
- El proveedor emite el documento y lo envía a la API de Recepción de
Gosocket. (En el apartado Forma de Envío - Vía API se explican las condiciones que se deben considerar para el envío). - El proveedor carga manualmente el XML a través del Upload de Gosocket (En el apartado Forma de Envío - Carga manual XML se explican las condiciones que se deben considerar en el envío).
- El proveedor emite el documento y lo envía a la API de Recepción de
Nota: Cuando se utilizan los canales de recepción de documentos, tanto la API como la carga manual del XML mediante la opción Upload, ambos procesos ejecutan las validaciones de esquema, firma y validación ante la ET (Entidad Tributaria).
-
El portal de Gosocket se encarga de la descarga y procesamiento de 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:
- 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. Además, se envía el acuse de recibo al emisor con el rechazo del documento. - Exitoso: El documento cumple con el formato fiscal, en ese caso continúa con la siguiente validación.
- 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
-
Se valida la firma electrónica del documento, esto para garantizar que no ha sido alterado. De esta validación se puede obtener uno de los siguientes resultados:
- Fallido: Significa que el documento ha sido alterado, por lo que será registrado en Gosocket con estado rechazado y se muestra en la iconografía el símbolo de exclamación rojo además, en las notas se indica el motivo del rechazo. Además, se emite un acuse de recibo al emisor con el rechazo del documento.
- Exitoso: En caso de que la validación de firma digital sea exitosa continúa con el flujo de recepción.
- Fallido: Significa que el documento ha sido alterado, por lo que será registrado en Gosocket con estado rechazado y se muestra en la iconografía el símbolo de exclamación rojo
-
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 (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.
Nota: Por cada reintento de consulta en la ET, se genera un registro en la sección Notas.
b. Documento rechazado en la ET
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 presenta algún motivo de rechazo en la Entidad Tributaria ya mencionado, su estado en Gosocket será Rechazado .
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.
Nota: Por cada reintento de consulta en la ET, se genera un registro en la sección Notas.
c. Documento registrado y sin errores ante la ET, pero se valida el certificado de Firma
Si el documento se encuentra correctamente registrado en la ET, Gosocket ejecuta una validación interna para verificar si la empresa tiene un certificado de firma activo en la plataforma:
Con certificado activo:
- Se emite y firma el acuse de recibo (ARECF) al emisor.
- El documento se marca con estado 0: e-CF Recibido.
- El documento se almacena en la plataforma.
Sin certificado activo:
- El documento no se recibe ni se almacena en la plataforma.
d. 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 ❗.
-
Si el resultado de las validaciones anteriores es satisfactorio el documento se registra en Gosocket con estado Aceptado y se muestra en la iconografía el símbolo
. -
Una vez que el documento fue recibido y validado correctamente, se emite el acuse comercial según el criterio del receptor. (Esto se explica con mayor detalle en el apartado de Acuses Comerciales )
a. Re- procesamiento automático de documentos tributarios adicional.
El Reprocesamiento se habilitó con el objetivo validar nuevamente los documentos que quedan con estado No Disponible en ET, los cuales se identifican con el ícono en Inbox:
Independientemente de la respuesta de la Entidad Tributaria sobre la existencia del documento, el sistema debe generar un acuse de recibo, ya que este es obligatorio.
El intervalo de ejecución es de 30 reprocesamientos cada 10 minutos.
- Si durante este intervalo se recibe una respuesta por parte de la Entidad Tributaria, el estado del documento se actualizará en Inbox. Sin embargo, este cambio no será notificado al cliente.
- En caso contrario, el documento permanecerá con el estado No Disponible en ET, manteniendo el ícono en Inbox.
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 consultar el estado del documento ante la ET y lo encontraremos en la siguiente ruta:
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 proceso de recepción de los documentos y acuses recibidos mediante la API de Gosocket en República Dominicana, la cual debe cumplir con el estándar de comunicación entre el emisor y receptor definido por la Dirección General de Impuestos Internos (DGII).
Existen dos formas de realizar el proceso de recepción de documentos en República Dominicana:
a. Vía API
b. Carga manual del XML a través del Upload de Gosocket
a. Vía API
En el proceso de recepción hay tres APIs involucradas:
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:
i. 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
· PRD: 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" |
ii. 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.
- PRD: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/autenticacion/api/validacioncertificado
- SBX: https://global-gosocket-api-rd-sbx.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" |
iii. 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.
- PRD: https://global-gosocket-api-rd-prd.azurewebsites.net/fe/recepcion/api/ecf
- SBX: https://global-gosocket-api-rd-sbx.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: 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:
b. Carga manual del XML 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 XML del documento.
La ruta de acceso es la siguiente: Menú principal > Upload > Carga Manual.
En esta opción, el usuario puede seleccionar el archivo XML 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 XML por la opción carga manual, se identificará:
- Cuantos archivos en total XML 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 XML cargado manualmente por esta opción y en caso contrario que el documento no tenga errores , se mostrará un detalle que se carga en la plataforma de Gosocket con éxito:
- finalmente el documento se visualizará en la bandeja de recibidos de inbox:
i. Consideraciones para la carga manual del XML
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
3. ACUSES COMERCIALES
a. URL aprobación comercial
URL de aprobación comercial, donde se encontrará el servicio web que recibirá los acuses comerciales del receptor del documento.
- SBX: https://global-gosocket-api-rd-sbx.azurewebsites.net/fe/aprobacioncomercial/api/ecf
- PRD: 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: 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:
b. Generación de acuses comerciales
Además de permitir la recepción y validación de documentos fiscales, Gosocket también cuenta con la opción de emitir la aprobación comercial para estos documentos.
El acuse comercial tiene la finalidad de validar los documentos ante la Entidad Tributaria y como resultado, tendremos un cambio de estado dentro de nuestra bandeja de documentos recibidos en el Inbox de Gosocket
Estos eventos se pueden generar desde dos puntos diferentes de Inbox que exploraremos a continuación:
i. Botón Opciones (Documentos Recibidos)
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.
- Sección para marcar uno o varios documentos para realizar la generación las diferentes acciones que se tiene.
- Menú de opciones donde estará la funcionalidad de generar el acuse comercial.
Dentro de este menú encontrará las siguientes opciones de Acuse Comercial:
- Al seleccionar Aceptado se muestra la ventana emergente:
- Al Enviar se emite una aprobación comercial.
- Al seleccionar Rechazado se muestra la ventana emergente:
- Ingrese el motivo del rechazo.
- Al enviar se emite el rechazo comercial del documento, que se envía al emisor.
Una vez que se generó el acuse comercial, se mostrará su registro en la vista previa del documento en el apartado de notas y el XML del evento enviado a la Entidad Tributaria se mostrará en la parte de adjuntos como lo vemos a continuación:
ii. Aplicar acuses comerciales desde la previsualización del documento
Esta acción se puede realizar desde la vista previa del documento a través del botón Acuse comercial.
iii. 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.
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.
4. 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 |
**Nota:**Al dar clic en el documento se abrirá la previsualización del documento donde podrá revisar las notas relacionadas con el motivo de rechazo.
Nota: para el caso en el que el documento quede en estado “ERROR”, el usuario podrá reprocesarlo a través del botón “Reprocesar documento” con el objetivo de realizar nuevamente las validaciones de esquema, firma o ET. Este proceso se explica a detalle en el apartado “Botón Opciones (Reprocesar documento)”.
Finlamente, 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.