Nubox es un software contable para pymes y contadores enfocado en facturación electrónica, gestión contable y remuneraciones. Sus productos están diseñados para simplificar y automatizar procesos administrativos y financieros, facilitando el cumplimiento de obligaciones tributarias y mejorando la eficiencia operativa.

¿Para qué sirve Nubox?

Nubox ofrece herramientas diseñadas para facilitar la gestión administrativa y financiera de las empresas. Con su plataforma, es posible emitir facturas electrónicas, lo que permite generar y enviar Documentos Tributarios Electrónicos (DTE) cumpliendo con la normativa vigente. Además, Nubox ayuda a llevar la contabilidad al registrar y organizar movimientos financieros, generar balances y estados de resultados, y preparar declaraciones juradas. Por último, también permite gestionar remuneraciones, ofreciendo funcionalidades para calcular y procesar liquidaciones de sueldo, administrar cotizaciones previsionales y generar informes relacionados con el pago de empleados.

Autenticación
Factura Electónica
- Compras
- Ventas
- Comunas
- Clientes
- Proveedores
- Productos
- Sucursales
Contabilidad
- Comprobantes
Partners
- Compras
- Pagos
- Recaudaciones
- Ventas

Colección de clientes

Un cliente es una persona que utiliza los servicios de un profesional o de una empresa, especialmente la que lo hace regularmente.

En esta sección aprenderás cómo utilizar la API para insertar una colección de clientes.

Flujo de inserción de una colección de clientes

Insertando una colección de clientes

Para insertar una colección de clientes utilizaremos el verbo http POST.

API endpoint exclusivo para partners que trabajen con factura electronica.

URL del recurso

https://api.nubox.com/Nubox.API/factura/{rut}/{numeroSerie}/clientes

Información del recurso

Formato de respuesta	JSON
¿Requiere autenticación?	SI
¿Requiere token?	SI
¿Requiere Partner key?	NO

Parámetros

Nombre	Descripción	Tipo del parámetro	Tipo del dato
rut	Rut de la empresa	Path	String
numeroSerie	Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API	Path	Boolean
clientes	Arreglo de json de clientes	body	Json

JSON de clientes

En el parámetro clientes debes incluir un JSON con la siguiente estructura

Nombre	Tipo	Obligatorio	Descripción
Rut	String	SI	Rut del cliente
RazonSocial	String	SI	Razón social del cliente
Giro	String	SI	Giro del cliente
Acteco	String	NO	Actividad económica
DireccionLegal	String	SI	Dirección
ComunaLegalNombre	String	SI	Comuna
Contacto	String	NO	Nombre del contacto
Email	String	SI	Email
seEnviaPDF	String	SI	Indicador de envió de archivos pdf, Valores posibles: Bool ['TRUE', 'FALSE']

    "Rut": "11111111-1",
    "RazonSocial": "Juan Cliente",
    "Giro": "EMPRESA DE SERVICIOS INTEGRALES DE INFORMATICA",
    "Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
    "DireccionLegal": "Orinoco 90",
    "ComunaLegalNombre": "Las Condes",
    "Contacto": "Juan Contador",
    "Email": "juan.contador@ejemplo.com",
    "seEnviaPDF": 1

Consideraciones

En este apartado se entrega información importante que debes tener en consideración.

Ejemplos de Request

curl --location --request POST 'https://api.nubox.com/Nubox.API/factura/1-9/1/clientes' \
--header 'token: 74d69e7e-8596-4ac6-8430-ed3c5da83bed' \
--header 'Content-Type: application/json' \
--header 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' \
--data-raw '[
    "Rut": "2-7",
    "RazonSocial": "Juan Cliente",
    "Giro": "EMPRESA DE SERVICIOS DE INFORMATICA",
    "Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
    "DireccionLegal": "Orinoco 90",
    "ComunaLegalNombre": "Las Condes",
    "Contacto": "Juan Contador",
    "Email": "juan.contador@ejemplo.com",
    "seEnviaPDF": 1

var settings = {
    "url": "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes",
    "method": "POST",
    "timeout": 0,
    "headers": {
      "token": "74d69e7e-8596-4ac6-8430-ed3c5da83bed",
      "Content-Type": "application/json",
      "Cookie": ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"
    "data": JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]),
  $.ajax(settings).done(function (response) {
    console.log(response);

var myHeaders = new Headers();
myHeaders.append("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da");
var raw = JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]);
var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
fetch("https://api.nubox.com/Nubox.API/factura/1-9/1/clientes", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

var data = JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]);
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
xhr.open("POST", "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes");
xhr.setRequestHeader("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed");
xhr.setRequestHeader("Content-Type", "application/json");
xhr.setRequestHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da");
xhr.send(data);

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.nubox.com/Nubox.API/factura/1-9/1/clientes',
  'headers': {
    'token': '74d69e7e-8596-4ac6-8430-ed3c5da83bed',
    'Content-Type': 'application/json',
    'Cookie': '.Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da'
  body: JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}])
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);

require "uri"
require "net/http"
url = URI("https://api.nubox.com/Nubox.API/factura/1-9/1/clientes")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["token"] = "74d69e7e-8596-4ac6-8430-ed3c5da83bed"
request["Content-Type"] = "application/json"
request["Cookie"] = ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"
request.body = "[\n  {\n    \"Rut\": \"2-7\",\n    \"RazonSocial\": \"Juan Cliente\",\n    \"Giro\": \"EMPRESA DE SERVICIOS DE INFORMATICA\",\n    \"Acteco\": \"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION\",\n    \"DireccionLegal\": \"Orinoco 90\",\n    \"ComunaLegalNombre\": \"Las Condes\",\n    \"Contacto\": \"Juan Contador\",\n    \"Email\": \"juan.contador@ejemplo.com\",\n    \"seEnviaPDF\": 1\n  }\n]"
response = https.request(request)
puts response.read_body

package main
  "strings"
  "net/http"
  "io/ioutil"
func main() {
  url := "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes"
  method := "POST"
  payload := strings.NewReader(`[
    "Rut": "2-7",
    "RazonSocial": "Juan Cliente",
    "Giro": "EMPRESA DE SERVICIOS DE INFORMATICA",
    "Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
    "DireccionLegal": "Orinoco 90",
    "ComunaLegalNombre": "Las Condes",
    "Contacto": "Juan Contador",
    "Email": "juan.contador@ejemplo.com",
    "seEnviaPDF": 1
  client := &http.Client {
  req, err := http.NewRequest(method, url, payload)
  if err != nil {
    fmt.Println(err)
  req.Header.Add("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da")
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
  defer res.Body.Close()
  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
  fmt.Println(string(body))

Ejemplo Response

Response Body

Response Header

Nombre	Valor
cache-control	no-cache
content-length	22
content-type	application/json; charset=utf-8
date	Wed, 08 Jul 2020 21:51:47 GMT

	[{
	"Rut": "11111111-1",
	"RazonSocial": "Juan Cliente",
	"Giro": "EMPRESA DE SERVICIOS INTEGRALES DE INFORMATICA",
	"Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
	"DireccionLegal": "Orinoco 90",
	"ComunaLegalNombre": "Las Condes",
	"Contacto": "Juan Contador",
	"Email": "juan.contador@ejemplo.com",
	"seEnviaPDF": 1
	}
	]

	curl --location --request POST 'https://api.nubox.com/Nubox.API/factura/1-9/1/clientes' \
	--header 'token: 74d69e7e-8596-4ac6-8430-ed3c5da83bed' \
	--header 'Content-Type: application/json' \
	--header 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' \
	--data-raw '[
	{
	"Rut": "2-7",
	"RazonSocial": "Juan Cliente",
	"Giro": "EMPRESA DE SERVICIOS DE INFORMATICA",
	"Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
	"DireccionLegal": "Orinoco 90",
	"ComunaLegalNombre": "Las Condes",
	"Contacto": "Juan Contador",
	"Email": "juan.contador@ejemplo.com",
	"seEnviaPDF": 1
	}
	]'

	var settings = {
	"url": "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes",
	"method": "POST",
	"timeout": 0,
	"headers": {
	"token": "74d69e7e-8596-4ac6-8430-ed3c5da83bed",
	"Content-Type": "application/json",
	"Cookie": ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"
	},
	"data": JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]),
	};

	$.ajax(settings).done(function (response) {
	console.log(response);
	});

	var myHeaders = new Headers();
	myHeaders.append("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed");
	myHeaders.append("Content-Type", "application/json");
	myHeaders.append("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da");

	var raw = JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]);

	var requestOptions = {
	method: 'POST',
	headers: myHeaders,
	body: raw,
	redirect: 'follow'
	};

	fetch("https://api.nubox.com/Nubox.API/factura/1-9/1/clientes", requestOptions)
	.then(response => response.text())
	.then(result => console.log(result))
	.catch(error => console.log('error', error));

	var data = JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}]);

	var xhr = new XMLHttpRequest();
	xhr.withCredentials = true;

	xhr.addEventListener("readystatechange", function() {
	if(this.readyState === 4) {
	console.log(this.responseText);
	}
	});

	xhr.open("POST", "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes");
	xhr.setRequestHeader("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed");
	xhr.setRequestHeader("Content-Type", "application/json");
	xhr.setRequestHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da");

	xhr.send(data);

	var request = require('request');
	var options = {
	'method': 'POST',
	'url': 'https://api.nubox.com/Nubox.API/factura/1-9/1/clientes',
	'headers': {
	'token': '74d69e7e-8596-4ac6-8430-ed3c5da83bed',
	'Content-Type': 'application/json',
	'Cookie': '.Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da'
	},
	body: JSON.stringify([{"Rut":"2-7","RazonSocial":"Juan Cliente","Giro":"EMPRESA DE SERVICIOS DE INFORMATICA","Acteco":"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION","DireccionLegal":"Orinoco 90","ComunaLegalNombre":"Las Condes","Contacto":"Juan Contador","Email":"juan.contador@ejemplo.com","seEnviaPDF":1}])

	};
	request(options, function (error, response) {
	if (error) throw new Error(error);
	console.log(response.body);
	});

	require "uri"
	require "net/http"

	url = URI("https://api.nubox.com/Nubox.API/factura/1-9/1/clientes")

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

	request = Net::HTTP::Post.new(url)
	request["token"] = "74d69e7e-8596-4ac6-8430-ed3c5da83bed"
	request["Content-Type"] = "application/json"
	request["Cookie"] = ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"
	request.body = "[\n {\n \"Rut\": \"2-7\",\n \"RazonSocial\": \"Juan Cliente\",\n \"Giro\": \"EMPRESA DE SERVICIOS DE INFORMATICA\",\n \"Acteco\": \"ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION\",\n \"DireccionLegal\": \"Orinoco 90\",\n \"ComunaLegalNombre\": \"Las Condes\",\n \"Contacto\": \"Juan Contador\",\n \"Email\": \"juan.contador@ejemplo.com\",\n \"seEnviaPDF\": 1\n }\n]"

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

	package main

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

	func main() {

	url := "https://api.nubox.com/Nubox.API/factura/1-9/1/clientes"
	method := "POST"

	payload := strings.NewReader(`[
	{
	"Rut": "2-7",
	"RazonSocial": "Juan Cliente",
	"Giro": "EMPRESA DE SERVICIOS DE INFORMATICA",
	"Acteco": "ACTIVIDADES DE ASESORAMIENTO EMPRESARIAL Y EN MATERIA DE GESTION",
	"DireccionLegal": "Orinoco 90",
	"ComunaLegalNombre": "Las Condes",
	"Contacto": "Juan Contador",
	"Email": "juan.contador@ejemplo.com",
	"seEnviaPDF": 1
	}
	]`)

	client := &http.Client {
	}
	req, err := http.NewRequest(method, url, payload)

	if err != nil {
	fmt.Println(err)
	return
	}
	req.Header.Add("token", "74d69e7e-8596-4ac6-8430-ed3c5da83bed")
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da")

	res, err := client.Do(req)
	if err != nil {
	fmt.Println(err)
	return
	}
	defer res.Body.Close()

	body, err := ioutil.ReadAll(res.Body)
	if err != nil {
	fmt.Println(err)
	return
	}
	fmt.Println(string(body))
	}