Digifact SHARED TOOL API

V1.0.0.5
01122021
DIGIFACT SHARED TOOL

Las operaciones DIGIFACT bajo modalidad de SHARED TOOL, cuenta con operaciones o transacciones que puede ser utilizado desde
cualquier sistema, que permita la conexión a nuestro API

ALCANCE

Brindar operaciones, de uso general, respecto a todo lo relacionado a la factura

Las operaciones que se publiquen en Digifact SHARED TOOL, responden a necesidades de los diferentes EFACE’s, y las mismas pueden
cambiar y modificarse, previo análisis del departamento técnico de Digifact.

NOTA: Si usted es implementador de Software, y necesita hacer uso de éstas y otras transacciones, agradeceríamos pueda realizar
todas las pruebas necesarias.
VERSIONAMIENTO DE DOCUMENTACIÓN

No. Versión Descripción Fecha Autor

1 V1.0.0.0 Se documenta operaciones que los EFACE’s pueden 10-08-2019 Departamento de
utilizar para su implementación Informática

2 V1.0.0.1 La Dirección ya no se mostrará en la información del 20-11-2019 Departamento de

NIT Informática
3 V1.0.0.2 Operación búsqueda por REFERENCIA INTERNA, 05-03-2019 Departamento de
mostrando todos los DTE’s relacionados para la Informática
misma referencia interna

4 V1.0.0.3 Operación búsqueda por REFERENCIA INTERNA, 13-07-2020 Departamento de

mostrando todos los DTE’s relacionados para la informática
misma referencia interna, mostrando menor
información, y agilizando la búsqueda, para una
respuesta, más inmediata

5 V1.0.0.4 Operación búsqueda sobre número de 02-12-2020 Departamento de

contingencia Informática

6 V1.0.0.5 SHARED_REPORTDAILYFELALL, permite obtener todos 05-10-2022 Departamento de

los DTE’s basado en parámetros de periodo, Informática
establecimiento (opcional), NIT, Tipo de Documento.

Consumo API
URL PRODUCCION : https://felgtaws.digifact.com.gt/gt.com.fel.api.v3/api/SHAREDINFO
URL TEST : https://felgttestaws.digifact.com.gt/gt.com.fel.api.v3/api/SHAREDINFO
OBTENGA el TOKEN, por medio de la operación GET_TOKEN
URL PRODUCCION : https://felgtaws.digifact.com.gt/gt.com.fel.api.v3/api/login/get_token
URL TEST : https://felgttestaws.digifact.com.gt/gt.com.fel.api.v3/api/login/get_token

Parámetros en Body Descripción Tipo Ejemplo

Username Nombre de usuario, concatenado así: CARACTER(50) GT.000000123456.USUARIO

Descripción Descripción
Formato
País Pais Default GT
NIT NIT completado a 12
caracteres
Username Username, o nombre
de usuario otorgado
por DIGIFACT

Password Contraseña enviada por CERTIFICADOR, al CARACTER(50)

usuario

Respuesta esperada ÉXITO

Parámetros en URL Descripción
Token TOKEN, cadena de cararcteres para hacer uso de las transacciones, enumeradas
expira_en Fecha en que expira el TOKEN, 360 dias.
Otorgado_a NIT al que se acredita el TOKEN

Respuesta esperada ERROR

 Parámetros en URL Descripción
Code 2001
message USERNAME_NOT_EXIST
description Descripción del error.
processor (VACIO)

1. SHARED_GETINFONITCOM

2. SHARED_GETDTEINFO

3. SHARED_GETDTEINFO_BY_INTERNALID

4. SHARED_GETDTEINFO_BY_INTERNALID_BASIC

5. SHARED_GET_REPORTDAILYFEL_BASIC

6. SHARED_GETDTEINFO_BY_CONTINGENCIA

7. SHARED_GETREPORTDAILYFELALL
 SHARED_GET_INFONITCOM
Parámetros a incluir de Solicitud
Transacción Descripción Dato Obligatorio Formato
NIT NIT del EFACE, que realiza la NIT, a consultar información SI
consulta
DATA1 SHARED_GETINFONITCOM SI
DATA2 Concatenación de la
palabra NIT, pipeline y el
NIT a consultar
DATA3 (vacío) (vacío) (vacío) NINGUNO
Formato de Respuesta
Campo Descripción Formato
REQUEST_DATA INFORMACION DEL OBJETO

Respuesta Ratifica el NIT de EMISOR String

Codigo Codigo de error String

1. ÉXITO
2. MAYOR a 1 ERROR
Procesador PROCESADOR, FEL () String

Mensaje Mensaje adicional que respalda en caso el código sea de error String

Descripcion Mensaje adicional que respalda en caso el código sea de error Entero

Fecha Fecha y Hora en que se procesa la solicitud DateTime

RESPONSE INFORMACION DEL OBJETO

PAIS GT por default Fecha y Hora

NIT NIT de CLIENTE, consignado por el EMISOR String

NOMBRE Nombre del NIT String

Direccion Dirección String

*Esto es opcional y a partir del 24 de Enero del 2020 y por
confidencialidad, la dirección no se estará consignando
DEPARTAMENTO Departamento String

MUNICIPIO Municipio String

 SHARED_GETDTEINFO
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Formato
Obliga
torio
Data1 SHARED_GETDTEINFO Muestra la información del DTE, como el ACUSE de RECIBO que SAT
entrega, y otros datos de utilidad para su respectiva recopilación
Data2 Concatenación de los Separado por PIPELINE así:
siguientes parámetros Ejemplo: AUTHNUMBER| 38E24C38-2B4E-4BCD-BCA0-468EF88F07E9
AUTHNUMBER Numero de autorización específico SI UUID DTE
Data3 (vacío) (vacío) (vacío) NINGUNO

Formato de Respuesta
Campo Descripción Formato
REQUEST_DATA INFORMACION DEL OBJETO

Respuesta Ratifica el NIT de EMISOR String

Codigo Codigo de error String

3. ÉXITO
4. MAYOR a 1, identifica un ERROR
Procesador PROCESADOR, FEL () String

Mensaje Mensaje adicional que respalda en caso el código sea de String

error
Descripcion Mensaje adicional que respalda en caso el código sea de Entero
error
Fecha Fecha y Hora en que se procesa la solicitud DateTime

RESPONSE INFORMACION DEL OBJETO

NIT_EMISOR Ratifica el NIT de EMISOR String

TIPO_DTE Tipo de DTE String

GUID Numero de Autorización consignada por el CERTIFICADOR String

SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

SUBTOTAL_SIN_DESCUENTO Subtotal del DTE, SIN Descuento aplicado Moneda

DESCUENTO Descuento aplicado al DTE Moneda

SUBTOTAL_CON_DESCUENTO Subtotal, CON Descuento aplicado Moneda

IVA IVA del DTE Moneda

TOTAL Total del DTE Moneda

ITEMS Cantidad de ITEMS incluidos en el DTE Entero

DTE EL XML firmado tanto por EMISOR como por CERTIFICADOR String BASE64

ACUSE_RECIBO_SAT_DTE Acuse de RECIBO por parte de SAT, que ratifica que el DTE, String
está en AGENCIA VIRTUAL tanto de EMISOR como de
CERTIFICADOR
ACUSE_RECIBO_ANULACION Acuse de RECIBO por parte de SAT, que ratifica que el DTE, HA String
SIDO ANULADO (Si el DTE, ha sido enviado a ANULAR), y dicho
estatus, está disponible en AGENCIA VIRTUAL tanto de EMISOR
como de CERTIFICADOR
ReferenciaInterna Referencia interna del Documento String
 SHARED_GETDTEINFO_BY_INTERNALID
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Formato
Obliga
torio
Data1 SHARED_GETDTEINFO_BY_INTERNALID Muestra la información del DTE, como el ACUSE de RECIBO
que SAT entrega, y otros datos de utilidad para su
respectiva recopilación, esta operación puede devolver
una tupla (línea) o más de una.
Data2 Concatenación de los siguientes Separado por PIPELINE así:
parámetros Ejemplo:
REFERENCIA_INTERNA| ************|ISSUEDDATE|<La
fecha de emisión aproximada correspondiente a la referencia
interna>
REFERENCIA_INTERNA Referencia Interna que desea consultar SI Cualquier
cadena
ISSUEDDATE Fecha de emisión del DTE aproximada o exacta SI yyyy-mm-dd
Data3 (vacío) (vacío) (vacío) NINGUNO

Formato de Respuesta
Campo Descripción Formato
REQUEST_DATA INFORMACION DEL OBJETO

Respuesta Ratifica el NIT de EMISOR String

Codigo Codigo de error String

1. ÉXITO
2. MAYOR a 1, identifica un ERROR
Procesador PROCESADOR, FEL () String

Mensaje Mensaje adicional que respalda en caso el código sea de String

error
Descripcion Mensaje adicional que respalda en caso el código sea de String
error
Fecha Fecha y Hora en que se procesa la solicitud DateTime

RESPONSE INFORMACION DEL OBJETO

NIT_EMISOR Ratifica el NIT de EMISOR String

TIPO_DTE Tipo de DTE String

GUID Numero de Autorización consignada por el CERTIFICADOR String

SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

SUBTOTAL_SIN_DESCUENTO Subtotal del DTE, SIN Descuento aplicado Moneda

DESCUENTO Descuento aplicado al DTE Moneda

SUBTOTAL_CON_DESCUENTO Subtotal, CON Descuento aplicado Moneda

IVA IVA del DTE Moneda

TOTAL Total del DTE Moneda

ITEMS Cantidad de ITEMS incluidos en el DTE Entero

DTE EL XML firmado tanto por EMISOR como por CERTIFICADOR String BASE64

ACUSE_RECIBO_SAT_DTE Acuse de RECIBO por parte de SAT, que ratifica que el DTE, String
está en AGENCIA VIRTUAL tanto de EMISOR como de
CERTIFICADOR
ACUSE_RECIBO_ANULACION Acuse de RECIBO por parte de SAT, que ratifica que el DTE, HA String
SIDO ANULADO (Si el DTE, ha sido enviado a ANULAR), y dicho
estatus, está disponible en AGENCIA VIRTUAL tanto de EMISOR
como de CERTIFICADOR
ReferenciaInterna Referencia interna del Documento String
 SHARED_GETDTEINFO_BY_INTERNALID_BASIC
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Formato
Obliga
torio
Data1 SHARED_GETDTEINFO_BY_INTERNALID_LESS Muestra la información del DTE, REDUCIDA sin la
información de SAT, de utilidad para su respectiva
recopilación, ideal para ser utilizado en consultas
con tiempos de espera más inmediatos como
QUICK SEARCH.
Data2 Concatenación de los siguientes Separado por PIPELINE así:
parámetros Ejemplo:
REFERENCIA_INTERNA|
************|ISSUEDDATE|<La fecha de emisión
aproximada correspondiente a la referencia interna>
REFERENCIA_INTERNA Referencia Interna que desea consultar SI Cualquier
cadena
ISSUEDDATE Fecha de emisión del DTE aproximada o SI yyyy-mm-dd
exacta
Data3 (vacío) (vacío) (vacío) NINGUNO

Formato de Respuesta
Campo Descripción Formato
REQUEST_DATA INFORMACION DEL OBJETO

Respuesta Ratifica el NIT de EMISOR String

Codigo Codigo de error String

1. ÉXITO
2. MAYOR a 1, identifica un ERROR
Procesador PROCESADOR, FEL () String

Mensaje Mensaje adicional que respalda en caso el código sea de String

error
Descripcion Mensaje adicional que respalda en caso el código sea de String
error
Fecha Fecha y Hora en que se procesa la solicitud DateTime

RESPONSE INFORMACION DEL OBJETO

NIT_EMISOR Ratifica el NIT de EMISOR String

TIPO_DTE Tipo de DTE String

GUID Numero de Autorización consignada por el CERTIFICADOR String

SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

SUBTOTAL_SIN_DESCUENTO Subtotal del DTE, SIN Descuento aplicado Moneda

DESCUENTO Descuento aplicado al DTE Moneda

SUBTOTAL_CON_DESCUENTO Subtotal, CON Descuento aplicado Moneda

IVA IVA del DTE Moneda

TOTAL Total del DTE Moneda

ITEMS Cantidad de ITEMS incluidos en el DTE Entero

ReferenciaInterna Referencia interna del Documento String

 SHARED_GETREPORTDAILYFEL_BASIC
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Obligatorio Formato
Data1 SHARED_GETREPORTDAILYFEL_BASIC Permite Realizar una consulta de
documentos, basado en los parámetros
consignados
Data2 Concatenación de los siguientes
parámetros
FECHA* Fecha de solicitud de SI yyyy-mm-dd
información, comparte la
información disponible.

ESTABLECIMIENTO* Numero de Establecimiento, SI, para NIT’s con más de 2 Entero

establecimientos
AUTHNUMBER Numero de autorización NO UUID DTE
específico
TIPO Basado en el siguiente catálogo NO Entero
1 FACTURA (FACT)
2 FACTURA CAMBIARIA (FCAM)
3 FACTURA PEQUEÑO
CONTRIBUYENTE (FPEQ)
4 FACTURA CAMBIARIA PEQUEÑO
CONTRIBUYENTE (FCAP)
5 FACTURA ESPECIAL (FESP)
6 NOTA DE ABONO (NABN)
7 RECIBO POR DONACION (RDON)
8 RECIBO (RECI)
9 NOTA DE DEBITO (NDEB)
10 NOTA DE CREDITO (NCRE)
Data3 (vacío) (vacío) (vacío) NINGUNO
 SHARED_GETREPORTDAILYFEL_BASIC
Formato de Respuesta
Campo Descripción Formato
Response.Result True o False, de acuerdo a si hubo éxito o fracaso al consultar la Boolean
transacción
Response.Data Mensaje u observación que amplia información respecto a un error al String
realizar la petición
Response.ResponseData.ResponseData1 Cantidad de filas que muestra la consulta realizada, bajo los parámetros Entero
colocados
Response.ResponseData.ResponseDataSet Muestra un DataSet, con columnas como:

INFORMACION DE TABLA
NIT_EMISOR Ratifica el NIT de EMISOR String

TIPO_DTE Tipo de DTE String

GUID Numero de Autorización consignada por el String

CERTIFICADOR
SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

TOTAL Total del DTE Moneda

ITEMS Cantidad de ITEMS incluidos en el DTE Entero

CONTINGENCIA Si contase con numero de contingencia relacionado String

NESTABLECIMIENTO Numero de establecimiento String

ESTABLECIMIENTO Nombre de Establecimiento String

 SHARED_GETDTEINFO_BY_CONTINGENCIA
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Obligatorio Formato
Data1 SHARED_GETDTEINFO_BY_CONTINGENCIA Permite Realizar una consulta de
documentos, basado en los
parámetros consignados
Data2 Concatenación de los siguientes
parámetros
CONTINGENCIA Numero de Contingencia SI Entero

FECHA_EMISION Fecha de solicitud de SI yyyy-mm-dd

información, comparte la
información disponible.
Data3 (vacío) (vacío) (vacío) NINGUNO
 SHARED_GETDTEINFO_BY_CONTINGENCIA
Formato de Respuesta
Campo Descripción Formato
Response.Result True o False, de acuerdo a si hubo éxito o fracaso al consultar la Boolean
transacción
Response.Data Mensaje u observación que amplia información respecto a un error al String
realizar la petición
Response.ResponseData.ResponseData1 Cantidad de filas que muestra la consulta realizada, bajo los parámetros Entero
colocados
Response.ResponseData.ResponseDataSet Muestra un DataSet, con columnas como:

INFORMACION DE TABLA
NIT_EMISOR Ratifica el NIT de EMISOR String

TIPO_DTE Tipo de DTE String

CONTINGENCIA Numero de Contingencia String

GUID Numero de Autorización consignada por el String

CERTIFICADOR
SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

SUBTOTSL_SIN_DESCUENTO Total del SUBTOTAL Moneda

DESCUENTO Valor descuento aplicado Moneda

SUBTOTAL_CON_DESCUENTO Valor de subtotal con descuento aplicado Moneda

IVA IVA Moneda

TOTAL Nombre de Establecimiento Moneda

ITEMS Numero de Items incluido Entero

 SHARED_GETREPORTDAILYFELALL
Formato de Solicitud
Transacción SHARED_INFO_EFACE Descripción Dato Obligatorio Formato
Data1 SHARED_GETREPORTDAILYFELALL Permite Realizar una consulta de
documentos, basado en los parámetros
consignados
Data2 Concatenación de los siguientes
parámetros
FECHA* Fecha de solicitud de información, SI yyyy-mm-dd
comparte la información
disponible.

ESTABLECIMIENTO* Numero de Establecimiento, SI (0, para obtener todos los Entero

establecimientos, o el
número específico del
establecimiento)
AUTHNUMBER Numero de autorización NO UUID DTE
específico
TIPO Basado en el siguiente catálogo NO Entero
1 FACTURA (FACT)
2 FACTURA CAMBIARIA (FCAM)
3 FACTURA PEQUEÑO
CONTRIBUYENTE (FPEQ)
4 FACTURA CAMBIARIA PEQUEÑO
CONTRIBUYENTE (FCAP)
5 FACTURA ESPECIAL (FESP)
6 NOTA DE ABONO (NABN)
7 RECIBO POR DONACION (RDON)
8 RECIBO (RECI)
9 NOTA DE DEBITO (NDEB)
10 NOTA DE CREDITO (NCRE)
Data3 (vacío) (vacío) (vacío) NINGUNO
 SHARED_GETREPORTDAILYFELALL
Formato de Respuesta
Campo Descripción Formato
Response.Result True o False, de acuerdo a si hubo éxito o fracaso al consultar la Boolean
transacción
Response.Data Mensaje u observación que amplia información respecto a un error al String
realizar la petición
Response.ResponseData.ResponseData1 Cantidad de filas que muestra la consulta realizada, bajo los parámetros Entero
colocados
Response.ResponseData.ResponseDataSet Muestra un DataSet, con columnas como:

INFORMACION DE TABLA
NIT_EMISOR Ratifica el NIT de EMISOR String

NE Numero de Establecimiento Entero

NOMBRE Nombre Comercial del establecimiento String

TIPO_DTE Tipo de DTE String

GUID Numero de Autorización consignada por el String

CERTIFICADOR
SERIE Serie de DTE String

NUMERO Número de DTE Entero

ESTATUS Si esta ANULANO o NO (Muestra espacio en blanco) String

FECHA_DE_EMISION Fecha de emisión consignada por el EMISOR Fecha y Hora

FECHA_DE_CERTIFICACION Fecha recibida por el CERTIFICADOR Fecha y Hora

NIT_COMPRADOR NIT de CLIENTE, consignado por el EMISOR String

NOMBRE_COMPRADOR Nombre de CLIENTE, consignado por el EMISOR String

TOTAL Total del DTE Moneda

ITEMS Cantidad de ITEMS incluidos en el DTE Entero

CONTINGENCIA Si contase con numero de contingencia relacionado String