Efisco® API

Efisco® permite gestionar la descarga masiva de XML y generar reportes de los archivos descargados. Para poder generar las descargas es necesario contar con un token de acceso temporal o token infinito válido.

✓ Antes de empezar

1 Obtén un token de acceso temporal o un token infinito válido.

2 Carga una FIEL vigente del RFC con el servicio Cargar FIEL (o una CIEC con Cargar CIEC).

3 Crea la solicitud de descarga, consulta su estatus y genera la URL de descarga (ver «Flujo de descarga»).

📊 Visualiza el flujo de descarga Efisco® 🔎

Tres pasos, en orden. El paso 1 tiene varios métodos disponibles (Web Service, Scraping, Metadata, Programada): usa el que corresponda a tu caso.

POST /gestion/v1/api/massiveservicemanager/request/create/webservice (u otro método)

Crea la solicitud de descarga. Responde con un requestId que se usa en los siguientes pasos. Ver .
GET /gestion/v1/api/gestionxml/{requestId} → poll

Consulta el estatus de la solicitud hasta que statusRequest indique que terminó. Ver .
POST /gestion/v1/api/file

Con el pathFile obtenido en el paso anterior, genera la URL pública de descarga. Ver .

URL´s

🚨 Importante: Efisco® no cuenta con ambiente de pruebas. Todas las solicitudes se realizan en producción, directamente contra los servicios de descarga del SAT, y deberás cargar una FIEL vigente para poder realizar solicitudes de descarga.

💡 Nota: Efisco® permite implementar un proceso de descargas programadas haciendo uso de un webhook. Para más información escríbenos a soporte@sw.com.mx o contacta con tu ejecutiva de ventas; ten en cuenta que el proceso de integración puede tomar tiempo.

📚 Referencia del API

POST

Ejemplo Request

💡 Nota: estos ejemplos son llamadas directas al API REST; puedes armarlas en el lenguaje que prefieras. Sustituye los valores entre < > por los tuyos.

Probar en Postman

Respuesta

Valores permitidos en los parámetros y en las respuestas.

requestType \| processType	Valor	Descripción
`WebService`	`0`	Petición realizada vía servicio web. Descarga CFDIs con su estatus (vigente o cancelado), sin fecha de cancelación
`WebPortal`	`1`	Petición realizada por Scraping \| Portal SAT
`Metadata`	`2`	Petición de información metadatos
`WebService (Con fecha de cancelación)`	`3`	Petición realizada vía Web Service. Descarga CFDIs y metadata en el mismo flujo, e incluye estatus y fecha de cancelación

documentType	Valor	Descripción
`Emision`	`0`	Documento que emitió el RFC que genera la solicitud
`Recepcion`	`1`	Documento que recibió el RFC que genera la solicitud

processType (`processes`)	Valor	Descripción
`CFDI`	`0`	Generación de reportes y descargas de archivos XML
`PDF`	`1`	Generación de archivos PDF de los XML descargados
`Metadata`	`2`	Reportes centrados en información de metadatos

statusRequest	Valor	Descripción
`InProgress`	`1`	Petición en curso
`Error`	`3`	Ocurrió un error durante el proceso
`Expired`	`4`	Petición expirada o ya no disponible
`Completed`	`6`	Proceso terminado con éxito

cfdiType	Valor	Descripción
`Todos`	`null`	Recuperar todos los tipos de comprobante
`Pagos`	`P`	Comprobante de tipo Pagos
`Nómina`	`N`	Comprobante de tipo Nómina
`Ingreso`	`I`	Comprobante de tipo Ingreso
`Egreso`	`E`	Comprobante de tipo Egreso
`Traslados`	`T`	Comprobante de tipo Traslados

cfdiComplement (Web Service)	Valor	Descripción
`Todos`	`null`	Recupera todos los complementos
`Acreditamiento de IEPS`	`acreditamientoieps10`	Complemento de Acreditamiento de IEPS
`Aerolíneas`	`aerolineas`	Complemento de Aerolíneas
`Certificado de Destrucción`	`certificadodedestruccion`	Complemento de Certificado de Destrucción
`CFDI Registro Fiscal`	`cfdiregistrofiscal`	Complemento de CFDI Registro Fiscal
`Comercio Exterior`	`comercioexterior10`	Complemento de Comercio Exterior
`Comercio Exterior 1.1`	`comercioexterior11`	Complemento de Comercio Exterior 1.1
`Comprobante`	`comprobante`	Complemento de Comprobante
`Consumo de Combustibles`	`consumodecombustibles`	Complemento de Consumo de Combustibles
`Consumo de Combustibles 1.1`	`consumodecombustibles11`	Complemento de Consumo de Combustibles 1.1
`Sector de Ventas a Detalle`	`detallista`	Complemento de Sector de Ventas a Detalle
`Compra Venta de Divisas`	`divisas`	Complemento de Compra Venta de Divisas
`Donatarias`	`donat11`	Complemento de Donatarias
`Estado de Cuenta de Combustibles de Monederos Electrónicos`	`ecc11`	Complemento de Estado de Cuenta de Combustibles de Monederos Electrónicos
`Estado de Cuenta de Combustibles 1.2`	`ecc12`	Complemento de Estado de Cuenta de Combustibles 1.2
`Gastos de Hidrocarburos`	`gastoshidrocarburos10`	Complemento de Gastos de Hidrocarburos
`Instituciones Educativas Privadas`	`iedu`	Complemento de Instituciones Educativas Privadas
`Otros Derechos e Impuestos`	`implocal`	Complemento de Otros Derechos e Impuestos
`INE 1.1`	`ine11`	Complemento de INE 1.1
`Ingresos de Hidrocarburos`	`ingresoshidrocarburos`	Complemento de Ingresos de Hidrocarburos
`Leyendas Fiscales`	`leyendasfiscales`	Complemento de Leyendas Fiscales
`Recibo de Pago de Salarios`	`nomina11`	Complemento de Recibo de Pago de Salarios
`Recibo de Pago de Salarios 1.2`	`nomina12`	Complemento de Recibo de Pago de Salarios 1.2
`Notarios Públicos`	`notariospublicos`	Complemento de Notarios Públicos
`Obras de arte y antigüedades`	`obrasarteantiguedades`	Complemento de Obras de arte y antigüedades
`Pago en Especie`	`pagoenespecie`	Complemento de Pago en Especie
`Recepción de Pagos`	`pagos10`	Complemento de Recepción de Pagos
`Persona Física Integrante de Coordinado`	`pfic`	Complemento de Persona Física Integrante de Coordinado
`Sustitución y Renovación Vehicular`	`renovacionysustitucionvehiculos`	Complemento de Sustitución y Renovación Vehicular
`Servicios Parciales de Construcción`	`servicioparcialconstruccion`	Complemento de Servicios Parciales de Construcción
`SPEI de Tercero a Tercero`	`spei`	Complemento de SPEI de Tercero a Tercero
`Terceros`	`terceros11`	Complemento de Terceros
`Turista o Pasajero Extranjero`	`turistapasajeroextranjero`	Complemento de Turista o Pasajero Extranjero
`Vales de Despensa`	`valesdedespensa`	Complemento de Vales de Despensa
`Vehículo Usado`	`vehiculousado`	Complemento de Vehículo Usado
`Venta de Vehículos`	`ventavehiculos11`	Complemento de Venta de Vehículos

cfdiComplement (Portal SAT \| Scraping)	Valor	Descripción
`Todos`	`TODOS`	Recupera todos los complementos
`Recibo de Pago de Salarios`	`RECIBO_PAGO_SALARIOS`	Complemento de Recibo de Pago de Salarios (Nómina)
`Recibo de Pago de Salarios 1.2`	`RECIBO_PAGO_SALARIOS_12`	Complemento de Recibo de Pago de Salarios (Nómina) versión 1.2
`Vales de Despensa`	`VALES_DESPENSA`	Complemento de Vales de Despensa
`INE 1.1`	`INE_11`	Complemento de INE versión 1.1
`Estado de Cuenta Bancario`	`ESTADO_CUENTA_BANCARIO`	Complemento de Estado de Cuenta Bancario
`Persona Física Integrante de Coordinado`	`PERSONA_FISICA_COORDINADO`	Complemento de Persona Física Integrante de Coordinado
`Comercio Exterior`	`COMERCIO_EXTERIOR`	Complemento de Comercio Exterior
`Comercio Exterior 1.1`	`COMERCIO_EXTERIOR_11`	Complemento de Comercio Exterior versión 1.1
`Comercio Exterior 2.0`	`COMERCIO_EXTERIOR_20`	Complemento de Comercio Exterior versión 2.0
`Sustitución y Renovación Vehicular`	`SUSTITUCION_RENOVACION_VEHICULAR`	Complemento de Sustitución y Renovación Vehicular
`Estado de Cuenta de Combustibles 1.2`	`ESTADO_CUENTA_COMBUSTIBLES_12`	Complemento de Estado de Cuenta de Combustibles versión 1.2
`Estado de Cuenta de Combustibles de Monederos Electrónicos`	`ESTADO_CUENTA_COMBUSTIBLES_MONEDEROS`	Complemento de Estado de Cuenta de Combustibles de Monederos Electrónicos
`Recepción de Pagos`	`RECEPCION_PAGOS`	Complemento de Recepción de Pagos
`Recepción de Pagos (versión anterior)`	`RECEPCION_PAGOS_OLD`	Complemento de Recepción de Pagos (versión anterior)
`Carta Porte`	`CARTA_PORTE`	Complemento Carta Porte (genérico)
`Carta Porte 2.0`	`CARTA_PORTE_20`	Complemento Carta Porte versión 2.0
`Carta Porte 3.0`	`CARTA_PORTE_30`	Complemento Carta Porte versión 3.0
`Carta Porte 3.1`	`CARTA_PORTE_31`	Complemento Carta Porte versión 3.1
`Vehículo Usado`	`VEHICULO_USADO`	Complemento de Vehículo Usado
`Consumo de Combustibles`	`CONSUMO_COMBUSTIBLES`	Complemento de Consumo de Combustibles
`Consumo de Combustibles 1.1`	`CONSUMO_COMBUSTIBLES_11`	Complemento de Consumo de Combustibles versión 1.1
`Donatarias`	`DONATARIAS`	Complemento de Donatarias
`Recibo de Donativo`	`RECIBO_DONATIVO`	Complemento de Recibo de Donativo
`Aerolíneas`	`AEROLINEAS`	Complemento de Aerolíneas
`Acreditamiento de IEPS`	`ACREDITAMIENTO_IEPS`	Complemento de Acreditamiento de IEPS
`Ingresos de Hidrocarburos`	`INGRESOS_HIDROCARBUROS`	Complemento de Ingresos de Hidrocarburos
`Gastos de Hidrocarburos`	`GASTOS_HIDROCARBUROS`	Complemento de Gastos de Hidrocarburos
`SPEI de Tercero a Tercero`	`SPEI_TERCERO_TERCERO`	Complemento de SPEI de Tercero a Tercero
`Timbre Fiscal Digital`	`TIMBRE_FISCAL_DIGITAL`	Complemento de Timbre Fiscal Digital
`Leyendas Fiscales`	`LEYENDAS_FISCALES`	Complemento de Leyendas Fiscales
`Instituciones Educativas Privadas`	`INSTITUCIONES_EDUCATIVAS`	Complemento de Instituciones Educativas Privadas
`Venta de Vehículos`	`VENTA_VEHICULOS`	Complemento de Venta de Vehículos
`Servicios Parciales de Construcción`	`SERVICIOS_CONSTRUCCION`	Complemento de Servicios Parciales de Construcción
`Obras de arte y antigüedades`	`OBRAS_ARTE_ANTIGUEDADES`	Complemento de Obras de arte y antigüedades
`Compra Venta de Divisas`	`COMPRA_VENTA_DIVISAS`	Complemento de Compra Venta de Divisas
`Pago en Especie`	`PAGO_ESPECIE`	Complemento de Pago en Especie
`Terceros (variante 1)`	`TERCEROS_1`	Complemento de Terceros (variante 1)
`Terceros (variante 2)`	`TERCEROS_2`	Complemento de Terceros (variante 2)
`Turista o Pasajero Extranjero`	`TURISTA_PASAJERO_EXTRANJERO`	Complemento de Turista o Pasajero Extranjero
`Mis Cuentas`	`MIS_CUENTAS`	Complemento de Mis Cuentas
`Certificado de Destrucción`	`CERTIFICADO_DESTRUCCION`	Complemento de Certificado de Destrucción
`Otros Derechos e Impuestos`	`OTROS_DERECHOS_IMPUESTOS`	Complemento de Otros Derechos e Impuestos
`Sector de Ventas a Detalle`	`SECTOR_VENTAS_DETALLE`	Complemento de Sector de Ventas a Detalle
`Notarios Públicos`	`NOTARIOS_PUBLICOS`	Complemento de Notarios Públicos
`Estándar`	`ESTANDAR`	CFDI estándar (sin complemento)

Código	Mensaje	Descripción
`304`	`Certificado Revocado o Caduco`	El certificado fue revocado o bien la fecha de vigencia expiró.
`305`	`Certificado Inválido`	El certificado puede ser inválido por múltiples razones como son el tipo, la vigencia, etc.
`404`	`Error no controlado`	Error no controlado devuelto por el SAT
`5002`	`Se han agotado las solicitudes de por vida`	Se ha alcanzado el límite de solicitudes, con el mismo criterio
`5003`	`Tope máximo`	Indica que con base en los parámetros de consulta se está superando el tope máximo de CFDI o Metadata, por solicitud de descarga masiva.
`5004`	`No se encontró la información`	No se encontró la información con los datos proporcionados, inténtalo con otros parámetros de búsqueda.
`5006`	`Error interno en el proceso`	Error interno en el proceso devuelto por el SAT

En SW® somos mejores para TI, es por ello que tu opinión es muy importante, por favor ayúdanos calificando este articulo y dejando tus comentarios.

Updated on octubre 2, 2026

Efisco® API

URL´s

📚 Referencia del API

Ejemplo Request

Respuesta

Scraping | Portal SAT

Web Service

Metadata

Related Articles