Subir certificado digital (PFX/P12)

POST

/api/v1/billing/empresa/certificado/pfx

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/empresa/certificado/pfx"),
    Headers =
    {
        { "X-Api-Key", "<X-Api-Key>" },
    },
    Content = new MultipartFormDataContent
    {
        new StringContent("")
        {
            Headers =
            {
                ContentType = new MediaTypeHeaderValue("application/octet-stream"),
                ContentDisposition = new ContentDispositionHeaderValue("form-data")
                {
                    Name = "file",
                    FileName = "file",
                }
            }
        },
        new StringContent("example")
        {
            Headers =
            {
                ContentType = new MediaTypeHeaderValue("text/plain"),
                ContentDisposition = new ContentDispositionHeaderValue("form-data")
                {
                    Name = "password",
                }
            }
        },
        new StringContent("12345678-9")
        {
            Headers =
            {
                ContentType = new MediaTypeHeaderValue("text/plain"),
                ContentDisposition = new ContentDispositionHeaderValue("form-data")
                {
                    Name = "rut_firmante",
                }
            }
        },
    },
};
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/empresa/certificado/pfx"))
    .header("X-Api-Key", "<X-Api-Key>")
    .header("Content-Type", "multipart/form-data; boundary=---011000010111000001101001")
    .method("POST", HttpRequest.BodyPublishers.ofString("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"file\"; filename=\"file\"\r\nContent-Type: application/octet-stream\r\n\r\n\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"password\"\r\nContent-Type: text/plain\r\n\r\nexample\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"rut_firmante\"\r\nContent-Type: text/plain\r\n\r\n12345678-9\r\n-----011000010111000001101001--\r\n"))
    .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/empresa/certificado/pfx';
const form = new FormData();
form.append('file', 'file');
form.append('password', 'example');
form.append('rut_firmante', '12345678-9');

const options = {method: 'POST', headers: {'X-Api-Key': '<X-Api-Key>'}};

options.body = form;

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/empresa/certificado/pfx \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <X-Api-Key>' \
  --form file=@file \
  --form password=example \
  --form rut_firmante=12345678-9

Sube un certificado digital en formato .pfx o .p12 vía multipart/form-data. El servidor convierte el PFX internamente y almacena el certificado encriptado; la clave privada nunca se expone en la API. Requiere rol admin. Tamaño máximo del archivo: 50KB.

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

multipart/form-data

object

file

requerido

Archivo .pfx o .p12 del certificado digital (max 50KB)

string format: binary

password

requerido

Password del certificado PFX

string

rut_firmante

requerido

RUT del firmante (con dígito verificador)

string

Example

12345678-9

Respuestas

201

Certificado subido y procesado

application/json

object

has_certificado

requerido

boolean

rut_firmante

string

nullable

fecha_vencimiento

string format: date

nullable

dias_para_vencimiento

Días restantes hasta vencimiento

integer

nullable

is_active

boolean

uploaded_at

string format: date-time

nullable

Example

{
  "rut_firmante": "12345678-9"
}

400

PFX inválido, password incorrecto, o archivo demasiado grande

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

403

Requiere rol admin

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

Subir certificado digital (PFX/P12)

Autenticación

Cuerpo de la peticiónrequerido

Example

Respuestas

201

Example

400

Example

401

Example

403

Example

Cuerpo de la petición^requerido