Saltar a contenido

Referencia

  • https://api.csfacturacion.com/visor-sat

API REST application/json

Credenciales de contratación vigente mediante Http Basic

Estadísticas

Consultar el importe total acumulado de las facturas emitidas y recibidas por mes

/visor-sat/stats Consultar importes de ISR e IVA

Petición

Tipo

application/json

Cuerpo

Campo Descripción Tipo
rfc* RFC de autenticación ante el SAT String
ciec CIEC de autenticación ante el SAT String
efirma.certificado Certificado e.firma en base64 String
efirma.llave_privada Llave privada e.firma en base64 String
efirma.password Contraseña de la llave privada e.firma String
solicitud.ejercicio* Año del ejercicio fiscal Integer
solicitud.tipo* Tipo de CFDI [I(ingreso), E(egreso)] String
solicitud.tipo_factura* Tipo Factura [R(recibidas), E(emitidas)] String
solicitud.regimen* Régimen fiscal String
solicitud.regimen_idc* Identificador de régimen fiscal String
solicitud.marca_decreto* Indica si aplica decreto fiscal Boolean

Ejemplo CIEC
GET /visor-sat/stats HTTP/1.1
Authorization: Basic QUFBMDEwMTAxQUFBOkllaGVlKnRoMjAzNg==
Host: api.csfacturacion.com
Content-Type: application/json
Content-Length: 47

{
    "rfc": "AAA010101AAA",
    "ciec": "CI3C",
    "solicitud": {
        "ejercicio": 2024,
        "tipo": "I",
        "tipo_factura": "E",
        "regimen": "601",
        "regimen_idc": "601",
        "marca_decreto": false
    }
}

Response

200 OK

application/json

Ejemplo
{
     // Consulte La guía de inicio rápido para ver el ejemplo completo de la respuesta
}

Descarga el JSON de muestra desde Aquí

422 Datos Inválidos

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": {
        "message": "ciec must not be empty"
    }
}

Schema

  • error: Objeto JSON
    Representa un error en la petición HTTP.
  • message: String
    Resumen/descripción del error
  • details: Objeto JSON
    Representa los detalles del error. Aplica para código 422
  • message: String
    Indica por que el campo es erróneo.
    • field: String
      El campo con dato erróneo.
401 Credenciales Inválidas

Tipo

application/json

Cuerpo

Ejemplo
{
    "error": {
        "message": "Credenciales inválidas: Usuario o password incorrecto",
    }
}

Schema

  • error: Objeto JSON
    Representa un error en la petición HTTP.
  • message: String
    Resumen/descripción del error
  • details: Objeto JSON
    Representa los detalles del error. Aplica para código 422
  • message: String
    Indica por que el campo es erróneo.
    • field: String
      El campo con dato erróneo.

Mapping de campos

Se describen los campos más relevantes del JSON.

Campo JSON Descripción / Equivalente en tabla del visor SAT
rfcEmisor RFC del emisor de los CFDI (columna de identificación del contribuyente).
rfcReceptor RFC del receptor (si aplica).
fechaCorte Fecha de corte del reporte (momento en que se genera la consulta).
fechaGeneracion Fecha en que se generó el archivo o reporte.
tipo Tipo de contribuyente en el visor: “Emisor” o “Receptor”.
ejercicio Año fiscal al que corresponde la información (ejemplo: 2024).
regimenFiscal Régimen fiscal del emisor (ejemplo: 601 – General de Ley Personas Morales).
metodoPago Método de pago del CFDI: PUE (Pago en una sola exhibición) o PPD (Pago en parcialidades).
formaPago Forma de pago (efectivo, transferencia, etc. – puede venir vacío).
usoCFDI Uso del CFDI declarado (ejemplo: G01, gastos en general).
numPeriodo Número del periodo dentro del ejercicio (1 = enero, 2 = febrero, etc.).
nombrePeriodo Nombre del mes (Enero, Febrero, etc.).
cfdiVigentes Cantidad de CFDI vigentes en ese periodo.
cfdiCancelados Cantidad de CFDI cancelados en ese periodo.
cfdiTotal Total de CFDI (vigentes + cancelados).
sumSubTotal Suma de subtotales de los CFDI emitidos.
sumDescuento Suma de descuentos aplicados.
sumSubTotalNeto Subtotal neto después de descuentos.
sumTotal Importe total de los CFDI (incluye impuestos).
sumRetISR Retenciones de ISR aplicadas.
sumRetIVA Retenciones de IVA aplicadas.
sumRetIEPS Retenciones de IEPS aplicadas.
sumTrasIVA IVA trasladado en el periodo.
sumTrasIVATasa16 IVA trasladado al 16%.
sumTrasIVATasa08 IVA trasladado al 8%.
sumTrasTotal Total de impuestos trasladados.
sumTrasIVATasaBase16 Base gravable para IVA al 16%.
sumTrasIVATasaBase08 Base gravable para IVA al 8%.
sumTrasIVATasaBase0 Base gravable para IVA al 0%.
sumTrasIVAExento Importe exento de IVA.
sumTrasIVANoObjeto Importe no objeto de IVA.
sumTrasIEPS IEPS trasladado.
sumTrasIEPSBase Base gravable para IEPS.
sumImportePagado Importe efectivamente pagado (si aplica).
sumIngCobSinImp Ingresos cobrados sin impuestos.
sumImporPagSinImp Importe pagado sin impuestos.
origen Origen del dato (puede venir vacío).
marcaPODEBI Marca si aplica el esquema PODEBI (sí/no).
marcaDecreto Marca si aplica algún decreto fiscal.