OneTeam/don_confiao_backend
16
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases 9 Wiki Activity
Files
6e14dd9f366a516d2e9a3f8aeca0a15f39c260b2
don_confiao_backend/doc/requests.org
monomono 128ba215dd #51 feat: registrar categorias en admin y documentar endpoints 
Issue #51: discriminacion y administracion de categorias de productos.

- ProductCategoryAdmin con list_display/filtro por active
- doc/requests.org: GET/PATCH product_categories, import_from_external,
  deactivate, activate
2026-10-10 16:47:12 -05:00

4.8 KiB
Raw Blame History

Requests

Ejemplo de request contra la api usando verb

Autenticación   verb

template http://localhost:7000/api Content-Type: application/json;

Solicitar token

post token

{ "username": "admin", "password": "admin" }

respuesta 
{
  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc4MDExNTc0NywiaWF0IjoxNzgwMDI5MzQ3LCJqdGkiOiIxNmVjZGMxZmY4Y2Y0MzA4ODM3ZjM5Y2ZiNjQwNmZiMCIsInVzZXJfaWQiOiIxIn0.wmN-wp3Izv0NrfL_ap_i8eyg29w-foHNrQCCL6HoZWg",
  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzgwMDMxMTQ3LCJpYXQiOjE3ODAwMjkzNDcsImp0aSI6ImQ4ZjE1YTRmODc5NzRjZGViZDEzYzc1ZTU4ZDk3ZjEwIiwidXNlcl9pZCI6IjEifQ.kkQVT2pcYeS_TxlJ6QPU3rNOlZhOv96pyqVEGJI85KA"
}

Perfil de usuario

get users/me Authorization:Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzgwMDA2MzU4LCJpYXQiOjE3ODAwMDQ1NTgsImp0aSI6IjkwNzY4OGU2MmNlNTQ1M2JiYzU5MTA2MDhmMjY1MmY5IiwidXNlcl9pZCI6IjEifQ.aFls9WyA1VuDeMMUu8t7Pa9CbbLfyvIg9pB9xIxydpU

Respuesta 
{
  "id": 1,
  "username": "admin",
  "email": "admin@admin.org",
  "first_name": "",
  "last_name": "",
  "role": "administrator"
}

Renovar token

post token/refresh

{ "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTc3ODU1Njc5MywiaWF0IjoxNzc4NDcwMzkzLCJqdGkiOiJlMDU0NTVkNWExYzA0YjFkYWZhNWZkNzFkZGM5Mzc1NyIsInVzZXJfaWQiOiIxIn0.wZcbBrGoxDMPjZxI-GR1GTAuRtzU4qaT0rgGS5Oblf4" }

response 
{
  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzc4NDcyMjQ5LCJpYXQiOjE3Nzg0NzA0NDksImp0aSI6IjE5YTM0ZDQ5Mzk3ZDQzNGE4NDlkZTgyYzdkNWQyNjQ0IiwidXNlcl9pZCI6IjEifQ.jowmaa5SXKIWpmUGLV0dj9CydYFtuecc7s_RveJvjLA"
}

Don confiao   verb

template http://localhost:7000/don_confiao/api/ Content-Type: application/json; Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzgwMDMxMTQ3LCJpYXQiOjE3ODAwMjkzNDcsImp0aSI6ImQ4ZjE1YTRmODc5NzRjZGViZDEzYzc1ZTU4ZDk3ZjEwIiwidXNlcl9pZCI6IjEifQ.kkQVT2pcYeS_TxlJ6QPU3rNOlZhOv96pyqVEGJI85KA

todas las rutas

get

response 
{
  "sales": "http://localhost:7000/don_confiao/api/sales/",
  "catalog_sales": "http://localhost:7000/don_confiao/api/catalog_sales/",
  "customers": "http://localhost:7000/don_confiao/api/customers/",
  "products": "http://localhost:7000/don_confiao/api/products/",
  "reconciliate_jar": "http://localhost:7000/don_confiao/api/reconciliate_jar/"
}

customers

get customers/

response 
[
  {
    "id": 1,
    "name": "Consumidor Final",
    "address": "",
    "email": "",
    "phone": "",
    "external_id": "2753"
  },
  ...
]

products

get products/

Productos Inactivos

get products/?active=false

Productos Activos

get products/?active=true

Traer todos los productos

get products/?active=all

Inactiva productos

patch products/1

{ "active": false }

Obtener Ventas por catalogo

get catalog_sales/

response 
{
    "id": 6,
    "customer": 1,
    "date": "2024-09-02T00:00:00Z",
    "catalogsaleline_set": [
      {
        "id": 2,
        "catalog_sale": 6,
        "product": 1,
        "unit_price": "3000.00",
        "quantity": "2.00"
      },
      {
        "id": 3,
        "catalog_sale": 6,
        "product": 1,
        "unit_price": "5000.00",
        "quantity": "3.00"
      }
    ],
    "total": 21000.0
  }

*** Crear una venta por catalogo
post catalog_sales/

{"customer": "1", "date": "2024-09-02", "catalogsaleline_set": [{"product": "1", "quantity": "2", "unit_price": "3000"}, {"product": "1", "quantity": "3", "unit_price": "5000"}]}

*** Importar Clientes de Tryton
post  importar_productos_de_tryton

{}

**** response
#+begin_src json
[]

Categorías de productos

La fuente de categorías es Tryton. name y external_id son solo lectura; Don Confiao administra description, alternative_name y active.

Listar categorías

get product_categories/?active=all get product_categories/?active=true get product_categories/?active=false

Actualizar campos administrados por Don Confiao

patch product_categories/1/

{
  "description": "Granos enteros",
  "alternative_name": "Cereales",
  "active": false
}
Importar categorías desde Tryton

Solo importa las categorías asociadas a productos salables; no borra categorías locales. Requiere administrador.

post product_categories/import_from_external

{}

Desactivar categorías

post product_categories/deactivate/

{
  "ids": [1, 2]
}
Activación de categorías

post product_categories/activate/

{
  "ids": [1, 2]
}