Actualizar producto

PUT

/api/v1/billing/productos/{id}

curl --request PUT \
  --url https://api.simplo.cl/api/v1/billing/productos/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --data '{ "codigo": "example", "nombre": "example", "descripcion": "example", "precio_unitario": 1, "unidad": "example", "es_exento": true, "categoria": "example" }'

• Producción

Actualiza datos de un producto existente.

Beta privada: las escrituras vía API key están en beta privada (solicitar acceso: hola@simplo.cl); las API keys hoy operan en modo lectura.

Autenticación

• ApiKeyAuth
• BearerAuth

Parámetros

Parámetros de ruta

id

requerido

string format: uuid

UUID del producto

Cuerpo de la petición^requerido

Media typeapplication/json

object

codigo

string

nombre

string

descripcion

string

precio_unitario

integer format: int64

unidad

string

es_exento

boolean

categoria

string

Example^generated

{
  "codigo": "example",
  "nombre": "example",
  "descripcion": "example",
  "precio_unitario": 1,
  "unidad": "example",
  "es_exento": true,
  "categoria": "example"
}

Respuestas

200

Producto actualizado

Media typeapplication/json

object

id

string format: uuid

codigo

string

nombre

string

descripcion

string

precio_unitario

integer format: int64

unidad

string

es_exento

boolean

categoria

string

created_at

string format: date-time

updated_at

string format: date-time

Example

{
  "codigo": "PROD-001",
  "nombre": "Hora de consultoria TI",
  "precio_unitario": 50000,
  "unidad": "HR"
}

401

Token o API key inválido o ausente

Media typeapplication/json

object

code

requerido

Código de error máquina-legible

string

message

requerido

Mensaje descriptivo del error. Este es el campo canónico para clientes nuevos.

string

error

Alias de compatibilidad de message mantenido hacia atrás.

string

details

Array<object>

object

field

requerido

Campo con error (dot notation para nested)

string

code

requerido

Código de validación

string

message

requerido

Mensaje descriptivo

string

action

Acción recomendada para el cliente

string

severity

Severidad opcional del error

string

Valores permitidos: critical error warning info

context

Contexto estructurado opcional para debugging

object

key

additional properties

any

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Error de validacion en los campos enviados",
  "details": [
    {
      "field": "receptor.rut",
      "code": "INVALID_RUT",
      "message": "RUT invalido: digito verificador no coincide"
    }
  ],
  "severity": "critical"
}

404

Recurso no encontrado

Media typeapplication/json

object

code

requerido

Código de error máquina-legible

string

message

requerido

Mensaje descriptivo del error. Este es el campo canónico para clientes nuevos.

string

error

Alias de compatibilidad de message mantenido hacia atrás.

string

details

Array<object>

object

field

requerido

Campo con error (dot notation para nested)

string

code

requerido

Código de validación

string

message

requerido

Mensaje descriptivo

string

action

Acción recomendada para el cliente

string

severity

Severidad opcional del error

string

Valores permitidos: critical error warning info

context

Contexto estructurado opcional para debugging

object

key

additional properties

any

Example

{
  "code": "VALIDATION_ERROR",
  "message": "Error de validacion en los campos enviados",
  "details": [
    {
      "field": "receptor.rut",
      "code": "INVALID_RUT",
      "message": "RUT invalido: digito verificador no coincide"
    }
  ],
  "severity": "critical"
}