Generar URL de descarga del PDF/XML de una factura

GET

/invoices/{id}/download

const url = 'https://api.dev.lade.com.mx/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/download?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&type=pdf';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.lade.com.mx/invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/download?teamId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&type=pdf' \
  --header 'Authorization: Bearer <token>'

Genera una URL prefirmada de S3 (expira en 900s) para descargar el PDF o XML de una factura ya timbrada o cancelada. No disponible para facturas en DRAFT/PENDING/ERROR.

Authorizations

cognitoAuth

Parameters

Path Parameters

required

string format: uuid

ID de la factura (UUID)

Query Parameters

teamId

required

string format: uuid

ID del equipo (UUID)

type

string

default: pdf

Allowed values: pdf xml

Tipo de archivo a descargar

Responses

200

URL de descarga generada

application/json

object

url

string format: uri

type

string

Allowed values: pdf xml

expiresIn

integer

Example

{
  "url": "https://lade-dev-invoices.s3.amazonaws.com/550e8400.../990e8400.../invoice.pdf?X-Amz-Signature=...",
  "type": "pdf",
  "expiresIn": 900
}

400

Solicitud inválida

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Validation failed",
  "field": "email",
  "message": "Invalid email format"
}

403

Sin permisos

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Forbidden",
  "message": "You don't have permission to access this resource"
}

404

Recurso no encontrado

application/json

object

error

required

string

message

string

field

string

Example

{
  "error": "Not found",
  "message": "Resource not found"
}