Descargar archivos

Descripción general

Este endpoint devuelve un enlace temporal para descargar un archivo de un CFDI, real o de prueba. El enlace vence en 3600 segundos (expires_in_seconds) y el archivo se descarga con el nombre <uuid>.<fileType>. Descárgalo con una solicitud GET a download_url antes de que venza.

Para un CFDI cancelado, pdf y xml devuelven el acuse de cancelación cuando está disponible, y si no, el archivo original. zip siempre devuelve el archivo original.

Requiere el permiso Leer en Órdenes de cobro.

Endpoint

GEThttps://app.credonix.mx/api/v1/invoices/{invoiceId}/cfdis/{cfdiId}/files/{fileType}

Path params:

invoiceId — el id de la orden de cobro.
cfdiId — el id del CFDI, real o de prueba.
fileType — pdf, xml o zip, en minúsculas.

Obtén el enlace de descarga

El ejemplo pide el PDF de un CFDI de prueba.

Campos de la respuesta

Campo	Tipo	Descripcion
`download_url`	string	Enlace temporal de descarga.
`expires_in_seconds`	integer	Segundos de vigencia del enlace: `3600`.

Errores

Status	Código	Causa
`401`	`MISSING_API_KEY` \| `INVALID_API_KEY` \| `API_KEY_REVOKED`	API key ausente, inválida o revocada.
`403`	`INSUFFICIENT_PERMISSIONS`	La API key no tiene el permiso Leer en Órdenes de cobro.
`404`	`NOT_FOUND`	`fileType` no es `pdf`, `xml` ni `zip`; la orden de cobro no existe; el CFDI no pertenece a esa orden de cobro; o el archivo no está disponible. `message` indica cuál.

`404` — tipo de archivo inválido

{
  "code": "NOT_FOUND",
  "message": "El tipo de archivo debe ser pdf, xml o zip.",
  "request_id": "5175381f-af5e-445b-9bb6-338496396bd5"
}