# API Reference — República Dominicana (doc V1.0.4)

> Documentación técnica de la API REST para certificar, anular y consultar DTE en el régimen FEL ante Dirección General de Impuestos Internos (DGII).


## Ambientes

- **Test:** `https://testnucdo.digifact.com/api` — corriendo **V2.6.1**
- **Producción:** `https://nucdo.digifact.com/api` — corriendo **V2.6.2**

> La versión de este documento (V1.0.4) y la versión del servicio son números independientes. Para saber qué está corriendo, consultá la raíz del ambiente (`GET https://testnucdo.digifact.com/api`), que responde con el número actual.

## Soporte

- **Email:** soporte@digifact.com.do
- **Teléfono:** +502 4219-2222

---

## Endpoints

### POST · Obtención del TOKEN (GET TOKEN)

El primer paso es la obtención del TOKEN, este se utilizará como forma de autenticación para las peticiones que se detallan más adelante. Para obtener el Token deberá agregar en el Body/Cuerpo de la solicitud, los atributos: Username, y el Password, proporcionado en las credenciales, enviados en formato JSON.

**URL Test:** `https://testnucdo.digifact.com/api/login/get_token`
**URL Prod:** `https://nucdo.digifact.com/api/login/get_token`

#### Body

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `Username` | string | Sí | Concatenación separada por punto (.): DO + "." + <RNC del usuario> + "." + <Nombre de usuario> | `DO.132752155.USER_TEST` |
| `Password` | string | Sí | Password brindado en las credenciales TEST o Productivas | — |

#### Body de ejemplo (JSON)

```json
{
  "Username": "DO.132752155.USER_TEST",
  "Password": "s142$%SAF"
}
```

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|

#### Ejemplo de Respuesta

```http
{
    "Token": "eyJhbGciOiJIUzI1NiIsInR5cCI6I....",
    "expira_en": "9/16/2026 4:58:31 PM",
    "otorgado_a": "DO.132752155.USER_TEST"
}
```

#### Notas

- ℹ️ El token generado tendrá una vigencia de 30 días a partir del momento que se solicita.
- ⚠️ Una vez se haya vencido el token el API mostrará como respuesta a cualquier petición el mensaje con el código de error 401 o Unauthorized. Y será necesario generar un nuevo token para poder realizar consultas autorizadas al API.
- ℹ️ El token se deberá agregar como encabezado en la petición, ingresando el nombre de Authorization y en su valor el Token vigente.
- ⚠️ Solicitar credenciales. Únicamente funciona con credenciales productivas cuando se da de alta a un RNC en nuestros sistemas.

---

### POST · CERTIFICATE DTE V2 (formato JSON) (CERTIFICATE DTE V2 JSON)

Esta operación permitirá certificar un Documento Tributario Electronico (DTE), el cual se espera dentro del Body de la petición. El cuerpo de la petición debe cumplir con el esquema JSON detallado en la Documentación Técnica del esquema NUC. La operación CERTIFICATE DTE V2 hará todas las validaciones que la Dirección General de Impuestos Internos ha normado tanto en su documentación técnica, como en lo publicado en el régimen de factura electrónica.

**URL Test:** `https://testnucdo.digifact.com/api/v2/transform/nuc_json`
**URL Prod:** `https://nucdo.digifact.com/api/v2/transform/nuc_json`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Content-type` | Sí | application/json |
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | — | Sí | RNC del usuario. Ej.: 132752155 | `132752155` |
| `FORMAT` | — | Sí | Posibles valores: XML, PDF, HTML. Se deben ingresar separados por "!" por ejemplo PDF!HTML!XML | `XML!HTML` |
| `USERNAME` | — | Sí | Usuario asignado de Test o Productivo según sea el caso. Ejemplo: UsuarioEjemplo1 | `USER_EXAMPLE` |

#### Body

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `BODY (raw)` | — | Sí | De acuerdo con la documentación proporcionada del NUC para República Dominicana en formato JSON | — |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `code` | string | contiene el código de la respuesta obtenida |
| `message` | string | contiene un mensaje informativo relacionado a la respuesta |
| `description` | string | descripción adicional del mensaje |
| `responseData1` | string | Texto codificado en base64 del xml NUC del DTE enviado. |
| `responseData2` | string | texto codificado en base64 que contiene la factura el formato HTML |
| `responseData3` | string | texto codificado en base64 que contiene la factura el formato PDF |
| `authNumber` | string | Identificador único del documento electrónico. Corresponde a un GUID v4. |
| `url` | string | Contiene el enlace para consultar el documento emitido |
| `infoDetails` | array | atributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el XML NUC. |
| `suggestedFileName` | string | nombre sugerido para nombrar y guardar el contenido de la información que contiene el responseData1, responseData2, responseData3 o algún otro documento relacionado con la información de la factura emitida. |
| `suggestedFileName2` | string | otro nombre sugerido |
| `batch` | string | Secuencia autorizada por la DGII. atributo sin valor por el momento |
| `serial` | string | atributo sin valor por el momento |
| `issuedTimeStamp` | string | fecha de emisión de la factura electrónica |
| `taxID` | string | RNC del contribuyente emisor de la factura |
| `name` | string | nombre o razón social del emisor |
| `branchCode` | string | código de establecimiento o sucursal donde fue emitida la factura, atributo sin valor por el momento |
| `branchName` | string | nombre comercial, atributo sin valor por el momento |
| `receiverTaxID` | string | RNC o identificador del receptor/comprador. atributo sin valor por el momento |
| `receiverName` | string | nombre o razón social del receptor |
| `discounts` | string | indica el total de descuentos aplicados a la factura, atributo sin valor por el momento |
| `taxes` | string | indica el total de impuestos aplicados a la factura, atributo sin valor por el momento |
| `subtotal` | string | subtotal de la factura, atributo sin valor por el momento |
| `totalAmount` | string | monto total de la factura, atributo sin valor por el momento |
| `enrolledTimeStamp` | string | fecha y hora de certificación de la factura |
| `backprocessor` | string | servidor que realiza la consulta |
| `additionalInfo` | object | Atributo tipo objeto que contiene información adicional sobre la factura emitida. atributo sin valor por el momento |

#### Ejemplo de Respuesta

```http
{
    "code": 1,
    "message": "Documento certificado exitosamente!",
    "description": "",
    "responseData1": "",
    "responseData2": "",
    "responseData3": "",
    "authNumber": "",
    "url": "",
    "infoDetails": [],
    "suggestedFileName": "",
    "suggestedFileName2": "",
    "batch": "",
    "serial": "",
    "issuedTimeStamp": "",
    "taxID": "",
    "name": "",
    "branchCode": "",
    "branchName": "",
    "receiverTaxID": "",
    "receiverName": "",
    "discounts": "",
    "taxes": "",
    "subTotal": "",
    "totalAmount": "",
    "enrolledTimeStamp": "",
    "backprocessor": "",
    "additionalInfo": 
}
```

#### Notas

- ⚠️ Previo al uso de esta operación deberá proporcionarnos su firma electrónica con certificado de persona física para procedimientos tributarios y contraseña asignada a dicha firma, la cual se puede obtener por distintas entidades dedicadas a proporcionar firmas digitales. Esta firma será la utilizada para los entornos de Test y Productivo.
- ℹ️ Ejemplo de URL: https://testnucdo.digifact.com/api/v2/transform/nuc_json?TAXID=132752155&FORMAT=XML|HTML&USERNAME=USER_EXAMPLE
- ℹ️ Para los envíos XML o JSON, el resultado será el mismo y será entregado en formato JSON.

---

### POST · CERTIFICATE DTE V2 (formato XML) (CERTIFICATE DTE V2 XML)

Esta operación permitirá certificar un Documento Tributario Electronico (DTE), el cual se espera dentro del Body de la petición. El cuerpo de la petición debe cumplir con el esquema XML detallado en la Documentación Técnica del esquema NUC. La operación CERTIFICATE DTE V2 hará todas las validaciones que la Dirección General de Impuestos Internos ha normado tanto en su documentación técnica, como en lo publicado en el régimen de factura electrónica.

**URL Test:** `https://testnucdo.digifact.com/api/v2/transform/nuc`
**URL Prod:** `https://nucdo.digifact.com/api/v2/transform/nuc`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Content-type` | Sí | application/xml |
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | — | Sí | RNC del usuario. Ej.: 132752155 | `132752155` |
| `FORMAT` | — | Sí | Posibles valores: XML, PDF, HTML. Se deben ingresar separados por "!" por ejemplo PDF!HTML!XML | `XML!HTML` |
| `USERNAME` | — | Sí | Usuario asignado de Test o Productivo según sea el caso. Ejemplo: UsuarioEjemplo1 | `USER_EXAMPLE` |

#### Body

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `BODY (raw)` | — | Sí | De acuerdo con la documentación proporcionada del NUC para República Dominicana en formato XML | — |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `code` | string | contiene el código de la respuesta obtenida |
| `message` | string | contiene un mensaje informativo relacionado a la respuesta |
| `description` | string | descripción adicional del mensaje |
| `responseData1` | string | Texto codificado en base64 del xml NUC del DTE enviado. |
| `responseData2` | string | texto codificado en base64 que contiene la factura el formato HTML |
| `responseData3` | string | texto codificado en base64 que contiene la factura el formato PDF |
| `authNumber` | string | Identificador único del documento electrónico. Corresponde a un GUID v4. |
| `url` | string | Contiene el enlace para consultar el documento emitido |
| `infoDetails` | array | atributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el XML NUC. |
| `suggestedFileName` | string | nombre sugerido para nombrar y guardar el contenido de la información de la factura emitida. |
| `suggestedFileName2` | string | otro nombre sugerido |
| `batch` | string | Secuencia autorizada por la DGII. atributo sin valor por el momento |
| `serial` | string | atributo sin valor por el momento |
| `issuedTimeStamp` | string | fecha de emisión de la factura electrónica |
| `taxID` | string | RNC del contribuyente emisor de la factura |
| `name` | string | nombre o razón social del emisor |
| `branchCode` | string | código de establecimiento o sucursal donde fue emitida la factura, atributo sin valor por el momento |
| `branchName` | string | nombre comercial, atributo sin valor por el momento |
| `receiverTaxID` | string | RNC o identificador del receptor/comprador. atributo sin valor por el momento |
| `receiverName` | string | nombre o razón social del receptor |
| `discounts` | string | indica el total de descuentos aplicados a la factura, atributo sin valor por el momento |
| `taxes` | string | indica el total de impuestos aplicados a la factura, atributo sin valor por el momento |
| `subtotal` | string | subtotal de la factura, atributo sin valor por el momento |
| `totalAmount` | string | monto total de la factura, atributo sin valor por el momento |
| `enrolledTimeStamp` | string | fecha y hora de certificación de la factura |
| `backprocessor` | string | servidor que realiza la consulta |
| `additionalInfo` | object | Atributo tipo objeto que contiene información adicional sobre la factura emitida. atributo sin valor por el momento |

#### Ejemplo de Respuesta

```http
{
    "code": 1,
    "message": "Documento certificado exitosamente!",
    "description": "",
    "responseData1": "",
    "responseData2": "",
    "responseData3": "",
    "authNumber": "",
    "url": "",
    "infoDetails": [],
    "suggestedFileName": "",
    "suggestedFileName2": "",
    "batch": "",
    "serial": "",
    "issuedTimeStamp": "",
    "taxID": "",
    "name": "",
    "branchCode": "",
    "branchName": "",
    "receiverTaxID": "",
    "receiverName": "",
    "discounts": "",
    "taxes": "",
    "subTotal": "",
    "totalAmount": "",
    "enrolledTimeStamp": "",
    "backprocessor": "",
    "additionalInfo": 
}
```

#### Notas

- ⚠️ Previo al uso de esta operación deberá proporcionarnos su firma electrónica con certificado de persona física para procedimientos tributarios y contraseña asignada a dicha firma. Esta firma será la utilizada para los entornos de Test y Productivo.
- ℹ️ Ejemplo de URL: https://testnucdo.digifact.com/api/v2/transform/nuc?TAXID=132752155&FORMAT=XML|HTML&USERNAME=USER_EXAMPLE
- ℹ️ Para los envíos XML o JSON, el resultado será el mismo y será entregado en formato JSON.

---

### GET · GET DOCUMENT (GetDocument)

Operación de tipo GET, permitirán obtener un documento en diferentes formatos, por medio del Código de Generación.

**URL Test:** `https://testnucdo.digifact.com/api/GetDocument`
**URL Prod:** `https://nucdo.digifact.com/api/GetDocument`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `AUTHNUMBER` | — | Sí | Identificador único del documento: el e-NCF (Número de Comprobante Fiscal Electrónico). | `E31000085979` |
| `TAXID` | — | Sí | RNC del emisor del documento a obtener. | `132752155` |
| `FORMAT` | — | Sí | Tipo de formato en que se desea recibir el documento codificado en base64, puede ser XML, HTML, PDF o JSON, separados por "!". Ej. Si se desea recibir el documento en formato HTML y PDF: HTML!PDF | `HTML!PDF` |
| `USERNAME` | — | Sí | Nombre de usuario que realiza la petición | — |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | Array | Contiene la información general de la consulta ejecutada. En la primera y única posición del arreglo se incluyen los siguientes atributos: { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }. |
| `RESPONSE` | Array | Contiene el resultado de la consulta. En la primera y única posición del arreglo se incluyen los siguientes atributos: { "ResponseData1", "ResponseData2", "ResponseData3" }. |
| `ResponseData1` | String | Documento electrónico en formato XML codificado en Base64. |
| `ResponseData2` | String | Documento electrónico en formato HTML codificado en Base64. |
| `ResponseData3` | String | Documento electrónico en formato PDF codificado en Base64. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": ""
        }
    ],
    "RESPONSE": [
        {
            "ResponseData1": "",
            "ResponseData2": "",
            "ResponseData3": ""
        }
    ]
}
```

#### Notas

- ℹ️ Ejemplo de url: https://testnucdo.digifact.com/api/GetDocument?TAXID=06142308221025&AUTHNUMBER=4D19A6D5-05B6-4D96-9EA4-7D75620B48CE&USERNAME=TESTUSER&FORMAT=xml
- ⚠️ Solicitar credenciales. Únicamente funciona con credenciales productivas cuando se da de alta a un RNC en nuestros sistemas.

---

### GET · SHARED_GETDTEINFO  (GETDTEINFO )

Permite obtener la información de un documento enviando el número de 
identificación el cual es el ENCF

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | — | Sí | RNC del emisor del documento a obtener. | `132752155` |
| `USERNAME` | — | Sí | Nombre de usuario que realiza la petición | `USER_TEST` |
| `DATA1` | — | Sí | nombre de la operación a realizar. en este caso Obtener Info | `SHARED_GETDTEINFO` |
| `DATA2` | — | Sí | Indice AUTHNUMBRE dividido con pipeline indicando el numero del ENCF de la informacion a obtener. | `AUTHNUMBER|E310008569878` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información general sobre el resultado de la consulta realizada. |
| `Respuesta` | integer | Indica el resultado de la operación. Generalmente 1 cuando la consulta fue procesada correctamente. |
| `Codigo` | integer | Código de respuesta devuelto por el servicio. |
| `Procesador` | string | Identificador del servidor o ambiente que procesó la solicitud. |
| `Mensaje` | string | Mensaje informativo asociado al resultado de la consulta. |
| `Descripcion` | string | Descripción adicional relacionada con la respuesta. |
| `Fecha` | string | Fecha y hora en que fue procesada la consulta. |
| `RESPONSE` | array | Contiene los datos del documento electrónico consultado. |
| `RNCEmisor` | string | RNC del contribuyente emisor del e-CF. |
| `TipoECF` | string | Descripción del tipo de comprobante fiscal electrónico. |
| `DocumentGUID` | string | Identificador único del documento electrónico. Corresponde a un GUID. |
| `NumeroSecuencia` | string | Número de comprobante fiscal electrónico (e-CF). |
| `Anulado` | string | Indica si el documento ha sido anulado. Valores esperados: Sí o No. |
| `FechaEmision` | string | Fecha de emisión del documento electrónico. |
| `FechaCertificacion` | string | Fecha y hora en que el documento fue certificado por el proveedor autorizado. |
| `IdReceptor` | string | RNC o identificador tributario del receptor del documento. |
| `NombreReceptor` | string | Nombre o razón social del receptor. |
| `ITBIS` | string | Monto total de ITBIS registrado en el documento. |
| `Total` | string | Monto total del documento electrónico. |
| `Items` | string | Cantidad de líneas o ítems incluidos en el documento. |
| `Xml` | string | Contenido del XML del documento electrónico codificado en Base64. |
| `ResultadoTrackID` | string | Identificador único de seguimiento asociado al procesamiento del documento. |
| `ResultadoEstado` | string | Estado actual del documento en DGII. |
| `ResultadoMensaje` | string | Mensaje devuelto por el DGII, el resultado del procesamiento o validación. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-17T13:58:10-06:00"
        }
    ],
    "RESPONSE": [
        {
            "RNCEmisor": "132752155",
            "TipoECF": "Factura de Credito Fiscal Electronica",
            "DocumentGUID": "080AC324-28EC-447E-A594-6A842AE798F0",
            "NumeroSecuencia": "E310008569878",
            "Anulado": "No",
            "FechaEmision": "7/7/2027 12:00:00 AM",
            "FechaCertificacion": "7/7/2026 10:44:10 AM",
            "IdReceptor": "130680681",
            "NombreReceptor": "LAS PALMAS CIGAR COMPANY SRL .",
            "ITBIS": "0.000000",
            "Total": "100.000000",
            "Items": "1",
            "Xml": "PD94bWwgdm...",
            "ResultadoTrackID": "f0813836-634d-4ae9-abbb-3021125c5b25",
            "ResultadoEstado": "Aceptado",
            "ResultadoMensaje": "0 - "
        }
    ]
}
```

#### Notas

- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETDTEINFO&DATA2=AUTHNUMBER|E310008569878. En este ejemplo se consulta la información de un documento electrónico utilizando el número de autorización (AUTHNUMBER).

---

### GET · GETDTEINFO_BY_INTERNALID (GETDTEINFO_BY_INTERNALID)

Permite obtener la información de un documento según su número de 
referencia interna. 

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | — | Sí | RNC del emisor asociado al documento electrónico cuya información se desea consultar. | `130666182` |
| `USERNAME` | — | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `USER_TEST` |
| `DATA1` | — | Sí | Nombre de la operación a ejecutar. En este caso, consulta la información de un documento electrónico utilizando una referencia interna. | `SHARED_GETDTEINFO_BY_INTERNALID` |
| `DATA2` | — | Sí | Parámetros de búsqueda concatenados mediante el carácter pipeline (\|). Debe incluir el identificador interno del documento mediante el índice REFERENCIA_INTERNA y la fecha de emisión mediante el índice ISSUEDDATE. Ejemplo: REFERENCIA_INTERNA\|PT-1056\|ISSUEDDATE\|2026-07-20. | `REFERENCIA_INTERNA|PT-1056|ISSUEDDATE|2026-07-20` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información general sobre el resultado de la consulta realizada. |
| `Respuesta` | integer | Indica el resultado de la operación. Generalmente 1 cuando la consulta fue procesada correctamente. |
| `Codigo` | integer | Código de respuesta devuelto por el servicio. |
| `Procesador` | string | Identificador del servidor o ambiente que procesó la solicitud. |
| `Mensaje` | string | Mensaje informativo asociado al resultado de la consulta. |
| `Descripcion` | string | Descripción adicional relacionada con la respuesta. |
| `Fecha` | string | Fecha y hora en que fue procesada la consulta. |
| `RESPONSE` | array | Contiene los datos del documento electrónico consultado. |
| `RNCEmisor` | string | RNC del contribuyente emisor del e-CF. |
| `TipoECF` | string | Descripción del tipo de comprobante fiscal electrónico. |
| `DocumentGUID` | string | Identificador único del documento electrónico. Corresponde a un GUID. |
| `NumeroSecuencia` | string | Número de comprobante fiscal electrónico (e-CF). |
| `Anulado` | string | Indica si el documento ha sido anulado. Valores esperados: Sí o No. |
| `FechaEmision` | string | Fecha de emisión del documento electrónico. |
| `FechaCertificacion` | string | Fecha y hora en que el documento fue certificado por el proveedor autorizado. |
| `IdReceptor` | string | RNC o identificador tributario del receptor del documento. |
| `NombreReceptor` | string | Nombre o razón social del receptor. |
| `ITBIS` | string | Monto total de ITBIS registrado en el documento. |
| `Total` | string | Monto total del documento electrónico. |
| `Items` | string | Cantidad de líneas o ítems incluidos en el documento. |
| `Xml` | string | Contenido del XML del documento electrónico codificado en Base64. |
| `ResultadoTrackID` | string | Identificador único de seguimiento asociado al procesamiento del documento. |
| `ResultadoEstado` | string | Estado actual del documento en DGII. |
| `ResultadoMensaje` | string | Mensaje devuelto por el DGII, el resultado del procesamiento o validación. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-17T13:58:10-06:00"
        }
    ],
    "RESPONSE": [
        {
            "RNCEmisor": "132752155",
            "TipoECF": "Factura de Credito Fiscal Electronica",
            "DocumentGUID": "080AC324-28EC-447E-A594-6A842AE798F0",
            "NumeroSecuencia": "E310008569878",
            "Anulado": "No",
            "FechaEmision": "7/7/2027 12:00:00 AM",
            "FechaCertificacion": "7/7/2026 10:44:10 AM",
            "IdReceptor": "130680681",
            "NombreReceptor": "LAS PALMAS CIGAR COMPANY SRL .",
            "ITBIS": "0.000000",
            "Total": "100.000000",
            "Items": "1",
            "Xml": "PD94bWwgd...",
            "ResultadoTrackID": "f0813836-634d-4ae9-abbb-3021125c5b25",
            "ResultadoEstado": "Aceptado",
            "ResultadoMensaje": "0 - "
        }
    ]
}
```

#### Notas

- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETDTEINFO_BY_INTERNALID&DATA2=REFERENCIA_INTERNA|JHE-20260815-181047|ISSUEDDATE|2026-08-15

---

### GET · SHARED_GETINFORTAXID (GETINFORTAXID)

Permite obtener la información asociada a un RNC, como su razón social, 
email, entre otros.

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | — | Sí | RNC del contribuyente cuya información se desea consultar. | `132752155` |
| `USERNAME` | — | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `USER_TEST` |
| `DATA1` | — | Sí | Nombre de la operación a ejecutar. En este caso, obtiene información asociada a un RNC registrado. | `SHARED_GETINFORTAXID` |
| `DATA2` | — | Sí | Parámetro de búsqueda compuesto por el índice RNC y el número de RNC a consultar, separados por el carácter pipeline (\|). Ejemplo: RNC\|132752155. | `RNC|132752155` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información sobre el resultado y procesamiento de la solicitud. |
| `Respuesta` | integer | Indica el resultado general de la operación. El valor 1 significa que la consulta fue procesada exitosamente. |
| `Codigo` | integer | Código de respuesta devuelto por el servicio. |
| `Procesador` | string | Identificador del ambiente o procesador que atendió la solicitud. |
| `Mensaje` | string | Mensaje devuelto por el servicio. Puede contener información adicional o detalles de errores. |
| `Descripcion` | string | Descripción complementaria asociada al resultado de la solicitud. |
| `Fecha` | datetime | Fecha y hora en que la solicitud fue procesada. |
| `RESPONSE` | array | Información del contribuyente asociado al RNC consultado. |
| `TAXID` | string | Número de RNC del contribuyente. |
| `NAME` | string | Nombre o razón social registrada para el contribuyente. |
| `NRC` | string | Número de registro asociado al contribuyente, cuando aplique. |
| `EMAIL` | string | Dirección de correo electrónico registrada para el contribuyente. |
| `COUNTRYCODE` | string | Código ISO del país donde está registrado el contribuyente. |
| `CODIGOACTIVIDAD` | string | Código de la actividad económica registrada para el contribuyente. |
| `PHONE` | string | Número telefónico registrado para el contribuyente. |
| `TYPE` | string | Tipo de identificación tributaria consultada. |
| `STATUS` | string | Estado actual del contribuyente en el registro tributario. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-18T09:25:24-06:00"
        }
    ],
    "RESPONSE": [
        {
            "TAXID": "132752155",
            "NAME": "DIGIFACT SERVICIOS SAS",
            "NRC": "",
            "EMAIL": "",
            "COUNTRYCODE": "DO",
            "CODIGOACTIVIDAD": "",
            "PHONE": "",
            "TYPE": "RNC",
            "STATUS": "ACTIVO"
        }
    ]
}
```

#### Notas

- ℹ️ La información presentada en la sección RESPONSE corresponde a los datos del contribuyente para el RNC consultado.
- ℹ️ El campo STATUS indica el estado actual del contribuyente ante la DGII. Un valor de 'ACTIVO' confirma que el RNC se encuentra habilitado y vigente en el registro tributario de la DGII al momento de la consulta.
- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETINFORTAXID&DATA2=RNC|132752155. En este ejemplo se consulta la información registrada para el RNC 132752155.

---

### GET · GETREPORTDAILYFELALL  (GETREPORTDAILYFELALL )

Permite obtener un reporte del día de los documentos emitidos por sucursal

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | string | Sí | RNC del emisor para el cual se desea consultar el reporte diario consolidado de documentos electrónicos. | `132752155` |
| `USERNAME` | string | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `USER_TEST` |
| `DATA1` | string | Sí | Nombre de la operación a ejecutar. En este caso permite consultar el reporte diario consolidado de documentos electrónicos emitidos. | `SHARED_GETREPORTDAILYFELALL` |
| `DATA2` | string | Sí | Parámetros de búsqueda concatenados mediante el carácter pipeline (\|). | `FECHA|2026-08-14|ESTABLECIMIENTO|0001|ENCF||TIPO||DEC|2` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información sobre el resultado de la consulta y el procesamiento realizado por el servicio. |
| `RESPONSE` | array | Listado de documentos electrónicos encontrados para los criterios de búsqueda enviados. |
| `GUID` | string | Identificador único asignado al documento electrónico dentro de la plataforma Digifact. |
| `TIPO_DTE` | string | Código del tipo de documento electrónico emitido. |
| `ENCF` | string | Número de e-NCF asociado al documento. |
| `NUMEROFACTURAINTERNA` | string | Número o referencia interna utilizada por el emisor para identificar el documento. |
| `EMISOR` | string | RNC del emisor del documento electrónico. |
| `NOMBRE_EMISOR` | string | Nombre o razón social del emisor registrado en el documento. |
| `BRANCH_NAME` | string | Código del establecimiento desde el cual fue emitido el documento. |
| `RECEPTOR` | string | RNC o identificación tributaria del receptor. |
| `NOMBRE_RECEPTOR` | string | Nombre o razón social del receptor del documento. |
| `ESTATUS` | string | Campo reservado para información adicional relacionada con el estatus del documento. |
| `FECHA_DE_EMISION` | datetime | Fecha de emisión registrada en el documento electrónico. |
| `FECHA_DE_CERTIFICACION` | datetime | Fecha y hora en que el documento fue certificado por Digifact. |
| `INFORMACIONADICIONALEMISOR` | string | Información complementaria proporcionada por el emisor. |
| `ANULADO` | string | Indica si el documento ha sido anulado. |
| `FECHA_DE_ANULACION` | string | Fecha de anulación del documento cuando corresponda. |
| `TRACKID` | string | Identificador único de seguimiento asignado por la DGII al documento electrónico. |
| `CODIGOSEGURDAD` | string | Código de seguridad utilizado para la validación pública del documento ante la DGII. |
| `LINK_CONSULTA_DGII` | string | URL de consulta pública que permite verificar la validez del documento en la DGII. |
| `SECUENCIA_UTILIZADA` | boolean | Indica si la secuencia fiscal del documento ya había sido utilizada anteriormente. |
| `MONTO_EXENTO` | decimal | Monto total exento de impuestos incluido en el documento. |
| `MONTO_GRAVADO` | decimal | Monto sujeto a impuestos registrado en el documento. |
| `MONTO_GRAVADO1` | decimal | Monto gravado correspondiente a la tasa principal de ITBIS. |
| `MONTO_IMPUESTO_ADICIONAL` | decimal | Monto total de impuestos adicionales aplicados al documento. |
| `MONTO_FACTURABLE` | decimal | Monto facturable calculado para el documento. |
| `MONTO_TOTAL` | decimal | Monto total final del documento electrónico. |
| `METODO_PAGO` | string | Detalle de los métodos de pago utilizados y sus respectivos montos. |
| `TOTALITBIS` | decimal | Monto total de ITBIS aplicado al documento. |
| `TOTALITBIS1` | decimal | Monto de ITBIS correspondiente a la primera tasa aplicada. |
| `TOTALITBIS2` | decimal | Monto de ITBIS correspondiente a la segunda tasa aplicada. |
| `TOTALITBIS3` | decimal | Monto de ITBIS correspondiente a la tercera tasa aplicada. |
| `TOTALDTE` | decimal | Valor total reportado por el documento electrónico. |
| `ESTADO` | string | Resultado devuelto por la DGII para el documento. Los valores más comunes son Aceptado o Rechazado. |
| `MENSAJES` | string | Mensajes o validaciones retornadas por la DGII durante el proceso de certificación. |
| `ENCF_MODIFICADO` | string | e-NCF relacionado o afectado por el documento actual, cuando aplique. |

#### Ejemplo de Respuesta

```http
{
  "REQUEST_DATA": [
    {
      "Respuesta": 1,
      "Codigo": 1,
      "Procesador": "TEST_DO",
      "Mensaje": "",
      "Descripcion": "106 ITEMS",
      "Fecha": "2026-08-18T09:48:41-06:00"
    }
  ],
  "RESPONSE": [
    {
      "GUID": "E320000002719",
      "TIPO_DTE": "32",
      "ENCF": "E320000002719",
      "NUMEROFACTURAINTERNA": "",
      "EMISOR": "132752155",
      "NOMBRE_EMISOR": "",
      "BRANCH_NAME": "0001",
      "RECEPTOR": "",
      "NOMBRE_RECEPTOR": "Consumidor Final",
      "ESTATUS": "",
      "FECHA_DE_EMISION": "8/14/2026 12:00:00 AM",
      "FECHA_DE_CERTIFICACION": "8/14/2026 11:41:21 AM",
      "INFORMACIONADICIONALEMISOR": "",
      "ANULADO": "",
      "FECHA_DE_ANULACION": "--",
      "TRACKID": "449bc8c4-3de0-4aef-8eed-70ef02eefd6c",
      "CODIGOSEGURDAD": "QHCZ8e",
      "LINK_CONSULTA_DGII": "https://fc.dgii.gov.do/TesteCF/ConsultaTimbreFC?RncEmisor=132752155&ENCF=E320000002719&MontoTotal=500&CodigoSeguridad=QHCZ8e",
      "SECUENCIA_UTILIZADA": "False",
      "MONTO_EXENTO": "500",
      "MONTO_GRAVADO": "0",
      "MONTO_GRAVADO1": "0",
      "MONTO_IMPUESTO_ADICIONAL": "0",
      "MONTO_FACTURABLE": "0",
      "MONTO_TOTAL": "500",
      "METODO_PAGO": "Efectivo: 500 ",
      "TOTALITBIS": "0",
      "TOTALITBIS1": "0",
      "TOTALITBIS2": "0",
      "TOTALITBIS3": "0",
      "TOTALDTE": "500",
      "ESTADO": "Aceptado",
      "MENSAJES": "",
      "ENCF_MODIFICADO": ""
    }
  ]
}

```

#### Notas

- ℹ️ Este servicio permite obtener reportes de documentos electrónicos emitidos por establecimiento.
- ℹ️ Si se requiere consultar todos los documentos de un contribuyente, debe ejecutarse el servicio para cada establecimiento y consolidar los resultados en la integración cliente.
- ℹ️ La respuesta incluye información fiscal del e-CF, montos, estado ante la DGII y URL de validación pública.
- ℹ️ Los filtros en DATA2 son variables. Puede consultar por FECHA + ESTABLECIMIENTO para obtener todos los documentos de esa fecha y establecimiento, por FECHA + ESTABLECIMIENTO + ENCF para obtener un documento específico, o por FECHA + ENCF sin indicar el establecimiento.
- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?DATA1=SHARED_GETREPORTDAILYFELALL&TAXID=132752155&USERNAME=USER_TEST&DATA2=FECHA|2026-08-14|ESTABLECIMIENTO|0001|ENCF||TIPO||DEC|2

---

### GET · GETRESULTADOENVIO (SHARED_GETRESULTADOENVIO)

Permite obtener la respuesta de la DGII sobre el envío de un ENCF

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TAXID` | string | Sí | RNC del emisor propietario del documento electrónico cuya información de envío se desea consultar. | `132752155` |
| `USERNAME` | string | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `USER_TEST` |
| `DATA1` | string | Sí | Nombre de la operación a realizar. Permite consultar el resultado del envío y procesamiento de un documento electrónico. | `SHARED_GETRESULTADOENVIO` |
| `DATA2` | string | Sí | Parámetro de búsqueda compuesto por el índice ENCF y el número de e-NCF a consultar, separados por el carácter pipeline (\|). | `ENCF|E310000000325` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información sobre el resultado y procesamiento de la consulta realizada. |
| `RESPONSE` | array | Contiene el resultado del envío y validación del documento electrónico consultado. |
| `Codigo` | string | Código de resultado devuelto por el servicio para la consulta del documento. |
| `Estado` | string | Estado actual del documento electrónico ante la DGII. Los valores más comunes son Aceptado o Rechazado. |
| `Mensajes` | string | Mensajes o validaciones retornadas por la DGII durante el proceso de recepción y validación del documento. |
| `ENCF` | string | Número de Comprobante Fiscal Electrónico (e-NCF) consultado. |
| `SecuenciaUtilizada` | boolean | Indica si la secuencia fiscal correspondiente al e-NCF ya fue utilizada en el proceso de certificación. |
| `FechaRecepcion` | datetime | Fecha y hora en que el documento fue recibido y procesado por la DGII. |
| `TrackID` | string | Identificador único de seguimiento asignado al documento. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-18T10:12:48-06:00"
        }
    ],
    "RESPONSE": [
        {
            "Codigo": "1",
            "Estado": "Aceptado",
            "Mensajes": "0 - |",
            "ENCF": "E310000000325",
            "SecuenciaUtilizada": "True",
            "FechaRecepcion": "10/24/2025 4:19:51 PM",
            "TrackID": "252f8209-cb93-48f1-ac22-cbf678f6bed3"
        }
    ]
}
```

#### Notas

- ℹ️ Este servicio permite consultar el estado registrado ante la DGII de un documento electrónico previamente certificado. Es útil para validar el resultado final del procesamiento realizado por la administración tributaria.
- ℹ️ Se recomienda utilizar esta consulta para verificar el estado de aceptación o rechazo de un e-CF después de su certificación y envío a la DGII.
- ℹ️ Los campos Estado y Mensajes muestran la respuesta más reciente devuelta por la DGII para el documento consultado, incluyendo observaciones o motivos de rechazo cuando existan.
- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETRESULTADOENVIO&DATA2=ENCF|E310000000325

---

### GET · GETCTACORRIENTE (GETCTACORRIENTE)

Permite obtener el monto de la cuenta corriente de un documento 
electrónico como resultado de haber aplicado notas de crédito/débito

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TRANSACTION` | string | Sí | Identificador de la transacción utilizada para consultar información relacionada con el estado de cuenta corriente de un documento electrónico. | `SHARED_INFO_EFACE` |
| `TAXID` | string | Sí | RNC del emisor propietario del documento electrónico consultado. | `132752155` |
| `USERNAME` | string | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `USER_TEST` |
| `DATA1` | string | Sí | Operación que permite obtener la información de cuenta corriente asociada a un documento electrónico. | `SHARED_GETCTACORRIENTE` |
| `DATA2` | string | Sí | Parámetro de búsqueda compuesto por un índice y un valor separados por el carácter pipeline (\|). | `ENCF|E320009990013` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información sobre el resultado y procesamiento de la consulta realizada. |
| `RESPONSE` | array | Contiene la información de cuenta corriente asociada al documento electrónico consultado. |
| `Column1` | string | RNC del emisor asociado al documento electrónico consultado. |
| `Column2` | string | Número de Comprobante Fiscal Electrónico (e-NCF) para el cual se consultó la información de cuenta corriente. |
| `Column3` | decimal | Saldo o monto pendiente registrado en la cuenta corriente asociada al documento consultado. |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-18T10:27:11-06:00"
        }
    ],
    "RESPONSE": [
        {
            "Column1": "132752155",
            "Column2": "E320009990013",
            "Column3": "0.000000"
        }
    ]
}
```

#### Notas

- ℹ️ Este servicio permite consultar el saldo o monto asociado a una factura electrónica.
- ℹ️ Se recomienda utilizar esta consulta antes de emitir una Nota de Crédito para validar los montos y evitar diferencias en las correcciones realizadas.
- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&TAXID=132752155&USERNAME=TEST_USER&DATA1=SHARED_GETCTACORRIENTE&DATA2=ENCF|E320009990013

---

### GET · GETLISTENCFAPPLIED (SHARED_GETLISTENCFAPPLIED)

Permite obtener el listado de notas de crédito/débito electrónicas que se 
han aplicado sobre un documento. 

**URL Test:** `https://testnucdo.digifact.com/api/SHAREDINFO`
**URL Prod:** `https://nucdo.digifact.com/api/SHAREDINFO`

#### Headers

| Nombre | Requerido | Descripción |
|---|---|---|
| `Authorization` | Sí | Token de autorización generado |

#### Query Params

| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
| `TRANSACTION` | string | Sí | Identificador de la transacción utilizada para consultar documentos relacionados o aplicados a un e-NCF. | `SHARED_INFO_EFACE` |
| `TAXID` | string | Sí | RNC del emisor propietario del documento electrónico consultado. | `132752155` |
| `USERNAME` | string | Sí | Nombre de usuario autorizado que realiza la solicitud al servicio. | `TEST_USER` |
| `DATA1` | string | Sí | Operación que permite obtener el listado de documentos electrónicos aplicados o relacionados a un e-NCF específico. | `SHARED_GETLISTENCFAPPLIED` |
| `DATA2` | string | Sí | Parámetro de búsqueda compuesto por un índice y un valor separados por el carácter pipeline (\|). | `ENCF|E310008569878` |

#### Respuesta

| Campo | Tipo | Descripción |
|---|---|---|
| `REQUEST_DATA` | array | Contiene información sobre el resultado y procesamiento de la consulta. |
| `RESPONSE` | array | Listado de documentos aplicados al e-NCF consultado, incluyendo notas de crédito y los montos relacionados. |
| `STAXID` | string | RNC del emisor propietario del documento electrónico. |
| `ENCF` | string | Número de Comprobante Fiscal Electrónico (e-NCF) consultado. |
| `FECHA_ENCF` | datetime | Fecha de emisión del documento electrónico original. |
| `TOTAL_ENCF` | decimal | Monto total del documento electrónico original. |
| `FECHA_EMISION_NCRED` | datetime | Fecha de emisión de la Nota de Crédito aplicada al documento. |
| `ENCF_NCRED` | string | Número de e-NCF correspondiente a la Nota de Crédito/Debito relacionada. |
| `VALOR` | decimal | Valor aplicado por la Nota de Crédito/Debito al documento consultado. |
| `VALOR_DOP` | decimal | Valor aplicado expresado en pesos dominicanos (DOP). |

#### Ejemplo de Respuesta

```http
{
    "REQUEST_DATA": [
        {
            "Respuesta": 1,
            "Codigo": 1,
            "Procesador": "TEST_DO",
            "Mensaje": "",
            "Descripcion": "",
            "Fecha": "2026-08-18T10:35:26-06:00"
        }
    ],
    "RESPONSE": [
        {
            "STAXID": "132752155",
            "ENCF": "E310008569878",
            "FECHA_ENCF": "7/7/2027 12:00:00 AM",
            "TOTAL_ENCF": "100.000000",
            "FECHA_EMISION_NCRED": "8/2/2027 12:00:00 AM",
            "ENCF_NCRED": "E330002159879",
            "VALOR": "100.000000",
            "VALOR_DOP": "100.000000"
        },
        {
            "STAXID": "132752155",
            "ENCF": "E310008569878",
            "FECHA_ENCF": "7/7/2027 12:00:00 AM",
            "TOTAL_ENCF": "100.000000",
            "FECHA_EMISION_NCRED": "7/7/2027 12:00:00 AM",
            "ENCF_NCRED": "E340005698798",
            "VALOR": "50.000000",
            "VALOR_DOP": "50.000000"
        }
    ]
}
```

#### Notas

- ℹ️ Este servicio permite consultar las Notas de Crédito o Notas de Débito aplicadas a un e-NCF específico.
- ℹ️ Se recomienda utilizar esta consulta antes de emitir una nueva Nota de Crédito o Débito para verificar si el documento ya posee correcciones previas y validar los montos aplicados.
- ℹ️ La respuesta muestra cada documento relacionado, incluyendo el e-NCF de la nota aplicada, la fecha de emisión y el valor afectado.
- ℹ️ Ejemplo de consumo: https://testnucdo.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&TAXID=132752155&USERNAME=TEST_USER&DATA1=SHARED_GETLISTENCFAPPLIED&DATA2=ENCF|E310008569878

---