Saltar al contenido
Facturador

Editar compra (observación y vencimiento)

PUT /api/purchases/{purchase_id}

Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).

Edita solo datos que no mueven stock ni dinero. Acepta PUT o PATCH; ambos campos son opcionales.

Quién puede usarlo: cualquier usuario autenticado. Un administrador accede a todos los registros; un vendedor solo a los que registró él (o en los que figura como vendedor). Si el registro existe pero es de otro vendedor responde 403.

Permisos adicionales del usuario (se activan en 3. Usuarios): editar exige edit_purchase, anular annular_purchase y eliminar delete_purchase. Sin el permiso responde 403.

Campo Tipo Obligatorio Descripción / valores permitidos
observation string No Observación (máx. 1000, puede ser null).
date_of_due date No Fecha de vencimiento YYYY-MM-DD (puede ser null).

Errores: 403 sin permiso edit_purchase o si es de otro vendedor; 409 si la compra está anulada; 422; 404.

Parámetros

Parámetro Dónde Obligatorio Ejemplo Descripción
purchase_id ruta sí 1

Cuerpo

Content-Type: application/json

{
  "observation": "Entrega parcial, saldo la próxima semana",
  "date_of_due": "2026-12-15"
}

Respuestas

200 — Editada

{
  "success": true,
  "data": {
    "id": 77,
    "external_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",
    "document_type_id": "01",
    "document_type_description": "FACTURA ELECTRÓNICA",
    "series": "F001",
    "number": "4587",
    "number_full": "F001-4587",
    "date_of_issue": "2026-11-07",
    "date_of_due": "2026-12-15",
    "state_type_id": "01",
    "state_type_description": "Registrado",
    "supplier_id": 14,
    "supplier": {
      "name": "DISTRIBUIDORA DEL SUR S.A.C.",
      "number": "20456789123"
    },
    "currency_type_id": "PEN",
    "exchange_rate_sale": 1.0,
    "total": 118.0,
    "total_paid": 50.0,
    "total_pending": 68.0,
    "observation": "Entrega parcial, saldo la próxima semana",
    "user_id": 5,
    "establishment_id": 1,
    "items": [
      {
        "id": 301,
        "item_id": 120,
        "description": "GASEOSA 500ML",
        "quantity": 50.0,
        "unit_price": 2.36,
        "total": 118.0,
        "warehouse_id": 1,
        "lot_code": null
      }
    ],
    "payments": [
      {
        "id": 51,
        "date_of_payment": "2026-11-07",
        "payment_method_type_id": "04",
        "payment_method_type_description": "Transferencia",
        "destination_type": "BankAccount",
        "destination_id": 3,
        "destination_description": "BCP SOLES",
        "reference": "OP-99812",
        "payment": 50.0
      }
    ]
  },
  "message": "Compra actualizada"
}

403 — Sin permiso

{
  "success": false,
  "message": "No tienes permiso para editar compras."
}

409 — Anulada

{
  "success": false,
  "message": "La compra está anulada y no se puede editar."
}

Pruébalo

Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.