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.

URL´s

Marca tu ambiente activo — los botones de copiar ruta de cada endpoint arman la URL completa con la base que elijas aquí.

🛠️ Pruebas:

https://api.test.sw.com.mx 📄

🚀 Productivo:

https://api.sw.com.mx 📄

🚨Importante: Los servicios de descarga del SAT no cuentan con ambiente de pruebas. El ambiente de pruebas Efisco® apunta a los servicios productivos 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 mas información, escribenos a soporte@sw.com.mx o contacta con tu ejecutiva de ventas, ten en cuenta que el proceso de integración puede tomar tiempo.

📖 En esta referencia

📖 Documentación

requestType | processType

requestType \| processType	Valor	Descripción
`WebService`	`0`	Petición realizada vía servicio web
`WebPortal`	`1`	Petición realizada por Scraping \| Portal SAT
`Metadata`	`2`	Petición de información metadatos
`WebService (Sin metadata)`	`3`	Petición realizada vía web service que no contiene metadata

documentType

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`)

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

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

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)

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)

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ódigos de error devueltos por el SAT

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

Cargar FIEL

Cargar una nueva FIEL en el sistema.

🔗 Endpoint

POST https://api.test.sw.com.mx/gestion/v1/api/certificates/create/fiel 📄

Header	Valor
`Authorization`	`Bearer Token`
`Content-Type`	`application/json`

🧾 Parámetros JSON

Propiedad	Tipo	Uso	Descripción
`privatekey`	string	Requerido	Key en Base64
`publickey`	string	Requerido	CSD en Base64
`password`	string	Requerido	Contraseña del certificado

Ejemplo Request

curl --location --request POST 'https://api.sw.com.mx/gestion/v1/api/certificates/create/fiel' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "privatekey": "{{base64Key}}",
    "publickey": "{{base64Cer}}",
    "password": "12345678a"
}'

Respuesta

{
    "data": {
        "idUser": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "idDealer": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "taxId": "CACX7605101P8",
        "createdDate": "2025-04-11T18:31:04.9935201+00:00",
        "serialNumber": "30001000000500003282",
        "name": "XOCHILT CASAS CHAVEZ",
        "notBefore": "2023-05-09T18:05:49+00:00",
        "notAfter": "2027-05-08T18:05:49+00:00",
        "encryptedPfx": "8nFGs1nqir...",
        "encryptedPK": "nxG25f9lPwt...",
        "encryptedPassword": "g109dSBauF8P3Fb7BNwBbg=="
    },
    "status": "success",
    "message": "OK",
    "messageDetail": ""
}

{
    "data": null,
    "status": "error",
    "message": "Verifique que el certificado y la contraseña sean correctos",
    "messageDetail": ""
}

Atributo	Tipo	Descripción
`data`	object/null	Objeto de datos referente a la solicitud cuando es exitoso.
`status`	String	“success” o “error”
`message`	String	Mensaje informativo sobre la petición generada. Varia si la petición fue “success” o “error”.
`messageDetail`	String	Mensaje más descriptivo del error cuando existe uno.

Atributo	Tipo	Descripción
`data`	array/null	Lista de objetos con información de paginación y datos filtrados. Cada elemento contine datos diferentes.
`status`	String	“success” o “error”
`message`	String	Mensaje informativo sobre la petición generada. Varia si la petición fue “success” o “error”.
`messageDetail`	String	Mensaje más descriptivo del error cuando existe uno.

Propiedad	Uso	Descripción
`page`	Requerido	Pagina que se extrae en la consulta
`per_page`	Requerido	Numero de registros por pagina

Propiedad	Tipo	Uso	Descripción
`taxId`	string	Requerido	RFC relacionado a la CIEC
`password`	string	Requerido	Contraseña CIEC

Propiedad	Tipo	Uso	Descripción
`documentType`	string	Requerido	Tipo de documento a descargar
`startDate`	string	Requerido	Fecha de inicio (“aaaa-mm-dd hh:mm:ss”)
`endDate`	string	Requerido	Fecha de fin (“aaaa-mm-dd hh:mm:ss”)
`taxId`	string	Requerido	RFC
	string	Opcional	(Default = null) Especifica el tipo de complemento a buscar (si es null busca todos los tipos de complementos)
`generatePDF`	bool	Opcional	(Default = false) Especificar si se generaran los PDFs de los documentos descargadas
`googleDrive`	bool	Opcional	(Default = false) Especificar si se guarda la descarga en Google Drive (si existe cuenta vinculada)

Propiedad	Tipo	Uso	Descripción
`active`	int	Requerido	Estatus de la descarga
`schedule`	string	Requerido	Hora de ejecución de la descarga, siempre se ejecuta a las 00:00:00 hrs
`documentType`	string	Requerido	Tipo de documento a descargar
`taxId`	string	Requerido	RFC del usuario
`lapseDays`	int	Requerido	Rango de días de la información a descargar
	int	Requerido	Tipo de proceso a ejecutar
`frecuencyInDays`	int	Requerido	Frecuencia en dias con la que se hará la descarga
`generatePdf`	int	Opcional	(Default = 0) Especificar si se generaran los PDFs de los documentos descargadas
`googleDrive`	int	Opcional	(Default = 0) Especificar si se guarda la descarga en Google Drive (si existe cuenta vinculada)
	string	Opcional	(Default = null) Especifica el tipo de comprobante a descargar (si es null busca todos los tipos de comprobantes)
	string	Opcional	(Default = null) Especifica el tipo de complemento a buscar (si es null busca todos los tipos de complementos)

Atributo	Tipo	Descripción
`data`	String/null	Descripción referente a la solicitud cuando es exitoso.
`status`	String	“success” o “error”
`message`	String	Mensaje informativo sobre la petición generada. Varia si la petición fue “success” o “error”.
`messageDetail`	String	Mensaje más descriptivo del error cuando existe uno.

Atributo	Tipo	Descripción
`data`	String/null	URL de descarga cuando es exitoso.
`status`	String	“success” o “error”
`message`	String	Mensaje informativo sobre la petición generada. Varia si la petición fue “success” o “error”.
`messageDetail`	String	Mensaje más descriptivo del error cuando existe uno.

Efisco® API

URL´s

🔄 Flujo de descarga Efisco

📖 Documentación

requestType | processType

documentType

processType (processes)

statusRequest

cfdiType

cfdiComplement (Web Service)

cfdiComplement (Portal SAT | Scraping)

Códigos de error devueltos por el SAT

Cargar FIEL

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Obtener FIEL por RFC

🔗 Endpoint

📍 Parámetros Query

Ejemplo Request

Respuesta

Obtener FIELs paginados

🔗 Endpoint

📍 Parámetros Query

Ejemplo Request

Respuesta

Eliminar FIEL

🔗 Endpoint

📍 Parámetros Path

Ejemplo Request

Respuesta

Cargar CIEC

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Obtener CIEC por ID

🔗 Endpoint

📍 Parámetros Path

Ejemplo Request

Respuesta

Obtener CIEC´s paginadas

🔗 Endpoint

📍 Parámetros Query

Ejemplo Request

Respuesta

Actualizar CIEC

🔗 Endpoint

📍 Parámetros Path

Ejemplo Request

Respuesta

Eliminar CIEC

🔗 Endpoint

📍 Parámetros Path

Ejemplo Request

Respuesta

Scraping | Portal SAT

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Web Service

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Metadata

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Programar descarga

🔗 Endpoint

🧾 Parámetros JSON

Ejemplo Request

Respuesta

Consulta por requestId

🔗 Endpoint

📍 Parámetros Path

processType (`processes`)