Skip to content

Endpoints

URL base: https://api.zelta.dev/pos/v1

Ventas

Listar ventas

http
GET /sales

Crear venta

http
POST /sales

Obtener venta

http
GET /sales/{id}

Cancelar venta

http
POST /sales/{id}/cancel

Devolución

http
POST /sales/{id}/refund

Productos

Listar productos

http
GET /products

Crear producto

http
POST /products

Obtener producto

http
GET /products/{id}

Actualizar producto

http
PATCH /products/{id}

Eliminar producto

http
DELETE /products/{id}

Inventario

Consultar stock

http
GET /inventory/{product_id}

Ajustar stock

http
POST /inventory/{product_id}/adjust

Transferir stock

http
POST /inventory/transfer

Ejemplo: Crear una venta

bash
curl -X POST https://api.zelta.dev/pos/v1/sales \
  -H "Authorization: Bearer tu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "product_id": "prod_abc123", "quantity": 2, "price": 299.00 },
      { "product_id": "prod_def456", "quantity": 1, "price": 599.00 }
    ],
    "payment_method": "card",
    "customer_id": "cust_xyz789"
  }'

INFO

Todos los endpoints retornan respuestas en formato JSON y soportan paginación con los parámetros page y per_page.

Documentación oficial de Zelta