Crear Credenciales en Lote

Crear credenciales en lote

curl --request POST \
  --url https://api.tupana.ai/v1/credentials/batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentials": [
    {
      "master_entity_rut": "76.123.456-0",
      "credential_type": "sii_company",
      "user_rut": "12.345.678-5",
      "password": "mi_password_segura"
    },
    {
      "master_entity_rut": "77.698.843-K",
      "credential_type": "SII",
      "user_rut": "11.111.111-1",
      "password": "otra_password"
    }
  ]
}
'

import requests

url = "https://api.tupana.ai/v1/credentials/batch"

payload = { "credentials": [
        {
            "master_entity_rut": "76.123.456-0",
            "credential_type": "sii_company",
            "user_rut": "12.345.678-5",
            "password": "mi_password_segura"
        },
        {
            "master_entity_rut": "77.698.843-K",
            "credential_type": "SII",
            "user_rut": "11.111.111-1",
            "password": "otra_password"
        }
    ] }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    credentials: [
      {
        master_entity_rut: '76.123.456-0',
        credential_type: 'sii_company',
        user_rut: '12.345.678-5',
        password: 'mi_password_segura'
      },
      {
        master_entity_rut: '77.698.843-K',
        credential_type: 'SII',
        user_rut: '11.111.111-1',
        password: 'otra_password'
      }
    ]
  })
};

fetch('https://api.tupana.ai/v1/credentials/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tupana.ai/v1/credentials/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'credentials' => [
        [
                'master_entity_rut' => '76.123.456-0',
                'credential_type' => 'sii_company',
                'user_rut' => '12.345.678-5',
                'password' => 'mi_password_segura'
        ],
        [
                'master_entity_rut' => '77.698.843-K',
                'credential_type' => 'SII',
                'user_rut' => '11.111.111-1',
                'password' => 'otra_password'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tupana.ai/v1/credentials/batch"

	payload := strings.NewReader("{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tupana.ai/v1/credentials/batch")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tupana.ai/v1/credentials/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "items": [
    {
      "item_id": "6b1f3c2e-9a4d-4e7a-8e2a-1a2b3c4d5e6f",
      "index": 0
    },
    {
      "item_id": "8c2d4b1a-3f5e-4a6b-9c7d-2e3f4a5b6c7d",
      "index": 1
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "message": "<string>"
}

{
  "error": "VALIDATION_ERROR",
  "message": "<string>"
}

{
  "credentials": [
    {},
    {
      "master_entity_rut": [
        "RUT de la entidad inválido."
      ]
    }
  ]
}

POST

credentials

batch

Crear credenciales en lote

curl --request POST \
  --url https://api.tupana.ai/v1/credentials/batch \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "credentials": [
    {
      "master_entity_rut": "76.123.456-0",
      "credential_type": "sii_company",
      "user_rut": "12.345.678-5",
      "password": "mi_password_segura"
    },
    {
      "master_entity_rut": "77.698.843-K",
      "credential_type": "SII",
      "user_rut": "11.111.111-1",
      "password": "otra_password"
    }
  ]
}
'

import requests

url = "https://api.tupana.ai/v1/credentials/batch"

payload = { "credentials": [
        {
            "master_entity_rut": "76.123.456-0",
            "credential_type": "sii_company",
            "user_rut": "12.345.678-5",
            "password": "mi_password_segura"
        },
        {
            "master_entity_rut": "77.698.843-K",
            "credential_type": "SII",
            "user_rut": "11.111.111-1",
            "password": "otra_password"
        }
    ] }
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    credentials: [
      {
        master_entity_rut: '76.123.456-0',
        credential_type: 'sii_company',
        user_rut: '12.345.678-5',
        password: 'mi_password_segura'
      },
      {
        master_entity_rut: '77.698.843-K',
        credential_type: 'SII',
        user_rut: '11.111.111-1',
        password: 'otra_password'
      }
    ]
  })
};

fetch('https://api.tupana.ai/v1/credentials/batch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tupana.ai/v1/credentials/batch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'credentials' => [
        [
                'master_entity_rut' => '76.123.456-0',
                'credential_type' => 'sii_company',
                'user_rut' => '12.345.678-5',
                'password' => 'mi_password_segura'
        ],
        [
                'master_entity_rut' => '77.698.843-K',
                'credential_type' => 'SII',
                'user_rut' => '11.111.111-1',
                'password' => 'otra_password'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tupana.ai/v1/credentials/batch"

	payload := strings.NewReader("{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tupana.ai/v1/credentials/batch")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tupana.ai/v1/credentials/batch")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credentials\": [\n    {\n      \"master_entity_rut\": \"76.123.456-0\",\n      \"credential_type\": \"sii_company\",\n      \"user_rut\": \"12.345.678-5\",\n      \"password\": \"mi_password_segura\"\n    },\n    {\n      \"master_entity_rut\": \"77.698.843-K\",\n      \"credential_type\": \"SII\",\n      \"user_rut\": \"11.111.111-1\",\n      \"password\": \"otra_password\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "items": [
    {
      "item_id": "6b1f3c2e-9a4d-4e7a-8e2a-1a2b3c4d5e6f",
      "index": 0
    },
    {
      "item_id": "8c2d4b1a-3f5e-4a6b-9c7d-2e3f4a5b6c7d",
      "index": 1
    }
  ]
}

{
  "error": "VALIDATION_ERROR",
  "message": "<string>"
}

{
  "error": "VALIDATION_ERROR",
  "message": "<string>"
}

{
  "credentials": [
    {},
    {
      "master_entity_rut": [
        "RUT de la entidad inválido."
      ]
    }
  ]
}

Que hace

Crea hasta 200 credenciales SII en una sola llamada
Valida el formato de cada credencial de inmediato (RUTs, tipo de credencial soportado, contraseña no vacia) y responde con el batch_id apenas el formato es correcto
Valida cada credencial contra el SII de forma asincrona, sin bloquear la respuesta
Notifica el resultado final de cada credencial por webhook (credential.validated o credential.invalid)
Crea automaticamente la entidad maestra (master_entity_rut) si aun no existe en Tupana

Ejemplos de uso

Migrar o dar de alta el portafolio completo de un contador/gestora de una sola vez
Reintentar credenciales que quedaron invalidas para varios clientes
Integrar un onboarding masivo de empresas sin esperar la validacion SII en el mismo request

Tipos de credenciales soportados

Este endpoint solo admite credenciales SII (no certificados digitales ni credenciales de otros proveedores, que se crean con POST /credentials):

Tipo (`credential_type`)	Descripcion
`SII`	Servicio de Impuestos Internos (clave tributaria personal)
`sii_company`	SII a nivel de empresa (clave de empresa)

Flujo del batch

Respuesta inmediata (201): confirma que el formato de cada credencial es valido y devuelve batch_id + un item_id por credencial, en el mismo orden enviado.
Procesamiento asincrono: cada credencial se valida contra el SII por separado. Una credencial con error no afecta a las demas del mismo lote.
Notificacion por webhook: cuando una credencial termina de procesarse, se dispara:
- credential.validated si el login al SII fue exitoso
- credential.invalid si la clave es incorrecta o la cuenta esta bloqueada

Idempotency-Key

Envia idempotency_key en el body para evitar crear un batch duplicado si reintentas la misma solicitud (por ejemplo, tras un timeout de red). Si ya existe un batch con esa clave, se devuelve el batch existente en vez de crear uno nuevo.

Errores de formato (`422`)

Si alguna credencial del lote no pasa la validacion de formato, la respuesta es 422 y no se crea ningun batch. Los errores se devuelven por indice, en el mismo orden del array credentials enviado.

Authorizations

Authorization

string

header

required

API Key para autenticación. Debe proporcionarse en el header Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo 'Api-Key ' seguido de tu API key)

Body

application/json

Lote de credenciales a crear/validar

credentials

object[]

required

Required array length: 1 - 200 elements

Show child attributes

idempotency_key

string

Clave opcional que previene la creación de lotes duplicados. Si se repite, se devuelve el batch ya creado en vez de uno nuevo.

Example:

"batch_credenciales_2026_01_15_001"

Response

Solicitud aceptada. El formato de cada credencial es válido; el resultado de cada una se notificará por webhook.

batch_id

string<uuid>

ID único del batch, usado para consultarlo en GET /credentials/batch/{batch_id}

Example:

"550e8400-e29b-41d4-a716-446655440000"

status

enum<string>

Estado del batch

Available options:

processing,

completed,

partial,

failed

Example:

"processing"

items

object[]

Un item por cada credencial recibida, en el mismo orden del request

Show child attributes

Introducción

Entidades

Credenciales

Documentos

Estados de Documentos

Documentos Programados

Webhooks

Crear Credenciales en Lote

Que hace

Ejemplos de uso

Tipos de credenciales soportados

Flujo del batch

Idempotency-Key

Errores de formato (`422`)

Authorizations

Body

Response

​Que hace

​Ejemplos de uso

​Tipos de credenciales soportados

​Flujo del batch

​Idempotency-Key

​Errores de formato (422)

Authorizations

Body

Response

Que hace

Ejemplos de uso

Tipos de credenciales soportados

Flujo del batch

Idempotency-Key

Errores de formato (`422`)