Ir al contenido
SimploSimplo Docs

Crear producto

POST
/api/v1/billing/productos
curl --request POST \
--url https://api.simplo.cl/api/v1/billing/productos \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <X-Api-Key>' \
--data '{ "codigo": "SERV-001", "nombre": "Hora de consultoria TI", "precio_unitario": 50000, "unidad": "HR", "es_exento": false, "categoria": "Servicios" }'

Crea un producto o servicio en el catálogo de la empresa. El codigo (si se envía) debe ser único dentro de la empresa.

Beta privada: las escrituras vía API key están en beta privada (solicitar acceso: [email protected]); las API keys hoy operan en modo lectura.

Media typeapplication/json
object
codigo
string
nombre
requerido
string
descripcion
string
precio_unitario

Precio en CLP (entero, sin decimales)

integer format: int64
unidad
string
default: UN
Valores permitidos: UN HR KG LT MT M2 M3
es_exento
boolean
categoria
string
Example
{
"codigo": "SERV-001",
"nombre": "Hora de consultoria TI",
"precio_unitario": 50000,
"unidad": "HR",
"es_exento": false,
"categoria": "Servicios"
}

Producto creado

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"
}

Datos inválidos (nombre vacio, precio negativo)

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"
}

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"
}

Producto con este código ya existe para la empresa

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"
}