Saltar al contenido
Facturador

Anular compra

POST /api/purchases/{purchase_id}/void

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

Anula la compra (estado 11): revierte el stock que ingresó, sus lotes y el costo promedio, y saca sus pagos de caja/bancos.

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.

Sin cuerpo.

Errores (409): la compra ya está anulada; alguno de sus productos ya se vendió (lotes/series vendidos) y no se puede revertir; una regla de caja lo impide. 403 sin permiso annular_purchase; 404.

Parámetros

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

Respuestas

200 — Anulada

{
  "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-07",
    "state_type_id": "11",
    "state_type_description": "Anulado",
    "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 en almacén central",
    "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 anulada con éxito"
}

409 — Ya anulada

{
  "success": false,
  "message": "La compra ya se encuentra anulada"
}

403 — Sin permiso

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

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.