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.