Crear cliente

POST

/api/v1/billing/clientes

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.simplo.cl/api/v1/billing/clientes"),
    Headers =
    {
        { "X-Api-Key", "<X-Api-Key>" },
    },
    Content = new StringContent("{ \"rut\": \"76543210-K\", \"razon_social\": \"Empresa Ejemplo SpA\", \"giro\": \"Desarrollo de software\", \"direccion\": \"Av. Providencia 1234\", \"comuna\": \"Providencia\", \"ciudad\": \"Santiago\", \"email\": \"facturacion@ejemplo.cl\" }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.simplo.cl/api/v1/billing/clientes"))
    .header("X-Api-Key", "<X-Api-Key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{ \"rut\": \"76543210-K\", \"razon_social\": \"Empresa Ejemplo SpA\", \"giro\": \"Desarrollo de software\", \"direccion\": \"Av. Providencia 1234\", \"comuna\": \"Providencia\", \"ciudad\": \"Santiago\", \"email\": \"facturacion@ejemplo.cl\" }"))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

const url = 'https://api.simplo.cl/api/v1/billing/clientes';
const options = {
  method: 'POST',
  headers: {'X-Api-Key': '<X-Api-Key>', 'Content-Type': 'application/json'},
  body: '{"rut":"76543210-K","razon_social":"Empresa Ejemplo SpA","giro":"Desarrollo de software","direccion":"Av. Providencia 1234","comuna":"Providencia","ciudad":"Santiago","email":"facturacion@ejemplo.cl"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.simplo.cl/api/v1/billing/clientes \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --data '{ "rut": "76543210-K", "razon_social": "Empresa Ejemplo SpA", "giro": "Desarrollo de software", "direccion": "Av. Providencia 1234", "comuna": "Providencia", "ciudad": "Santiago", "email": "facturacion@ejemplo.cl" }'

Crea un cliente (receptor frecuente) en el catálogo de la empresa. El RUT debe ser valido y único dentro de la empresa.

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

Cuerpo de la petición^requerido

application/json

object

rut

requerido

RUT del cliente con dígito verificador

string

razon_social

requerido

string

giro

string

direccion

string

comuna

string

ciudad

string

email

string format: email

telefono

string

contacto

string

Example

{
  "rut": "76543210-K",
  "razon_social": "Empresa Ejemplo SpA",
  "giro": "Desarrollo de software",
  "direccion": "Av. Providencia 1234",
  "comuna": "Providencia",
  "ciudad": "Santiago",
  "email": "facturacion@ejemplo.cl"
}

Respuestas

201

Cliente creado

application/json

object

string format: uuid

rut

string

razon_social

string

giro

string

direccion

string

comuna

string

ciudad

string

email

string

telefono

string

contacto

string

notas

string

created_at

string format: date-time

updated_at

string format: date-time

Example

{
  "rut": "76543210-K",
  "razon_social": "Empresa Ejemplo SpA"
}

400

Datos inválidos (RUT inválido, razon_social vacía)

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

401

Token o API key inválido o ausente

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

409

Cliente con este RUT ya existe para la empresa

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

Crear cliente

Autenticación

Cuerpo de la peticiónrequerido

Example

Respuestas

201

Example

400

Example

401

Example

409

Example

Cuerpo de la petición^requerido