Reportes diarios: contingencia, acuses SAT y resumen 🧾
Tres consultas nuevas de APINUC para saber, por día y por NIT emisor, qué documentos se emitieron en contingencia, si la SAT ya aceptó cada documento y su anulación, y un resumen con los totales. Se consultan con el endpoint GET /api/Shared, igual que el resto de consultas.
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_GETREPORTDAILYCONTINGENCIA | Documentos del día emitidos en contingencia, con su número de acceso y el estado ante la SAT. |
SHARED_GETREPORTDAILYACUSES | Todos 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_GETREPORTDAILYRESUMEN | Totales 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:
| Parte | Qué trae |
|---|---|
REQUEST_DATA | El resultado. Respuesta 1 = con datos; Descripcion = total de documentos (32 ITEMS). |
RESPONSE | Un 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ámetro | Valor |
|---|---|
COUNTRY | GT |
TAXID | 000005888492 |
DATA1 | SHARED_GETREPORTDAILYCONTINGENCIA |
DATA2 | FECHA|2026-10-06 |
USERNAME | GEOSOP |
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
| Filtro | Formato | Obligatorio | Ejemplo de `DATA2` |
|---|---|---|---|
FECHA | yyyy-MM-dd o yyyy-MM-dd HH:mm[:ss] | Sí | FECHA|2026-10-06 |
FECHAFIN | igual que FECHA; máximo 2 días desde FECHA | No | FECHA|2026-10-06 08:00|FECHAFIN|2026-10-06 12:00 |
ESTABLECIMIENTO | número | No | FECHA|2026-10-06|ESTABLECIMIENTO|2 |
AUTHNUMBER | número de autorización | No | FECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63 |
TIPO | número del tipo de DTE (1 = FACT, 9 = NDEB, 10 = NCRE…) | No | FECHA|2026-10-06|TIPO|1 |
ESTADOACUSE | ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT | No | FECHA|2026-10-06|ESTADOACUSE|RECHAZADO_SAT |
LIMITE | número mayor a 0; devuelve los primeros n por hora de emisión | No | FECHA|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.
{
"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
| Campo | Qué contiene | Ejemplo |
|---|---|---|
NIT_EMISOR | NIT del emisor, sin ceros a la izquierda. | 5888492 |
NE | Número de establecimiento. | 2 |
NOMBRE | Nombre del establecimiento. | ESTABLECIMIENTO "TEST GEN" |
TIPO_DTE | Tipo de documento. | FACT |
GUID | Número de autorización. | 43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63 |
SERIE | Serie del DTE. | 43FA028F |
NUMERO | Número del DTE. | 1835682532 |
ESTATUS | ANULADO, o vacío si no está anulado. | ANULADO |
FECHA_DE_EMISION | Fecha declarada en el documento. | 10/6/2026 12:20:00 PM |
FECHA_DE_CERTIFICACION | Momento en que se certificó. | 10/6/2026 4:10:00 PM |
NIT_COMPRADOR | NIT del receptor, o CF. | CF |
NOMBRE_COMPRADOR | Nombre del receptor. | CONSUMIDOR FINAL |
SUBTOTAL | Total menos impuestos. | 563.392857 |
IVA | IVA. | 67.607143 |
OTROS_IMPUESTOS | Suma de impuestos distintos al IVA. Solo viene si algún documento de la respuesta los tiene. | 0.5 |
TOTAL | Total del documento. | 631 |
ITEMS | Cantidad de líneas. | 2 |
CONTINGENCIA | Número de acceso de contingencia. Vacío si no se emitió en contingencia. | 100000011 |
REFERENCIA_INTERNA | Referencia interna del emisor. | REFINTERNAJC-20260921-1 |
ACUSE_RECEPCION_ESTADO | Estado ante la SAT del documento: ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT. | ACEPTADO_SAT |
ACUSE_RECEPCION_FECHA | Cuándo aceptó la SAT el documento. Vacío si no está ACEPTADO_SAT. | 10/6/2026 4:10:06 PM |
ACUSE_ANULACION_ESTADO | Estado ante la SAT de la anulación. Vacío si el documento no está anulado. | ACEPTADO_SAT |
ACUSE_ANULACION_FECHA | Cuándo aceptó la SAT la anulación. | 10/6/2026 4:11:34 PM |
FCID | FCID que asignó la SAT al documento. Vacío si no está ACEPTADO_SAT. | FCID2026…43FA028F6D6A4AE4AC9B5B00E18D8C63 |
FCID_ANULACION | FCID 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ámetro | Valor |
|---|---|
COUNTRY | GT |
TAXID | 000005888492 |
DATA1 | SHARED_GETREPORTDAILYACUSES |
DATA2 | FECHA|2026-10-06 |
USERNAME | GEOSOP |
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
| Filtro | Formato | Obligatorio | Ejemplo de `DATA2` |
|---|---|---|---|
FECHA | yyyy-MM-dd o yyyy-MM-dd HH:mm[:ss] | Sí | FECHA|2026-10-06 |
FECHAFIN | igual que FECHA; máximo 2 días desde FECHA | No | FECHA|2026-10-06 08:00|FECHAFIN|2026-10-06 12:00 |
ESTABLECIMIENTO | número | No | FECHA|2026-10-06|ESTABLECIMIENTO|2 |
AUTHNUMBER | número de autorización | No | FECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63 |
TIPO | número del tipo de DTE (1 = FACT, 9 = NDEB, 10 = NCRE…) | No | FECHA|2026-10-06|TIPO|1 |
ESTADOACUSE | ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT | No | FECHA|2026-10-06|ESTADOACUSE|RECHAZADO_SAT |
LIMITE | número mayor a 0; devuelve los primeros n por hora de emisión | No | FECHA|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.
{
"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
| Campo | Qué contiene | Ejemplo |
|---|---|---|
NIT_EMISOR | NIT del emisor, sin ceros a la izquierda. | 5888492 |
NE | Número de establecimiento. | 2 |
NOMBRE | Nombre del establecimiento. | ESTABLECIMIENTO "TEST GEN" |
TIPO_DTE | Tipo de documento. | FACT |
GUID | Número de autorización. | 43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63 |
SERIE | Serie del DTE. | 43FA028F |
NUMERO | Número del DTE. | 1835682532 |
ESTATUS | ANULADO, o vacío si no está anulado. | ANULADO |
FECHA_DE_EMISION | Fecha declarada en el documento. | 10/6/2026 12:20:00 PM |
FECHA_DE_CERTIFICACION | Momento en que se certificó. | 10/6/2026 4:10:00 PM |
NIT_COMPRADOR | NIT del receptor, o CF. | CF |
NOMBRE_COMPRADOR | Nombre del receptor. | CONSUMIDOR FINAL |
SUBTOTAL | Total menos impuestos. | 563.392857 |
IVA | IVA. | 67.607143 |
OTROS_IMPUESTOS | Suma de impuestos distintos al IVA. Solo viene si algún documento de la respuesta los tiene. | 0.5 |
TOTAL | Total del documento. | 631 |
ITEMS | Cantidad de líneas. | 2 |
CONTINGENCIA | Número de acceso de contingencia. Vacío si no se emitió en contingencia. | 100000011 |
REFERENCIA_INTERNA | Referencia interna del emisor. | REFINTERNAJC-20260921-1 |
ACUSE_RECEPCION_ESTADO | Estado ante la SAT del documento: ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT. | ACEPTADO_SAT |
ACUSE_RECEPCION_FECHA | Cuándo aceptó la SAT el documento. Vacío si no está ACEPTADO_SAT. | 10/6/2026 4:10:06 PM |
ACUSE_ANULACION_ESTADO | Estado ante la SAT de la anulación. Vacío si el documento no está anulado. | ACEPTADO_SAT |
ACUSE_ANULACION_FECHA | Cuándo aceptó la SAT la anulación. | 10/6/2026 4:11:34 PM |
FCID | FCID que asignó la SAT al documento. Vacío si no está ACEPTADO_SAT. | FCID2026…43FA028F6D6A4AE4AC9B5B00E18D8C63 |
FCID_ANULACION | FCID 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
| Estado | Significado |
|---|---|
ACEPTADO_SAT | La SAT aceptó el documento (o la anulación). |
RECHAZADO_SAT | La SAT rechazó el documento (o la anulación). |
PENDIENTE_SAT | Todaví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ámetro | Valor |
|---|---|
COUNTRY | GT |
TAXID | 000005888492 |
DATA1 | SHARED_GETREPORTDAILYRESUMEN |
DATA2 | FECHA|2026-10-06|TIPOREPORTE|TODOS |
USERNAME | GEOSOP |
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
| Filtro | Formato | Obligatorio | Ejemplo de `DATA2` |
|---|---|---|---|
FECHA | yyyy-MM-dd o yyyy-MM-dd HH:mm[:ss] | Sí | FECHA|2026-10-06 |
FECHAFIN | igual que FECHA; máximo 2 días desde FECHA | No | FECHA|2026-10-06|FECHAFIN|2026-10-07 |
TIPOREPORTE | CONTINGENCIA, NORMALES o TODOS. Sin él, TODOS. | No | FECHA|2026-10-06|TIPOREPORTE|CONTINGENCIA |
ESTABLECIMIENTO | número | No | FECHA|2026-10-06|ESTABLECIMIENTO|2 |
AUTHNUMBER | número de autorización | No | FECHA|2026-10-06|AUTHNUMBER|43FA028F-6D6A-4AE4-AC9B-5B00E18D8C63 |
TIPO | número del tipo de DTE | No | FECHA|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:
{
"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
| Campo | Qué cuenta | Ejemplo |
|---|---|---|
TotalDocumentosRecibidos | Todos los documentos del rango. | 32 |
TotalDocumentosContingencia | Los emitidos en contingencia. | 1 |
Aceptados | Aceptados por la SAT. | 16 |
Rechazados | Rechazados por la SAT. | 16 |
Pendientes | Sin respuesta de la SAT. | 0 |
AnuladosAceptados | Anulados con la anulación aceptada por la SAT. | 2 |
AnuladosRechazados | Anulados con la anulación rechazada por la SAT. | 0 |
ContingenciasAceptadas | En contingencia y aceptados por la SAT. | 1 |
ContingenciasRechazadas | En 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):
{
"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": []
}| Filtro | Regla |
|---|---|
FECHA | Obligatoria, con formato yyyy-MM-dd o yyyy-MM-dd HH:mm[:ss]. |
FECHA a FECHAFIN | El rango no puede superar 2 días. |
ESTADOACUSE | Solo ACEPTADO_SAT, PENDIENTE_SAT o RECHAZADO_SAT. No se acepta en el resumen. |
LIMITE | Número entero mayor a 0. No se acepta en el resumen. |
TIPOREPORTE | Solo CONTINGENCIA, NORMALES o TODOS, y solo en el resumen. |
ESTABLECIMIENTO, TIPO | Numéricos. |