Skip to main content
POST
Solicitar export masivo de XML

Authorizations

x-api
string
header
required

API key emitida por Ipsofactura, enviada en el header x-api.

Body

application/json
desde
string<date>
required

Primer día del rango, inclusive (zona horaria America/Mexico_City).

Example:

"2026-08-01"

hasta
string<date>
required

Último día del rango, inclusive. El rango no puede abarcar más de 366 días: para un periodo mayor hay que pedir varios exports.

Example:

"2026-08-31"

rfcEmisor
string

Opcional. Limita el export a un solo emisor. Si se omite, el export cubre todas las empresas registradas de la cuenta.

Maximum string length: 13
Pattern: ^$|^[A-Za-z&Ññ]{3,4}[0-9]{6}[A-Za-z0-9]{3}$
Example:

"EKU9003173C9"

Response

Export encolado

Estado de un export masivo de XML

completedAt
string<date-time>

Cuándo terminó de generarse o de fallar.

createdAt
string<date-time>

Cuándo se pidió el export.

desde
string<date>

Primer día del rango, inclusive.

Example:

"2026-08-01"

errorCode
string

Por qué falló, cuando el estatus es fallido. Código estable; el texto de error_message es informativo y no debe parsearse.

Example:

"EXPORT_TOO_LARGE"

errorMessage
string

Descripción del fallo, para quien lo lea.

estatus
string

pendiente (en cola), en_proceso (armando el archivo), listo (descargable) o fallido.

Example:

"pendiente"

expirado
boolean

true cuando el export se generó correctamente pero su archivo ya se borró por la política de retención. No es un error: hay que volver a pedir el export.

Example:

false

hasta
string<date>

Último día del rango, inclusive.

Example:

"2026-08-31"

id
string<uuid>

Id del export. Es lo que se debe almacenar: la URL de descarga se vuelve a pedir con él.

Example:

"9a4f07ff-3abc-435f-b7a6-88c2bc65b4c1"

rfcEmisor
string

Emisor al que se limitó el export, si se pidió así.

Example:

"EKU9003173C9"

tamanoBytes
integer<int64>

Tamaño del ZIP en bytes. Sólo cuando el export está listo.

Example:

5242880

totalCfdis
integer<int32>

CFDIs incluidos en el archivo. Sólo cuando el export está listo. Puede ser 0: un rango sin CFDIs produce un ZIP válido y vacío.

Example:

1043

url
string

URL firmada, de solo lectura, con vigencia de 15 minutos desde que se genera. No la almacenes: guarda el id y vuelve a llamar a GET /cfdi/exports/{id}. El ZIP contiene un XML por CFDI, nombrado por folio fiscal, más un manifiesto.csv que los relaciona con serie, folio, receptor, total y estatus.

Example:

"https://storage.ipsofactura.com/exports/9a4f07ff.zip?sig=..."