📄 Registrar Nueva Factura

Permite registrar una nueva factura en el sistema, vinculándola a un pedido (order) existente. Recibe el orderId y el archivo PDF como multipart/form-data.

Sin autenticación

Este endpoint tiene auth: false. Está pensado para servicios internos o procesos automatizados. Asegúrate de restringir el acceso a nivel de red en producción.

POST

/api/invoices/register Sin Auth No requiere JWT

---

¿Cómo funciona?

1. Validación del archivo — Verifica que se haya enviado el campo invoicePdf. Si falta, responde 400.

2. Validación del body — Comprueba que orderId esté presente en el body.

3. Comprobación de duplicado — Verifica que no exista ya una factura para ese pedido. Si existe, lanza error 400.

4. Búsqueda del pedido — Localiza el Order en Strapi por numberOrder, incluyendo el usuario relacionado.

5. Subida del PDF — Sube el archivo a la Media Library de Strapi mediante uploadFile.

6. Creación de la factura — Crea el registro Invoice con invoiceId, order, user, file y date.

7. Respuesta — Retorna los datos de la factura recién creada.

---

Uso

Request

POST /api/invoices/register
Content-Type: multipart/form-data

Campo	Tipo	Requerido	Descripción
orderId	string	✅	Identificador del pedido (numberOrder en la colección Order)
invoicePdf	file	✅	Archivo PDF de la factura

Respuestas

✅ 200 Éxito

{
  "message": "Invoice registered successfully",
  "invoice": {
    "invoiceId": "ORD-2024-001",
    "date": "2024-03-15",
    "order": 42,
    "user": 7,
    "file": 15
  }
}

❌ 400 Sin PDF

{
  "success": false,
  "message": "Invoice PDF is required"
}

❌ 400 Ya existe

{
  "success": false,
  "message": "Invoice for order ID ORD-2024-001 already exists"
}

❌ 400 Pedido no encontrado

{
  "success": false,
  "message": "Order not found: ORD-2024-001"
}

Ejemplo con fetch

const formData = new FormData();
formData.append("orderId", "ORD-2024-001");
formData.append("invoicePdf", pdfFile); // File object

const response = await fetch("/api/invoices/register", {
  method: "POST",
  body: formData,
});

const data = await response.json();
console.log("Factura registrada:", data.invoice.invoiceId);

---

Archivos relacionados

Archivo	Rol
src/api/invoice/controllers/invoice.ts	Controlador — valida inputs y llama al servicio
src/api/invoice/services/invoice.ts	Servicio — lógica de negocio y persistencia
src/api/invoice/routes/custom-invoice.ts	Definición de la ruta
src/utils/uploadFile.ts	Utilidad para subir archivos a la Media Library
src/api/invoice/content-types/invoice/schema.json	Esquema del content type Invoice