API Reference — El Salvador | Digifact Developer Portal

🧪 Test

https://testnucsv.digifact.com/api

🚀 Producción

https://nucsv.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. Para obtener el Token deberá realizar una petición HTTP de tipo POST y agregar en el Body/Cuerpo de la solicitud, los atributos: Username, y el Password, proporcionado en las credenciales, enviados en formato JSON.

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

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

Body

Nombre	Req.	Descripción	Ejemplo
Username	Req	Concatenación separada por punto (.): SV + "." + <NIT del usuario> + "." + <Nombre de usuario>	SV.06142308221025.USER_TEST
Password	Req	Password brindado en las credenciales TEST o productivas	s142$%SAF

Respuesta

Nombre	Tipo	Descripción
Token	string	Token de autenticación. Tendrá una vigencia de 30 días a partir del momento que se solicita.

ℹ️

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 TEST a través del correo de soporte [email protected] brindando su nombre, nombre de la empresa que representa y un número de contacto, colocando como Subject: "Solicitud de credenciales TEST".

Ejemplo de Request

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

Ejemplo de Response

json

POSTCERTIFICATE DTE V2 (JSON)CERTIFICATE DTE V2

Esta operación de tipo POST 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 el Ministerio de Hacienda ha normado tanto en su documentación técnica, como en lo publicado en el régimen de factura electrónica.

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

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

Headers

Nombre	Req.	Descripción
Content-type	Req	application/json ó application/xml según sea el caso
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	NIT del usuario.	06142308221025
FORMAT	Req	Posibles valores: XML, PDF, HTML o JSON. Se deben ingresar separados por pipelines "\|" por ejemplo PDF\|HTML\|XML\|JSON
USERNAME	Req	Usuario asignado de Test o Productivo según sea el caso.	UsuarioEjemplo1

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo a la documentación proporcionada del NUC para El Salvador en formato XML o JSON según sea el caso

Respuesta

Nombre	Tipo	Descripción
code	number	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
responseData4	string	Texto codificado en base64 que contiene el JSON del documento certificado
authNumber	string	codigo de generación único de la factura electrónica
url	string	Contiene el enlace para consultar el DTE emitido en el Ministerio de Hacienda
infoDetails	array	atributo tipo arreglo de objetos que, cuando la respuesta es un error, muestra el listado de errores que contiene el 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	número de serie de la factura, atributo sin valor por el momento
serial	string	Contiene el número de control del documento
issuedTimeStamp	string	fecha de emisión de la factura electrónica
taxID	string	NIT 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	NIT 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. Puede contener como atributos los siguientes valores: selloRecepcion: contiene el sello de recibido otorgado por el Ministerio de Hacienda

⚠️

Para el uso de esta operación en productivo, deberá proporcionarnos su firma electrónica o certificado y contraseña asignada a dicha firma, la cual obtiene en la agencia virtual del Ministerio de Hacienda.

ℹ️

Ejemplo de URL: https://testnucsv.digifact.com/api/v2/transform/nuc_json?TAXID=06142308221025&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://testnucsv.digifact.com/api/v2/transform/nuc_json?TAXID=06142308221025&FORMAT=%3CFORMAT%3E&USERNAME=UsuarioEjemplo1" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

POSTCERTIFICATE DTE V2 (XML)CERTIFICATE DTE V2 XML

Esta operación de tipo POST permitirá certificar un Documento Tributario Electronico (DTE) enviado en formato XML. El cuerpo de la petición debe cumplir con el esquema XML detallado en la Documentación Técnica del esquema NUC.

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

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

Headers

Nombre	Req.	Descripción
Content-type	Req	application/json ó application/xml según sea el caso
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	NIT del usuario.	06142308221025
FORMAT	Req	Posibles valores: XML, PDF, HTML o JSON. Se deben ingresar separados por pipelines "\|" por ejemplo PDF\|HTML\|XML\|JSON
USERNAME	Req	Usuario asignado de Test o Productivo según sea el caso.	UsuarioEjemplo1

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo a la documentación proporcionada del NUC para El Salvador en formato XML o JSON según sea el caso

Respuesta

Nombre	Tipo	Descripción
code	number	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

ℹ️

Para los envíos XML o JSON, el resultado será el mismo y será entregado en formato JSON (ver respuesta de CERTIFICATE DTE V2 JSON).

⚠️

Ejemplo de Request

curl -X POST "https://testnucsv.digifact.com/api/v2/transform/nuc?TAXID=06142308221025&FORMAT=%3CFORMAT%3E&USERNAME=UsuarioEjemplo1" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

POSTCANCEL DTECANCEL DTE

Esta operación de tipo POST permitirá realizar la anulación o invalidación de un documento electrónico emitido anteriormente.

TESThttps://testnucsv.digifact.com/api/CancelFeSV

PRODhttps://nucsv.digifact.com/api/CancelFeSV

Headers

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

Query Params

Nombre	Req.	Descripción
USERNAME	Req	Nombre de usuario que realiza la peticion

Body

Nombre	Req.	Descripción	Ejemplo
nit	Req	Número de identificación tributaria (NIT) del contribuyente emisor de la factura electrónica	06142308221025
tipoDte	Req	Tipo de documento a anular	01
docGUID	Req	Código de generación del documento emitido que será anulado	9B0FDD27-BABF-49DF-AA8C-06C618C1A1D1
fechaEmision	Req	Fecha de emisión del documento que se invalidará, en formato YYYY-MM-DD	2023-04-29
newDocGUID	Opt	En el caso de que se requiera indicar que un nuevo documento emitido será el que sustituya el documento a anular, se deberá agregar el código de generación del documento que reemplaza al invalidado. De lo contrario enviar como null este campo.	A76FDD27-1ABC-0DDF-A28A-088618C8455F1
nombreEstablecimiento	Opt	Nombre del establecimiento donde se emite la invalidación
tipoAnulacion	Req	Tipo de invalidación a realizar, puede ser uno de los siguientes valores 1: Error en la información del documento tributario electrónico a invalidar. 2: Rescindir de la operación realizada 3: Otro Importante: Cuando este valor no sea 2 (Rescindir de la operacion realizada), es decir cuando sea 1 o 3, previo al envío de la anulación el contribuyente emisor deberá emitir un nuevo documento que sustituya la operación que se desea invalidar. Y deberá ingresar el código de generación del nuevo documento en el atributo newDocGUID.
motivoAnulacion	Req	Deberá describir el motivo de la invalidación, indicando los campos donde se encuentra el error que ocasiona la anulación
nombreResponsable	Req	Nombre del responsable de invalidar el DTE
tipoDocumentoResponsable	Req	Tipo de documento de identificación del responsable 36: NIT 13: DUI 37: Otro 03: Pasaporte 02: Carnet de Residente
numDocumentoResponsable	Req	Numero de documento de identificación del responsable
numDocumentoSolicitante	Req	Nombre de la persona quien solicita invalidar el DTE
numDocumentoSolicitante	Req	Tipo de documento de identificación del solicitante 36: NIT 13: DUI 37: Otro 03: Pasaporte 02: Carnet de Residente
numDocumentoSolicitante	Req	Numero de documento de identificación del solicitante

Respuesta

Nombre	Tipo	Descripción
Codigo	number	Código de respuesta que indicará si la operación fue realizada exitosamente. 1: anulación del documento exitosa. 0: error al invalidar el documento. 400: error en contenido de la petición. 500: error interno, en caso de obtener este error comunicarse con el equipo de soporte.
Anulado	boolean	Atributo booleano que indicará si la anulación fue realizada correctamente
Mensaje	string	Contiene información relacionada a la respuesta
RespuestaMH	object	Objeto que contiene las siguientes propiedades: codigoGeneracion: corresponde al código de generación del evento de invalidación/anulación. selloRecibido: sello de recepción del Ministerio de Hacienda del evento de invalidación/anulación.

Ejemplo de Request

curl -X POST "https://testnucsv.digifact.com/api/CancelFeSV?USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"

Ejemplo de Response

json

GETGET DOCUMENTGET DOCUMENT

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

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

PRODhttps://nucsv.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	Código de generación del documento electrónico a obtener	4D19A6D5-05B6-4D96-9EA4-7D75620B48CE
TAXID	Req	NIT del emisor del documento a obtener.	06142308221025
FORMAT	Req	Tipo de formato en que se desea recibir el documento codificado en base64, puede ser XML, HTML, PDF o JSON, separados por pipelines " \| ". Ej. Si se desea recibir el documento en formato HTML y PDF: HTML\|PDF
USERNAME	Req	Nombre de usuario que realiza la petición

Respuesta

Nombre	Tipo	Descripción
REQUEST_DATA	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }
RESPONSE	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "ResponseData1", "ResponseData2", "ResponseData3", "ResponseData4" }. Nota: ResponseData1 corresponde al documento en formato XML, ResponseData2 corresponde al documento en formato HTML, el ResponseData3 corresponde al documento en formato PDF y el ResponseData4 corresponde al JSON del DTE emitido. Si algún dato que se requiere en los parámetros no existe, la respuesta será un arreglo vacío. Ej. "RESPONSE": []

ℹ️

Ejemplo de url: https://testnucsv.digifact.com/api/GetDocument?TAXID=06142308221025&AUTHNUMBER=4D19A6D5-05B6-4D96-9EA4-7D75620B48CE&USERNAME=TESTUSER&FORMAT=xml

Ejemplo de Request

curl -X GET "https://testnucsv.digifact.com/api/GetDocument?AUTHNUMBER=4D19A6D5-05B6-4D96-9EA4-7D75620B48CE&TAXID=06142308221025&FORMAT=%3CFORMAT%3E&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

GETGET DTE INFOGET DTE INFO

Permite obtener la información de un documento mediante su Código de Generación. Las operaciones de tipo GET permitirán obtener diferente información relacionada al contribuyente, como información fiscal, información sobre documentos emitidos, etc.

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

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

Headers

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

Query Params

Nombre	Req.	Descripción	Ejemplo
TRANSACTION	Req	Tipo de transacción	SHARED_INFO_EFACE
NIT	Req	NIT del usuario.	06142308221025
DATA1	Req	Tipo de procedimiento a ejecutar	SHARED_GETDTEINFO
DATA2	Req	Para esta función es necesario agregar el NIT del emisor y el Código de generación del documento emitido, se debe agregar de la siguiente manera:	STAXID\|06142308221025\|AUTHNUMBER\|D45C98CB-0000-4552-8DBE-AB64DF70B000
USERNAME	Req	Nombre de usuario

Respuesta

Nombre	Tipo	Descripción
REQUEST_DATA	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }
RESPONSE	Array	Este atributo contendrá todas las respuestas que se obtengan. No tiene un formato en específico, el resultado depende de lo que devuelva la transacción. Nota: si se ingresa como DATA1 alguna operación que no exista y no devuelva un resultado, este arreglo se encontrará vacío. "[ ]"

ℹ️

Url de ejemplo: https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&USERNAME=TESTUSER&DATA1=SHARED_GETDTEINFO&DATA2=STAXID|06142308221025|AUTHNUMBER|AA5C98CB-FC78-0000-8DBE-AB64DF7AADAE

Ejemplo de Request

curl -X GET "https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&DATA1=SHARED_GETDTEINFO&DATA2=STAXID%7C06142308221025%7CAUTHNUMBER%7CD45C98CB-0000-4552-8DBE-AB64DF70B000&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

GETGET DTE INFO BY INTERNAL IDGET DTE INFO BY INTERNAL ID

Permite obtener la información de un documento mediante el código de referencia interna agregado en la adenda.

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

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

Headers

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

Query Params

Nombre	Req.	Descripción	Ejemplo
TRANSACTION	Req	Tipo de transacción	SHARED_INFO_EFACE
NIT	Req	NIT del usuario.	06142308221025
DATA1	Req	Tipo de procedimiento a ejecutar	SHARED_GETDTEINFO_BY_INTERNALID
DATA2	Req	Para esta función es necesario agregar el NIT del emisor, el código de referencia interna y la fecha de emisión del documento	STAXID\|06142308221025\|REFERENCIA_INTERNA\|28SAKJKSJDA\|ISSUEDDATE\|2023-07-17
USERNAME	Req	Nombre de usuario

Respuesta

Nombre	Tipo	Descripción
REQUEST_DATA	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }
RESPONSE	Array	Este atributo contendrá todas las respuestas que se obtengan. No tiene un formato en específico, el resultado depende de lo que devuelva la transacción.

ℹ️

Ejemplo de Request

curl -X GET "https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&DATA1=SHARED_GETDTEINFO_BY_INTERNALID&DATA2=STAXID%7C06142308221025%7CREFERENCIA_INTERNA%7C28SAKJKSJDA%7CISSUEDDATE%7C2023-07-17&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

GETGET INFO NITGET INFO NIT

Permite obtener la información de un contribuyente utilizando su NIT.

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

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

Headers

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

Query Params

Nombre	Req.	Descripción	Ejemplo
TRANSACTION	Req	Tipo de transacción	SHARED_INFO_EFACE
NIT	Req	NIT del usuario.	06142308221025
DATA1	Req	Tipo de procedimiento a ejecutar	SHARED_GETINFORTAXID
DATA2	Req	Para esta función es necesario agregar el NIT de quien se desea obtener la información, debe ser de la siguiente manera:	RTAXID\|06142308221025
USERNAME	Req	Nombre de usuario

Respuesta

Nombre	Tipo	Descripción
REQUEST_DATA	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }
RESPONSE	Array	Este atributo contendrá todas las respuestas que se obtengan. No tiene un formato en específico, el resultado depende de lo que devuelva la transacción.

ℹ️

Url de ejemplo: https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&USERNAME=TESTUSER&DATA1=SHARED_GETINFORTAXID&DATA2=RTAXID|06142308221025

Ejemplo de Request

curl -X GET "https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&DATA1=SHARED_GETINFORTAXID&DATA2=RTAXID%7C06142308221025&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

GETREPORT DAILYREPORT DAILY

Permite obtener un resumen de los documentos emitidos en el día. Disponible únicamente en ambiente productivo.

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

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

Headers

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

Query Params

Nombre	Req.	Descripción	Ejemplo
TRANSACTION	Req	Tipo de transacción	SHARED_INFO_EFACE
NIT	Req	NIT del usuario.	06142308221025
DATA1	Req	Tipo de procedimiento a ejecutar	SHARED_GETREPORTDAILYFELALL
DATA2	Req	Para esta función es necesario agregar la fecha en formato AAAA-MM-DD, el código de establecimiento, al código de generación (si no se coloca un valor devuelve todos los documentos del día) y el tipo de documento a consultar en el resumen.	FECHA\|2024-12-31\|ESTABLECIMIENTO\|M001\|AUTHNUMBER\|\|TIPO\|01
USERNAME	Req	Nombre de usuario

Respuesta

Nombre	Tipo	Descripción
REQUEST_DATA	Array	Este atributo contendrá en la primera y única posición de su arreglo los siguientes atributos { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }
RESPONSE	Array	Este atributo contendrá todas las respuestas que se obtengan. No tiene un formato en específico, el resultado depende de lo que devuelva la transacción.

⚠️

Disponible únicamente en ambiente productivo.

ℹ️

Url de ejemplo: https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&USERNAME=TESTUSER&DATA1=SHARED_GETREPORTDAILYFELALL&DATA2=FECHA|2024-12-31|ESTABLECIMIENTO|M001|AUTHNUMBER||TIPO|01

Ejemplo de Request

curl -X GET "https://testnucsv.digifact.com/api/SHAREDINFO?TRANSACTION=SHARED_INFO_EFACE&NIT=06142308221025&DATA1=SHARED_GETREPORTDAILYFELALL&DATA2=FECHA%7C2024-12-31%7CESTABLECIMIENTO%7CM001%7CAUTHNUMBER%7C%7CTIPO%7C01&USERNAME=%3CUSERNAME%3E" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

POSTGET PREVIEW (JSON)GET PREVIEW

Esta operación de tipo POST permitirá obtener el HTML de vista previa de un documento JSON o XML NUC previo a ser enviado para certificar.

TESThttps://testnucsv.digifact.com/api/getJsonPreview

PRODhttps://nucsv.digifact.com/api/getJsonPreview

Headers

Nombre	Req.	Descripción
Content-type	Req	application/json ó application/xml según sea el caso
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	NIT del usuario.	06142308221025
USERNAME	Req	Usuario asignado de Test o Productivo según sea el caso.	UsuarioEjemplo1

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo a la documentación proporcionada del NUC para El Salvador en formato XML o JSON según sea el caso. Se debe enviar el contenido del NUC de un documento que esté válido según su esquema. No realiza validaciones de cálculos de totales, información acerca del emisor, receptor, etc. Únicamente genera el HTML de la representación gráfica del archivo que se envía.

Respuesta

Nombre	Tipo	Descripción
codigo	number	Código de respuesta que indicará si la operación fue realizada exitosamente. 1: operación realizada correctamente. 0: error por esquema u otro. 400: error en contenido de la petición. 500: error interno del servidor, en caso de recibir una respuesta de este tipo, comunicarse con el equipo de soporte.
mensaje	string	Contiene un breve mensaje de la respuesta según el código que se obtenga
data1	string	Contiene el texto del HTML codificado en base64.

ℹ️

No realiza validaciones de cálculos de totales, información acerca del emisor, receptor, etc. Únicamente genera el HTML de la representación gráfica del archivo que se envía.

Ejemplo de Request

curl -X POST "https://testnucsv.digifact.com/api/getJsonPreview?TAXID=06142308221025&USERNAME=UsuarioEjemplo1" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

POSTGET PREVIEW (XML)GET PREVIEW XML

Esta operación de tipo POST permitirá obtener el HTML de vista previa de un documento XML NUC previo a ser enviado para certificar.

TESThttps://testnucsv.digifact.com/api/getXmlPreview

PRODhttps://nucsv.digifact.com/api/getXmlPreview

Headers

Nombre	Req.	Descripción
Content-type	Req	application/json ó application/xml según sea el caso
Authorization	Req	Token de autorización generado

Query Params

Nombre	Req.	Descripción	Ejemplo
TAXID	Req	NIT del usuario.	06142308221025
USERNAME	Req	Usuario asignado de Test o Productivo según sea el caso.	UsuarioEjemplo1

Body

Nombre	Req.	Descripción
BODY (raw)	Req	De acuerdo a la documentación proporcionada del NUC para El Salvador en formato XML o JSON según sea el caso. Se debe enviar el contenido del NUC de un documento que esté válido según su esquema.

Respuesta

Nombre	Tipo	Descripción
codigo	number	Código de respuesta que indicará si la operación fue realizada exitosamente. 1: operación realizada correctamente. 0: error por esquema u otro. 400: error en contenido de la petición. 500: error interno del servidor, en caso de recibir una respuesta de este tipo, comunicarse con el equipo de soporte.
mensaje	string	Contiene un breve mensaje de la respuesta según el código que se obtenga
data1	string	Contiene el texto del HTML codificado en base64.

Ejemplo de Request

curl -X POST "https://testnucsv.digifact.com/api/getXmlPreview?TAXID=06142308221025&USERNAME=UsuarioEjemplo1" \
  -H "Content-type: <valor>" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

Ejemplo de Response

json

GETGENERACIÓN DE QRQR

Esta operación de tipo GET permite obtener la imagen del código QR para descargar un documento emitido.

TEST

PRODhttps://digifact.com/QRShare/api/QR

Query Params

Nombre	Req.	Descripción	Ejemplo
COUNTRYCODE	Req	SV	SV
UUID	Req	Código de generación del documento	38CB75D5-E113-49DD-84CE-30047685CA9E
STAXID	Req	NIT del emisor del documento
FORMAT	Req	Formato para la descarga del documento, valores posibles: PDF o JSON (no ambos)
SIZE	Req	Tamaño en pixeles de la imagen a obtener, el formato a seguir es mxn donde m y n son números enteros.	300x100

Respuesta

ℹ️

URL de ejemplo: https://digifact.com/QRShare/api/QR?COUNTRYCODE=SV&UUID=6F0FB355-0413-4361-834D-20407DCE34FC&STAXID=06142308221025&FORMAT=PDF&SIZE=300x300

⚠️

El PDF de API solo documenta URL de ambiente Productivo para esta operación.

Ejemplo de Request

curl -X GET "?COUNTRYCODE=SV&UUID=38CB75D5-E113-49DD-84CE-30047685CA9E&STAXID=%3CSTAXID%3E&FORMAT=%3CFORMAT%3E&SIZE=300x100"

Ejemplo de Response

json

GETGENERACIÓN DE URL DE DESCARGAURL DESCARGA

Esta operación de tipo GET permite obtener la URL para descargar un documento emitido.

TEST

PRODhttps://digifact.com/SV/GETURL/api/URLINVOICE

Query Params

Nombre	Req.	Descripción	Ejemplo
COUNTRYCODE	Req	SV	SV
UUID	Req	Código de generación del documento	38CB75D5-E113-49DD-84CE-30047685CA9E
STAXID	Req	NIT del emisor del documento
FORMAT	Req	Formato para la descarga del documento, valores posibles: PDF o JSON (no ambos)

Respuesta

Nombre	Tipo	Descripción
Code	number	Código de respuesta que indicará si la operación fue realizada exitosamente
Message	string	Contiene un breve mensaje de la respuesta según el código que se obtenga
Urlpath	string	Contiene la URL de descarga del documento

ℹ️

URL de ejemplo: https://digifact.com/SV/GETURL/api/URLINVOICE?COUNTRYCODE=SV&UUID=77573E04-7673-4DEB-8995-C23AAE0F4959&STAXID=06142308221025&FORMAT=PDF

⚠️

El PDF de API solo documenta URL de ambiente Productivo para esta operación.

Ejemplo de Request

curl -X GET "?COUNTRYCODE=SV&UUID=38CB75D5-E113-49DD-84CE-30047685CA9E&STAXID=%3CSTAXID%3E&FORMAT=%3CFORMAT%3E"

Ejemplo de Response

json

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 — El Salvador 🇸🇻

Soporte Técnico