# Referencia de la API Los 34 endpoints de la API pública de Posdata, generados del contrato OpenAPI 1.0.0. API REST servidor a servidor para cuentas con plan Pro. Autenticación con API key (Bearer). Montos en pesos colombianos enteros; fechas ISO 8601 en UTC. Cada endpoint tiene su página con parámetros, cuerpo, respuestas, errores y ejemplos. Los objetos que devuelve y recibe la API están, campo por campo, en [Objetos](https://developers.posdata.so/referencia/objetos/). El contrato completo en OpenAPI 3.1 está en [api.posdata.so/public/v1/openapi.json](https://api.posdata.so/public/v1/openapi.json). ## URLs base - `https://api.posdata.so/public/v1`: Producción (keys pdk_live\_). - `https://apidev.posdata.so/public/v1`: Pruebas (keys pdk_test\_, datos de prueba, puede reiniciarse). Todas las peticiones llevan `Authorization: Bearer `. Mira[Autenticación](https://developers.posdata.so/autenticacion/). ## Cuenta | Endpoint | Qué hace | Permiso | | -------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------------- | | [GET/me](https://developers.posdata.so/referencia/operations/getme/) | [Cuenta, API key y frescura de los datos](https://developers.posdata.so/referencia/operations/getme/) | cualquier key | ## Productos | Endpoint | Qué hace | Permiso | | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ---------------- | | [GET/products](https://developers.posdata.so/referencia/operations/listproducts/) | [Listar productos](https://developers.posdata.so/referencia/operations/listproducts/) | `products:read` | | [POST/products](https://developers.posdata.so/referencia/operations/createproduct/) | [Crear producto](https://developers.posdata.so/referencia/operations/createproduct/) | `products:write` | | [GET/products/{id}](https://developers.posdata.so/referencia/operations/getproduct/) | [Obtener un producto](https://developers.posdata.so/referencia/operations/getproduct/) | `products:read` | | [PATCH/products/{id}](https://developers.posdata.so/referencia/operations/updateproduct/) | [Editar producto](https://developers.posdata.so/referencia/operations/updateproduct/) | `products:write` | | [GET/categories](https://developers.posdata.so/referencia/operations/listcategories/) | [Listar categorías](https://developers.posdata.so/referencia/operations/listcategories/) | `products:read` | | [POST/categories](https://developers.posdata.so/referencia/operations/createcategory/) | [Crear categoría](https://developers.posdata.so/referencia/operations/createcategory/) | `products:write` | | [GET/categories/{id}](https://developers.posdata.so/referencia/operations/getcategory/) | [Obtener una categoría](https://developers.posdata.so/referencia/operations/getcategory/) | `products:read` | | [PATCH/categories/{id}](https://developers.posdata.so/referencia/operations/updatecategory/) | [Editar categoría](https://developers.posdata.so/referencia/operations/updatecategory/) | `products:write` | | [PATCH/products/{id}/variants/{variantId}](https://developers.posdata.so/referencia/operations/updatevariant/) | [Editar variante](https://developers.posdata.so/referencia/operations/updatevariant/) | `products:write` | ## Clientes | Endpoint | Qué hace | Permiso | | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------- | | [GET/customers](https://developers.posdata.so/referencia/operations/listcustomers/) | [Listar clientes](https://developers.posdata.so/referencia/operations/listcustomers/) | `customers:read` | | [POST/customers](https://developers.posdata.so/referencia/operations/createcustomer/) | [Crear cliente](https://developers.posdata.so/referencia/operations/createcustomer/) | `customers:write` | | [GET/customers/{id}](https://developers.posdata.so/referencia/operations/getcustomer/) | [Obtener un cliente](https://developers.posdata.so/referencia/operations/getcustomer/) | `customers:read` | | [PATCH/customers/{id}](https://developers.posdata.so/referencia/operations/updatecustomer/) | [Editar cliente](https://developers.posdata.so/referencia/operations/updatecustomer/) | `customers:write` | ## Inventario | Endpoint | Qué hace | Permiso | | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ----------------- | | [GET/warehouses](https://developers.posdata.so/referencia/operations/listwarehouses/) | [Listar bodegas](https://developers.posdata.so/referencia/operations/listwarehouses/) | `inventory:read` | | [GET/warehouses/{id}](https://developers.posdata.so/referencia/operations/getwarehouse/) | [Obtener una bodega](https://developers.posdata.so/referencia/operations/getwarehouse/) | `inventory:read` | | [GET/inventory/movements](https://developers.posdata.so/referencia/operations/liststockmovements/) | [Listar movimientos de inventario](https://developers.posdata.so/referencia/operations/liststockmovements/) | `inventory:read` | | [POST/inventory/movements](https://developers.posdata.so/referencia/operations/createstockmovement/) | [Registrar movimiento de stock](https://developers.posdata.so/referencia/operations/createstockmovement/) | `inventory:write` | | [GET/inventory/levels](https://developers.posdata.so/referencia/operations/liststocklevels/) | [Listar el stock por bodega](https://developers.posdata.so/referencia/operations/liststocklevels/) | `inventory:read` | | [GET/inventory/movements/{id}](https://developers.posdata.so/referencia/operations/getstockmovement/) | [Obtener un movimiento de inventario](https://developers.posdata.so/referencia/operations/getstockmovement/) | `inventory:read` | | [POST/inventory/counts](https://developers.posdata.so/referencia/operations/createstockcount/) | [Registrar un conteo de inventario](https://developers.posdata.so/referencia/operations/createstockcount/) | `inventory:write` | | [GET/inventory/kardex](https://developers.posdata.so/referencia/operations/getinventorykardex/) | [Kardex de un producto](https://developers.posdata.so/referencia/operations/getinventorykardex/) | `inventory:read` | | [GET/inventory/valuation](https://developers.posdata.so/referencia/operations/getinventoryvaluation/) | [Valor del inventario](https://developers.posdata.so/referencia/operations/getinventoryvaluation/) | `inventory:costs` | ## Ventas | Endpoint | Qué hace | Permiso | | ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | ------------ | | [GET/sales](https://developers.posdata.so/referencia/operations/listsales/) | [Listar ventas](https://developers.posdata.so/referencia/operations/listsales/) | `sales:read` | | [GET/sales/{id}](https://developers.posdata.so/referencia/operations/getsale/) | [Obtener una venta](https://developers.posdata.so/referencia/operations/getsale/) | `sales:read` | ## Facturación | Endpoint | Qué hace | Permiso | | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- | --------------- | | [GET/invoices](https://developers.posdata.so/referencia/operations/listinvoices/) | [Listar documentos](https://developers.posdata.so/referencia/operations/listinvoices/) | `invoices:read` | | [GET/invoices/{id}](https://developers.posdata.so/referencia/operations/getinvoice/) | [Obtener un documento](https://developers.posdata.so/referencia/operations/getinvoice/) | `invoices:read` | ## Cotizaciones | Endpoint | Qué hace | Permiso | | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------------- | | [GET/quotes](https://developers.posdata.so/referencia/operations/listquotes/) | [Listar cotizaciones](https://developers.posdata.so/referencia/operations/listquotes/) | `quotes:read` | | [GET/quotes/{id}](https://developers.posdata.so/referencia/operations/getquote/) | [Obtener una cotización](https://developers.posdata.so/referencia/operations/getquote/) | `quotes:read` | ## Caja | Endpoint | Qué hace | Permiso | | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ----------- | | [GET/cash-sessions](https://developers.posdata.so/referencia/operations/listcashsessions/) | [Listar turnos de caja](https://developers.posdata.so/referencia/operations/listcashsessions/) | `cash:read` | | [GET/cash-sessions/{id}](https://developers.posdata.so/referencia/operations/getcashsession/) | [Obtener un turno de caja](https://developers.posdata.so/referencia/operations/getcashsession/) | `cash:read` | ## Reportes | Endpoint | Qué hace | Permiso | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | -------------- | | [GET/reports/daily-sales](https://developers.posdata.so/referencia/operations/getdailysales/) | [Ventas por día](https://developers.posdata.so/referencia/operations/getdailysales/) | `reports:read` | ## Eventos | Endpoint | Qué hace | Permiso | | -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------- | | [GET/events](https://developers.posdata.so/referencia/operations/listevents/) | [Listar eventos](https://developers.posdata.so/referencia/operations/listevents/) | `events:read` | | [GET/events/{id}](https://developers.posdata.so/referencia/operations/getevent/) | [Obtener un evento](https://developers.posdata.so/referencia/operations/getevent/) | `events:read` | --- Fuente: https://developers.posdata.so/referencia/ · Índice para agentes: https://developers.posdata.so/llms.txt