API Reference — Rep. Dominicana | Digifact Developer Portal

🧪 Test

https://testnucdo.digifact.com/api

🚀 Producción

https://nucdo.digifact.com/api

ℹ️

Todas las operaciones requieren un token JWT obtenido en GET TOKEN. El token expira automáticamente — al recibir un error 401, solicitar un nuevo token.

POSTObtención del TOKENGET 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.

TESThttps://testnucdo.digifact.com/api/login/get_token

PRODhttps://nucdo.digifact.com/api/login/get_token

Body

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

Respuesta

ℹ️

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.

Ejemplo de Request

curl -X POST "https://testnucdo.digifact.com/api/login/get_token" \
  -d '{
  "Username": "DO.132752155.USER_TEST",
  "Password": "s142$%SAF"
}'

Ejemplo de Response

json

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

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

TESThttps://testnucdo.digifact.com/api/v2/transform/nuc_json

PRODhttps://nucdo.digifact.com/api/v2/transform/nuc_json

Headers

Nombre	Req.	Descripción
Content-type	Req	application/json
Authorization	Req	Token de autorización generado

Query Params

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

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo con la documentación proporcionada del NUC para República Dominicana en formato JSON

Respuesta

Nombre	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

⚠️

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.

Ejemplo de Request

curl -X POST "https://testnucdo.digifact.com/api/v2/transform/nuc_json?TAXID=132752155&FORMAT=XML!HTML&USERNAME=USER_EXAMPLE" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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": 
}

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

TESThttps://testnucdo.digifact.com/api/v2/transform/nuc

PRODhttps://nucdo.digifact.com/api/v2/transform/nuc

Headers

Nombre	Req.	Descripción
Content-type	Req	application/xml
Authorization	Req	Token de autorización generado

Query Params

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

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo con la documentación proporcionada del NUC para República Dominicana en formato XML

Respuesta

Nombre	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

⚠️

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.

Ejemplo de Request

curl -X POST "https://testnucdo.digifact.com/api/v2/transform/nuc?TAXID=132752155&FORMAT=XML!HTML&USERNAME=USER_EXAMPLE" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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": 
}

GETGET DOCUMENTGetDocument

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

TESThttps://testnucdo.digifact.com/api/GetDocument

PRODhttps://nucdo.digifact.com/api/GetDocument

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
AUTHNUMBER	Req	Identificador único del documento: el e-NCF (Número de Comprobante Fiscal Electrónico).	E31000085979
TAXID	Req	RNC del emisor del documento a obtener.	132752155
FORMAT	Req	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	Req	Nombre de usuario que realiza la petición

Respuesta

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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/GetDocument?AUTHNUMBER=E31000085979&TAXID=132752155&FORMAT=HTML!PDF&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

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

GETSHARED_GETDTEINFO GETDTEINFO

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

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

Respuesta

Nombre	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 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).

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETDTEINFO&DATA2=AUTHNUMBER%7CE310008569878" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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 - "
        }
    ]
}

GETGETDTEINFO_BY_INTERNALIDGETDTEINFO_BY_INTERNALID

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	RNC del emisor asociado al documento electrónico cuya información se desea consultar.	130666182
USERNAME	Req	Nombre de usuario autorizado que realiza la solicitud al servicio.	USER_TEST
DATA1	Req	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	Req	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

Nombre	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 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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=130666182&USERNAME=USER_TEST&DATA1=SHARED_GETDTEINFO_BY_INTERNALID&DATA2=REFERENCIA_INTERNA%7CPT-1056%7CISSUEDDATE%7C2026-07-20" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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 - "
        }
    ]
}

GETSHARED_GETINFORTAXIDGETINFORTAXID

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	RNC del contribuyente cuya información se desea consultar.	132752155
USERNAME	Req	Nombre de usuario autorizado que realiza la solicitud al servicio.	USER_TEST
DATA1	Req	Nombre de la operación a ejecutar. En este caso, obtiene información asociada a un RNC registrado.	SHARED_GETINFORTAXID
DATA2	Req	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

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

ℹ️

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.

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETINFORTAXID&DATA2=RNC%7C132752155" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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"
        }
    ]
}

GETGETREPORTDAILYFELALL GETREPORTDAILYFELALL

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Tipo	Req.	Descripción	Ejemplo
TAXID	string	Req	RNC del emisor para el cual se desea consultar el reporte diario consolidado de documentos electrónicos.	132752155
USERNAME	string	Req	Nombre de usuario autorizado que realiza la solicitud al servicio.	USER_TEST
DATA1	string	Req	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	Req	Parámetros de búsqueda concatenados mediante el carácter pipeline (\|).	FECHA\|2026-08-14\|ESTABLECIMIENTO\|0001\|ENCF\|\|TIPO\|\|DEC\|2

Respuesta

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

ℹ️

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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETREPORTDAILYFELALL&DATA2=FECHA%7C2026-08-14%7CESTABLECIMIENTO%7C0001%7CENCF%7C%7CTIPO%7C%7CDEC%7C2" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
  "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": ""
    }
  ]
}

GETGETRESULTADOENVIOSHARED_GETRESULTADOENVIO

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Tipo	Req.	Descripción	Ejemplo
TAXID	string	Req	RNC del emisor propietario del documento electrónico cuya información de envío se desea consultar.	132752155
USERNAME	string	Req	Nombre de usuario autorizado que realiza la solicitud al servicio.	USER_TEST
DATA1	string	Req	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	Req	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

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

ℹ️

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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETRESULTADOENVIO&DATA2=ENCF%7CE310000000325" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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"
        }
    ]
}

GETGETCTACORRIENTEGETCTACORRIENTE

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

Nombre	Tipo	Req.	Descripción	Ejemplo
TRANSACTION	string	Req	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	Req	RNC del emisor propietario del documento electrónico consultado.	132752155
USERNAME	string	Req	Nombre de usuario autorizado que realiza la solicitud al servicio.	USER_TEST
DATA1	string	Req	Operación que permite obtener la información de cuenta corriente asociada a un documento electrónico.	SHARED_GETCTACORRIENTE
DATA2	string	Req	Parámetro de búsqueda compuesto por un índice y un valor separados por el carácter pipeline (\|).	ENCF\|E320009990013

Respuesta

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

ℹ️

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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&TAXID=132752155&USERNAME=USER_TEST&DATA1=SHARED_GETCTACORRIENTE&DATA2=ENCF%7CE320009990013" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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"
        }
    ]
}

GETGETLISTENCFAPPLIEDSHARED_GETLISTENCFAPPLIED

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

TESThttps://testnucdo.digifact.com/api/SHAREDINFO

PRODhttps://nucdo.digifact.com/api/SHAREDINFO

Headers

Nombre	Req.	Descripción
Authorization	Req	Token de autorización generado

Query Params

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

Respuesta

Nombre	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).

ℹ️

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

Ejemplo de Request

curl -X GET "https://testnucdo.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&TAXID=132752155&USERNAME=TEST_USER&DATA1=SHARED_GETLISTENCFAPPLIED&DATA2=ENCF%7CE310008569878" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

{
    "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"
        }
    ]
}

Soporte Técnico

Disponible en horario hábil para dudas durante implementación, pruebas y producción.

[email protected]

Teléfono

+502 4219-2222 opción 2

Subject recomendado: [NIT] Tipo_REST · [NIT] Tipo_GENERAL

API Reference — Rep. Dominicana 🇩🇴

Soporte Técnico