1Disponibilidad

⚠️

Aviso: Estas consultas están disponibles por ahora solo en el ambiente de TEST. La disponibilidad en PRODUCCIÓN se anunciará con una nueva novedad cuando esté lista.

Consulta (`DATA1`)Para qué sirve
SHARED_GETREPORTDAILYCONTINGENCIADocumentos del día emitidos en contingencia, con su número de acceso y el estado ante la SAT.
SHARED_GETREPORTDAILYACUSESTodos los documentos del día con el estado del acuse de la SAT, de la emisión y de la anulación, y su FCID.
SHARED_GETREPORTDAILYRESUMENTotales del día: documentos recibidos, en contingencia, aceptados, rechazados, pendientes y anulados.

Las tres se piden siempre para un NIT emisor y por fecha de emisión. Incluyen los documentos certificados el mismo día de la consulta.

2Formato de la respuesta

Las tres consultas usan el mismo endpoint de APINUC, GET /api/Shared; solo cambian DATA1 (la consulta) y DATA2 (los filtros). Cada consulta tiene abajo su request, sus filtros y una respuesta de ejemplo.

La respuesta siempre trae dos partes:

ParteQué trae
REQUEST_DATAEl resultado. Respuesta 1 = con datos; Descripcion = total de documentos (32 ITEMS).
RESPONSEUn objeto por documento (contingencia y acuses) o un solo objeto con los totales (resumen).

Formato de los valores:

  • Todos los valores llegan como texto, también los montos y las cantidades.
  • Las fechas llegan como M/d/yyyy h:mm:ss AM/PM, en hora de Guatemala. Ejemplo: 10/6/2026 4:10:06 PM.
  • Un dato que no aplica llega vacío ("").

31. Reporte de contingencia

SHARED_GETREPORTDAILYCONTINGENCIA devuelve los documentos del día emitidos en contingencia, con su número de acceso y su estado ante la SAT.

Request

ParámetroValor
COUNTRYGT
TAXID000005888492
DATA1SHARED_GETREPORTDAILYCONTINGENCIA
DATA2FECHA|2026-10-06
USERNAMEGEOSOP
http
GET https://testnucgt.digifact.com/api/Shared?COUNTRY=GT&TAXID=000005888492&DATA1=SHARED_GETREPORTDAILYCONTINGENCIA&DATA2=FECHA%7C2026-10-06&USERNAME=GEOSOP
Authorization: <token JWT>

Filtros

FiltroFormatoObligatorioEjemplo de `DATA2`
FECHAyyyy-MM-dd o yyyy-MM-dd HH:mm[:ss]SíFECHA|2026-10-06
FECHAFINigual que FECHA; máximo 2 días desde FECHANoFECHA|2026-10-06 08:00|FECHAFIN|2026-10-06 12:00
ESTABLECIMIENTOnúmeroNoFECHA|2026-10-06|ESTABLECIMIENTO|2
AUTHNUMBERnúmero de autorizaciónNoFECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63
TIPOnúmero del tipo de DTE (1 = FACT, 9 = NDEB, 10 = NCRE…)NoFECHA|2026-10-06|TIPO|1
ESTADOACUSEACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SATNoFECHA|2026-10-06|ESTADOACUSE|RECHAZADO_SAT
LIMITEnúmero mayor a 0; devuelve los primeros n por hora de emisiónNoFECHA|2026-10-06|LIMITE|5

Se pueden combinar: FECHA|2026-10-06|TIPO|1|ESTADOACUSE|ACEPTADO_SAT.

Respuesta

Respuesta del consumo con FECHA|2026-10-06: un documento en contingencia, anulado, con la emisión y la anulación aceptadas por la SAT.

json
{
  "REQUEST_DATA": [
    {
      "Respuesta": 1,
      "Codigo": 1,
      "Procesador": "gt-test-ec2",
      "Mensaje": "",
      "Descripcion": "1 ITEMS",
      "Fecha": "2026-10-16T17:29:13-06:00"
    }
  ],
  "RESPONSE": [
    {
      "NIT_EMISOR": "5888492",
      "NE": "2",
      "NOMBRE": "ESTABLECIMIENTO \"TEST\t GEN\"",
      "TIPO_DTE": "FACT",
      "GUID": "43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63",
      "SERIE": "43FA028F",
      "NUMERO": "1835682532",
      "ESTATUS": "ANULADO",
      "FECHA_DE_EMISION": "10/6/2026 12:20:00 PM",
      "FECHA_DE_CERTIFICACION": "10/6/2026 4:10:00 PM",
      "NIT_COMPRADOR": "CF",
      "NOMBRE_COMPRADOR": "CONSUMIDOR FINAL",
      "SUBTOTAL": "563.392857",
      "IVA": "67.607143",
      "TOTAL": "631",
      "ITEMS": "2",
      "CONTINGENCIA": "100000011",
      "REFERENCIA_INTERNA": "REFINTERNAJC-20260921-1",
      "ACUSE_RECEPCION_ESTADO": "ACEPTADO_SAT",
      "ACUSE_RECEPCION_FECHA": "10/6/2026 4:10:06 PM",
      "ACUSE_ANULACION_ESTADO": "ACEPTADO_SAT",
      "ACUSE_ANULACION_FECHA": "10/6/2026 4:11:34 PM",
      "FCID": "FCID202620261006T16:10:0006:0043FA028F6D6A4AE4AC9B5B00E18D8C63",
      "FCID_ANULACION": "FCID0000000037749674763200658185348857730592246593634874174644074583954"
    }
  ]
}

Ese día ningún documento en contingencia tiene otros impuestos, por eso OTROS_IMPUESTOS no viene.

Campos de cada documento

CampoQué contieneEjemplo
NIT_EMISORNIT del emisor, sin ceros a la izquierda.5888492
NENúmero de establecimiento.2
NOMBRENombre del establecimiento.ESTABLECIMIENTO "TEST GEN"
TIPO_DTETipo de documento.FACT
GUIDNúmero de autorización.43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63
SERIESerie del DTE.43FA028F
NUMERONúmero del DTE.1835682532
ESTATUSANULADO, o vacío si no está anulado.ANULADO
FECHA_DE_EMISIONFecha declarada en el documento.10/6/2026 12:20:00 PM
FECHA_DE_CERTIFICACIONMomento en que se certificó.10/6/2026 4:10:00 PM
NIT_COMPRADORNIT del receptor, o CF.CF
NOMBRE_COMPRADORNombre del receptor.CONSUMIDOR FINAL
SUBTOTALTotal menos impuestos.563.392857
IVAIVA.67.607143
OTROS_IMPUESTOSSuma de impuestos distintos al IVA. Solo viene si algún documento de la respuesta los tiene.0.5
TOTALTotal del documento.631
ITEMSCantidad de líneas.2
CONTINGENCIANúmero de acceso de contingencia. Vacío si no se emitió en contingencia.100000011
REFERENCIA_INTERNAReferencia interna del emisor.REFINTERNAJC-20260921-1
ACUSE_RECEPCION_ESTADOEstado ante la SAT del documento: ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT.ACEPTADO_SAT
ACUSE_RECEPCION_FECHACuándo aceptó la SAT el documento. Vacío si no está ACEPTADO_SAT.10/6/2026 4:10:06 PM
ACUSE_ANULACION_ESTADOEstado ante la SAT de la anulación. Vacío si el documento no está anulado.ACEPTADO_SAT
ACUSE_ANULACION_FECHACuándo aceptó la SAT la anulación.10/6/2026 4:11:34 PM
FCIDFCID que asignó la SAT al documento. Vacío si no está ACEPTADO_SAT.FCID2026…43FA028F6D6A4AE4AC9B5B00E18D8C63
FCID_ANULACIONFCID que asignó la SAT a la anulación. Vacío si no está anulado o si la anulación no fue aceptada.FCID0000000037749674…

42. Reporte de acuses SAT

SHARED_GETREPORTDAILYACUSES devuelve todos los documentos del día con el estado ante la SAT de la emisión y de la anulación, y sus FCID.

Request

ParámetroValor
COUNTRYGT
TAXID000005888492
DATA1SHARED_GETREPORTDAILYACUSES
DATA2FECHA|2026-10-06
USERNAMEGEOSOP
http
GET https://testnucgt.digifact.com/api/Shared?COUNTRY=GT&TAXID=000005888492&DATA1=SHARED_GETREPORTDAILYACUSES&DATA2=FECHA%7C2026-10-06&USERNAME=GEOSOP
Authorization: <token JWT>

Filtros

FiltroFormatoObligatorioEjemplo de `DATA2`
FECHAyyyy-MM-dd o yyyy-MM-dd HH:mm[:ss]SíFECHA|2026-10-06
FECHAFINigual que FECHA; máximo 2 días desde FECHANoFECHA|2026-10-06 08:00|FECHAFIN|2026-10-06 12:00
ESTABLECIMIENTOnúmeroNoFECHA|2026-10-06|ESTABLECIMIENTO|2
AUTHNUMBERnúmero de autorizaciónNoFECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63
TIPOnúmero del tipo de DTE (1 = FACT, 9 = NDEB, 10 = NCRE…)NoFECHA|2026-10-06|TIPO|1
ESTADOACUSEACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SATNoFECHA|2026-10-06|ESTADOACUSE|RECHAZADO_SAT
LIMITEnúmero mayor a 0; devuelve los primeros n por hora de emisiónNoFECHA|2026-10-06|LIMITE|5

Ejemplo: solo los rechazados por la SAT entre las 08:00 y las 12:00 → FECHA|2026-10-06 08:00|FECHAFIN|2026-10-06 12:00|ESTADOACUSE|RECHAZADO_SAT.

Respuesta

Respuesta del consumo con FECHA|2026-10-06. Ese día hay 32 documentos (Descripcion = 32 ITEMS); acá se muestran 3: uno aceptado, uno rechazado y uno anulado en contingencia.

json
{
  "REQUEST_DATA": [
    {
      "Respuesta": 1,
      "Codigo": 1,
      "Procesador": "gt-test-ec2",
      "Mensaje": "",
      "Descripcion": "32 ITEMS",
      "Fecha": "2026-10-16T17:29:12-06:00"
    }
  ],
  "RESPONSE": [
    {
      "NIT_EMISOR": "5888492",
      "NE": "2",
      "NOMBRE": "ESTABLECIMIENTO \"TEST\t GEN\"",
      "TIPO_DTE": "FACT",
      "GUID": "D3149C62-5D53-4F8F-A947-EF59881D637A",
      "SERIE": "D3149C62",
      "NUMERO": "1565740943",
      "ESTATUS": "",
      "FECHA_DE_EMISION": "10/6/2026 10:00:00 AM",
      "FECHA_DE_CERTIFICACION": "10/6/2026 12:50:42 PM",
      "NIT_COMPRADOR": "CF",
      "NOMBRE_COMPRADOR": "CONSUMIDOR FINAL",
      "SUBTOTAL": "500",
      "IVA": "0",
      "OTROS_IMPUESTOS": "0",
      "TOTAL": "500",
      "ITEMS": "1",
      "CONTINGENCIA": "",
      "REFERENCIA_INTERNA": "EJEMPLO-GASOLINA-EXENTA",
      "ACUSE_RECEPCION_ESTADO": "ACEPTADO_SAT",
      "ACUSE_RECEPCION_FECHA": "10/6/2026 12:50:43 PM",
      "ACUSE_ANULACION_ESTADO": "",
      "ACUSE_ANULACION_FECHA": "",
      "FCID": "FCID202620261006T12:50:4206:00D3149C625D534F8FA947EF59881D637A",
      "FCID_ANULACION": ""
    },
    {
      "NIT_EMISOR": "5888492",
      "NE": "2",
      "NOMBRE": "ESTABLECIMIENTO \"TEST\t GEN\"",
      "TIPO_DTE": "FACT",
      "GUID": "6BBC27EF-2B79-4523-9753-739F3D46A668",
      "SERIE": "6BBC27EF",
      "NUMERO": "729367843",
      "ESTATUS": "",
      "FECHA_DE_EMISION": "10/6/2026 8:38:58 AM",
      "FECHA_DE_CERTIFICACION": "10/6/2026 8:39:00 AM",
      "NIT_COMPRADOR": "CF",
      "NOMBRE_COMPRADOR": "CONSUMIDOR FINAL",
      "SUBTOTAL": "314.285712",
      "IVA": "37.714288",
      "OTROS_IMPUESTOS": "0",
      "TOTAL": "352",
      "ITEMS": "16",
      "CONTINGENCIA": "",
      "REFERENCIA_INTERNA": "3EDB6A74-F3D4-46E7-852E-E630F13D868E",
      "ACUSE_RECEPCION_ESTADO": "RECHAZADO_SAT",
      "ACUSE_RECEPCION_FECHA": "",
      "ACUSE_ANULACION_ESTADO": "",
      "ACUSE_ANULACION_FECHA": "",
      "FCID": "",
      "FCID_ANULACION": ""
    },
    {
      "NIT_EMISOR": "5888492",
      "NE": "2",
      "NOMBRE": "ESTABLECIMIENTO \"TEST\t GEN\"",
      "TIPO_DTE": "FACT",
      "GUID": "43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63",
      "SERIE": "43FA028F",
      "NUMERO": "1835682532",
      "ESTATUS": "ANULADO",
      "FECHA_DE_EMISION": "10/6/2026 12:20:00 PM",
      "FECHA_DE_CERTIFICACION": "10/6/2026 4:10:00 PM",
      "NIT_COMPRADOR": "CF",
      "NOMBRE_COMPRADOR": "CONSUMIDOR FINAL",
      "SUBTOTAL": "563.392857",
      "IVA": "67.607143",
      "OTROS_IMPUESTOS": "0",
      "TOTAL": "631",
      "ITEMS": "2",
      "CONTINGENCIA": "100000011",
      "REFERENCIA_INTERNA": "REFINTERNAJC-20260921-1",
      "ACUSE_RECEPCION_ESTADO": "ACEPTADO_SAT",
      "ACUSE_RECEPCION_FECHA": "10/6/2026 4:10:06 PM",
      "ACUSE_ANULACION_ESTADO": "ACEPTADO_SAT",
      "ACUSE_ANULACION_FECHA": "10/6/2026 4:11:34 PM",
      "FCID": "FCID202620261006T16:10:0006:0043FA028F6D6A4AE4AC9B5B00E18D8C63",
      "FCID_ANULACION": "FCID0000000037749674763200658185348857730592246593634874174644074583954"
    }
  ]
}

Campos de cada documento

CampoQué contieneEjemplo
NIT_EMISORNIT del emisor, sin ceros a la izquierda.5888492
NENúmero de establecimiento.2
NOMBRENombre del establecimiento.ESTABLECIMIENTO "TEST GEN"
TIPO_DTETipo de documento.FACT
GUIDNúmero de autorización.43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63
SERIESerie del DTE.43FA028F
NUMERONúmero del DTE.1835682532
ESTATUSANULADO, o vacío si no está anulado.ANULADO
FECHA_DE_EMISIONFecha declarada en el documento.10/6/2026 12:20:00 PM
FECHA_DE_CERTIFICACIONMomento en que se certificó.10/6/2026 4:10:00 PM
NIT_COMPRADORNIT del receptor, o CF.CF
NOMBRE_COMPRADORNombre del receptor.CONSUMIDOR FINAL
SUBTOTALTotal menos impuestos.563.392857
IVAIVA.67.607143
OTROS_IMPUESTOSSuma de impuestos distintos al IVA. Solo viene si algún documento de la respuesta los tiene.0.5
TOTALTotal del documento.631
ITEMSCantidad de líneas.2
CONTINGENCIANúmero de acceso de contingencia. Vacío si no se emitió en contingencia.100000011
REFERENCIA_INTERNAReferencia interna del emisor.REFINTERNAJC-20260921-1
ACUSE_RECEPCION_ESTADOEstado ante la SAT del documento: ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT.ACEPTADO_SAT
ACUSE_RECEPCION_FECHACuándo aceptó la SAT el documento. Vacío si no está ACEPTADO_SAT.10/6/2026 4:10:06 PM
ACUSE_ANULACION_ESTADOEstado ante la SAT de la anulación. Vacío si el documento no está anulado.ACEPTADO_SAT
ACUSE_ANULACION_FECHACuándo aceptó la SAT la anulación.10/6/2026 4:11:34 PM
FCIDFCID que asignó la SAT al documento. Vacío si no está ACEPTADO_SAT.FCID2026…43FA028F6D6A4AE4AC9B5B00E18D8C63
FCID_ANULACIONFCID que asignó la SAT a la anulación. Vacío si no está anulado o si la anulación no fue aceptada.FCID0000000037749674…

Estados ante la SAT

EstadoSignificado
ACEPTADO_SATLa SAT aceptó el documento (o la anulación).
RECHAZADO_SATLa SAT rechazó el documento (o la anulación).
PENDIENTE_SATTodavía no hay respuesta de la SAT.
⚠️

Importante: El FCID solo existe cuando la SAT acepta. Un documento RECHAZADO_SAT o PENDIENTE_SAT llega con FCID vacío, como el segundo documento del ejemplo.

53. Resumen diario

SHARED_GETREPORTDAILYRESUMEN devuelve en un solo objeto los totales del día: documentos recibidos, en contingencia, aceptados, rechazados, pendientes y anulados.

Request

ParámetroValor
COUNTRYGT
TAXID000005888492
DATA1SHARED_GETREPORTDAILYRESUMEN
DATA2FECHA|2026-10-06|TIPOREPORTE|TODOS
USERNAMEGEOSOP
http
GET https://testnucgt.digifact.com/api/Shared?COUNTRY=GT&TAXID=000005888492&DATA1=SHARED_GETREPORTDAILYRESUMEN&DATA2=FECHA%7C2026-10-06%7CTIPOREPORTE%7CTODOS&USERNAME=GEOSOP
Authorization: <token JWT>

Filtros

FiltroFormatoObligatorioEjemplo de `DATA2`
FECHAyyyy-MM-dd o yyyy-MM-dd HH:mm[:ss]SíFECHA|2026-10-06
FECHAFINigual que FECHA; máximo 2 días desde FECHANoFECHA|2026-10-06|FECHAFIN|2026-10-07
TIPOREPORTECONTINGENCIA, NORMALES o TODOS. Sin él, TODOS.NoFECHA|2026-10-06|TIPOREPORTE|CONTINGENCIA
ESTABLECIMIENTOnúmeroNoFECHA|2026-10-06|ESTABLECIMIENTO|2
AUTHNUMBERnúmero de autorizaciónNoFECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63
TIPOnúmero del tipo de DTENoFECHA|2026-10-06|TIPO|1
ℹ️

Nota: El resumen no acepta ESTADOACUSE ni LIMITE: siempre cuenta todos los documentos y todos los estados, para que los totales no salgan parciales.

Respuesta

Respuesta del consumo con FECHA|2026-10-06|TIPOREPORTE|TODOS:

json
{
  "REQUEST_DATA": [
    {
      "Respuesta": 1,
      "Codigo": 1,
      "Procesador": "gt-test-ec2",
      "Mensaje": "",
      "Descripcion": "32 ITEMS",
      "Fecha": "2026-10-16T17:29:14-06:00"
    }
  ],
  "RESPONSE": [
    {
      "TotalDocumentosRecibidos": "32",
      "TotalDocumentosContingencia": "1",
      "Aceptados": "16",
      "Rechazados": "16",
      "Pendientes": "0",
      "AnuladosAceptados": "2",
      "AnuladosRechazados": "0",
      "ContingenciasAceptadas": "1",
      "ContingenciasRechazadas": "0"
    }
  ]
}

Campos

CampoQué cuentaEjemplo
TotalDocumentosRecibidosTodos los documentos del rango.32
TotalDocumentosContingenciaLos emitidos en contingencia.1
AceptadosAceptados por la SAT.16
RechazadosRechazados por la SAT.16
PendientesSin respuesta de la SAT.0
AnuladosAceptadosAnulados con la anulación aceptada por la SAT.2
AnuladosRechazadosAnulados con la anulación rechazada por la SAT.0
ContingenciasAceptadasEn contingencia y aceptados por la SAT.1
ContingenciasRechazadasEn contingencia y rechazados por la SAT.0

Aceptados + Rechazados + Pendientes = TotalDocumentosRecibidos. CONTINGENCIA + NORMALES = TODOS.

6Respuestas sin datos y reglas de los filtros

Si no hay documentos para los filtros enviados, o algún filtro no cumple las reglas, la respuesta trae Respuesta 0, el mensaje "No existe el recurso solicitado." y RESPONSE vacío. Respuesta del consumo con FECHA|06-10-2026 (formato de fecha incorrecto):

json
{
  "REQUEST_DATA": [
    {
      "Respuesta": 0,
      "Codigo": 0,
      "Procesador": "gt-test-ec2",
      "Mensaje": "No existe el recurso solicitado.",
      "Descripcion": "gt-test-ec2",
      "Fecha": "2026-10-16T17:29:20-06:00"
    }
  ],
  "RESPONSE": []
}
FiltroRegla
FECHAObligatoria, con formato yyyy-MM-dd o yyyy-MM-dd HH:mm[:ss].
FECHA a FECHAFINEl rango no puede superar 2 días.
ESTADOACUSESolo ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT. No se acepta en el resumen.
LIMITENúmero entero mayor a 0. No se acepta en el resumen.
TIPOREPORTESolo CONTINGENCIA, NORMALES o TODOS, y solo en el resumen.
ESTABLECIMIENTO, TIPONuméricos.