🧾 Partes de Orden de Compra (`updatePartes`)

🧠 Concepto general

El endpoint updatePartes permite sincronizar el estado completo de las partes de una orden de compra.

👉 No existen endpoints separados para:

- crear parte
- editar parte
- eliminar parte

Todo se resuelve enviando el array completo de partes.

📌 Endpoint

POST /ordenes_de_compra/{id}/updatePartes

Parámetro	Tipo	Descripción
`id`	number	ID de la orden de compra

⚠️ Funcionamiento general

El frontend siempre debe enviar el snapshot completo actual de partes.

Caso	Resultado
Parte con `id`	Se actualiza
Parte sin `id`	Se crea
Parte existente que no vino en el array	Se elimina
`partes: []`	La OC queda sin partes

🔑 Campo `key`

Cada parte debe tener un campo key.

Este campo debe generarse en frontend y sirve para identificar filas nuevas antes de tener un id real de base de datos.

Se recomienda utilizar UUID.

Ejemplo:

{
  "key": "f8b94a91-8a3f-4e8a-a66f-9c1b2d4a1234"
}

📥 Payload

{
  "partes": [
    {
      "id": 15,
      "key": "f8b94a91-8a3f-4e8a-a66f-9c1b2d4a1234",
      "numeroParte": 1,
      "descripcion": "Primera entrega",
      "montoTotal": 50000,
      "moneda": "Peso Argentino",
      "estado": "FACTURADO",
      "remitoNumero": "R-0001",
      "remitoFecha": "2026-05-13 10:00:00",
      "facturado": true,
      "facturaNumero": "FC-0001-00001234",
      "facturaFecha": "2026-05-14 10:00:00",
      "pagado": false,
      "fechaPago": null,
      "montoPagado": null,
      "observaciones": "Factura presentada"
    }
  ]
}

📤 Respuesta

La respuesta devuelve el estado oficial final persistido por el backend.

👉 El frontend debe utilizar esta respuesta como fuente de verdad.

{
  "ok": true,
  "idOrdenDeCompra": 123,
  "ordenDeCompra": {
    "id": 123,
    "dividida": true,
    "estado": "FACTURADO",
    "compraEstado": "TOTAL",
    "entregaEstado": "PENDIENTE",
    "facturado": true,
    "pagado": false,
    "montoPagado": 0
  },
  "partes": [
    {
      "id": 15,
      "key": "f8b94a91-8a3f-4e8a-a66f-9c1b2d4a1234"
    }
  ]
}

🧩 Uso recomendado en React

setOrden((current) => ({
  ...current,
  ...response.ordenDeCompra,
}));

setPartes((current) =>
  current.map((parte) => {
    const updated = response.partes.find(
      (p) => p.key === parte.key
    );

    return updated
      ? {
          ...parte,
          id: updated.id,
        }
      : parte;
  })
);

➕ Crear partes

Para crear partes nuevas, enviar objetos sin id.

{
  "partes": [
    {
      "key": "a1",
      "numeroParte": 1,
      "descripcion": "Parte 1",
      "montoTotal": 50000,
      "estado": "PENDIENTE",
      "facturado": false,
      "pagado": false
    }
  ]
}

✏️ Actualizar partes

Para actualizar una parte, enviar su id.

{
  "partes": [
    {
      "id": 15,
      "key": "a1",
      "numeroParte": 1,
      "descripcion": "Parte actualizada",
      "montoTotal": 75000,
      "estado": "FACTURADO",
      "facturado": true,
      "pagado": false
    }
  ]
}

🗑️ Eliminar partes

Para eliminar una parte, simplemente no incluirla en el array enviado.

🚫 Eliminar todas las partes

{
  "partes": []
}

⚠️ Importante sobre montos

La suma de partes no necesita coincidir con el monto total original de la orden de compra.

❌ Posibles errores

Orden no encontrada

{
  "error": "Orden de compra no encontrada"
}

ID inválido

{
  "error": "id inválido"
}

Error por `numeroParte` duplicado

{
  "error": "Duplicate entry '123-1' for key 'uq_oc_parte'"
}

Error por `key` duplicada

{
  "error": "Duplicate entry 'uuid' for key 'uq_oc_partes_key'"
}

📘 Tipos TypeScript

export type OrdenDeCompraParteEstado =
  | "PENDIENTE"
  | "ENTREGADO"
  | "FACTURADO"
  | "PAGADO"
  | "CANCELADO";

export interface OrdenDeCompraParteInput {
  id?: number;

  key: string;

  numeroParte: number;
  descripcion?: string | null;

  montoTotal: number;
  moneda?: string | null;

  estado: OrdenDeCompraParteEstado;

  remitoNumero?: string | null;
  remitoFecha?: string | null;

  facturado: boolean;
  facturaNumero?: string | null;
  facturaFecha?: string | null;

  pagado: boolean;
  fechaPago?: string | null;
  montoPagado?: number | null;

  observaciones?: string | null;
}

export interface OrdenDeCompraResumenResponse {
  id: number;

  dividida: boolean;

  estado: string;
  compraEstado: string;
  entregaEstado: string;

  facturado: boolean;
  pagado: boolean;

  montoPagado: number | null;
}

export interface UpdatePartesRequest {
  partes: OrdenDeCompraParteInput[];
}

export interface UpdatePartesResponseParte {
  id: number;
  key: string;
}

export interface UpdatePartesResponse {
  ok: boolean;

  idOrdenDeCompra: number;

  ordenDeCompra: OrdenDeCompraResumenResponse;

  partes: UpdatePartesResponseParte[];
}

🧑‍💻 Helper `createGuid`

export function createGuid(): string {
  if (
    typeof crypto !== "undefined"
    && crypto.randomUUID
  ) {
    return crypto.randomUUID();
  }

  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(
    /[xy]/g,
    (c) => {
      const r = Math.random() * 16 | 0;
      const v = c === "x"
        ? r
        : (r & 0x3 | 0x8);

      return v.toString(16);
    }
  );
}

➕ Helper para crear una parte vacía

export function createEmptyParte(
  numeroParte: number
): OrdenDeCompraParteInput {
  return {
    key: createGuid(),

    numeroParte,

    descripcion: null,

    montoTotal: 0,

    moneda: null,

    estado: "PENDIENTE",

    remitoNumero: null,
    remitoFecha: null,

    facturado: false,
    facturaNumero: null,
    facturaFecha: null,

    pagado: false,
    fechaPago: null,
    montoPagado: null,

    observaciones: null,
  };
}

🔄 Ejemplo con Axios

import axios from "axios";

export async function updateOrdenDeCompraPartes(
  idOrdenDeCompra: number,
  partes: OrdenDeCompraParteInput[]
): Promise<UpdatePartesResponse> {

  const response = await axios.post<UpdatePartesResponse>(
    `/ordenes_de_compra/${idOrdenDeCompra}/updatePartes`,
    { partes }
  );

  return response.data;
}

✅ Resumen rápido

Crear:
- enviar sin id

Actualizar:
- enviar con id

Eliminar:
- no enviar en el array

Eliminar todas:
- enviar partes: []

El backend devuelve:
- estado actualizado de la OC
- partes finales persistidas