Guides
Getting started
The same path as the «Get started with the API» tutorial in Developers, for whoever writes the code. Create a test key (pt_test_…) with read-only scopes, check the connection, read real data and, once the integration is ready, switch to a live key with the minimum scopes. Webhooks and writes require the Developer plan or above.
1. Create a key in «My keys»
Pick the test environment and read-only scopes (e.g. budgets:read). The full key is shown only once: store it in a password manager and send it in the Authorization: Bearer header.
2. Check the connection
GET /api/v1/ping
Returns the key name, its scopes and environment. 401 means invalid key; 403, a missing scope.
3. Read your real data
GET /api/v1/budgets
?limit=3
Lists are cursor-paginated: repeat the call with cursor=<next_cursor> until has_more is false. Every response carries X-RateLimit-Remaining with the requests left in the window.
4. Receive webhooks
POST /api/v1/webhooks
{ "url": "https://your-system.com/shop-notices", "events": ["lead.accepted", "vehicle.ready"] }They can also be created from the Webhooks tab without code. Keep the signing secret and verify X-PT-Signature on every delivery; answer 2xx within 5 seconds.
5. Go live
Before that, you can try writes, acceptances, invoices and messages risk-free in the sandbox (https://demo.programa-taller.es/desarrolladores-sandbox): fictitious data and nothing is really sent. Create a live key with the minimum scopes and, if you write data, add Idempotency-Key to every POST. Limits and the workshop's API plan are shown in the Usage tab; Developer and Business plans can be purchased from within the app.
Guide: create a budget and propose an appointment
Typical flow for a CRM or booking site. Every POST carries an Idempotency-Key (a fresh UUID per operation; reuse it only when retrying the same one). You need a live key with clients:write, vehicles:write, budgets:write, appointments:read and appointments:write.
1. Client: create it or get the existing one
POST /api/v1/clients
{ "name": "Laura Gómez", "phone": "600111222", "email": "laura@ejemplo.com" }With ?on_conflict=return_existing, if the phone, email or tax id exist you get that client (200) instead of 409.
2. The client's vehicle
POST /api/v1/vehicles
{ "client_id": 1204, "plate": "1234KLM", "brand": "Seat", "model": "León" }If the plate belongs to another client: 409 vehicle_belongs_to_other_client (the workshop decides).
3. Budget with its lines
POST /api/v1/budgets
{ "client_id": 1204, "vehicle_id": 871, "lines": [{ "description": "Oil and filter change", "quantity": 1, "unit_price": 65 }] }The response includes the computed totals. The client accepts and signs from the link the workshop sends (the API never returns that link); if they confirm it to you another way, accept on their behalf with POST /budgets/{id}/accept (budgets:accept scope).
4. Free slots
GET /api/v1/appointments/availability
?from=2026-10-14&to=2026-10-18&duration_minutes=60
5. Propose the appointment
POST /api/v1/appointments
{ "budget_id": 1234, "start": "2026-10-14T09:00:00+02:00", "duration_minutes": 60 }In «propose» mode it stays status=proposed until the workshop confirms it (you get appointment.confirmed by webhook). If the slot was taken: 409 slot_unavailable with alternatives.
Guide: your bot or AI on the workshop's channels
Your assistant answers on WhatsApp, SMS, website chat or email instead of the program's assistant. You need a live key with communications:read, messages:send, settings:write and webhooks:manage (Business or Partner plan). Try it first in the sandbox with POST /sandbox/simulate/message.
1. Subscribe to message.received
POST /api/v1/webhooks
{ "url": "https://your-bot.com/shop", "events": ["message.received"] }Every client message arrives signed with the conversation key, client, active budget, text and attachments.
2. Turn on the external assistant mode
PUT /api/v1/settings/assistant
{ "external_channels": ["whatsapp", "chat"], "fallback_minutes": 10 }On those channels the program's assistant stops answering. If you don't reply in time, or your key or webhook stop working, it answers that message again.
3. Read the thread if needed
GET /api/v1/conversations/{key}/messages
4. Reply
POST /api/v1/conversations/{key}/messages
{ "text": "We have a slot tomorrow at 9:00. Shall I book it for you?" }Outside the WhatsApp 24 h window send template_id (GET /messages/templates). To close the sale: POST /appointments, POST /budgets/{id}/accept or POST /budgets/{id}/invoice depending on your scopes.
Sandbox
https://demo.programa-taller.es is an instance with fictitious data restored every 2 hours. Every key there is a sandbox key with all scopes: it can write, accept, invoice and «send», but nothing is really sent (sends are logged as simulated) and webhooks are emitted anyway to test the full cycle. Your keys, webhooks and request log survive the resets.
1. Get your key
POST /api/v1/sandbox/keys
{ "email": "dev@example.com", "company": "Example Integrations Ltd", "name": "Anna Smith" }Also from https://demo.programa-taller.es/desarrolladores-sandbox. The key is shown only once and lasts 30 days.
2. Simulate a client writing
POST /api/v1/sandbox/simulate/message
{ "channel": "whatsapp", "from": "+34600111222", "text": "Do you have a slot tomorrow?" }3. Switch to production
Change the base URL to the workshop's instance and use a live key created in its Developers section.
Clients
GET /api/v1/clients clients:read
List clients
Ordered by ascending id. Clients erased under GDPR appear anonymised, with erased_at set.
Required scope: clients:read.
Query
| Name | Type | Required | Description |
|---|
search | string | No | Searches name, phone, email and tax id (2 characters minimum). |
expand | string [vehicles] | No | Optional relations to include. |
limit | integer · default 50 | No | Results per page (1–200). |
cursor | string | No | Opaque cursor returned as next_cursor by the previous page. |
Example
curl "https://your-shop.example/api/v1/clients" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": 1204,
"name": "Laura Gómez",
"phone": "+34600111222",
"phone_secondary": null,
"whatsapp_phone": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"vip": false,
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
},
"erased_at": null,
"vehicles": [
{
"id": 871,
"client_id": 1204,
"client": null,
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
]
}
],
"next_cursor": "aWQ6MTIzNA",
"has_more": true
}
POST /api/v1/clients clients:write
Create a client
Never merges into an existing record: if the tax id, email or phone already belong to another client it answers 409 client_exists with existing_id (or 200 with that client when ?on_conflict=return_existing). Phones are stored like in the app (Spain as 9 digits, other countries with prefix), emails lower-cased; typos are not auto-corrected. Marketing opt-outs are recorded in the consent log.
Required scope: clients:write.
Query
| Name | Type | Required | Description |
|---|
on_conflict | string [error, return_existing] · default error | No | error (default): 409 when it exists. return_existing: 200 with the existing client. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"name": "Laura Gómez",
"phone": "600111222",
"phone_secondary": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
}
}
Example
curl -X POST "https://your-shop.example/api/v1/clients" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"name":"Laura Gómez","phone":"600111222","phone_secondary":null,"email":"laura@ejemplo.com","billing_email":null,"tax_id":"12345678Z","address":"C/ Mayor 12","city":"Barcelona","zip":"08001","province":"Barcelona","country":"ES","preferred_language":"es","preferred_contact_method":"whatsapp","marketing_opt_out":false,"channel_opt_out":{"email":false,"sms":false,"whatsapp":false,"call":false}}'
Response
{
"id": 1204,
"name": "Laura Gómez",
"phone": "+34600111222",
"phone_secondary": null,
"whatsapp_phone": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"vip": false,
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
},
"erased_at": null,
"vehicles": [
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
]
}
GET /api/v1/clients/{id} clients:read
Client detail
Required scope: clients:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Client id. |
Query
| Name | Type | Required | Description |
|---|
expand | string [vehicles] | No | Optional relations to include. |
Example
curl "https://your-shop.example/api/v1/clients/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": 1204,
"name": "Laura Gómez",
"phone": "+34600111222",
"phone_secondary": null,
"whatsapp_phone": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"vip": false,
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
},
"erased_at": null,
"vehicles": [
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
]
}
PATCH /api/v1/clients/{id} clients:write
Update a client
Only the fields sent change (null clears a field). Changing email or phone is allowed and records old → new in the client's activity with the key name; emits client.updated. Setting another client's email, phone or tax id answers 409 client_exists. GDPR-erased clients answer 409 client_erased.
Required scope: clients:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Client id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | No | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"name": "Laura Gómez Ruiz",
"phone": "600111222",
"phone_secondary": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
}
}
Example
curl -X PATCH "https://your-shop.example/api/v1/clients/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"name":"Laura Gómez Ruiz","phone":"600111222","phone_secondary":null,"email":"laura@ejemplo.com","billing_email":null,"tax_id":"12345678Z","address":"C/ Mayor 12","city":"Barcelona","zip":"08001","province":"Barcelona","country":"ES","preferred_language":"es","preferred_contact_method":"whatsapp","marketing_opt_out":false,"channel_opt_out":{"email":false,"sms":false,"whatsapp":false,"call":false}}'
Response
{
"id": 1204,
"name": "Laura Gómez",
"phone": "+34600111222",
"phone_secondary": null,
"whatsapp_phone": null,
"email": "laura@ejemplo.com",
"billing_email": null,
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona",
"country": "ES",
"preferred_language": "es",
"preferred_contact_method": "whatsapp",
"vip": false,
"marketing_opt_out": false,
"channel_opt_out": {
"email": false,
"sms": false,
"whatsapp": false,
"call": false
},
"erased_at": null,
"vehicles": [
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
]
}
Vehicles
GET /api/v1/vehicles vehicles:read
List vehicles
Includes the latest recorded mileage and the MOT (ITV) expiry date.
Required scope: vehicles:read.
Query
| Name | Type | Required | Description |
|---|
plate | string | No | Exact plate (spaces and dashes ignored). |
client_id | integer | No | Filter by client. |
status | string [activo, baja_temporal, baja] | No | Vehicle status. |
limit | integer · default 50 | No | Results per page (1–200). |
cursor | string | No | Opaque cursor returned as next_cursor by the previous page. |
Example
curl "https://your-shop.example/api/v1/vehicles" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
],
"next_cursor": "aWQ6MTIzNA",
"has_more": true
}
POST /api/v1/vehicles vehicles:write
Create a vehicle
Always for an existing client (client_id). The plate is normalised (upper case, no spaces or dashes). If it belongs to ANOTHER client: 409 vehicle_belongs_to_other_client. If the same client already has it: 409 vehicle_exists with existing_id (or 200 with ?on_conflict=return_existing).
Required scope: vehicles:write.
Query
| Name | Type | Required | Description |
|---|
on_conflict | string [error, return_existing] · default error | No | error (default) or return_existing. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"client_id": 1204,
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
Example
curl -X POST "https://your-shop.example/api/v1/vehicles" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"client_id":1204,"plate":"1234 KLM","vin":"VSSZZZ5FZJR123456","brand":"Seat","model":"León","variant":"1.5 TSI","year":2019,"registration_date":"2019-03-15","fuel":"Gasolina","transmission":"Manual","engine_code":"DADA","horsepower":130,"displacement":"1498","color_code":null,"environmental_label":"C","itv_expiry_date":"2027-03-15","status":"activo"}'
Response
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
GET /api/v1/vehicles/{id} vehicles:read
Vehicle detail
Required scope: vehicles:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Vehicle id. |
Example
curl "https://your-shop.example/api/v1/vehicles/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
PATCH /api/v1/vehicles/{id} vehicles:write
Update a vehicle
Partial changes. client_id does not accept null: a vehicle is never unlinked from its owner via the API (it can move to another existing client).
Required scope: vehicles:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Vehicle id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | No | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"client_id": 1204,
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
Example
curl -X PATCH "https://your-shop.example/api/v1/vehicles/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"client_id":1204,"plate":"1234 KLM","vin":"VSSZZZ5FZJR123456","brand":"Seat","model":"León","variant":"1.5 TSI","year":2019,"registration_date":"2019-03-15","fuel":"Gasolina","transmission":"Manual","engine_code":"DADA","horsepower":130,"displacement":"1498","color_code":null,"environmental_label":"C","itv_expiry_date":"2027-03-15","status":"activo"}'
Response
{
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
}
GET /api/v1/vehicles/{id}/history vehicles:read
Vehicle history
Workshop visits (all its budgets except internal ones, newest first) with status, check-in and delivery, mileage, amount, invoice number and line concepts; plus interventions recorded at other workshops. Never includes costs.
Required scope: vehicles:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Vehicle id. |
Query
| Name | Type | Required | Description |
|---|
limit | integer · default 50 | No | Maximum visits (1–200). |
Example
curl "https://your-shop.example/api/v1/vehicles/1234/history" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"vehicle": {
"id": 871,
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"plate": "1234 KLM",
"vin": "VSSZZZ5FZJR123456",
"brand": "Seat",
"model": "León",
"variant": "1.5 TSI",
"year": 2019,
"registration_date": "2019-03-15",
"fuel": "Gasolina",
"transmission": "Manual",
"engine_code": "DADA",
"horsepower": 130,
"displacement": "1498",
"color_code": null,
"environmental_label": "C",
"km": 84500,
"itv_expiry_date": "2027-03-15",
"status": "activo"
},
"visits": [
{
"budget_id": 1234,
"status": "Facturado",
"created_at": "2026-10-06T09:30:00.000Z",
"checked_in_at": "2026-09-02T07:30:00.000Z",
"delivered_at": "2026-09-03T16:00:00.000Z",
"km": 84210,
"amount": 245.3,
"invoice": "F26/118",
"category": "Mantenimiento",
"works": [
"Oil and filter change"
]
}
],
"external_interventions": [
{
"title": "Tyre change",
"date": "2025-11-20",
"km": 78000,
"workshop_name": null,
"warranty_until": null
}
]
}
Budgets
GET /api/v1/budgets budgets:read
List budgets
Never includes the workshop's internal budgets nor cost data. Lines and totals are in /budgets/{id}.
Required scope: budgets:read.
Query
| Name | Type | Required | Description |
|---|
status | string | No | Exact status (Pendiente, Enviado, Aprobado, Finalizado, Facturado, Rechazado…). |
client_id | integer | No | Filter by client. |
vehicle_id | integer | No | Filter by vehicle. |
from | string (date-time) | No | Created on or after this date. |
to | string (date-time) | No | Created on or before this date. |
updated_since | string (date-time) | No | Only records modified on or after this date (ISO 8601). |
limit | integer · default 50 | No | Results per page (1–200). |
cursor | string | No | Opaque cursor returned as next_cursor by the previous page. |
Example
curl "https://your-shop.example/api/v1/budgets" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": null
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null
}
],
"next_cursor": "aWQ6MTIzNA",
"has_more": true
}
POST /api/v1/budgets budgets:write
Create a budget
Starts as «Pendiente» with channel «API», just like a budget created in the app (log, opening milestone, lead.created webhook). Totals are computed server-side with the workshop's tax; lines without tax_rate use the workshop rate. The vehicle, if given, must belong to the client. Internal-use categories are not allowed. With notify_client=true (and communications:send) the client gets the acknowledgement with their tracking link.
Required scope: budgets:write.
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"client_id": 1204,
"vehicle_id": 871,
"category_id": 5,
"subcategory_id": 51,
"client_reference": "PED-2026-118",
"public_notes": "Also check the suspension noise.",
"lines": [
{
"description": "Oil and filter change",
"quantity": 1,
"unit_price": 65,
"tax_rate": 21,
"discount_pct": 0,
"line_type": "labor",
"reference": null,
"group_title": null
}
],
"notify_client": false
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"client_id":1204,"vehicle_id":871,"category_id":5,"subcategory_id":51,"client_reference":"PED-2026-118","public_notes":"Also check the suspension noise.","lines":[{"description":"Oil and filter change","quantity":1,"unit_price":65,"tax_rate":21,"discount_pct":0,"line_type":"labor","reference":null,"group_title":null}],"notify_client":false}'
Response
{
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": 2,
"name": "Lift 2"
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
GET /api/v1/budgets/{id} budgets:read
Budget detail
Lines (description, quantity, unit price, tax, type, discount), totals with breakdown, appointment, in/out dates, assigned user and public tracking URL.
Required scope: budgets:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Example
curl "https://your-shop.example/api/v1/budgets/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": 2,
"name": "Lift 2"
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
GET /api/v1/budgets/{id}/activity budgets:read
Budget activity
What happened to the budget, newest first: status changes, sends, acceptance (with its origin), appointments, client messages, invoicing… The same log the workshop sees; public=true marks what the client also sees. One-time codes and access links are masked.
Required scope: budgets:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Query
| Name | Type | Required | Description |
|---|
visibility | string [all, public] · default all | No | all: full log; public: only what the client sees. |
limit | integer · default 50 | No | Results per page (1–200). |
cursor | string | No | Opaque cursor returned as next_cursor by the previous page. |
Example
curl "https://your-shop.example/api/v1/budgets/1234/activity" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": 88123,
"at": "2026-10-06T09:30:00.000Z",
"event": "web_accepted",
"detail": "Budget accepted by the customer from the tracking page",
"source": "client",
"public": true,
"user": {
"id": 3,
"name": "Marta"
}
}
],
"next_cursor": "aWQ6MTIzNA",
"has_more": true
}
POST /api/v1/budgets/{id}/lines budgets:write
Add a line
The other lines keep their ids. Takes a prior snapshot and logs the change like any edit in the app. 409 budget_locked when the budget is invoiced, cancelled, rejected, withdrawn or already has an invoice.
Required scope: budgets:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"description": "Oil and filter change",
"quantity": 1,
"unit_price": 65,
"tax_rate": 21,
"discount_pct": 0,
"line_type": "labor",
"reference": null,
"group_title": null
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/lines" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"description":"Oil and filter change","quantity":1,"unit_price":65,"tax_rate":21,"discount_pct":0,"line_type":"labor","reference":null,"group_title":null}'
Response
{
"line": {
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
},
"budget": {
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": null,
"name": null
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
}
PATCH /api/v1/budgets/{id}/lines/{lineId} budgets:write
Update a line
Required scope: budgets:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
lineId | integer | Yes | Line id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | No | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"description": "Oil and filter change",
"quantity": 1,
"unit_price": 65,
"tax_rate": 21,
"discount_pct": 0,
"line_type": "labor",
"reference": null,
"group_title": null
}
Example
curl -X PATCH "https://your-shop.example/api/v1/budgets/1234/lines/5501" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"description":"Oil and filter change","quantity":1,"unit_price":65,"tax_rate":21,"discount_pct":0,"line_type":"labor","reference":null,"group_title":null}'
Response
{
"line": {
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
},
"budget": {
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": null,
"name": null
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
}
DELETE /api/v1/budgets/{id}/lines/{lineId} budgets:write
Delete a line
Returns the budget with recalculated totals. The line remains in the prior snapshot of the version history.
Required scope: budgets:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
lineId | integer | Yes | Line id. |
Example
curl -X DELETE "https://your-shop.example/api/v1/budgets/1234/lines/5501" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": 2,
"name": "Lift 2"
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
POST /api/v1/budgets/{id}/status budgets:write
Change the status
Accepts Pendiente/En cotización/Enviado (before acceptance), En curso (already accepted), Finalizado (from Aprobado, En curso or En espera) and Cancelado. «Aprobado» answers 403 client_acceptance_required: acceptance is signed by the client from the link the workshop sends, or recorded on their behalf by your integration with POST /budgets/{id}/accept (budgets:accept scope). Rejecting goes through POST /budgets/{id}/reject and invoicing through POST /budgets/{id}/invoice (invoices:write scope); here they answer 403 status_transition_forbidden, like withdrawing; from Facturado or Cancelado, 409 budget_locked. «Enviado» also requires communications:send and sent_via: it records that YOUR system already sent it (it does not send). No change notifies the client except Finalizado with notify_client=true and communications:send.
Required scope: budgets:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"status": "En curso",
"sent_via": "email",
"notify_client": false
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/status" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"status":"En curso","sent_via":"email","notify_client":false}'
Response
{
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": {
"id": 2,
"name": "Lift 2"
}
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
}
POST /api/v1/budgets/{id}/accept budgets:accept
Accept on behalf of the client
For when the client accepts through another channel (phone, in person, your website…). Evidence is mandatory: accepted_by and channel (phone, in_person, email, whatsapp, other); note is optional. Goes through the program's single acceptance rule: Aprobado status, transition, minimum client tax data (if missing, 422 fiscal_data_incomplete with missing), campaign discount, internal notice to the workshop, confirmation to the client per the configured notices and lead.accepted and budget.accepted webhooks. Only from «Enviado» (already accepted answers 200 with already=true); Cancelado, Rechazado, Desistido, Finalizado or Facturado answer 409 budget_locked. If the workshop requires a signature, the API accepts anyway and records it: «sin firma, aceptado por integración» (signature=waived_by_integration). The log reads «Aceptado por API en nombre del cliente · integración <key> · <accepted_by> por <channel>».
Required scope: budgets:accept.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"accepted_by": "Laura Gómez",
"channel": "phone",
"note": "Confirmed by phone at 10:12"
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/accept" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"accepted_by":"Laura Gómez","channel":"phone","note":"Confirmed by phone at 10:12"}'
Response
{
"budget": {
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": null
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
},
"already": false,
"signature": "not_required"
}
POST /api/v1/budgets/{id}/reject budgets:accept
Reject on behalf of the client
Reason required. Same rule as a client rejection: from Pendiente, En cotización, Enviado or Aprobado (if the vehicle has not checked in). Emits lead.rejected and budget.rejected and is logged with the key name.
Required scope: budgets:accept.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"reason": "They will do it at another shop",
"rejected_by": "Laura Gómez",
"channel": "phone"
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/reject" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"reason":"They will do it at another shop","rejected_by":"Laura Gómez","channel":"phone"}'
Response
{
"budget": {
"id": 1234,
"status": "Aprobado",
"created_at": "2026-10-06T09:30:00.000Z",
"updated_at": "2026-10-06T09:30:00.000Z",
"channel": "web",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"subcategory": {
"id": 5,
"name": "Mantenimiento"
},
"assigned_user": {
"id": 3,
"name": "Marta"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"appointment": {
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"status": "confirmed",
"client_confirmed_at": null,
"estimated_duration_minutes": 60,
"box": null
},
"date_in": null,
"date_out": null,
"km": 84500,
"client_reference": null,
"waiting_parts": false,
"on_hold": false,
"hold_until": null,
"client_signed_at": null,
"estimated_ready_at": null,
"delivered_at": null,
"reject_reason": null,
"public_notes": "Also check the noise in the suspension.",
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 5501,
"description": "Oil and filter change",
"extended_detail": null,
"reference": null,
"line_type": "labor",
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"price_estimated": false,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
]
},
"already": false,
"signature": "not_required"
}
POST /api/v1/budgets/{id}/documents budgets:write
Attach a document
multipart/form-data with the «file» field (JPEG, PNG, WebP or PDF, checked by content; 4 MB max). Staff-only by default; client_visible=true shows it on the tracking page and mechanic_visible=true in the mechanic app. The idempotency fingerprint includes the file.
Required scope: budgets:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body (multipart/form-data)
| Name | Type | Required | Description |
|---|
file | string (binary) | Yes | Fichero |
client_visible | string [true, false] | No | |
mechanic_visible | string [true, false] | No | |
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/documents" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-F "file=@fichero.pdf" \
-F "client_visible=false" \
-F "mechanic_visible=false"
Response
{
"id": 991,
"budget_id": 1234,
"filename": "parte-de-trabajo.pdf",
"content_type": "application/pdf",
"size": 182044,
"url": "https://…/leads/1234/api-parte-de-trabajo.pdf",
"client_visible": false,
"mechanic_visible": false,
"created_at": "2026-10-06T09:30:00.000Z"
}
Invoices
POST /api/v1/budgets/{id}/invoice invoices:write
Invoice a budget
Uses the program's own invoicing: copies the budget lines and tax, creates the accounting entry and, with issue=true (default), issues the invoice with the right series, sequential number, chained hash and Verifactu QR. The budget becomes Facturado. Budgets in Aprobado, En curso, En espera or Finalizado with an amount can be invoiced; if it already has an invoice that one is returned (created=false), never a second one. Emits invoice.created and invoice.issued. Corrective invoices are not available through the API: they are made in the program.
Required scope: invoices:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Budget id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"issue": true,
"pay_method": "TARJETA"
}
Example
curl -X POST "https://your-shop.example/api/v1/budgets/1234/invoice" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"issue":true,"pay_method":"TARJETA"}'
Response
{
"invoice": {
"id": 412,
"number": 87,
"series": "F26",
"full_number": "F2687",
"kind": "invoice",
"rectifies_number": null,
"status": "issued",
"date": "2026-10-06",
"issued_at": "2026-10-06T09:30:00.000Z",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"budget_id": 1234,
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"plate": "1234 KLM",
"km": 84500,
"total": 78.65,
"currency": "EUR",
"payments": {
"paid": 78.65,
"pending": 0,
"settled": true
},
"payment_method": "Tarjeta",
"rebu": false,
"verifactu_hash": "3f9a…",
"registered_externally": false,
"billing": {
"name": "Laura Gómez",
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona"
},
"date_in": null,
"date_out": null,
"public_notes": null,
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 9001,
"description": "Oil and filter change",
"reference": null,
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
],
"payment_list": [
{
"id": 77,
"date": "2026-10-06T09:30:00.000Z",
"amount": 78.65,
"currency": "EUR",
"method": "Tarjeta"
}
]
},
"created": true
}
GET /api/v1/invoices invoices:read
List invoices
Issued invoices and drafts ordered by id, with a payments summary.
Required scope: invoices:read.
Query
| Name | Type | Required | Description |
|---|
from | string (date-time) | No | Invoice date from. |
to | string (date-time) | No | Invoice date to. |
client_id | integer | No | Filter by client. |
status | string [draft, issued, cancelled] | No | Invoice status. |
series | string | No | Exact series. |
limit | integer · default 50 | No | Results per page (1–200). |
cursor | string | No | Opaque cursor returned as next_cursor by the previous page. |
Example
curl "https://your-shop.example/api/v1/invoices" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": 412,
"number": 87,
"series": "F26",
"full_number": "F2687",
"kind": "invoice",
"rectifies_number": null,
"status": "issued",
"date": "2026-10-06",
"issued_at": "2026-10-06T09:30:00.000Z",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"budget_id": 1234,
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"plate": "1234 KLM",
"km": 84500,
"total": 78.65,
"currency": "EUR",
"payments": {
"paid": 78.65,
"pending": 0,
"settled": true
},
"payment_method": "Tarjeta",
"rebu": false,
"verifactu_hash": "3f9a…",
"registered_externally": false
}
],
"next_cursor": "aWQ6MTIzNA",
"has_more": true
}
GET /api/v1/invoices/{id} invoices:read
Invoice detail
Required scope: invoices:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Invoice id. |
Example
curl "https://your-shop.example/api/v1/invoices/1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": 412,
"number": 87,
"series": "F26",
"full_number": "F2687",
"kind": "invoice",
"rectifies_number": null,
"status": "issued",
"date": "2026-10-06",
"issued_at": "2026-10-06T09:30:00.000Z",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"budget_id": 1234,
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"plate": "1234 KLM",
"km": 84500,
"total": 78.65,
"currency": "EUR",
"payments": {
"paid": 78.65,
"pending": 0,
"settled": true
},
"payment_method": "Tarjeta",
"rebu": false,
"verifactu_hash": "3f9a…",
"registered_externally": false,
"billing": {
"name": "Laura Gómez",
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona"
},
"date_in": null,
"date_out": null,
"public_notes": null,
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 9001,
"description": "Oil and filter change",
"reference": null,
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
],
"payment_list": [
{
"id": 77,
"date": "2026-10-06T09:30:00.000Z",
"amount": 78.65,
"currency": "EUR",
"method": "Tarjeta"
}
]
}
GET /api/v1/invoices/{id}/pdf invoices:read
Invoice PDF
The same PDF the program generates (with the Verifactu QR when issued). application/pdf response.
Required scope: invoices:read.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Invoice id. |
Example
curl "https://your-shop.example/api/v1/invoices/1234/pdf" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
(application/pdf)
POST /api/v1/invoices/{id}/payments invoices:write
Record a payment
Same payment log as the invoice screen: the «paid» flag is recalculated from all payments (never forced) and payment.received is emitted. Issued invoices only. Returns the invoice with its payments summary.
Required scope: invoices:write.
Parameters
| Name | Type | Required | Description |
|---|
id | integer | Yes | Invoice id. |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"amount": 245.3,
"date": "2026-10-13",
"pay_method": "TARJETA",
"notes": "Paid at the counter"
}
Example
curl -X POST "https://your-shop.example/api/v1/invoices/1234/payments" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"amount":245.3,"date":"2026-10-13","pay_method":"TARJETA","notes":"Paid at the counter"}'
Response
{
"id": 412,
"number": 87,
"series": "F26",
"full_number": "F2687",
"kind": "invoice",
"rectifies_number": null,
"status": "issued",
"date": "2026-10-06",
"issued_at": "2026-10-06T09:30:00.000Z",
"client_id": 1204,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"budget_id": 1234,
"vehicle_id": 871,
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"plate": "1234 KLM",
"km": 84500,
"total": 78.65,
"currency": "EUR",
"payments": {
"paid": 78.65,
"pending": 0,
"settled": true
},
"payment_method": "Tarjeta",
"rebu": false,
"verifactu_hash": "3f9a…",
"registered_externally": false,
"billing": {
"name": "Laura Gómez",
"tax_id": "12345678Z",
"address": "C/ Mayor 12",
"city": "Barcelona",
"zip": "08001",
"province": "Barcelona"
},
"date_in": null,
"date_out": null,
"public_notes": null,
"totals": {
"base": 65,
"tax": 13.65,
"total": 78.65,
"currency": "EUR",
"tax_rates": [
{
"rate": 21,
"base": 65,
"quota": 13.65
}
]
},
"lines": [
{
"id": 9001,
"description": "Oil and filter change",
"reference": null,
"group_title": null,
"quantity": 1,
"unit_price": 65,
"discount_pct": 0,
"tax_rate": 21,
"tax_exempt_code": null,
"base": 65,
"currency": "EUR",
"sort_order": 0
}
],
"payment_list": [
{
"id": 77,
"date": "2026-10-06T09:30:00.000Z",
"amount": 78.65,
"currency": "EUR",
"method": "Tarjeta"
}
]
}
Appointments
GET /api/v1/appointments appointments:read
Confirmed and proposed appointments
Defaults to the next 30 days. status=confirmed are booked appointments; status=proposed are client proposals awaiting workshop confirmation (they block the slot).
Required scope: appointments:read.
Query
| Name | Type | Required | Description |
|---|
from | string (date-time) | No | Range start (defaults to now). |
to | string (date-time) | No | Range end (defaults to +30 days, 1 year max). |
status | string [confirmed, proposed] | No | Only one kind. |
box_id | integer | No | Filter by bay/box. |
Example
curl "https://your-shop.example/api/v1/appointments" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"id": "b1234",
"budget_id": 1234,
"status": "confirmed",
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"estimated_duration_minutes": 60,
"client_confirmed_at": null,
"budget_status": "Aprobado",
"checked_in_at": null,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"box": {
"id": 2,
"name": "Lift 2"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"channel": null,
"proposed_at": null
}
],
"from": "2026-10-06T00:00:00.000Z",
"to": "2026-11-05T00:00:00.000Z"
}
POST /api/v1/appointments appointments:write
Propose or book an appointment
Follows the workshop booking mode (booking_mode in GET /workshop). In «propose» a proposal is created (status=proposed) that blocks the slot until the workshop confirms it; asking mode=book answers 403 booking_mode_propose_only. In «book» the appointment is confirmed (status=confirmed) unless you ask mode=propose. The slot is checked with the same logic as /appointments/availability; if not free, 409 slot_unavailable with up to 3 alternatives in error.alternatives. The client is not notified unless notify_client=true with communications:send.
Required scope: appointments:write.
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | Yes | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"budget_id": 1234,
"start": "2026-10-14T09:00:00+02:00",
"box_id": 2,
"duration_minutes": 60,
"mode": "propose",
"notify_client": false
}
Example
curl -X POST "https://your-shop.example/api/v1/appointments" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"budget_id":1234,"start":"2026-10-14T09:00:00+02:00","box_id":2,"duration_minutes":60,"mode":"propose","notify_client":false}'
Response
{
"id": "b1234",
"budget_id": 1234,
"status": "confirmed",
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"estimated_duration_minutes": 60,
"client_confirmed_at": null,
"budget_status": "Aprobado",
"checked_in_at": null,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"box": {
"id": 2,
"name": "Lift 2"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"channel": null,
"proposed_at": null
}
GET /api/v1/appointments/availability appointments:read
Free slots
Same logic as the agenda and the tracking page: workshop and bay hours, lunch break, national/regional/local holidays, open appointments and pending proposals (which block their slot). Starts every 30 min, at least 1 h from now. Defaults to the next 7 days (31 max). Includes the workshop booking_mode.
Required scope: appointments:read.
Query
| Name | Type | Required | Description |
|---|
from | string (date-time) | No | From (defaults to now). |
to | string (date-time) | No | To (defaults to +7 days; 31 days max). |
duration_minutes | integer | No | Appointment length (15–720). Defaults to the agenda minimum. |
box_id | integer | No | Only that bay. |
limit | integer · default 100 | No | Maximum slots (1–500). |
Example
curl "https://your-shop.example/api/v1/appointments/availability" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"data": [
{
"start": "2026-10-14T07:00:00.000Z",
"end": "2026-10-14T08:00:00.000Z",
"box": {
"id": 2,
"name": "Lift 2"
}
}
],
"duration_minutes": 60,
"from": "2026-10-14T00:00:00.000Z",
"to": "2026-10-21T00:00:00.000Z",
"booking_mode": "propose"
}
DELETE /api/v1/appointments/{id} appointments:write
Cancel an appointment or withdraw a proposal
b<budget>: cancels the confirmed appointment (same as «Cancel appointment» in the app). p<proposal>: withdraws the pending proposal; with notify_client=true and communications:send the client is invited to pick another time. Emits appointment.cancelled.
Required scope: appointments:write.
Parameters
| Name | Type | Required | Description |
|---|
id | string | Yes | Appointment id (b1234 or p88). |
Query
| Name | Type | Required | Description |
|---|
notify_client | boolean · default false | No | Proposals only: notify the client. |
Example
curl -X DELETE "https://your-shop.example/api/v1/appointments/b1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"ok": true,
"id": "b1234",
"status": "cancelled"
}
GET /api/v1/appointments/{id} appointments:read
Appointment detail
Required scope: appointments:read.
Parameters
| Name | Type | Required | Description |
|---|
id | string | Yes | Appointment id (b1234 or p88). |
Example
curl "https://your-shop.example/api/v1/appointments/b1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"id": "b1234",
"budget_id": 1234,
"status": "confirmed",
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"estimated_duration_minutes": 60,
"client_confirmed_at": null,
"budget_status": "Aprobado",
"checked_in_at": null,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"box": {
"id": 2,
"name": "Lift 2"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"channel": null,
"proposed_at": null
}
PATCH /api/v1/appointments/{id} appointments:write
Move an appointment or change a proposal
b<budget>: moves the confirmed appointment to the new time (only if the workshop works in «book» mode; in «propose» mode it answers 403 booking_mode_propose_only: create a proposal with POST /appointments). p<proposal>: withdraws the proposal and creates a new one at the new time (the id changes). The slot is checked like on creation (409 slot_unavailable with alternatives). Emits appointment.updated.
Required scope: appointments:write.
Parameters
| Name | Type | Required | Description |
|---|
id | string | Yes | Appointment id (b1234 or p88). |
Headers
| Name | Type | Required | Description |
|---|
Idempotency-Key | string | No | Unique key per operation (UUID recommended). Repeating it with the same body within 24 h returns the stored response with Idempotent-Replay: true; with a different body, 409 idempotency_conflict. |
Body
{
"start": "2026-10-15T10:00:00+02:00",
"box_id": 2,
"duration_minutes": 60,
"notify_client": false
}
Example
curl -X PATCH "https://your-shop.example/api/v1/appointments/b1234" \
-H "Authorization: Bearer pt_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"start":"2026-10-15T10:00:00+02:00","box_id":2,"duration_minutes":60,"notify_client":false}'
Response
{
"id": "b1234",
"budget_id": 1234,
"status": "confirmed",
"start": "2026-10-06T09:30:00.000Z",
"end": "2026-10-06T10:30:00.000Z",
"estimated_duration_minutes": 60,
"client_confirmed_at": null,
"budget_status": "Aprobado",
"checked_in_at": null,
"client": {
"id": 1204,
"name": "Laura Gómez"
},
"vehicle": {
"id": 871,
"plate": "1234 KLM",
"brand": "Seat",
"model": "León"
},
"mechanic": {
"id": 3,
"name": "Marta"
},
"box": {
"id": 2,
"name": "Lift 2"
},
"category": {
"id": 5,
"name": "Mantenimiento"
},
"channel": null,
"proposed_at": null
}