Saltar al contenido
Facturador

Ver devolución

GET /api/inventory/devolutions/{devolution_id}

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

Devuelve una devolución con sus productos, series, lotes y el movimiento de kardex que generó.

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.

Formato de respuesta: estándar {success, data, message?} (registro único).

Parámetros de la ruta:

Campo Tipo Obligatorio Descripción / valores permitidos
devolution_id integer Sí Id de la devolución.

Errores:

  • 403 si la registró otro vendedor.
  • 404 si el registro no existe.
  • 401 sin token o con un token inválido.

Parámetros

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

Respuestas

200 — Devolución

{
  "success": true,
  "data": {
    "id": 31,
    "number": "DV-31",
    "external_id": "6b0d3c2e-8a4f-4b7a-9f51-2c1e7d9a0b44",
    "date_of_issue": "2026-11-07",
    "time_of_issue": "10:15:00",
    "state_type_id": "01",
    "establishment": {
      "id": 1,
      "description": "Tienda Centro"
    },
    "warehouse": {
      "id": 3,
      "description": "Almacén - Tienda Centro"
    },
    "devolution_reason": {
      "id": 2,
      "description": "Productos dañados"
    },
    "observation": "Devolución al proveedor DISTRIBUIDORA LIMA SAC, guía 0001-552",
    "user": {
      "id": 7,
      "name": "JUAN PEREZ"
    },
    "total_quantity": 4.0,
    "created_at": "2026-11-07 10:15:03",
    "items": [
      {
        "id": 52,
        "item_id": 15,
        "description": "GASEOSA 500 ML",
        "internal_id": "P0015",
        "unit_type_id": "NIU",
        "quantity": 4.0,
        "series": [],
        "lots": []
      }
    ],
    "kardex": [
      {
        "id": 9140,
        "item_id": 15,
        "warehouse_id": 3,
        "quantity": -4.0,
        "date_of_issue": "2026-11-07"
      }
    ]
  }
}

403 — Registro de otro vendedor

{
  "success": false,
  "message": "No tienes permiso para acceder a este registro."
}

404 — No existe

{
  "success": false,
  "message": "Registro no encontrado."
}

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.